@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,688 +0,0 @@
1
- import * as path from "node:path";
2
- import { ObservationCache } from "./cache.js";
3
- import { Metrics } from "./metrics.js";
4
- import {
5
- type PersistedLocalActivityWindow,
6
- PersistedLocalHistoryAttachUnavailableError,
7
- PersistedLocalHistoryStore,
8
- type PersistedLocalHistoryAttachDeclaration,
9
- type PersistedLocalHistoryContext,
10
- type RepoConcurrencySummary,
11
- type PersistedLocalHistorySummary,
12
- } from "./persisted-local-history.js";
13
- import { type PersistedLocalHistoryGraphContext } from "./persisted-local-history-graph.js";
14
- import { RepoStateTracker, type RepoObservation } from "./repo-state.js";
15
- import type { RuntimeCausalContext } from "./runtime-causal-context.js";
16
- import { buildRuntimeStagedTarget } from "./runtime-staged-target.js";
17
- import {
18
- buildRuntimeWorkspaceOverlayFooting,
19
- type RuntimeWorkspaceOverlayFooting,
20
- } from "./runtime-workspace-overlay.js";
21
- import { buildWorkspaceReadObservation, type AttributedReadToolName } from "./workspace-read-observation.js";
22
- import {
23
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
24
- WorkspaceBindingRequiredError,
25
- type CausalAttachResult,
26
- type ResolvedWorkspace,
27
- type WorkspaceActionResult,
28
- type WorkspaceAuthorizationPolicy,
29
- type WorkspaceBindAction,
30
- type WorkspaceBindRequest,
31
- type WorkspaceCapabilityProfile,
32
- type WorkspaceExecutionContext,
33
- type WorkspaceMode,
34
- type WorkspaceSharedAttachPolicy,
35
- type WorkspaceStatus,
36
- } from "./workspace-router-model.js";
37
- import { resolveWorkspaceRequest, stableWorkspaceId } from "./workspace-router-resolution.js";
38
- import type { FileSystem } from "../ports/filesystem.js";
39
- import type { GitClient } from "../ports/git.js";
40
- import type { WarpContext } from "../warp/context.js";
41
- import type { JsonObject } from "../contracts/json-object.js";
42
- import type { WarpPool } from "./warp-pool.js";
43
- import { DEFAULT_WARP_WRITER_ID } from "../warp/writer-id.js";
44
- import { GovernorTracker } from "../session/tracker.js";
45
- import {
46
- type BoundWorkspace,
47
- type WorkspaceSlice,
48
- boundWorkspaceStatus,
49
- buildPersistedLocalHistoryContext,
50
- buildPersistedLocalHistoryContextFromExecution,
51
- buildPersistedLocalHistoryGraphContext,
52
- buildWorkspaceCausalContext,
53
- createBoundWorkspace,
54
- createWorkspaceSlice,
55
- nextBindingSliceDir,
56
- resolveCheckoutBoundaryHookEvent,
57
- unboundWorkspaceStatus,
58
- } from "./workspace-router-runtime.js";
59
- export {
60
- DEFAULT_DAEMON_CAPABILITY_PROFILE,
61
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
62
- WorkspaceBindingRequiredError,
63
- WorkspaceCapabilityDeniedError,
64
- type CausalAttachResult,
65
- type ResolvedWorkspace,
66
- type WorkspaceActionResult,
67
- type WorkspaceAuthorizationPolicy,
68
- type WorkspaceBindAction,
69
- type WorkspaceBindRequest,
70
- type WorkspaceCapabilityProfile,
71
- type WorkspaceExecutionContext,
72
- type WorkspaceMode,
73
- type WorkspaceSharedAttachPolicy,
74
- type WorkspaceStatus,
75
- } from "./workspace-router-model.js";
76
- export { resolveWorkspaceRequest } from "./workspace-router-resolution.js";
77
-
78
- interface WorkspaceRouterOptions {
79
- readonly mode: WorkspaceMode;
80
- readonly fs: FileSystem;
81
- readonly git: GitClient;
82
- readonly graftDir: string;
83
- readonly projectRoot?: string | undefined;
84
- readonly warpPool: WarpPool;
85
- readonly transportSessionId: string;
86
- readonly warpWriterId?: string | undefined;
87
- readonly authorizationPolicy?: WorkspaceAuthorizationPolicy | undefined;
88
- readonly sharedAttachPolicy?: WorkspaceSharedAttachPolicy | undefined;
89
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
90
- readonly persistedLocalHistoryGraph?: boolean;
91
- }
92
-
93
- export class WorkspaceRouter {
94
- private bindingCounter = 0;
95
- private sliceIdCounter = 0;
96
- private currentSlice: WorkspaceSlice;
97
- private currentBinding: BoundWorkspace | null = null;
98
- private initialization: Promise<void> | null = null;
99
-
100
- constructor(private readonly options: WorkspaceRouterOptions) {
101
- const initialProjectRoot = options.mode === "repo_local" ? options.projectRoot : undefined;
102
- this.currentSlice = createWorkspaceSlice({
103
- graftDir: options.mode === "repo_local" ? options.graftDir : path.join(options.graftDir, "unbound"),
104
- fs: options.fs,
105
- git: options.git,
106
- nextSliceId: `slice-${String(++this.sliceIdCounter).padStart(4, "0")}`,
107
- ...(initialProjectRoot !== undefined ? { projectRoot: initialProjectRoot } : {}),
108
- });
109
- }
110
-
111
- async initialize(): Promise<void> {
112
- if (this.options.mode !== "repo_local") {
113
- return;
114
- }
115
- if (this.currentBinding !== null) {
116
- return;
117
- }
118
- if (this.initialization !== null) {
119
- await this.initialization;
120
- return;
121
- }
122
-
123
- const projectRoot = this.options.projectRoot;
124
- if (projectRoot === undefined) {
125
- throw new Error("repo_local workspace router requires projectRoot");
126
- }
127
-
128
- this.initialization = (async () => {
129
- const resolved = await resolveWorkspaceRequest(this.options.git, { cwd: projectRoot });
130
- const initialWorkspace = "code" in resolved
131
- ? {
132
- repoId: stableWorkspaceId("repo", projectRoot),
133
- worktreeId: stableWorkspaceId("worktree", projectRoot),
134
- worktreeRoot: projectRoot,
135
- gitCommonDir: projectRoot,
136
- }
137
- : {
138
- repoId: resolved.repoId,
139
- worktreeId: stableWorkspaceId("worktree", projectRoot),
140
- worktreeRoot: projectRoot,
141
- gitCommonDir: resolved.gitCommonDir,
142
- };
143
- const currentBinding = await this.createBoundWorkspace(
144
- initialWorkspace,
145
- this.options.graftDir,
146
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
147
- undefined,
148
- this.currentSlice,
149
- );
150
- const currentRepoState = currentBinding.slice.repoState;
151
- if (currentRepoState === null) {
152
- throw new WorkspaceBindingRequiredError("workspace");
153
- }
154
- await currentRepoState.initialize();
155
- await this.options.persistedLocalHistory.noteBinding({
156
- current: this.buildPersistedLocalHistoryContext(currentBinding, currentRepoState.getState()),
157
- currentGraph: await this.buildPersistedLocalHistoryGraphContext(currentBinding),
158
- });
159
- this.currentBinding = currentBinding;
160
- })();
161
-
162
- await this.initialization;
163
- }
164
-
165
- get mode(): WorkspaceMode {
166
- return this.options.mode;
167
- }
168
-
169
- get governor(): GovernorTracker {
170
- return this.currentSlice.governor;
171
- }
172
-
173
- get cache(): ObservationCache {
174
- return this.currentSlice.cache;
175
- }
176
-
177
- get metrics(): Metrics {
178
- return this.currentSlice.metrics;
179
- }
180
-
181
- get graftDir(): string {
182
- return this.currentSlice.graftDir;
183
- }
184
-
185
- isBound(): boolean {
186
- return this.currentBinding !== null;
187
- }
188
-
189
- getProjectRoot(): string {
190
- return this.requireBinding().worktreeRoot;
191
- }
192
-
193
- getGraftignorePatterns(): readonly string[] {
194
- return this.requireBinding().graftignorePatterns;
195
- }
196
-
197
- getPathResolver(): (input: string) => string {
198
- return this.requireBinding().resolvePath;
199
- }
200
-
201
- getWarp(): Promise<WarpContext> {
202
- return this.requireBinding().getWarp();
203
- }
204
-
205
- async observeRepoState(): Promise<void> {
206
- const binding = this.requireBinding();
207
- const repoState = this.requireRepoState();
208
- const previousObservation = repoState.getState();
209
- const nextObservation = await repoState.observe();
210
- const checkoutBoundaryHookEvent = previousObservation.checkoutEpoch !== nextObservation.checkoutEpoch
211
- ? await this.resolveCheckoutBoundaryHookEvent(binding, previousObservation.observedAt, nextObservation)
212
- : null;
213
- const previousContext = this.buildPersistedLocalHistoryContext(binding, previousObservation);
214
- const nextContext = this.buildPersistedLocalHistoryContext(
215
- binding,
216
- nextObservation,
217
- checkoutBoundaryHookEvent,
218
- );
219
- if (previousContext.checkoutEpochId !== nextContext.checkoutEpochId) {
220
- await this.options.persistedLocalHistory.noteCheckoutBoundary({
221
- previous: previousContext,
222
- current: nextContext,
223
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
224
- });
225
- }
226
- }
227
-
228
- getRepoState() {
229
- return this.requireRepoState().getState();
230
- }
231
-
232
- getStatus(): WorkspaceStatus {
233
- if (this.currentBinding === null) {
234
- return unboundWorkspaceStatus(this.options.mode);
235
- }
236
- return boundWorkspaceStatus(this.options.mode, this.currentBinding);
237
- }
238
-
239
- async getPersistedLocalHistorySummary(): Promise<PersistedLocalHistorySummary> {
240
- const binding = this.currentBinding;
241
- if (binding?.slice.repoState === null || binding === null) {
242
- return {
243
- availability: "none",
244
- persistence: "persisted_local_history",
245
- historyPath: null,
246
- totalContinuityRecords: 0,
247
- active: false,
248
- lastOperation: null,
249
- lastObservedAt: null,
250
- continuityKey: null,
251
- causalSessionId: null,
252
- strandId: null,
253
- checkoutEpochId: null,
254
- continuedFromCausalSessionId: null,
255
- continuityConfidence: "unknown",
256
- continuityEvidence: [],
257
- attribution: {
258
- actor: {
259
- actorId: "unknown",
260
- actorKind: "unknown",
261
- displayName: "Unknown",
262
- source: "persisted_local_history.fallback",
263
- authorityScope: "inferred",
264
- },
265
- confidence: "unknown",
266
- basis: "unknown_fallback",
267
- evidence: [],
268
- },
269
- latestReadEvent: null,
270
- latestStageEvent: null,
271
- latestTransitionEvent: null,
272
- preserves: [
273
- "continuity_operations",
274
- "read_events",
275
- "stage_events",
276
- "transition_events",
277
- "runtime_context_ids",
278
- "workspace_overlay_snapshots",
279
- ],
280
- excludes: [
281
- "raw_chat_transcripts",
282
- "queue_bookkeeping",
283
- "canonical_provenance",
284
- "canonical_structural_truth",
285
- ],
286
- nextAction: "bind_workspace_to_begin_local_history",
287
- };
288
- }
289
- const status = this.getStatus();
290
- const repoState = binding.slice.repoState.getState();
291
- const causalContext = this.buildCausalContext(binding, repoState);
292
- const graph = await this.buildPersistedLocalHistoryGraphContext(binding);
293
- let summary = await this.options.persistedLocalHistory.summarize(status, causalContext, graph);
294
-
295
- if (repoState.semanticTransition !== null) {
296
- await this.options.persistedLocalHistory.noteSemanticTransitionObservation({
297
- current: this.buildPersistedLocalHistoryContext(binding, repoState),
298
- semanticTransition: repoState.semanticTransition,
299
- transition: repoState.lastTransition,
300
- attribution: summary.attribution,
301
- graph,
302
- });
303
- summary = await this.options.persistedLocalHistory.summarize(status, causalContext, graph);
304
- }
305
-
306
- const stagedTarget = buildRuntimeStagedTarget(status, causalContext, repoState, summary.attribution);
307
-
308
- if (stagedTarget.availability === "full_file") {
309
- await this.options.persistedLocalHistory.noteStageObservation({
310
- current: this.buildPersistedLocalHistoryContext(binding, repoState),
311
- stagedTarget,
312
- attribution: summary.attribution,
313
- graph,
314
- });
315
- return this.options.persistedLocalHistory.summarize(status, causalContext, graph);
316
- }
317
-
318
- return summary;
319
- }
320
-
321
- async getRepoConcurrencySummary(): Promise<RepoConcurrencySummary | null> {
322
- const binding = this.currentBinding;
323
- if (binding?.slice.repoState === null || binding === null) {
324
- return null;
325
- }
326
- return this.options.persistedLocalHistory.summarizeRepoConcurrency(
327
- this.getStatus(),
328
- await this.buildPersistedLocalHistoryGraphContext(binding),
329
- );
330
- }
331
-
332
- async getPersistedLocalActivityWindow(limit: number): Promise<PersistedLocalActivityWindow> {
333
- const binding = this.currentBinding;
334
- if (binding?.slice.repoState === null || binding === null) {
335
- return {
336
- historyPath: null,
337
- limit,
338
- totalMatchingItems: 0,
339
- truncated: false,
340
- items: [],
341
- };
342
- }
343
-
344
- await this.getPersistedLocalHistorySummary();
345
-
346
- const status = this.getStatus();
347
- const repoState = binding.slice.repoState.getState();
348
- const causalContext = this.buildCausalContext(binding, repoState);
349
- const graph = await this.buildPersistedLocalHistoryGraphContext(binding);
350
- return this.options.persistedLocalHistory.listRecentActivity(
351
- status,
352
- causalContext,
353
- limit,
354
- graph,
355
- );
356
- }
357
-
358
- getWorkspaceOverlayFooting(): Promise<RuntimeWorkspaceOverlayFooting | null> {
359
- const binding = this.currentBinding;
360
- if (binding?.slice.repoState === null || binding === null) {
361
- return Promise.resolve(null);
362
- }
363
- return buildRuntimeWorkspaceOverlayFooting(
364
- this.options.fs,
365
- this.options.git,
366
- binding.worktreeRoot,
367
- binding.gitCommonDir,
368
- binding.slice.repoState.getState(),
369
- );
370
- }
371
-
372
- async noteReadObservation(
373
- toolName: AttributedReadToolName,
374
- args: JsonObject,
375
- result: JsonObject,
376
- execution?: WorkspaceExecutionContext | null,
377
- ): Promise<void> {
378
- const active = execution ?? this.captureCurrentExecutionContext();
379
- if (active === null) {
380
- return;
381
- }
382
-
383
- const readObservation = buildWorkspaceReadObservation(active, toolName, args, result);
384
- if (readObservation === null) {
385
- return;
386
- }
387
-
388
- const summary = await this.options.persistedLocalHistory.summarize(
389
- active.status,
390
- active.getCausalContext(),
391
- await this.buildPersistedLocalHistoryGraphContextFromExecution(active),
392
- );
393
-
394
- await this.options.persistedLocalHistory.noteReadObservation({
395
- current: this.buildPersistedLocalHistoryContextFromExecution(active, active.repoState.getState()),
396
- attribution: summary.attribution,
397
- graph: await this.buildPersistedLocalHistoryGraphContextFromExecution(active),
398
- ...readObservation,
399
- });
400
- }
401
-
402
- captureExecutionContext(): WorkspaceExecutionContext {
403
- const binding = this.requireBinding();
404
- const repoState = binding.slice.repoState;
405
- if (repoState === null) {
406
- throw new WorkspaceBindingRequiredError("workspace");
407
- }
408
- return {
409
- sliceId: binding.slice.sliceId,
410
- repoId: binding.repoId,
411
- worktreeId: binding.worktreeId,
412
- projectRoot: binding.worktreeRoot,
413
- worktreeRoot: binding.worktreeRoot,
414
- gitCommonDir: binding.gitCommonDir,
415
- graftignorePatterns: binding.graftignorePatterns,
416
- resolvePath: binding.resolvePath,
417
- capabilityProfile: binding.capabilityProfile,
418
- warpWriterId: binding.warpWriterId,
419
- getCausalContext: () => this.buildCausalContext(binding, repoState.getState()),
420
- status: boundWorkspaceStatus(this.options.mode, binding),
421
- governor: binding.slice.governor,
422
- cache: binding.slice.cache,
423
- metrics: binding.slice.metrics,
424
- graftDir: binding.slice.graftDir,
425
- repoState,
426
- getWarp: binding.getWarp,
427
- };
428
- }
429
-
430
- async bind(request: WorkspaceBindRequest, actionName: string): Promise<WorkspaceActionResult> {
431
- return this.bindInternal("bind", request, actionName);
432
- }
433
-
434
- async rebind(request: WorkspaceBindRequest, actionName: string): Promise<WorkspaceActionResult> {
435
- if (this.currentBinding === null) {
436
- return {
437
- ok: false,
438
- action: "rebind",
439
- freshSessionSlice: false,
440
- ...this.getStatus(),
441
- errorCode: "UNBOUND_SESSION",
442
- error: "workspace_rebind requires an active workspace binding.",
443
- };
444
- }
445
- return this.bindInternal("rebind", request, actionName);
446
- }
447
-
448
- async declareAttach(
449
- declaration: PersistedLocalHistoryAttachDeclaration,
450
- ): Promise<CausalAttachResult> {
451
- const binding = this.currentBinding;
452
- if (binding?.slice.repoState === null || binding === null) {
453
- return {
454
- ok: false,
455
- action: "attach",
456
- ...this.getStatus(),
457
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
458
- errorCode: "UNBOUND_SESSION",
459
- error: "causal_attach requires an active workspace binding.",
460
- };
461
- }
462
-
463
- try {
464
- await this.options.persistedLocalHistory.declareAttach({
465
- current: this.buildPersistedLocalHistoryContext(binding, binding.slice.repoState.getState()),
466
- declaration,
467
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
468
- });
469
- } catch (error) {
470
- if (error instanceof PersistedLocalHistoryAttachUnavailableError) {
471
- const sharedAttachSource = this.options.sharedAttachPolicy?.resolveSharedAttachSource({
472
- sessionId: this.options.transportSessionId,
473
- repoId: binding.repoId,
474
- worktreeId: binding.worktreeId,
475
- }) ?? null;
476
- if (sharedAttachSource !== null) {
477
- await this.options.persistedLocalHistory.declareSharedAttach({
478
- current: this.buildPersistedLocalHistoryContext(binding, binding.slice.repoState.getState()),
479
- declaration,
480
- source: sharedAttachSource,
481
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
482
- });
483
- return {
484
- ok: true,
485
- action: "attach",
486
- ...this.getStatus(),
487
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
488
- };
489
- }
490
- return {
491
- ok: false,
492
- action: "attach",
493
- ...this.getStatus(),
494
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
495
- errorCode: error.code,
496
- error: error.message,
497
- };
498
- }
499
- throw error;
500
- }
501
-
502
- return {
503
- ok: true,
504
- action: "attach",
505
- ...this.getStatus(),
506
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
507
- };
508
- }
509
-
510
- private async bindInternal(
511
- action: WorkspaceBindAction,
512
- request: WorkspaceBindRequest,
513
- actionName: string,
514
- ): Promise<WorkspaceActionResult> {
515
- const resolved = await resolveWorkspaceRequest(this.options.git, request);
516
- if ("code" in resolved) {
517
- return {
518
- ok: false,
519
- action,
520
- freshSessionSlice: false,
521
- ...this.getStatus(),
522
- errorCode: resolved.code,
523
- error: resolved.message,
524
- };
525
- }
526
-
527
- const sliceDir = nextBindingSliceDir(this.options.graftDir, ++this.bindingCounter);
528
- await this.options.fs.mkdir(sliceDir, { recursive: true });
529
-
530
- const capabilityProfile = this.options.mode === "repo_local"
531
- ? DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE
532
- : (await this.options.authorizationPolicy?.getCapabilityProfile(resolved)) ?? null;
533
- if (capabilityProfile === null) {
534
- return {
535
- ok: false,
536
- action,
537
- freshSessionSlice: false,
538
- ...this.getStatus(),
539
- errorCode: "WORKSPACE_NOT_AUTHORIZED",
540
- error: `Workspace ${resolved.worktreeRoot} is not authorized for daemon binding. Call workspace_authorize first.`,
541
- };
542
- }
543
-
544
- const nextBinding = await this.createBoundWorkspace(resolved, sliceDir, capabilityProfile, actionName);
545
- const nextRepoState = nextBinding.slice.repoState;
546
- if (nextRepoState === null) {
547
- throw new WorkspaceBindingRequiredError("workspace");
548
- }
549
- await nextRepoState.initialize();
550
- const previousBinding = this.currentBinding;
551
- const previousRepoState = previousBinding?.slice.repoState;
552
- await this.options.persistedLocalHistory.noteBinding({
553
- current: this.buildPersistedLocalHistoryContext(nextBinding, nextRepoState.getState()),
554
- previous: previousBinding === null || previousRepoState == null
555
- ? null
556
- : this.buildPersistedLocalHistoryContext(previousBinding, previousRepoState.getState()),
557
- currentGraph: await this.buildPersistedLocalHistoryGraphContext(nextBinding),
558
- previousGraph: previousBinding === null
559
- ? null
560
- : await this.buildPersistedLocalHistoryGraphContext(previousBinding),
561
- });
562
- if (this.options.mode === "daemon") {
563
- await this.options.authorizationPolicy?.noteBound(resolved);
564
- }
565
- this.currentBinding = nextBinding;
566
- this.currentSlice = nextBinding.slice;
567
-
568
- return {
569
- ok: true,
570
- action,
571
- freshSessionSlice: true,
572
- ...this.getStatus(),
573
- };
574
- }
575
-
576
- private async createBoundWorkspace(
577
- resolved: ResolvedWorkspace,
578
- graftDir: string,
579
- capabilityProfile: WorkspaceCapabilityProfile,
580
- actionName: string | undefined,
581
- sliceOverride?: WorkspaceSlice,
582
- ): Promise<BoundWorkspace> {
583
- const slice = sliceOverride ?? createWorkspaceSlice({
584
- graftDir,
585
- projectRoot: resolved.worktreeRoot,
586
- fs: this.options.fs,
587
- git: this.options.git,
588
- nextSliceId: `slice-${String(++this.sliceIdCounter).padStart(4, "0")}`,
589
- });
590
- return createBoundWorkspace({
591
- resolved,
592
- graftDir,
593
- capabilityProfile,
594
- ...(actionName !== undefined ? { actionName } : {}),
595
- slice,
596
- fs: this.options.fs,
597
- transportSessionId: this.options.transportSessionId,
598
- warpWriterId: this.options.warpWriterId ?? DEFAULT_WARP_WRITER_ID,
599
- warpPool: this.options.warpPool,
600
- });
601
- }
602
-
603
- private requireBinding(): BoundWorkspace {
604
- if (this.currentBinding === null) {
605
- throw new WorkspaceBindingRequiredError("workspace");
606
- }
607
- return this.currentBinding;
608
- }
609
-
610
- private requireRepoState(): RepoStateTracker {
611
- const repoState = this.currentBinding?.slice.repoState;
612
- if (repoState === null || repoState === undefined) {
613
- throw new WorkspaceBindingRequiredError("workspace");
614
- }
615
- return repoState;
616
- }
617
-
618
- private buildCausalContext(
619
- binding: BoundWorkspace,
620
- observation: { readonly checkoutEpoch: number },
621
- ): RuntimeCausalContext {
622
- return buildWorkspaceCausalContext(binding, observation);
623
- }
624
-
625
- private buildPersistedLocalHistoryContext(
626
- binding: BoundWorkspace,
627
- observation: RepoObservation,
628
- hookEvent: import("./runtime-workspace-overlay.js").GitTransitionHookEvent | null = null,
629
- ): PersistedLocalHistoryContext {
630
- return buildPersistedLocalHistoryContext({
631
- persistedLocalHistory: this.options.persistedLocalHistory,
632
- mode: this.options.mode,
633
- binding,
634
- observation,
635
- hookEvent,
636
- });
637
- }
638
-
639
- private buildPersistedLocalHistoryContextFromExecution(
640
- execution: WorkspaceExecutionContext,
641
- observation: RepoObservation,
642
- ): PersistedLocalHistoryContext {
643
- return buildPersistedLocalHistoryContextFromExecution({
644
- persistedLocalHistory: this.options.persistedLocalHistory,
645
- execution,
646
- observation,
647
- });
648
- }
649
-
650
- private async resolveCheckoutBoundaryHookEvent(
651
- binding: BoundWorkspace,
652
- previousObservedAt: string,
653
- observation: RepoObservation,
654
- ): Promise<import("./runtime-workspace-overlay.js").GitTransitionHookEvent | null> {
655
- return resolveCheckoutBoundaryHookEvent({
656
- fs: this.options.fs,
657
- git: this.options.git,
658
- binding,
659
- previousObservedAt,
660
- observation,
661
- });
662
- }
663
-
664
- private captureCurrentExecutionContext(): WorkspaceExecutionContext | null {
665
- if (this.currentBinding === null) {
666
- return null;
667
- }
668
- return this.captureExecutionContext();
669
- }
670
-
671
- private async buildPersistedLocalHistoryGraphContext(
672
- binding: BoundWorkspace,
673
- ): Promise<PersistedLocalHistoryGraphContext | null> {
674
- if (this.options.persistedLocalHistoryGraph === false) {
675
- return null;
676
- }
677
- return buildPersistedLocalHistoryGraphContext(binding.worktreeRoot, binding.getWarp);
678
- }
679
-
680
- private async buildPersistedLocalHistoryGraphContextFromExecution(
681
- execution: WorkspaceExecutionContext,
682
- ): Promise<PersistedLocalHistoryGraphContext | null> {
683
- if (this.options.persistedLocalHistoryGraph === false) {
684
- return null;
685
- }
686
- return buildPersistedLocalHistoryGraphContext(execution.worktreeRoot, execution.getWarp);
687
- }
688
- }