@firstpick/pi-package-webui 0.11.1 → 0.11.3

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 (310) hide show
  1. package/DEVELOPMENT.md +151 -12
  2. package/README.md +34 -6
  3. package/TECHNICAL.md +75 -8
  4. package/bin/pi-webui.mjs +5390 -11423
  5. package/index.ts +10 -3
  6. package/lib/component-update-state.mjs +2 -2
  7. package/lib/git-workflow-preference-values.mjs +122 -0
  8. package/lib/git-workflow-preferences.mjs +35 -563
  9. package/lib/package-updates.mjs +260 -0
  10. package/lib/rpc-supervisor-client.mjs +8 -4
  11. package/lib/server/app-runners.mjs +1667 -0
  12. package/lib/server/codex-fast-mode.mjs +161 -0
  13. package/lib/server/conversation-mode.mjs +218 -0
  14. package/lib/server/conversation-voice.mjs +318 -0
  15. package/lib/server/extension-ui-requests.mjs +114 -0
  16. package/lib/server/git-generation.mjs +459 -0
  17. package/lib/server/git-mutations.mjs +1827 -0
  18. package/lib/server/git-reads.mjs +608 -0
  19. package/lib/server/git-worktree-sessions.mjs +408 -0
  20. package/lib/server/helper-requests.mjs +82 -0
  21. package/lib/server/no-project-workspaces.mjs +103 -0
  22. package/lib/server/rpc-transports.mjs +394 -0
  23. package/lib/server/settings-store.mjs +544 -0
  24. package/lib/server/sse-delivery.mjs +138 -0
  25. package/lib/server/workspace-files.mjs +563 -0
  26. package/lib/update/supervisor.mjs +4 -0
  27. package/lib/webui-workspaces.mjs +2 -0
  28. package/package.json +4 -4
  29. package/public/activity-agents-controller.mjs +269 -0
  30. package/public/activity-events-controller.mjs +236 -0
  31. package/public/activity-intercom-controller.mjs +627 -0
  32. package/public/activity-queue-controller.mjs +534 -0
  33. package/public/activity-todo-view.mjs +89 -0
  34. package/public/activity-usage-controller.mjs +589 -0
  35. package/public/app.js +3761 -3886
  36. package/public/conversation-overview.css +84 -0
  37. package/public/conversation-overview.mjs +193 -0
  38. package/public/draft-conversations.mjs +135 -0
  39. package/public/focused-composer-controls.css +111 -0
  40. package/public/focused-composer-controls.mjs +143 -0
  41. package/public/focused-composer-disclosure.mjs +223 -0
  42. package/public/focused-shell-adapter.css +264 -0
  43. package/public/focused-shell-adapter.mjs +257 -0
  44. package/public/index.html +137 -80
  45. package/public/model-catalog-order.mjs +63 -0
  46. package/public/platform-event-stream.mjs +64 -0
  47. package/public/project-artifact-controller.mjs +218 -0
  48. package/public/project-file-viewer-controller.mjs +383 -0
  49. package/public/project-git-tools-controller.mjs +181 -0
  50. package/public/project-runners-controller.mjs +220 -0
  51. package/public/service-worker.js +52 -1
  52. package/public/session-attention-scheduler.mjs +182 -0
  53. package/public/session-composer-store.mjs +56 -0
  54. package/public/session-context.mjs +51 -0
  55. package/public/session-extension-requests.mjs +63 -0
  56. package/public/session-shelf-state.mjs +151 -0
  57. package/public/session-shelves.css +171 -0
  58. package/public/session-shelves.mjs +95 -0
  59. package/public/settings-navigation-controller.mjs +249 -0
  60. package/public/settings-navigation.css +61 -0
  61. package/public/settings-resource-controller.mjs +232 -0
  62. package/public/settings-workspace.css +19 -0
  63. package/public/settings-workspace.mjs +175 -0
  64. package/public/shell-actions.mjs +87 -0
  65. package/public/shell-attention-inbox.css +72 -0
  66. package/public/shell-attention-inbox.mjs +198 -0
  67. package/public/shell-context-actions.css +61 -0
  68. package/public/shell-context-actions.mjs +168 -0
  69. package/public/shell-inspector-resize.mjs +124 -0
  70. package/public/shell-navigation-resize.mjs +107 -0
  71. package/public/shell-navigation.mjs +127 -0
  72. package/public/shell-preferences.mjs +108 -0
  73. package/public/shell-surfaces.mjs +99 -0
  74. package/public/shell-tools-launcher.css +97 -0
  75. package/public/shell-tools-launcher.mjs +222 -0
  76. package/public/shell-view-host.mjs +115 -0
  77. package/public/shell-workspace.css +266 -0
  78. package/public/shell-workspace.mjs +402 -0
  79. package/public/sidebar-update-menu.css +190 -0
  80. package/public/sidebar-update-menu.mjs +512 -0
  81. package/public/styles.css +322 -169
  82. package/public/subagent-launch-slot-state.mjs +2 -2
  83. package/public/themed-selects.css +156 -0
  84. package/public/workspace-choices.mjs +104 -0
  85. package/tests/activity-agents-controller.test.mjs +652 -0
  86. package/tests/activity-events-controller.test.mjs +511 -0
  87. package/tests/app-runner-terminal-static.test.mjs +3 -3
  88. package/tests/append-system-http.test.mjs +7 -6
  89. package/tests/append-system-selector-static.test.mjs +6 -6
  90. package/tests/aur-review-widget-static.test.mjs +11 -3
  91. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  92. package/tests/browser/action-feedback-gutter.spec.mjs +251 -0
  93. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  94. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  95. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  96. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  97. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  98. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  99. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  100. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  101. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  102. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  103. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  104. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  105. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  106. package/tests/browser/control-visibility.spec.mjs +5 -0
  107. package/tests/browser/controls-layout.spec.mjs +21 -2
  108. package/tests/browser/conversation-overview.spec.mjs +251 -0
  109. package/tests/browser/draft-conversations.spec.mjs +276 -0
  110. package/tests/browser/empty-startup-fixture.mjs +135 -0
  111. package/tests/browser/empty-startup.spec.mjs +282 -0
  112. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  113. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  114. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  115. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  116. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  117. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  118. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  119. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  120. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  121. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  122. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  123. package/tests/browser/inspector-header.spec.mjs +221 -0
  124. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  125. package/tests/browser/inspector-resize.spec.mjs +227 -0
  126. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  127. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  128. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  129. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  130. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  131. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  132. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  133. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  134. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  135. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  136. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  137. package/tests/browser/more-row-menus.spec.mjs +258 -0
  138. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  139. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  140. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  141. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  142. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  143. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  144. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  145. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  146. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  147. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  148. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  149. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  150. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  151. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  152. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  153. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  154. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  155. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  156. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  157. package/tests/browser/session-fixture.mjs +118 -0
  158. package/tests/browser/session-ownership.spec.mjs +175 -0
  159. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  160. package/tests/browser/session-shelves.spec.mjs +340 -0
  161. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  162. package/tests/browser/session-summary.spec.mjs +17 -12
  163. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  164. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  165. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  166. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  167. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  168. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  169. package/tests/browser/shell-ownership.spec.mjs +398 -0
  170. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  171. package/tests/browser/shell-rollout.spec.mjs +357 -0
  172. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  173. package/tests/browser/shell-workspace.spec.mjs +433 -0
  174. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  175. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  176. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  177. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  178. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  179. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  180. package/tests/browser/themed-selects.spec.mjs +297 -0
  181. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  182. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  183. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  184. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  185. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  186. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  187. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  188. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  189. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  190. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  191. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  192. package/tests/codex-fast-mode-static.test.mjs +16 -11
  193. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  194. package/tests/codex-usage-source.test.mjs +4 -3
  195. package/tests/component-update-api-static.test.mjs +2 -2
  196. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  197. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  198. package/tests/control-visibility-static.test.mjs +3 -3
  199. package/tests/controls-layout-static.test.mjs +5 -5
  200. package/tests/conversation-overview-adapter.test.mjs +100 -0
  201. package/tests/document-artifact-static.test.mjs +2 -1
  202. package/tests/draft-conversations.test.mjs +205 -0
  203. package/tests/empty-startup-launcher.test.mjs +197 -0
  204. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  205. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  206. package/tests/fast-mode-client-static.test.mjs +1 -1
  207. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  208. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  209. package/tests/file-viewer-image-static.test.mjs +15 -11
  210. package/tests/file-viewer-search-static.test.mjs +5 -5
  211. package/tests/fixtures/fake-pi.mjs +41 -9
  212. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  213. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  214. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  215. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  216. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  217. package/tests/git-workflow-dispatch.test.mjs +66 -0
  218. package/tests/git-workflow-preferences.test.mjs +9 -1
  219. package/tests/guided-git-activation-static.test.mjs +14 -11
  220. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  221. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  222. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  223. package/tests/http-endpoints-harness.test.mjs +21 -9
  224. package/tests/interaction-state-stability-static.test.mjs +4 -3
  225. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  226. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  227. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  228. package/tests/main-output-loading-static.test.mjs +4 -4
  229. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  230. package/tests/mobile-compact-layout.test.mjs +2 -2
  231. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  232. package/tests/mobile-foundation-static.test.mjs +10 -7
  233. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  234. package/tests/mobile-static.test.mjs +173 -135
  235. package/tests/model-catalog-order.test.mjs +103 -0
  236. package/tests/native-parity.test.mjs +6 -4
  237. package/tests/native-session-choice-owner.test.mjs +102 -0
  238. package/tests/native-update-lifecycle.test.mjs +10 -5
  239. package/tests/no-project-http-harness.test.mjs +328 -0
  240. package/tests/no-project-navigation.test.mjs +54 -0
  241. package/tests/no-project-workspaces.test.mjs +77 -0
  242. package/tests/open-issue-wizard-static.test.mjs +1 -1
  243. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  244. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  245. package/tests/package-updates.test.mjs +630 -0
  246. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  247. package/tests/platform-event-stream.test.mjs +253 -0
  248. package/tests/project-file-viewer-controller.test.mjs +652 -0
  249. package/tests/project-git-tools-adapter.test.mjs +103 -0
  250. package/tests/project-git-tools-controller.test.mjs +577 -0
  251. package/tests/project-runners-controller.test.mjs +453 -0
  252. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  253. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  254. package/tests/questionnaire-dialog.test.mjs +6 -6
  255. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  256. package/tests/rpc-supervisor-host.test.mjs +4 -1
  257. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  258. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  259. package/tests/server-app-runners.test.mjs +536 -0
  260. package/tests/server-codex-fast-mode.test.mjs +346 -0
  261. package/tests/server-conversation-mode.test.mjs +386 -0
  262. package/tests/server-conversation-voice.test.mjs +426 -0
  263. package/tests/server-extension-ui-requests.test.mjs +357 -0
  264. package/tests/server-git-generation.test.mjs +558 -0
  265. package/tests/server-git-mutations.test.mjs +729 -0
  266. package/tests/server-git-reads.test.mjs +381 -0
  267. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  268. package/tests/server-helper-requests.test.mjs +364 -0
  269. package/tests/server-rpc-transports.test.mjs +553 -0
  270. package/tests/server-settings-store.test.mjs +132 -0
  271. package/tests/server-shell-rollout.test.mjs +478 -0
  272. package/tests/server-sse-delivery.test.mjs +410 -0
  273. package/tests/server-workspace-files.test.mjs +546 -0
  274. package/tests/session-attention-scheduler.test.mjs +514 -0
  275. package/tests/session-composer-store.test.mjs +153 -0
  276. package/tests/session-context.test.mjs +134 -0
  277. package/tests/session-extension-requests.test.mjs +193 -0
  278. package/tests/session-ownership-adapter.test.mjs +130 -0
  279. package/tests/session-sampling-ui-static.test.mjs +10 -4
  280. package/tests/session-send-lifetime.test.mjs +140 -0
  281. package/tests/session-shelf-state.test.mjs +348 -0
  282. package/tests/session-shelves-adapter.test.mjs +79 -0
  283. package/tests/session-summary-lifetime.test.mjs +54 -0
  284. package/tests/settings-resource-controller.test.mjs +548 -0
  285. package/tests/shell-action-adapter.test.mjs +169 -0
  286. package/tests/shell-actions.test.mjs +182 -0
  287. package/tests/shell-navigation.test.mjs +348 -0
  288. package/tests/shell-preferences.test.mjs +367 -0
  289. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  290. package/tests/stream-output-isolation-static.test.mjs +1 -1
  291. package/tests/subagent-gate-visibility.test.mjs +1 -1
  292. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  293. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  294. package/tests/subagent-observability-static.test.mjs +2 -2
  295. package/tests/subagent-reliability-integration.test.mjs +13 -30
  296. package/tests/syntax-highlighting-static.test.mjs +3 -3
  297. package/tests/tab-close-continuity-static.test.mjs +1 -1
  298. package/tests/tab-metadata-ordering.test.mjs +99 -0
  299. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  300. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  301. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  302. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  303. package/tests/theme-customizer-static.test.mjs +1 -1
  304. package/tests/thread-display-title.test.mjs +44 -0
  305. package/tests/update-api-harness.test.mjs +15 -14
  306. package/tests/update-tab-restore-harness.test.mjs +3 -0
  307. package/tests/webui-settings-locking.test.mjs +2 -2
  308. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  309. package/tests/workspace-choices.test.mjs +114 -0
  310. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,502 @@
