@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,558 @@
1
+ import assert from "node:assert/strict";
2
+ import { mkdir, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
3
+ import os from "node:os";
4
+ import path from "node:path";
5
+ import { setTimeout as delay } from "node:timers/promises";
6
+ import test from "node:test";
7
+ import { writeGitWorkflowPreferences } from "../lib/git-workflow-preferences.mjs";
8
+ import { createGitGenerationService } from "../lib/server/git-generation.mjs";
9
+
10
+ const providerFailure = "FIRSTPICK_GUIDED_GIT_PROVIDER_FAILURE: fixture provider failed";
11
+ const profile = { provider: "fixture", modelId: "writer", thinkingLevel: "low" };
12
+ const fallbackProfile = { provider: "fixture", modelId: "backup", thinkingLevel: "high" };
13
+ const makeHttpError = (statusCode, message) => Object.assign(new Error(message), { statusCode });
14
+
15
+ async function fixture(t, { fallback = false, overrides = {}, mutations = {}, onPrompt } = {}) {
16
+ const root = await mkdtemp(path.join(os.tmpdir(), "webui-git-generation-"));
17
+ const settingsFile = path.join(root, "settings.json");
18
+ const previousSettingsFile = process.env.PI_WEBUI_SETTINGS_FILE;
19
+ process.env.PI_WEBUI_SETTINGS_FILE = settingsFile;
20
+ t.after(async () => {
21
+ if (previousSettingsFile === undefined) delete process.env.PI_WEBUI_SETTINGS_FILE;
22
+ else process.env.PI_WEBUI_SETTINGS_FILE = previousSettingsFile;
23
+ await rm(root, { recursive: true, force: true });
24
+ });
25
+ await writeGitWorkflowPreferences({
26
+ generation: { ...profile, fallback: fallback ? fallbackProfile : {} },
27
+ commit: { language: "en", scope: "auto" },
28
+ }, settingsFile);
29
+ const paths = {
30
+ shortPath: path.join(root, "dev", "COMMIT", "staged-commit-short.txt"),
31
+ longPath: path.join(root, "dev", "COMMIT", "staged-commit-long.txt"),
32
+ branchPath: path.join(root, "dev", "COMMIT", "staged-branch-name.txt"),
33
+ prPath: path.join(root, "dev", "PR", "topic.md"),
34
+ };
35
+ async function artifact(file, text) {
36
+ await mkdir(path.dirname(file), { recursive: true });
37
+ await writeFile(file, text);
38
+ }
39
+ async function messages(short = "feat: fixture", long = "feat: fixture\n\nFixture details.") {
40
+ await artifact(paths.shortPath, short);
41
+ await artifact(paths.longPath, long);
42
+ }
43
+ async function readArtifact(file) {
44
+ const [text, info] = await Promise.all([readFile(file, "utf8"), stat(file)]);
45
+ return { path: file, text, mtimeMs: info.mtimeMs, ctimeMs: info.ctimeMs, ino: String(info.ino) };
46
+ }
47
+ const calls = { rpc: [], commands: [], staged: [], activity: [], events: [], replay: [] };
48
+ const tab = {
49
+ id: "tab-fixture", title: "Fixture", cwd: root,
50
+ gitWorkflowGeneration: null,
51
+ gitWorkflowMessageGeneration: null,
52
+ gitWorkflowArtifactGeneration: null,
53
+ gitWorkflowFallbackLifecycle: null,
54
+ lastState: { model: { provider: "session", id: "unchanged" }, thinkingLevel: "medium" },
55
+ rpc: {
56
+ isRunning: () => true,
57
+ async send(request) {
58
+ calls.rpc.push(request);
59
+ return onPrompt ? onPrompt(request, { tab, calls, paths, artifact, messages }) : { success: true };
60
+ },
61
+ },
62
+ };
63
+ const deps = {
64
+ getGitRoot: async () => root,
65
+ gitMutations: {
66
+ assertExpectedStagedContentHash: async (...args) => { calls.staged.push(args); },
67
+ gitWorkflowMessageCwd: (gitRoot, cwd) => cwd,
68
+ commitMessagePaths: (cwd) => {
69
+ assert.equal(cwd, root);
70
+ return paths;
71
+ },
72
+ readGitWorkflowBranchName: async () => readArtifact(paths.branchPath),
73
+ readGitWorkflowPrDescription: async () => readArtifact(paths.prPath),
74
+ ...mutations,
75
+ },
76
+ makeHttpError,
77
+ sanitizeError: (error) => error?.message || String(error),
78
+ safeRpcData: async (...args) => {
79
+ calls.commands.push(args);
80
+ return { ok: true, data: { commands: [
81
+ { name: "git-staged-msg:2", source: "extension" },
82
+ { name: "git-branch-name", source: "extension" },
83
+ { name: "pr", source: "extension" },
84
+ ] } };
85
+ },
86
+ currentSessionState: async () => tab.lastState,
87
+ availableGitWorkflowModels: async () => [
88
+ { provider: profile.provider, id: profile.modelId, reasoning: true },
89
+ { provider: fallbackProfile.provider, id: fallbackProfile.modelId, reasoning: true },
90
+ ],
91
+ stateIsBusyForSettings: () => false,
92
+ markTabWorking: () => calls.activity.push("working"),
93
+ markTabIdle: () => calls.activity.push("idle"),
94
+ broadcastTabEvent: (target, event) => { assert.equal(target, tab); calls.events.push(event); },
95
+ sendSseToClient: (client, event) => calls.replay.push({ client, event }),
96
+ statusRpcTimeoutMs: 1234,
97
+ ...overrides,
98
+ };
99
+ return { root, settingsFile, paths, artifact, messages, tab, calls, service: createGitGenerationService(deps) };
100
+ }
101
+
102
+ async function waitFor(predicate) {
103
+ const deadline = Date.now() + 2000;
104
+ while (!predicate()) {
105
+ assert.ok(Date.now() < deadline, "timed out waiting for controlled RPC boundary");
106
+ await delay(5);
107
+ }
108
+ }
109
+
110
+ function decodeProfile(message) {
111
+ return JSON.parse(Buffer.from(message.split("--firstpick-webui-generation-profile=")[1], "base64url").toString("utf8"));
112
+ }
113
+
114
+ test("factory is lazy and exposes only the five generation methods", () => {
115
+ const unexpected = () => assert.fail("factory must not perform work");
116
+ const service = createGitGenerationService({ gitMutations: {}, getGitRoot: unexpected, safeRpcData: unexpected });
117
+ assert.deepEqual(Object.keys(service).sort(), [
118
+ "startGitWorkflowGeneration", "consumeGitWorkflowGenerationEvent", "replayGitWorkflowFallbackLifecycle",
119
+ "cancelGitWorkflowGeneration", "loseGitWorkflowGeneration",
120
+ ].sort());
121
+ assert.equal(service.cancelGitWorkflowGeneration({}), false);
122
+ });
123
+
124
+ test("reservation precedes the first await and cancellation retains ownership until cleanup", async (t) => {
125
+ const gate = Promise.withResolvers();
126
+ const f = await fixture(t, { mutations: { assertExpectedStagedContentHash: () => gate.promise } });
127
+ const previous = { id: "previous" };
128
+ f.tab.gitWorkflowMessageGeneration = previous;
129
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit", expectedStagedContentHash: "approved" });
130
+ const record = f.tab.gitWorkflowGeneration;
131
+ assert.ok(record);
132
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), { statusCode: 409 });
133
+ assert.equal(f.service.cancelGitWorkflowGeneration(f.tab), true);
134
+ assert.equal(f.tab.gitWorkflowGeneration, record);
135
+ gate.resolve();
136
+ await assert.rejects(pending, { code: "GIT_WORKFLOW_CANCELLED" });
137
+ assert.equal(f.tab.gitWorkflowGeneration, null);
138
+ assert.equal(f.tab.gitWorkflowMessageGeneration, previous);
139
+ assert.deepEqual(f.calls.rpc, []);
140
+ });
141
+
142
+ test("staged approval and preflight failures release the reservation before dispatch", async (t) => {
143
+ const f = await fixture(t, { mutations: {
144
+ assertExpectedStagedContentHash: async () => { throw makeHttpError(409, "Staged content changed"); },
145
+ } });
146
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /Staged content changed/);
147
+ assert.equal(f.tab.gitWorkflowGeneration, null);
148
+ assert.deepEqual(f.calls.commands, []);
149
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "unknown" }), { statusCode: 400 });
150
+ assert.equal(f.tab.gitWorkflowGeneration, null);
151
+ });
152
+
153
+ test("native commit dispatch uses extension collision suffix, fresh pair and the configured profile", async (t) => {
154
+ const f = await fixture(t, { onPrompt: async (request, { messages }) => {
155
+ await messages();
156
+ return { success: true };
157
+ } });
158
+ const body = { kind: "commit", expectedStagedContentHash: "approved" };
159
+ const state = structuredClone(f.tab.lastState);
160
+ const result = await f.service.startGitWorkflowGeneration(f.tab, body);
161
+ assert.equal(result.accepted, true);
162
+ assert.equal(result.fallbackUsed, false);
163
+ assert.deepEqual(result.generation, profile);
164
+ assert.match(result.message, /^\/git-staged-msg:2 en auto /);
165
+ assert.deepEqual(decodeProfile(result.message), { version: 1, ...profile });
166
+ assert.deepEqual(f.calls.staged, [[f.tab, body]]);
167
+ assert.deepEqual(f.calls.commands[0], [f.tab, { type: "get_commands" }, 1234]);
168
+ assert.deepEqual(f.calls.rpc.map((request) => request.type), ["prompt"]);
169
+ assert.deepEqual(f.tab.lastState, state);
170
+ assert.equal(f.tab.gitWorkflowGeneration, null);
171
+ assert.equal(f.tab.gitWorkflowArtifactGeneration, f.tab.gitWorkflowMessageGeneration);
172
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.terminal, true);
173
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, true);
174
+ assert.deepEqual(f.calls.activity, ["working", "idle"]);
175
+ });
176
+
177
+ test("prompt templates never substitute for the native extension", async (t) => {
178
+ const f = await fixture(t, { overrides: {
179
+ safeRpcData: async () => ({ ok: true, data: { commands: [{ name: "git-staged-msg", source: "prompt" }] } }),
180
+ } });
181
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /Same-named prompt templates are not used/);
182
+ assert.deepEqual(f.calls.rpc, []);
183
+ assert.equal(f.tab.gitWorkflowGeneration, null);
184
+ });
185
+
186
+ for (const [label, overrides, message] of [
187
+ ["busy session", { stateIsBusyForSettings: () => true }, /current agent run/],
188
+ ["unavailable model", { availableGitWorkflowModels: async () => [] }, /model is unavailable/],
189
+ ["unsupported thinking", { availableGitWorkflowModels: async () => [{ provider: "fixture", id: "writer", reasoning: false }] }, /thinking level low is unavailable/],
190
+ ]) {
191
+ test(`${label} fails without dispatch or fallback`, async (t) => {
192
+ const f = await fixture(t, { fallback: true, overrides });
193
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), message);
194
+ assert.deepEqual(f.calls.rpc, []);
195
+ assert.deepEqual(f.calls.events, []);
196
+ assert.equal(f.tab.gitWorkflowGeneration, null);
197
+ });
198
+ }
199
+
200
+ for (const kind of ["branch", "pr"]) {
201
+ test(`native ${kind} generation requires a changed correlated artifact`, async (t) => {
202
+ const f = await fixture(t, { onPrompt: async (request, { artifact, paths }) => {
203
+ await artifact(kind === "branch" ? paths.branchPath : paths.prPath, "new generated content");
204
+ return { success: true };
205
+ } });
206
+ await f.artifact(kind === "branch" ? f.paths.branchPath : f.paths.prPath, "previous content");
207
+ const result = await f.service.startGitWorkflowGeneration(f.tab, { kind });
208
+ assert.equal(result.kind, kind);
209
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, true);
210
+ assert.equal(f.tab.gitWorkflowMessageGeneration, null);
211
+ assert.deepEqual(f.calls.events, []);
212
+ });
213
+ }
214
+
215
+ for (const mode of ["unchanged", "partial", "empty", "missing"]) {
216
+ test(`commit readiness rejects ${mode} artifacts and restores the previous message record`, async (t) => {
217
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { paths, artifact, messages }) => {
218
+ if (mode === "partial") await artifact(paths.shortPath, "new short");
219
+ if (mode === "empty") await messages(" ", "new long");
220
+ return { success: true };
221
+ } });
222
+ if (mode !== "missing") await f.messages("old short", "old long");
223
+ const previous = { id: "previous" };
224
+ f.tab.gitWorkflowMessageGeneration = previous;
225
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /Waiting for/);
226
+ assert.equal(f.calls.rpc.length, 1);
227
+ assert.equal(f.tab.gitWorkflowGeneration, null);
228
+ assert.equal(f.tab.gitWorkflowMessageGeneration, previous);
229
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.terminal, true);
230
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, false);
231
+ assert.deepEqual(f.calls.events, []);
232
+ });
233
+ }
234
+
235
+ test("marked prompt rejection retries once using fallback and preserves the session model", async (t) => {
236
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { calls, messages }) => {
237
+ if (calls.rpc.length === 1) return { success: false, error: providerFailure };
238
+ await messages();
239
+ return { success: true };
240
+ } });
241
+ const state = structuredClone(f.tab.lastState);
242
+ const result = await f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
243
+ assert.equal(result.fallbackUsed, true);
244
+ assert.deepEqual(result.generation, fallbackProfile);
245
+ assert.deepEqual(result.primaryGeneration, profile);
246
+ assert.deepEqual(f.calls.rpc.map((request) => decodeProfile(request.message)), [
247
+ { version: 1, ...profile }, { version: 1, ...fallbackProfile },
248
+ ]);
249
+ assert.deepEqual(f.tab.lastState, state);
250
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, true);
251
+ assert.equal(f.calls.events.length, 1);
252
+ const client = {};
253
+ f.service.replayGitWorkflowFallbackLifecycle(f.tab, client);
254
+ assert.deepEqual(f.calls.replay, [{ client, event: { ...f.calls.events[0], replayed: true } }]);
255
+ assert.equal(f.calls.events[0].replayed, undefined);
256
+ });
257
+
258
+ test("double provider failure has bounded replay, error correlation and previous-message cleanup", async (t) => {
259
+ const f = await fixture(t, { fallback: true, onPrompt: async () => ({ success: false, error: `${providerFailure}\nprivate fixture details` }) });
260
+ const previous = { id: "previous" };
261
+ f.tab.gitWorkflowMessageGeneration = previous;
262
+ let error;
263
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), (value) => {
264
+ error = value;
265
+ return true;
266
+ });
267
+ assert.equal(f.calls.rpc.length, 2);
268
+ assert.deepEqual(error.gitWorkflowGeneration, {
269
+ generationId: f.tab.gitWorkflowFallbackLifecycle.generationId,
270
+ kind: "commit", fallbackUsed: true, generation: fallbackProfile, primaryGeneration: profile,
271
+ });
272
+ assert.equal(f.tab.gitWorkflowMessageGeneration, previous);
273
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, false);
274
+ assert.equal(f.tab.gitWorkflowGeneration, null);
275
+ assert.deepEqual(f.calls.events.map((event) => event.type), [
276
+ "webui_git_workflow_generation_fallback_started", "webui_git_workflow_generation_fallback_failed",
277
+ ]);
278
+ for (const event of f.calls.events) {
279
+ assert.ok((event.reason || event.error).length <= 240);
280
+ assert.doesNotMatch(event.reason || event.error, /private|\n/);
281
+ }
282
+ f.service.replayGitWorkflowFallbackLifecycle(f.tab, "client");
283
+ assert.equal(f.calls.replay.length, 2);
284
+ assert.ok(f.calls.replay.every(({ event }) => event.replayed));
285
+ assert.equal(f.tab.gitWorkflowFallbackLifecycle.events.length, 2);
286
+ });
287
+
288
+ for (const mode of ["ordinary rejection", "unmarked transport error", "marker text on unmarked transport error"]) {
289
+ test(`${mode} does not authorize fallback`, async (t) => {
290
+ const f = await fixture(t, { fallback: true, onPrompt: async () => {
291
+ if (mode === "ordinary rejection") return { success: false, error: "Command failed" };
292
+ throw new Error(mode === "unmarked transport error" ? "RPC connection failed" : providerFailure);
293
+ } });
294
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }));
295
+ assert.equal(f.calls.rpc.length, 1);
296
+ assert.deepEqual(f.calls.events, []);
297
+ assert.equal(f.tab.gitWorkflowGeneration, null);
298
+ });
299
+ }
300
+
301
+ test("only the matching native command error marks provider fallback eligibility", async (t) => {
302
+ let service;
303
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { tab, calls, messages }) => {
304
+ if (calls.rpc.length === 1) {
305
+ service.consumeGitWorkflowGenerationEvent(tab, { type: "extension_error", event: "command", extensionPath: "command:other", error: providerFailure });
306
+ assert.equal(tab.gitWorkflowGeneration.nativeCommandError, null);
307
+ service.consumeGitWorkflowGenerationEvent(tab, { type: "extension_error", event: "command", extensionPath: "command:git-staged-msg:2", error: providerFailure });
308
+ } else await messages();
309
+ return { success: true };
310
+ } });
311
+ service = f.service;
312
+ assert.equal((await service.startGitWorkflowGeneration(f.tab, { kind: "commit" })).fallbackUsed, true);
313
+ assert.equal(f.calls.rpc.length, 2);
314
+ });
315
+
316
+ test("late native provider error during the 500ms grace triggers fallback", async (t) => {
317
+ const firstResponse = Promise.withResolvers();
318
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { calls, messages }) => {
319
+ if (calls.rpc.length === 1) return firstResponse.promise;
320
+ await messages();
321
+ return { success: true };
322
+ } });
323
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
324
+ await waitFor(() => f.calls.rpc.length === 1);
325
+ firstResponse.resolve({ success: true });
326
+ await delay(40);
327
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, {
328
+ type: "extension_error", event: "command", extensionPath: "command:git-staged-msg:2", error: providerFailure,
329
+ });
330
+ assert.equal((await pending).fallbackUsed, true);
331
+ assert.equal(f.calls.rpc.length, 2);
332
+ });
333
+
334
+ for (const mode of ["cancel", "process loss"]) {
335
+ test(`${mode} during RPC prevents fallback and preserves a replacement reservation`, async (t) => {
336
+ const response = Promise.withResolvers();
337
+ const f = await fixture(t, { fallback: true, onPrompt: () => response.promise });
338
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
339
+ await waitFor(() => f.calls.rpc.length === 1);
340
+ const old = f.tab.gitWorkflowGeneration;
341
+ const artifactGeneration = f.tab.gitWorkflowArtifactGeneration;
342
+ if (mode === "cancel") f.service.cancelGitWorkflowGeneration(f.tab);
343
+ else {
344
+ f.service.loseGitWorkflowGeneration(f.tab);
345
+ assert.equal(old.processLost, true);
346
+ assert.equal(artifactGeneration.terminal, true);
347
+ assert.equal(artifactGeneration.successful, false);
348
+ assert.equal(f.tab.gitWorkflowMessageGeneration, null);
349
+ }
350
+ const replacement = { generationId: "replacement" };
351
+ const message = { id: "replacement-message" };
352
+ f.tab.gitWorkflowGeneration = replacement;
353
+ f.tab.gitWorkflowMessageGeneration = message;
354
+ const activityBefore = [...f.calls.activity];
355
+ response.resolve({ success: false, error: providerFailure });
356
+ await assert.rejects(pending, (error) => {
357
+ assert.match(error.message, /no longer active/);
358
+ assert.equal(error.gitWorkflowGeneration, undefined);
359
+ return true;
360
+ });
361
+ assert.equal(f.tab.gitWorkflowGeneration, replacement);
362
+ assert.equal(f.tab.gitWorkflowMessageGeneration, message);
363
+ assert.deepEqual(f.calls.activity, activityBefore);
364
+ assert.deepEqual(f.calls.events, []);
365
+ assert.equal(f.calls.rpc.length, 1);
366
+ });
367
+ }
368
+
369
+ test("cancellation while artifacts are pending restores the previous message generation", async (t) => {
370
+ const response = Promise.withResolvers();
371
+ const f = await fixture(t, { fallback: true, onPrompt: () => response.promise });
372
+ const previous = { id: "previous" };
373
+ f.tab.gitWorkflowMessageGeneration = previous;
374
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
375
+ await waitFor(() => f.calls.rpc.length === 1);
376
+ f.service.cancelGitWorkflowGeneration(f.tab);
377
+ response.resolve({ success: false, error: providerFailure });
378
+ await assert.rejects(pending, { code: "GIT_WORKFLOW_CANCELLED" });
379
+ assert.equal(f.tab.gitWorkflowGeneration, null);
380
+ assert.equal(f.tab.gitWorkflowMessageGeneration, previous);
381
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, false);
382
+ assert.deepEqual(f.calls.events, []);
383
+ });
384
+
385
+ test("process loss during preflight cannot mutate the next generation", async (t) => {
386
+ const gate = Promise.withResolvers();
387
+ const f = await fixture(t, { mutations: { assertExpectedStagedContentHash: () => gate.promise } });
388
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
389
+ const old = f.tab.gitWorkflowGeneration;
390
+ f.service.loseGitWorkflowGeneration(f.tab);
391
+ const replacement = { generationId: "replacement" };
392
+ f.tab.gitWorkflowGeneration = replacement;
393
+ gate.resolve();
394
+ await assert.rejects(pending, /no longer active/);
395
+ assert.equal(old.processLost, true);
396
+ assert.equal(f.tab.gitWorkflowGeneration, replacement);
397
+ assert.deepEqual(f.calls.activity, []);
398
+ });
399
+
400
+ for (const { finalError, aborted } of [
401
+ { finalError: false, aborted: false },
402
+ { finalError: true, aborted: false },
403
+ { finalError: false, aborted: true },
404
+ ]) {
405
+ test(`settlement consumes only a started attempt, failure=${finalError}, aborted=${aborted}`, async (t) => {
406
+ const f = await fixture(t);
407
+ const previous = { id: "previous" };
408
+ const artifactGeneration = { id: "event-generation", terminal: false, successful: false };
409
+ const record = {
410
+ generationId: artifactGeneration.id, attempt: "primary", promptAccepted: true,
411
+ artifactGeneration, messageGeneration: artifactGeneration, previousMessageGeneration: previous,
412
+ fallback: { ...fallbackProfile }, cancelled: false,
413
+ };
414
+ f.tab.gitWorkflowGeneration = record;
415
+ f.tab.gitWorkflowArtifactGeneration = artifactGeneration;
416
+ f.tab.gitWorkflowMessageGeneration = artifactGeneration;
417
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_settled" });
418
+ assert.equal(f.tab.gitWorkflowGeneration, record);
419
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_start" });
420
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_settled", aborted }, { finalError });
421
+ await waitFor(() => f.tab.gitWorkflowGeneration === null);
422
+ assert.equal(artifactGeneration.terminal, true);
423
+ assert.equal(artifactGeneration.successful, !finalError && !aborted);
424
+ assert.equal(f.tab.gitWorkflowMessageGeneration, finalError || aborted ? previous : artifactGeneration);
425
+ assert.deepEqual(f.calls.events, []);
426
+ assert.deepEqual(f.calls.rpc, []);
427
+ });
428
+ }
429
+
430
+ test("an early settlement is retained until prompt acceptance and abort marks cancellation", async (t) => {
431
+ const response = Promise.withResolvers();
432
+ const f = await fixture(t, { onPrompt: () => response.promise });
433
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
434
+ await waitFor(() => f.calls.rpc.length === 1);
435
+ const record = f.tab.gitWorkflowGeneration;
436
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_start" });
437
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_settled" }, { finalError: true });
438
+ assert.deepEqual(record.pendingSettlement, { attempt: "primary", failed: true, cancelled: false });
439
+ assert.equal(f.tab.gitWorkflowGeneration, record);
440
+ f.service.consumeGitWorkflowGenerationEvent(f.tab, { type: "agent_end", aborted: true });
441
+ assert.equal(record.cancelled, true);
442
+ response.resolve({ success: true });
443
+ await assert.rejects(pending, { code: "GIT_WORKFLOW_CANCELLED" });
444
+ assert.equal(f.tab.gitWorkflowGeneration, null);
445
+ });
446
+
447
+ for (const mode of ["cancel", "process loss"]) {
448
+ test(`${mode} during fallback suppresses terminal fallback reporting and correlation`, async (t) => {
449
+ const response = Promise.withResolvers();
450
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { calls }) => {
451
+ if (calls.rpc.length === 1) return { success: false, error: providerFailure };
452
+ return response.promise;
453
+ } });
454
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
455
+ await waitFor(() => f.calls.rpc.length === 2);
456
+ if (mode === "cancel") f.service.cancelGitWorkflowGeneration(f.tab);
457
+ else f.service.loseGitWorkflowGeneration(f.tab);
458
+ response.resolve({ success: false, error: providerFailure });
459
+ await assert.rejects(pending, (error) => {
460
+ assert.match(error.message, mode === "cancel" ? /cancelled/ : /no longer active/);
461
+ assert.equal(error.gitWorkflowGeneration, undefined);
462
+ return true;
463
+ });
464
+ assert.equal(f.tab.gitWorkflowGeneration, null);
465
+ assert.equal(f.calls.events.length, 1);
466
+ assert.equal(f.calls.events[0].type, "webui_git_workflow_generation_fallback_started");
467
+ });
468
+ }
469
+
470
+ test("ownership is rechecked after asynchronous artifact readiness", async (t) => {
471
+ const readiness = Promise.withResolvers();
472
+ let reads = 0;
473
+ const f = await fixture(t, { mutations: {
474
+ readGitWorkflowBranchName: async () => {
475
+ reads += 1;
476
+ if (reads === 1) return { path: "branch", mtimeMs: 1, ctimeMs: 1, ino: "1" };
477
+ return readiness.promise;
478
+ },
479
+ } });
480
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "branch" });
481
+ await waitFor(() => reads === 2);
482
+ f.service.loseGitWorkflowGeneration(f.tab);
483
+ const replacement = { generationId: "replacement" };
484
+ f.tab.gitWorkflowGeneration = replacement;
485
+ const activity = [...f.calls.activity];
486
+ readiness.resolve({ path: "branch", mtimeMs: 2, ctimeMs: 2, ino: "1" });
487
+ await assert.rejects(pending, /no longer active/);
488
+ assert.equal(f.tab.gitWorkflowGeneration, replacement);
489
+ assert.deepEqual(f.calls.activity, activity);
490
+ });
491
+
492
+ test("ownership is rechecked after the native command error grace", async (t) => {
493
+ const response = Promise.withResolvers();
494
+ const f = await fixture(t, { fallback: true, onPrompt: () => response.promise });
495
+ const pending = f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
496
+ await waitFor(() => f.calls.rpc.length === 1);
497
+ response.resolve({ success: true });
498
+ await delay(40);
499
+ f.service.loseGitWorkflowGeneration(f.tab);
500
+ const replacement = { generationId: "replacement" };
501
+ f.tab.gitWorkflowGeneration = replacement;
502
+ const activity = [...f.calls.activity];
503
+ await assert.rejects(pending, /no longer active/);
504
+ assert.equal(f.tab.gitWorkflowGeneration, replacement);
505
+ assert.deepEqual(f.calls.activity, activity);
506
+ assert.deepEqual(f.calls.events, []);
507
+ });
508
+
509
+ for (const kind of ["branch", "pr"]) {
510
+ test(`unchanged ${kind} artifacts fail readiness without provider fallback`, async (t) => {
511
+ const f = await fixture(t, { fallback: true });
512
+ await f.artifact(kind === "branch" ? f.paths.branchPath : f.paths.prPath, "unchanged");
513
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind }), /did not update its correlated artifact/);
514
+ assert.equal(f.tab.gitWorkflowGeneration, null);
515
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.successful, false);
516
+ assert.equal(f.calls.rpc.length, 1);
517
+ assert.deepEqual(f.calls.events, []);
518
+ });
519
+ }
520
+
521
+ test("unmarked native command error never starts fallback", async (t) => {
522
+ let service;
523
+ const f = await fixture(t, { fallback: true, onPrompt: async (request, { tab }) => {
524
+ service.consumeGitWorkflowGenerationEvent(tab, {
525
+ type: "extension_error", event: "command", extensionPath: "command:git-staged-msg:2", error: "Permission denied writing artifact",
526
+ });
527
+ return { success: true };
528
+ } });
529
+ service = f.service;
530
+ await assert.rejects(service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /Permission denied/);
531
+ assert.equal(f.calls.rpc.length, 1);
532
+ assert.deepEqual(f.calls.events, []);
533
+ });
534
+
535
+ test("a stopped RPC process and incomplete setup fail before prompting", async (t) => {
536
+ const f = await fixture(t);
537
+ f.tab.rpc.isRunning = () => false;
538
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /process is not running/);
539
+ assert.equal(f.tab.gitWorkflowGeneration, null);
540
+ f.tab.rpc.isRunning = () => true;
541
+ await writeGitWorkflowPreferences({ generation: { provider: "", modelId: "" } }, f.settingsFile);
542
+ await assert.rejects(f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" }), /Guided Git Setup/);
543
+ assert.equal(f.tab.gitWorkflowGeneration, null);
544
+ assert.deepEqual(f.calls.rpc, []);
545
+ });
546
+
547
+ test("non-repository commit artifacts use the tab cwd and a new generation replaces replay", async (t) => {
548
+ const f = await fixture(t, { overrides: { getGitRoot: async () => { throw new Error("not a repository"); } }, onPrompt: async (request, { messages }) => {
549
+ await messages();
550
+ return { success: true };
551
+ } });
552
+ f.tab.gitWorkflowFallbackLifecycle = { generationId: "previous", events: [{ type: "old" }] };
553
+ const result = await f.service.startGitWorkflowGeneration(f.tab, { kind: "commit" });
554
+ assert.equal(f.tab.gitWorkflowArtifactGeneration.root, f.root);
555
+ assert.equal(f.tab.gitWorkflowFallbackLifecycle.generationId, result.generationId);
556
+ f.service.replayGitWorkflowFallbackLifecycle(f.tab, "new client");
557
+ assert.deepEqual(f.calls.replay, []);
558
+ });