1
+ import assert from "node:assert/strict";
2
+ import { execFile } from "node:child_process";
3
+ import { existsSync } from "node:fs";
4
+ import { mkdir, mkdtemp, readFile, readdir, realpath, rm, symlink, writeFile } from "node:fs/promises";
5
+ import { tmpdir } from "node:os";
6
+ import path from "node:path";
7
+ import { test } from "node:test";
8
+ import { promisify } from "node:util";
9
+ import { SessionManager } from "@earendil-works/pi-coding-agent";
10
+ import { createGitWorktreeSessionService } from "../lib/server/git-worktree-sessions.mjs";
11
+ import { createGitWorktree, listGitWorktrees, pathInside } from "../lib/git-worktrees.mjs";
12
+
13
+ const execute = promisify(execFile);
14
+ const approvedHash = "a".repeat(64);
15
+
16
+ async function git(cwd, args, options = {}) {
17
+ return execute("git", args, { cwd, timeout: 10_000, maxBuffer: 8 * 1024 * 1024, ...options });
18
+ }
19
+
20
+ function httpError(statusCode, message) {
21
+ return Object.assign(new Error(message), { statusCode });
22
+ }
23
+
24
+ async function fixture(t, overrides = {}) {
25
+ const root = await realpath(await mkdtemp(path.join(tmpdir(), "webui-worktree-sessions-")));
26
+ t.after(() => rm(root, { recursive: true, force: true }));
27
+ const repo = path.join(root, "repo");
28
+ const sessions = path.join(root, "sessions");
29
+ await mkdir(repo);
30
+ await mkdir(sessions);
31
+ await git(repo, ["init", "--initial-branch=main"]);
32
+ for (const [key, value] of Object.entries({
33
+ "user.name": "Worktree tests",
34
+ "user.email": "worktree@example.invalid",
35
+ "commit.gpgsign": "false",
36
+ "core.hooksPath": path.join(root, "no-hooks"),
37
+ "core.autocrlf": "false",
38
+ })) await git(repo, ["config", key, value]);
39
+ await writeFile(path.join(repo, "tracked.txt"), "initial\n");
40
+ await git(repo, ["add", "."]);
41
+ await git(repo, ["commit", "-m", "Initial"]);
42
+
43
+ const source = { id: "source", title: "Source", cwd: repo };
44
+ const tabs = new Map([[source.id, source]]);
45
+ const events = [];
46
+ const creates = [];
47
+ const metadata = [];
48
+ const allowed = [];
49
+ const commands = [];
50
+ const busy = [];
51
+ const boundaryCalls = [];
52
+ let serial = 0;
53
+ const gitMutations = {
54
+ cleanGitBranchName: (branch) => String(branch || "").trim(),
55
+ validateGitBranchName: async (...args) => { boundaryCalls.push(["validateGitBranchName", ...args]); },
56
+ expectedStagedContentHashFromBody: (body) => body.expectedStagedContentHash || "",
57
+ readStagedContentHash: async () => ({ stagedDiff: Buffer.alloc(0), hasStagedChanges: false, stagedContentHash: null }),
58
+ gitWorkflowMessageCwd: (root) => root,
59
+ commitMessagePaths: (root) => ({
60
+ shortPath: path.join(root, "dev", "COMMIT", "staged-commit-short.txt"),
61
+ longPath: path.join(root, "dev", "COMMIT", "staged-commit-long.txt"),
62
+ }),
63
+ requestedRemoteRef: (body) => Object.hasOwn(body, "remoteRef") ? body.remoteRef : null,
64
+ verifyRemoteGitBranchIntent: async (...args) => {
65
+ boundaryCalls.push(["verifyRemoteGitBranchIntent", ...args]);
66
+ return { root: repo, branch: args[1], remoteRef: args[2] };
67
+ },
68
+ runGitWorkflowCommand: async (args, options) => {
69
+ commands.push({ args, options, patch: await readFile(args.at(-1)) });
70
+ const result = await git(options.cwd, args);
71
+ return { ...result, exitCode: 0 };
72
+ },
73
+ requireConfirmed: (body, label) => {
74
+ boundaryCalls.push(["requireConfirmed", body, label]);
75
+ if (body.confirmed !== true) throw httpError(409, "Confirmation required");
76
+ },
77
+ readGitOperationSnapshot: async () => ({ root: repo, branch: "main", operation: "merge", summary: { staged: 1, unstaged: 2 }, conflicts: [{ path: "tracked.txt", status: "UU", preview: "private preview" }] }),
78
+ ...overrides.gitMutations,
79
+ };
80
+ const dependencies = {
81
+ noSession: false,
82
+ getGitRoot: async (cwd) => (await git(cwd, ["rev-parse", "--show-toplevel"])).stdout.trim(),
83
+ gitMutations,
84
+ formatGitCommand: (args) => `git ${args.join(" ")}`,
85
+ makeHttpError: httpError,
86
+ sanitizeError: (error) => error.message,
87
+ configuredSessionDir: () => sessions,
88
+ currentSessionState: async (tab) => tab.lastState || {},
89
+ tabRestorableSessionFile: (tab) => tab.sessionFile,
90
+ requireAllowedSessionPath: (file) => {
91
+ allowed.push(file);
92
+ if (!pathInside(sessions, file)) throw httpError(403, "Session path denied");
93
+ },
94
+ getOpenTabs: () => tabs.values(),
95
+ createTab: async (request) => {
96
+ creates.push(request);
97
+ const tab = { id: `created-${++serial}`, title: request.title || "Worktree", ...request, rpc: { send: async () => ({ success: true }) } };
98
+ tabs.set(tab.id, tab);
99
+ return tab;
100
+ },
101
+ tabMeta: ({ rpc, ...tab }) => tab,
102
+ listTabs: () => [...tabs.values()].map(({ id }) => ({ id })),
103
+ scheduleSupervisorMetadataUpdate: (tab) => metadata.push(tab),
104
+ recordEvent: (event) => events.push(event),
105
+ markTabWorking: (tab) => busy.push(["working", tab.id]),
106
+ markTabIdle: (tab) => busy.push(["idle", tab.id]),
107
+ promptRequestTimeoutMs: 4321,
108
+ ...Object.fromEntries(Object.entries(overrides).filter(([key]) => key !== "gitMutations")),
109
+ };
110
+ const service = createGitWorktreeSessionService(dependencies);
111
+ return { root, repo, sessions, source, tabs, events, creates, metadata, allowed, commands, busy, boundaryCalls, gitMutations, dependencies, service };
112
+ }
113
+
114
+ async function stagedSnapshot(repo) {
115
+ const { stdout } = await git(repo, ["diff", "--cached", "--binary", "--full-index"], { encoding: "buffer" });
116
+ return { stagedDiff: stdout, hasStagedChanges: stdout.length > 0, stagedContentHash: stdout.length ? approvedHash : null };
117
+ }
118
+
119
+ async function persistedSource(f) {
120
+ const manager = SessionManager.create(f.repo, f.sessions);
121
+ manager.appendMessage({ role: "user", content: "Preserve this conversation", timestamp: Date.now() });
122
+ f.source.sessionFile = manager.getSessionFile();
123
+ return f.source.sessionFile;
124
+ }
125
+
126
+ async function sessionEntries(file) {
127
+ return (await readFile(file, "utf8")).trimEnd().split("\n").map((line) => JSON.parse(line));
128
+ }
129
+
130
+ test("exports only the six G3 entrypoints and creates an empty persisted session rooted at the worktree", async (t) => {
131
+ const f = await fixture(t);
132
+ assert.deepEqual(Object.keys(f.service).sort(), ["createGitWorkflowBranchWorktree", "createGitWorktreeTab", "openExistingGitWorktreeTab", "removeGitWorktreeForTab", "openGitConflictResolutionAgentTab", "pruneGitWorktreesData"].sort());
133
+ const result = await f.service.createGitWorktreeTab(f.source, { branch: "feature/empty", sessionMode: "new", title: "Feature" });
134
+ assert.equal(result.created, true);
135
+ assert.equal(result.openedTab, true);
136
+ assert.equal(result.session.mode, "empty");
137
+ const entries = await sessionEntries(result.session.sessionFile);
138
+ assert.equal(entries.length, 1);
139
+ assert.equal(entries[0].type, "session");
140
+ assert.equal(entries[0].cwd, result.worktree.path);
141
+ assert.equal(f.creates[0].titleSource, "explicit");
142
+ assert.equal(f.creates[0].sessionFile, result.session.sessionFile);
143
+ assert.equal(f.tabs.get(result.tab.id).gitWorkspace.commonGitDir, result.commonGitDir);
144
+ assert.match(result.dependencyHint, /node_modules/);
145
+ assert.deepEqual(f.events.map(({ type }) => type), ["webui_worktree_opened", "webui_worktree_created"]);
146
+ assert.equal(f.events[0].sessionMode, "empty");
147
+ });
148
+
149
+ test("fork-current copies persisted conversation into a new session and keeps the source untouched", async (t) => {
150
+ const f = await fixture(t);
151
+ const sourceFile = await persistedSource(f);
152
+ const before = await readFile(sourceFile);
153
+ const result = await f.service.createGitWorktreeTab(f.source, { branchName: "forked" });
154
+ assert.equal(result.session.mode, "fork-current");
155
+ assert.equal(result.session.parentSession, sourceFile);
156
+ assert.notEqual(result.session.sessionFile, sourceFile);
157
+ assert.deepEqual(f.allowed, [sourceFile]);
158
+ const entries = await sessionEntries(result.session.sessionFile);
159
+ assert.equal(entries[0].cwd, result.worktree.path);
160
+ assert.equal(entries[0].parentSession, sourceFile);
161
+ assert.ok(entries.some(({ message }) => message?.content === "Preserve this conversation"));
162
+ assert.deepEqual(await readFile(sourceFile), before);
163
+ });
164
+
165
+ test("fork uses last state after RPC state failure, then the restorable session fallback", async (t) => {
166
+ const f = await fixture(t, { currentSessionState: async () => { throw new Error("RPC gone"); } });
167
+ const sourceFile = await persistedSource(f);
168
+ f.source.lastState = { sessionFile: sourceFile };
169
+ const first = await f.service.createGitWorktreeTab(f.source, { branch: "last-state", sessionMode: "fork" });
170
+ assert.equal(first.session.parentSession, sourceFile);
171
+ delete f.source.lastState;
172
+ const second = await f.service.createGitWorktreeTab(f.source, { branch: "restorable" });
173
+ assert.equal(second.session.parentSession, sourceFile);
174
+ });
175
+
176
+ test("unpersisted or missing source sessions open an empty header with a warning", async (t) => {
177
+ const f = await fixture(t);
178
+ for (const branch of ["unpersisted", "missing-file"]) {
179
+ if (branch === "missing-file") f.source.sessionFile = path.join(f.sessions, "missing.jsonl");
180
+ const result = await f.service.createGitWorktreeTab(f.source, { branch });
181
+ assert.equal(result.session.mode, "empty");
182
+ assert.equal(result.session.requestedMode, "fork-current");
183
+ assert.match(result.session.warning, /not persisted/);
184
+ assert.equal((await sessionEntries(result.session.sessionFile)).length, 1);
185
+ }
186
+ });
187
+
188
+ test("no-session bypasses mode validation and creates no session file", async (t) => {
189
+ const f = await fixture(t, { noSession: true, configuredSessionDir: () => { throw new Error("Must not access sessions"); } });
190
+ const result = await f.service.createGitWorktreeTab(f.source, { branch: "ephemeral", sessionMode: "unsupported" });
191
+ assert.deepEqual(result.session, { mode: "none", requestedMode: "none", sessionFile: undefined, warning: "Web UI was started with --no-session." });
192
+ assert.equal(f.creates[0].sessionFile, undefined);
193
+ assert.deepEqual(await readdir(f.sessions), []);
194
+ });
195
+
196
+ test("opening current or existing tabs mutates their real metadata without creating sessions", async (t) => {
197
+ const f = await fixture(t);
198
+ const current = await f.service.openExistingGitWorktreeTab(f.source, { path: f.repo });
199
+ assert.equal(current.openedCurrent, true);
200
+ assert.equal(current.openedTab, false);
201
+ assert.equal(f.source.gitWorkspace.isMainWorktree, true);
202
+ const created = await f.service.createGitWorktreeTab(f.source, { branch: "reused", sessionMode: "empty" });
203
+ const sessionBefore = await readFile(created.session.sessionFile);
204
+ const reused = await f.service.openExistingGitWorktreeTab(f.source, { worktreePath: created.worktree.path, sessionMode: "unsupported" });
205
+ assert.equal(reused.openedExistingTab, true);
206
+ assert.equal(reused.tab.id, created.tab.id);
207
+ assert.deepEqual(f.metadata, [f.source, f.tabs.get(created.tab.id)]);
208
+ assert.equal(f.creates.length, 1);
209
+ assert.deepEqual(await readFile(created.session.sessionFile), sessionBefore);
210
+ const unopened = await f.service.createGitWorktreeTab(f.source, { branch: "without-tab", openTab: false, sessionMode: "unsupported" });
211
+ assert.equal(unopened.openedTab, false);
212
+ assert.equal(unopened.tab, null);
213
+ assert.equal(unopened.session, null);
214
+ assert.equal(f.creates.length, 1);
215
+ });
216
+
217
+ test("invalid session modes clean up only new worktrees and retain their branches", async (t) => {
218
+ const f = await fixture(t);
219
+ for (const sessionMode of ["clone-current", "parent-only", "garbage"]) {
220
+ const branch = `invalid-${sessionMode}`;
221
+ await assert.rejects(f.service.createGitWorktreeTab(f.source, { branch, sessionMode }), { statusCode: 400 });
222
+ assert.ok(!(await listGitWorktrees(f.repo)).worktrees.some((item) => item.branch === branch));
223
+ await git(f.repo, ["show-ref", "--verify", `refs/heads/${branch}`]);
224
+ assert.equal(f.events.at(-1).cleanup.removed, true);
225
+ }
226
+ assert.equal(f.creates.length, 0);
227
+ });
228
+
229
+ test("session path denial removes a new worktree but preserves a reused worktree", async (t) => {
230
+ const f = await fixture(t);
231
+ const reused = await createGitWorktree(f.repo, { branch: "existing" });
232
+ f.source.sessionFile = path.join(f.root, "denied.jsonl");
233
+ await assert.rejects(f.service.createGitWorktreeTab(f.source, { branch: "new-denied" }), { statusCode: 403 });
234
+ assert.equal(f.events.at(-1).cleanup.removed, true);
235
+ await assert.rejects(f.service.createGitWorktreeTab(f.source, { branch: "existing" }), { statusCode: 403 });
236
+ assert.equal(f.events.at(-1).cleanup, null);
237
+ assert.ok(existsSync(reused.worktree.path));
238
+ });
239
+
240
+ test("tab admission failure keeps newly persisted session files and removes the new worktree", async (t) => {
241
+ const f = await fixture(t, { createTab: async () => { throw new Error("Tab limit reached"); } });
242
+ await assert.rejects(f.service.createGitWorktreeTab(f.source, { branch: "admission", sessionMode: "empty" }), /Tab limit reached/);
243
+ assert.equal(f.events.at(-1).cleanup.removed, true);
244
+ const sessionFiles = await readdir(f.sessions);
245
+ assert.equal(sessionFiles.length, 1);
246
+ assert.equal((await sessionEntries(path.join(f.sessions, sessionFiles[0]))).length, 1);
247
+ await git(f.repo, ["show-ref", "--verify", "refs/heads/admission"]);
248
+ });
249
+
250
+ test("guided workflow copies raw staged binary bytes and root message files while preserving source state", async (t) => {
251
+ const f = await fixture(t);
252
+ const binary = Buffer.from([0, 255, 254, 128, 1, 10, 0, 200]);
253
+ await writeFile(path.join(f.repo, "binary.dat"), binary);
254
+ await git(f.repo, ["add", "binary.dat"]);
255
+ await mkdir(path.join(f.repo, "nested"));
256
+ f.source.cwd = path.join(f.repo, "nested");
257
+ await mkdir(path.join(f.repo, "dev", "COMMIT"), { recursive: true });
258
+ const short = "feat: preserve binary\n";
259
+ const long = "Copy binary content without decoding.\n";
260
+ await writeFile(f.gitMutations.commitMessagePaths(f.repo).shortPath, short);
261
+ await writeFile(f.gitMutations.commitMessagePaths(f.repo).longPath, long);
262
+ const snapshot = await stagedSnapshot(f.repo);
263
+ f.gitMutations.readStagedContentHash = async () => snapshot;
264
+ const service = createGitWorktreeSessionService(f.dependencies);
265
+ const result = await service.createGitWorkflowBranchWorktree(f.source, { branch: "binary-workflow", expectedStagedContentHash: approvedHash, sessionMode: "empty" });
266
+ assert.equal(result.carriedStagedChanges, true);
267
+ assert.equal(result.exitCode, 0);
268
+ assert.equal(result.stderr, "");
269
+ assert.match(result.command, /^git worktree add -b binary-workflow /);
270
+ assert.match(result.stdout, /source checkout was left/);
271
+ assert.deepEqual(await readFile(path.join(result.worktree.path, "binary.dat")), binary);
272
+ assert.deepEqual((await git(result.worktree.path, ["show", ":binary.dat"], { encoding: "buffer" })).stdout, binary);
273
+ assert.deepEqual((await git(f.repo, ["diff", "--cached", "--binary", "--full-index"], { encoding: "buffer" })).stdout, snapshot.stagedDiff);
274
+ assert.equal((await git(f.repo, ["branch", "--show-current"])).stdout.trim(), "main");
275
+ assert.deepEqual(result.copiedMessageFiles, ["dev/COMMIT/staged-commit-short.txt", "dev/COMMIT/staged-commit-long.txt"]);
276
+ assert.equal(await readFile(path.join(result.worktree.path, result.copiedMessageFiles[0]), "utf8"), short);
277
+ assert.equal(await readFile(path.join(result.worktree.path, result.copiedMessageFiles[1]), "utf8"), long);
278
+ assert.deepEqual(f.commands[0].patch, snapshot.stagedDiff);
279
+ assert.equal(existsSync(f.commands[0].args.at(-1)), false);
280
+ assert.equal(f.commands[0].options.timeoutMs, 5 * 60 * 1000);
281
+ assert.deepEqual(f.events.map(({ type }) => type), ["webui_worktree_opened", "webui_worktree_created", "webui_git_workflow_worktree"]);
282
+ });
283
+
284
+ test("each guided snapshot rejects approval drift or a now-clean index before creating a branch", async (t) => {
285
+ const f = await fixture(t);
286
+ let snapshot = { stagedDiff: Buffer.from("changed"), hasStagedChanges: true, stagedContentHash: "b".repeat(64) };
287
+ f.gitMutations.readStagedContentHash = async () => snapshot;
288
+ const service = createGitWorktreeSessionService(f.dependencies);
289
+ for (const branch of ["drifted", "now-clean"]) {
290
+ if (branch === "now-clean") snapshot = { stagedDiff: Buffer.alloc(0), hasStagedChanges: false, stagedContentHash: null };
291
+ await assert.rejects(service.createGitWorkflowBranchWorktree(f.source, { branch, expectedStagedContentHash: approvedHash }), { statusCode: 409 });
292
+ assert.equal((await git(f.repo, ["branch", "--list", branch])).stdout, "");
293
+ }
294
+ assert.equal(f.events.length, 0);
295
+ assert.equal(f.creates.length, 0);
296
+ });
297
+
298
+ test("legacy guided requests accept a clean index and reused worktrees receive no staged or message transfer", async (t) => {
299
+ const f = await fixture(t);
300
+ const created = await f.service.createGitWorkflowBranchWorktree(f.source, { branch: "clean", openTab: false });
301
+ assert.equal(created.carriedStagedChanges, false);
302
+ assert.match(created.stdout, /index was clean/);
303
+ const existing = await createGitWorktree(f.repo, { branch: "reuse-workflow" });
304
+ await writeFile(path.join(existing.worktree.path, "preserved.txt"), "Keep existing changes");
305
+ await mkdir(path.join(f.repo, "dev", "COMMIT"), { recursive: true });
306
+ await writeFile(f.gitMutations.commitMessagePaths(f.repo).shortPath, "Should not transfer");
307
+ f.gitMutations.readStagedContentHash = async () => ({ stagedDiff: Buffer.from("not a real patch"), hasStagedChanges: true, stagedContentHash: approvedHash });
308
+ const result = await createGitWorktreeSessionService(f.dependencies).createGitWorkflowBranchWorktree(f.source, { branch: "reuse-workflow", openTab: false });
309
+ assert.equal(result.created, false);
310
+ assert.equal(result.carriedStagedChanges, false);
311
+ assert.deepEqual(result.copiedMessageFiles, []);
312
+ assert.equal(f.commands.length, 0);
313
+ assert.match(result.stdout, /reused/);
314
+ assert.equal(await readFile(path.join(existing.worktree.path, "preserved.txt"), "utf8"), "Keep existing changes");
315
+ assert.equal(existsSync(path.join(existing.worktree.path, "dev", "COMMIT")), false);
316
+ });
317
+
318
+ test("failed, timed-out, cancelled, and errored applies clean temporary patches and only new worktrees", async (t) => {
319
+ const f = await fixture(t);
320
+ const patchPaths = [];
321
+ f.gitMutations.readStagedContentHash = async () => ({ stagedDiff: Buffer.from([0, 255]), hasStagedChanges: true, stagedContentHash: approvedHash });
322
+ const failures = [
323
+ { exitCode: 1, stderr: "Apply failed" },
324
+ { exitCode: 0, timedOut: true, stderr: "Apply failed" },
325
+ { exitCode: 0, cancelled: true, stdout: "Apply failed" },
326
+ { exitCode: 0, error: "Apply failed" },
327
+ ];
328
+ for (const [index, failure] of failures.entries()) {
329
+ f.gitMutations.runGitWorkflowCommand = async (args) => {
330
+ patchPaths.push(args.at(-1));
331
+ assert.deepEqual(await readFile(args.at(-1)), Buffer.from([0, 255]));
332
+ return failure;
333
+ };
334
+ const branch = `apply-failure-${index}`;
335
+ const service = createGitWorktreeSessionService(f.dependencies);
336
+ await assert.rejects(service.createGitWorkflowBranchWorktree(f.source, { branch }), /Apply failed/);
337
+ assert.equal(existsSync(patchPaths.at(-1)), false);
338
+ assert.equal(f.events.at(-1).cleanup.removed, true);
339
+ assert.equal(f.events.at(-1).type, "webui_git_workflow_worktree_failed");
340
+ await git(f.repo, ["show-ref", "--verify", `refs/heads/${branch}`]);
341
+ }
342
+ assert.equal(f.creates.length, 0);
343
+ });
344
+
345
+ test("a thrown apply error cleans its patch and cleanup failure does not replace the original error", async (t) => {
346
+ const f = await fixture(t);
347
+ let patchPath;
348
+ const original = new Error("Command slot busy");
349
+ f.gitMutations.readStagedContentHash = async () => ({ stagedDiff: Buffer.from("patch"), hasStagedChanges: true, stagedContentHash: approvedHash });
350
+ f.gitMutations.runGitWorkflowCommand = async (args, { cwd }) => {
351
+ patchPath = args.at(-1);
352
+ await git(f.repo, ["worktree", "lock", cwd]);
353
+ throw original;
354
+ };
355
+ await assert.rejects(createGitWorktreeSessionService(f.dependencies).createGitWorkflowBranchWorktree(f.source, { branch: "locked-cleanup" }), (error) => error === original);
356
+ assert.equal(existsSync(patchPath), false);
357
+ const event = f.events.at(-1);
358
+ assert.equal(event.error, original.message);
359
+ assert.equal(event.cleanup.ok, false);
360
+ assert.equal(event.cleanup.code, "GIT_COMMAND_FAILED");
361
+ assert.ok((await listGitWorktrees(f.repo)).worktrees.some(({ branch }) => branch === "locked-cleanup"));
362
+ });
363
+
364
+ test("message transfer refuses paths outside the worktree and leaves the source message intact", async (t) => {
365
+ const f = await fixture(t);
366
+ const outside = path.join(f.root, "outside-message.txt");
367
+ await writeFile(outside, "Do not overwrite");
368
+ f.gitMutations.commitMessagePaths = () => ({ shortPath: outside, longPath: path.join(f.root, "missing.txt") });
369
+ await assert.rejects(createGitWorktreeSessionService(f.dependencies).createGitWorkflowBranchWorktree(f.source, { branch: "escape", openTab: false }), /outside the worktree/);
370
+ assert.equal(f.events.at(-1).cleanup.removed, true);
371
+ assert.equal(await readFile(outside, "utf8"), "Do not overwrite");
372
+ });
373
+
374
+ test("remote worktree creation retains exact remote tracking intent and fails stale refs without network access", async (t) => {
375
+ const f = await fixture(t);
376
+ await git(f.repo, ["remote", "add", "team/origin", path.join(f.root, "no-network.git")]);
377
+ await git(f.repo, ["update-ref", "refs/remotes/team/origin/feature/remote", "HEAD"]);
378
+ const result = await f.service.createGitWorktreeTab(f.source, { branchName: "feature/remote", remoteRef: "team/origin/feature/remote", openTab: false });
379
+ assert.equal(result.created, true);
380
+ assert.deepEqual(f.boundaryCalls[0], ["verifyRemoteGitBranchIntent", f.repo, "feature/remote", "team/origin/feature/remote"]);
381
+ assert.equal((await git(f.repo, ["config", "branch.feature/remote.remote"])).stdout.trim(), "team/origin");
382
+ assert.equal((await git(f.repo, ["config", "branch.feature/remote.merge"])).stdout.trim(), "refs/heads/feature/remote");
383
+ await assert.rejects(f.service.createGitWorktreeTab(f.source, { branch: "stale", remoteRef: "team/origin/stale", openTab: false }), /Unknown remote git branch/);
384
+ assert.equal(f.events.at(-1).cleanup, null);
385
+ });
386
+
387
+ test("removal requires confirmation and refuses occupied worktrees or descendants even with force and relative paths", async (t) => {
388
+ const f = await fixture(t);
389
+ const created = await createGitWorktree(f.repo, { branch: "busy" });
390
+ await mkdir(path.join(created.worktree.path, "nested"));
391
+ const occupant = { id: "occupant", cwd: created.worktree.path };
392
+ f.tabs.set(occupant.id, occupant);
393
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { path: created.worktree.path }), { statusCode: 409 });
394
+ for (const cwd of [created.worktree.path, path.join(created.worktree.path, "nested")]) {
395
+ occupant.cwd = cwd;
396
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { path: path.relative(f.repo, created.worktree.path), confirmed: true, force: true }), (error) => error.code === "WORKTREE_BUSY" && error.details.tabIds[0] === occupant.id);
397
+ assert.ok(existsSync(created.worktree.path));
398
+ }
399
+ f.tabs.delete(occupant.id);
400
+ const result = await f.service.removeGitWorktreeForTab(f.source, { worktreePath: created.worktree.path, confirmed: true });
401
+ assert.equal(result.removed, true);
402
+ assert.deepEqual(result.tabs, [{ id: f.source.id }]);
403
+ assert.equal(f.events.at(-1).type, "webui_worktree_removed");
404
+ });
405
+
406
+ test("removal recognizes symlink aliases in both request paths and live descendant tabs", async (t) => {
407
+ const f = await fixture(t);
408
+ const created = await createGitWorktree(f.repo, { branch: "alias-busy" });
409
+ await mkdir(path.join(created.worktree.path, "nested"));
410
+ const alias = path.join(f.root, "alias");
411
+ try {
412
+ await symlink(created.worktree.path, alias, "dir");
413
+ } catch (error) {
414
+ if (["EPERM", "EACCES", "ENOSYS"].includes(error.code)) return t.skip(`Directory symlinks unavailable: ${error.code}`);
415
+ throw error;
416
+ }
417
+ f.tabs.set("alias-tab", { id: "alias-tab", cwd: path.join(alias, "nested") });
418
+ for (const requestedPath of [alias, created.worktree.path]) {
419
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { path: requestedPath, confirmed: true, force: true }), { code: "WORKTREE_BUSY" });
420
+ }
421
+ });
422
+
423
+ test("removal retains lower-level dirty and main-worktree guards and supports forced dirty removal", async (t) => {
424
+ const f = await fixture(t);
425
+ const created = await createGitWorktree(f.repo, { branch: "dirty" });
426
+ await writeFile(path.join(created.worktree.path, "untracked.txt"), "dirty");
427
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { path: created.worktree.path, confirmed: true }), { code: "DIRTY_WORKTREE" });
428
+ const removed = await f.service.removeGitWorktreeForTab(f.source, { path: created.worktree.path, confirmed: true, force: true });
429
+ assert.equal(removed.removed, true);
430
+ f.tabs.clear();
431
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { path: f.repo, confirmed: true, force: true }), { code: "IS_MAIN_WORKTREE" });
432
+ await assert.rejects(f.service.openExistingGitWorktreeTab(f.source), { statusCode: 400 });
433
+ await assert.rejects(f.service.removeGitWorktreeForTab(f.source, { confirmed: true }), { statusCode: 400 });
434
+ });
435
+
436
+ test("prune defaults to a read-only preview and requires confirmation before mutating stale records", async (t) => {
437
+ const f = await fixture(t);
438
+ const created = await createGitWorktree(f.repo, { branch: "prunable" });
439
+ await rm(created.worktree.path, { recursive: true, force: true });
440
+ const preview = await f.service.pruneGitWorktreesData(f.repo);
441
+ assert.equal(preview.dryRun, true);
442
+ assert.equal(f.boundaryCalls.length, 0);
443
+ assert.ok((await listGitWorktrees(f.repo)).worktrees.some(({ branch }) => branch === "prunable"));
444
+ await assert.rejects(f.service.pruneGitWorktreesData(f.repo, {}, { dryRun: false }), { statusCode: 409 });
445
+ const result = await f.service.pruneGitWorktreesData(f.repo, { confirmed: true }, { dryRun: false });
446
+ assert.equal(result.dryRun, false);
447
+ assert.ok(!result.worktrees.some(({ branch }) => branch === "prunable"));
448
+ assert.equal(f.boundaryCalls.at(-1)[2], "Pruning stale worktree records");
449
+ });
450
+
451
+ test("conflict agent receives the bounded prompt and preserves tab, event, and operation response metadata", async (t) => {
452
+ const f = await fixture(t);
453
+ let request;
454
+ const create = f.dependencies.createTab;
455
+ f.dependencies.createTab = async (options) => {
456
+ const tab = await create(options);
457
+ tab.rpc.send = async (command, timeout) => { request = { command, timeout }; return { success: true }; };
458
+ return tab;
459
+ };
460
+ const result = await createGitWorktreeSessionService(f.dependencies).openGitConflictResolutionAgentTab(f.source);
461
+ assert.equal(f.creates[0].conversationStarted, true);
462
+ assert.equal(f.creates[0].title, "Resolve merge conflicts");
463
+ assert.equal(f.creates[0].cwd, f.repo);
464
+ assert.equal(request.timeout, 4321);
465
+ assert.equal(request.command.type, "prompt");
466
+ assert.match(request.command.message, /Do not continue, skip, abort, commit, reset, or push the merge/);
467
+ assert.match(request.command.message, /UU "tracked.txt"/);
468
+ assert.deepEqual(f.busy, [["working", result.tab.id]]);
469
+ assert.equal(result.sourceTabId, f.source.id);
470
+ assert.deepEqual(result.operation.conflicts, [{ path: "tracked.txt", status: "UU" }]);
471
+ assert.equal(f.events[0].type, "webui_git_conflict_agent_started");
472
+ assert.equal(f.events[0].conflicts, 1);
473
+ });
474
+
475
+ test("conflict handoff rejects absent, bisect, and already resolved operations before tab creation", async (t) => {
476
+ const f = await fixture(t);
477
+ for (const operation of [{ operation: null }, { operation: "bisect", conflicts: [{}] }, { operation: "merge", conflicts: [] }]) {
478
+ f.gitMutations.readGitOperationSnapshot = async () => operation;
479
+ await assert.rejects(createGitWorktreeSessionService(f.dependencies).openGitConflictResolutionAgentTab(f.source), { statusCode: 409 });
480
+ }
481
+ assert.equal(f.creates.length, 0);
482
+ assert.equal(f.busy.length, 0);
483
+ });
484
+
485
+ test("conflict RPC transport and rejection failures retain their tabs and mark them idle", async (t) => {
486
+ const f = await fixture(t);
487
+ const create = f.dependencies.createTab;
488
+ const transportError = new Error("RPC disconnected");
489
+ for (const failure of [transportError, { success: false, error: "Handoff refused" }, { success: false }]) {
490
+ f.dependencies.createTab = async (options) => {
491
+ const tab = await create(options);
492
+ tab.rpc.send = async () => { if (failure instanceof Error) throw failure; return failure; };
493
+ return tab;
494
+ };
495
+ await assert.rejects(createGitWorktreeSessionService(f.dependencies).openGitConflictResolutionAgentTab(f.source), (error) => failure instanceof Error ? error === failure : error.statusCode === 502 && error.message === (failure.error || "The conflict-resolution agent rejected the handoff prompt"));
496
+ const id = f.busy.at(-1)[1];
497
+ assert.ok(f.tabs.has(id));
498
+ assert.deepEqual(f.busy.slice(-2), [["working", id], ["idle", id]]);
499
+ }
500
+ assert.equal(f.tabs.size, 4);
501
+ assert.equal(f.events.length, 0);
502
+ });