@bevel-software/platform-core-frontend 0.25.2 → 0.27.0

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 (193) hide show
  1. package/package.json +2 -2
  2. package/src/core/CoreAppShell.tsx +87 -25
  3. package/src/core/ProductName.tsx +49 -0
  4. package/src/core/__tests__/ShellRoutes.test.tsx +22 -0
  5. package/src/core/__tests__/core-contributions.test.ts +16 -0
  6. package/src/core/core-contributions.ts +17 -0
  7. package/src/core/registry.ts +51 -1
  8. package/src/index.css +23 -5
  9. package/src/index.ts +5 -0
  10. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +1 -1
  11. package/src/modules/access/components/ManageAccessDialog.tsx +1 -1
  12. package/src/modules/admin/__tests__/RolesCorruptedBanner.test.tsx +70 -0
  13. package/src/modules/admin/components/RolesCorruptedBanner.tsx +9 -4
  14. package/src/modules/auth/components/LoginScreen.tsx +4 -1
  15. package/src/modules/auth/services/account.api.ts +28 -1
  16. package/src/modules/auth/services/sso.ts +1 -2
  17. package/src/modules/change-requests/__tests__/ChangeRequestDialog.sync-banner.test.tsx +176 -0
  18. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +68 -0
  19. package/src/modules/change-requests/__tests__/ChangeRequestLink.test.tsx +182 -0
  20. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +1 -1
  21. package/src/modules/change-requests/__tests__/readFileOnBranch.test.ts +79 -0
  22. package/src/modules/change-requests/components/ChangeBox.tsx +6 -1
  23. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +45 -15
  24. package/src/modules/change-requests/components/ChangeRequestLink.tsx +151 -0
  25. package/src/modules/change-requests/components/CrFileTree.tsx +2 -1
  26. package/src/modules/change-requests/components/FileChangeBoxes.tsx +4 -2
  27. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +6 -3
  28. package/src/modules/change-requests/services/change-requests.api.ts +15 -2
  29. package/src/modules/change-requests/utils/readFailure.ts +22 -0
  30. package/src/modules/embed/__tests__/EmbedLinkPage.test.tsx +74 -0
  31. package/src/modules/embed/__tests__/EmbedView.test.tsx +473 -0
  32. package/src/modules/embed/__tests__/embed-config.test.ts +128 -0
  33. package/src/modules/embed/__tests__/embed-host.test.ts +111 -0
  34. package/src/modules/embed/__tests__/mcp-app-view.test.ts +295 -0
  35. package/src/modules/embed/__tests__/mount.test.tsx +157 -0
  36. package/src/modules/embed/components/EmbedLinkPage.tsx +109 -0
  37. package/src/modules/embed/components/EmbedView.tsx +545 -0
  38. package/src/modules/embed/embed-config.ts +132 -0
  39. package/src/modules/embed/embed-host.ts +120 -0
  40. package/src/modules/embed/mount.tsx +80 -0
  41. package/src/modules/embed/services/embed-token.ts +22 -0
  42. package/src/modules/embed/services/embed.api.ts +158 -0
  43. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +202 -4
  44. package/src/modules/git/__tests__/GitSyncFailedBanner.test.tsx +59 -1
  45. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +39 -22
  46. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +7 -2
  47. package/src/modules/git/branch-delete-menu-item.tsx +24 -0
  48. package/src/modules/git/components/BranchSwitcher.tsx +29 -5
  49. package/src/modules/git/components/GitSyncFailedBanner.tsx +53 -15
  50. package/src/modules/git/components/HistoryVersionPreview.tsx +5 -3
  51. package/src/modules/git/components/PullNeededBanner.tsx +15 -49
  52. package/src/modules/git/hooks/useAutoPullUpdates.ts +9 -5
  53. package/src/modules/git/index.ts +15 -0
  54. package/src/modules/git/services/__tests__/error-messages.test.ts +67 -0
  55. package/src/modules/git/services/__tests__/pull-failure.test.ts +36 -0
  56. package/src/modules/git/services/error-messages.ts +58 -1
  57. package/src/modules/git/services/pull-failure.ts +68 -0
  58. package/src/modules/git/state/branch-delete-confirm.ts +46 -0
  59. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +1 -0
  60. package/src/modules/layout/__tests__/breakpoints.test.ts +7 -1
  61. package/src/modules/layout/breakpoints.ts +8 -0
  62. package/src/modules/library/__tests__/PluginExtras.test.tsx +9 -9
  63. package/src/modules/library/__tests__/PluginPage.test.tsx +8 -1
  64. package/src/modules/library/__tests__/SkillsTree.test.tsx +13 -4
  65. package/src/modules/library/__tests__/ToolPage.test.tsx +53 -0
  66. package/src/modules/library/components/LibraryPage.tsx +22 -0
  67. package/src/modules/library/components/PluginExtras.tsx +23 -6
  68. package/src/modules/library/components/PluginPage.tsx +6 -1
  69. package/src/modules/library/components/tool-page/ToolPage.tsx +45 -1
  70. package/src/modules/library/routes/LibraryRoutes.tsx +8 -7
  71. package/src/modules/library/services/plugins.api.ts +4 -1
  72. package/src/modules/library/services/tools.api.ts +27 -0
  73. package/src/modules/library/state/plugins-revision.ts +28 -0
  74. package/src/modules/onboarding/__tests__/agent-connection-api.test.ts +55 -0
  75. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +87 -82
  76. package/src/modules/onboarding/__tests__/first-page-prompt.test.ts +109 -0
  77. package/src/modules/onboarding/__tests__/get-started-column.test.tsx +1001 -0
  78. package/src/modules/onboarding/__tests__/invite-dialog.test.tsx +392 -0
  79. package/src/modules/onboarding/__tests__/onboarding.test.tsx +226 -193
  80. package/src/modules/onboarding/__tests__/starter-pack-card.test.tsx +136 -0
  81. package/src/modules/onboarding/components/CreatorWelcomePage.tsx +7 -11
  82. package/src/modules/onboarding/components/EmailChipsInput.tsx +138 -0
  83. package/src/modules/onboarding/components/GetStartedColumn.tsx +651 -0
  84. package/src/modules/onboarding/components/InviteButton.tsx +35 -0
  85. package/src/modules/onboarding/components/InviteDialog.tsx +424 -0
  86. package/src/modules/onboarding/components/RootLanding.tsx +8 -24
  87. package/src/modules/onboarding/components/StarterPackCard.tsx +98 -0
  88. package/src/modules/onboarding/components/WelcomePage.tsx +65 -154
  89. package/src/modules/onboarding/first-page-prompt.ts +89 -0
  90. package/src/modules/onboarding/invite-emails.ts +175 -0
  91. package/src/modules/onboarding/services/agent-connection.api.ts +53 -0
  92. package/src/modules/onboarding/services/starter-packs.api.ts +83 -0
  93. package/src/modules/onboarding/state/agent-connection.ts +167 -0
  94. package/src/modules/onboarding/state/invite-dialog.context.ts +32 -0
  95. package/src/modules/onboarding/state/invite-dialog.tsx +31 -0
  96. package/src/modules/onboarding/state/onboarding.ts +133 -59
  97. package/src/modules/onboarding/state/starter-packs.ts +169 -0
  98. package/src/modules/settings/settings-nav-items.tsx +8 -3
  99. package/src/modules/setup/__tests__/setup.first-run-storage.test.tsx +389 -0
  100. package/src/modules/setup/__tests__/setup.github.test.tsx +5 -5
  101. package/src/modules/setup/__tests__/setup.kept-draft.test.tsx +1 -1
  102. package/src/modules/setup/__tests__/setup.repository-change.test.tsx +1 -1
  103. package/src/modules/setup/__tests__/setup.repository.test.tsx +21 -21
  104. package/src/modules/setup/__tests__/setup.test.tsx +65 -81
  105. package/src/modules/setup/__tests__/useConnectionProbe.test.tsx +123 -0
  106. package/src/modules/setup/components/FirstRunStorage.tsx +560 -0
  107. package/src/modules/setup/components/SetupGate.tsx +46 -1
  108. package/src/modules/setup/components/SetupScreen.tsx +92 -152
  109. package/src/modules/setup/hooks/useConnectionProbe.ts +93 -0
  110. package/src/modules/setup/services/setup.api.ts +3 -3
  111. package/src/modules/setup/utils/suggested-branch.ts +27 -0
  112. package/src/modules/toolbar/commands/__tests__/actions.test.tsx +210 -0
  113. package/src/modules/toolbar/commands/actions.tsx +324 -0
  114. package/src/modules/toolbar/commands/command-menu.ts +44 -0
  115. package/src/modules/toolbar/commands/useCommandActions.ts +69 -0
  116. package/src/modules/toolbar/commands/useCommandShortcuts.ts +121 -0
  117. package/src/modules/toolbar/components/AppSwitcher.tsx +106 -22
  118. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +1 -1
  119. package/src/modules/toolbar/components/ProfileMenu.tsx +9 -4
  120. package/src/modules/toolbar/components/SearchPalette.tsx +540 -0
  121. package/src/modules/toolbar/components/Toolbar.tsx +10 -0
  122. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +187 -54
  123. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +4 -4
  124. package/src/modules/toolbar/components/__tests__/ProfileMenu.test.tsx +64 -0
  125. package/src/modules/toolbar/components/__tests__/SearchPalette.test.tsx +832 -0
  126. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +57 -2
  127. package/src/modules/toolbar/search/__tests__/rank.test.ts +93 -0
  128. package/src/modules/toolbar/search/__tests__/sources.test.ts +131 -0
  129. package/src/modules/toolbar/search/rank.ts +111 -0
  130. package/src/modules/toolbar/search/sources.ts +169 -0
  131. package/src/modules/workflow/hooks/useFileLock.ts +10 -7
  132. package/src/modules/workflow/services/__tests__/lock.api.test.ts +41 -0
  133. package/src/modules/workflow/services/lock.api.ts +17 -2
  134. package/src/modules/workspace/__tests__/useWorkspaceState.test.ts +49 -1
  135. package/src/modules/workspace/components/EditorTabs.tsx +39 -15
  136. package/src/modules/workspace/components/FileExplorer.tsx +39 -6
  137. package/src/modules/workspace/components/FilePaneCard.tsx +6 -2
  138. package/src/modules/workspace/components/FileRoute.tsx +12 -7
  139. package/src/modules/workspace/components/FileViewer.tsx +271 -74
  140. package/src/modules/workspace/components/KbPageHeader.tsx +13 -6
  141. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +88 -21
  142. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +101 -11
  143. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +23 -3
  144. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +330 -6
  145. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +17 -2
  146. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +11 -16
  147. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +6 -0
  148. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +23 -21
  149. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +13 -29
  150. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +9 -2
  151. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +8 -0
  152. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +14 -19
  153. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +11 -17
  154. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +35 -7
  155. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -17
  156. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.links.test.tsx +73 -0
  157. package/src/modules/workspace/components/renderers/__tests__/ToolRenderer.scaffold.test.tsx +64 -0
  158. package/src/modules/workspace/components/renderers/__tests__/ToolRenderer.surface.test.tsx +82 -0
  159. package/src/modules/workspace/components/renderers/__tests__/bridgeHarness.ts +99 -0
  160. package/src/modules/workspace/components/renderers/__tests__/htmlSandbox.test.ts +129 -35
  161. package/src/modules/workspace/components/renderers/__tests__/htmlViewsGuide.test.ts +149 -0
  162. package/src/modules/workspace/components/renderers/__tests__/kbMarkdownLinkPolicy.test.tsx +100 -0
  163. package/src/modules/workspace/components/renderers/htmlSandbox.ts +76 -20
  164. package/src/modules/workspace/components/renderers/index.ts +26 -0
  165. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +51 -1
  166. package/src/modules/workspace/components/renderers/rendererRawRead.ts +53 -0
  167. package/src/modules/workspace/components/renderers/rendererSurface.ts +109 -0
  168. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +8 -2
  169. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +126 -21
  170. package/src/modules/workspace/hooks/useCreatePage.ts +116 -0
  171. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +24 -7
  172. package/src/modules/workspace/hooks/useWorkspaceState.ts +42 -8
  173. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +10 -0
  174. package/src/modules/workspace/routing/__tests__/md-links-parity.test.tsx +113 -0
  175. package/src/modules/workspace/routing/kb-routes.ts +66 -12
  176. package/src/modules/workspace/state/editable-page.ts +42 -0
  177. package/src/modules/workspace/state/workspace.context.ts +13 -4
  178. package/src/modules/workspace/utils/__tests__/display-file-name.test.ts +60 -0
  179. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +75 -0
  180. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +26 -14
  181. package/src/modules/workspace/utils/display-file-name.ts +102 -0
  182. package/src/modules/workspace/utils/fileTree.ts +49 -14
  183. package/src/modules/workspace/utils/treeConfirm.ts +22 -5
  184. package/src/shared/__tests__/no-builtin-confirm.test.ts +102 -0
  185. package/src/shared/components/ConfirmProvider.tsx +156 -0
  186. package/src/shared/components/Dialog.tsx +7 -0
  187. package/src/shared/components/__tests__/ConfirmProvider.test.tsx +198 -0
  188. package/src/shared/components/confirm-context.ts +94 -0
  189. package/src/shared/components/index.ts +3 -0
  190. package/src/shared/mcp/__tests__/connect-snippets.test.ts +2 -2
  191. package/src/shared/mcp/connect-snippets.ts +8 -5
  192. package/src/modules/onboarding/components/WelcomeRoute.tsx +0 -57
  193. package/src/modules/onboarding/welcome-state.ts +0 -36
@@ -99,12 +99,12 @@ describe('SetupScreen: the ways of having a repository', () => {
99
99
  it('offers them as tabs, in the order the deployment gives', () => {
100
100
  show();
101
101
  const tabs = within(screen.getByRole('tablist', { name: 'Where the repository is' })).getAllByRole('tab');
102
- expect(tabs.map((t) => t.textContent)).toEqual(['Managed for you', 'Address and token']);
102
+ expect(tabs.map((t) => t.textContent)).toEqual(['Hexis takes care of it', 'Address and token']);
103
103
  });
104
104
 
105
105
  it('opens a new deployment on the first: the repository it keeps itself', () => {
106
106
  show();
107
- expect(tab('Managed for you')).toHaveAttribute('aria-selected', 'true');
107
+ expect(tab('Hexis takes care of it')).toHaveAttribute('aria-selected', 'true');
108
108
  expect(screen.getByTestId('managed-repository')).toHaveTextContent('There is nothing to connect and nothing to enter');
109
109
  // Nothing to type, nothing to test.
110
110
  expect(address()).toBeNull();
@@ -122,7 +122,7 @@ describe('SetupScreen: the ways of having a repository', () => {
122
122
 
123
123
  it('gives each tab a panel of its own', async () => {
124
124
  show();
125
- for (const name of ['Managed for you', 'Address and token']) {
125
+ for (const name of ['Hexis takes care of it', 'Address and token']) {
126
126
  await userEvent.click(tab(name));
127
127
  const panel = document.getElementById(tab(name).getAttribute('aria-controls')!);
128
128
  expect(panel).toHaveAttribute('role', 'tabpanel');
@@ -161,7 +161,7 @@ describe('SetupScreen: saving a repository the deployment keeps', () => {
161
161
  await userEvent.click(tab('Address and token'));
162
162
  await userEvent.type(address()!, 'https://git.example.com/acme/kb.git');
163
163
  await userEvent.type(screen.getByLabelText('Access token', { exact: false }), 'a-token');
164
- await userEvent.click(tab('Managed for you'));
164
+ await userEvent.click(tab('Hexis takes care of it'));
165
165
  await save();
166
166
  await waitFor(() => expect(api.saveSettings).toHaveBeenCalledWith({ gitMode: 'managed' }));
167
167
  expect(api.testConnection).not.toHaveBeenCalled();
@@ -177,7 +177,7 @@ describe('SetupScreen: saving a repository the deployment keeps', () => {
177
177
  await screen.findByText('The host turned that token down.');
178
178
  expect(screen.getByRole('button', { name: 'Save and continue' })).toBeDisabled();
179
179
 
180
- await userEvent.click(tab('Managed for you'));
180
+ await userEvent.click(tab('Hexis takes care of it'));
181
181
  expect(screen.getByRole('button', { name: 'Save and continue' })).toBeEnabled();
182
182
  await save();
183
183
  await waitFor(() => expect(api.saveSettings).toHaveBeenCalled());
@@ -223,7 +223,7 @@ describe('SetupScreen: saving a repository reached by its address', () => {
223
223
  it('opens the tab a refused address or token is on', async () => {
224
224
  api.saveSettings.mockRejectedValue(new SettingsProblems({ gitToken: 'The host turned that token down.' }));
225
225
  show({ configured: true, mode: 'managed', variant: 'settings' });
226
- expect(tab('Managed for you')).toHaveAttribute('aria-selected', 'true');
226
+ expect(tab('Hexis takes care of it')).toHaveAttribute('aria-selected', 'true');
227
227
  await save();
228
228
  expect(await screen.findByText('The host turned that token down.')).toBeInTheDocument();
229
229
  expect(tab('Address and token')).toHaveAttribute('aria-selected', 'true');
@@ -233,7 +233,7 @@ describe('SetupScreen: saving a repository reached by its address', () => {
233
233
  describe('SetupScreen: moving a deployment to another repository', () => {
234
234
  it('says what saving will do, before it is pressed', async () => {
235
235
  show({ configured: true, variant: 'settings' });
236
- await userEvent.click(tab('Managed for you'));
236
+ await userEvent.click(tab('Hexis takes care of it'));
237
237
  const warning = screen.getByTestId('moves-repository');
238
238
  expect(warning).toHaveTextContent('moves this deployment to another repository');
239
239
  expect(warning).toHaveTextContent('Nothing is deleted');
@@ -263,13 +263,13 @@ describe('SetupScreen: moving a deployment to another repository', () => {
263
263
  it('does not move on a save the admin was not asked about', async () => {
264
264
  asksFirst();
265
265
  show({ configured: true, variant: 'settings' });
266
- await userEvent.click(tab('Managed for you'));
266
+ await userEvent.click(tab('Hexis takes care of it'));
267
267
  await userEvent.type(screen.getByLabelText('Knowledge folder', { exact: false }), 'Docs');
268
268
  await save();
269
269
 
270
270
  // Asked at the button, naming what is left and what is moved to.
271
271
  const asked = await question();
272
- expect(asked).toHaveTextContent('Move this deployment from “Address and token” to “Managed for you”?');
272
+ expect(asked).toHaveTextContent('Move this deployment from “Address and token” to “Hexis takes care of it”?');
273
273
  expect(asked).toHaveTextContent('Nothing is deleted');
274
274
  expect(asked).toHaveTextContent('with no restart');
275
275
  // One refused attempt, and the save button waits for the answer.
@@ -280,7 +280,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
280
280
  it('sends the move once the admin has said yes, and nothing of the repository it leaves', async () => {
281
281
  asksFirst();
282
282
  show({ configured: true, variant: 'settings' });
283
- await userEvent.click(tab('Managed for you'));
283
+ await userEvent.click(tab('Hexis takes care of it'));
284
284
  await save();
285
285
  await question();
286
286
  await confirmMove();
@@ -300,7 +300,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
300
300
  repository={{ mode: 'token', chosen: 'token', modes: ['managed', 'github-app', 'token'] }}
301
301
  />,
302
302
  );
303
- await userEvent.click(tab('Managed for you'));
303
+ await userEvent.click(tab('Hexis takes care of it'));
304
304
  await save();
305
305
  await question();
306
306
  await confirmMove();
@@ -325,7 +325,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
325
325
  repository={{ mode: 'token', chosen: 'token', modes: ['managed', 'github-app', 'token'] }}
326
326
  />,
327
327
  );
328
- await userEvent.click(tab('Managed for you'));
328
+ await userEvent.click(tab('Hexis takes care of it'));
329
329
  await save();
330
330
  await question();
331
331
  await userEvent.click(tab('GitHub'));
@@ -336,7 +336,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
336
336
  it('closes the open change requests when the admin picks that, and says so', async () => {
337
337
  asksFirst(2);
338
338
  show({ configured: true, variant: 'settings' });
339
- await userEvent.click(tab('Managed for you'));
339
+ await userEvent.click(tab('Hexis takes care of it'));
340
340
  await save();
341
341
  await question();
342
342
  await userEvent.click(screen.getByRole('radio', { name: /Close them as/ }));
@@ -354,7 +354,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
354
354
  return { ...saved('managed', true), repositoryChange: { choice: confirm, closedChangeRequests: 0 } };
355
355
  });
356
356
  show({ configured: true, variant: 'settings' });
357
- await userEvent.click(tab('Managed for you'));
357
+ await userEvent.click(tab('Hexis takes care of it'));
358
358
  await save();
359
359
  await question();
360
360
  expect(screen.queryAllByRole('radio')).toEqual([]);
@@ -369,7 +369,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
369
369
  it('cancelling leaves the deployment where it is', async () => {
370
370
  asksFirst(2);
371
371
  show({ configured: true, variant: 'settings' });
372
- await userEvent.click(tab('Managed for you'));
372
+ await userEvent.click(tab('Hexis takes care of it'));
373
373
  await save();
374
374
  expect(await question()).toHaveTextContent('There are 2 open change requests.');
375
375
  await userEvent.click(screen.getByRole('button', { name: 'Cancel' }));
@@ -381,7 +381,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
381
381
  it('asks nothing of a save that stays where the deployment is', async () => {
382
382
  api.saveSettings.mockResolvedValue(saved('token', true));
383
383
  show({ configured: true, variant: 'settings' });
384
- await userEvent.click(tab('Managed for you'));
384
+ await userEvent.click(tab('Hexis takes care of it'));
385
385
  await userEvent.click(tab('Address and token'));
386
386
  await userEvent.type(screen.getByLabelText('Knowledge folder', { exact: false }), 'Docs');
387
387
  await save();
@@ -394,7 +394,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
394
394
  show();
395
395
  await userEvent.click(tab('Address and token'));
396
396
  expect(screen.queryByTestId('moves-repository')).toBeNull();
397
- await userEvent.click(tab('Managed for you'));
397
+ await userEvent.click(tab('Hexis takes care of it'));
398
398
  await save();
399
399
  await waitFor(() => expect(api.saveSettings).toHaveBeenCalledWith({ gitMode: 'managed' }));
400
400
  expect(screen.queryByTestId('repository-change-confirm')).toBeNull();
@@ -409,7 +409,7 @@ describe('SetupScreen: moving a deployment to another repository', () => {
409
409
  describe('SetupScreen: a way chosen that is not in effect yet', () => {
410
410
  it('opens on the way chosen, and says the deployment is still on the one it has', () => {
411
411
  show({ configured: true, mode: 'token', chosen: 'managed', variant: 'settings' });
412
- expect(tab('Managed for you')).toHaveAttribute('aria-selected', 'true');
412
+ expect(tab('Hexis takes care of it')).toHaveAttribute('aria-selected', 'true');
413
413
  const pending = screen.getByTestId('move-pending');
414
414
  expect(pending).toHaveTextContent('A restart is pending');
415
415
  expect(pending).toHaveTextContent('still working on “Address and token”');
@@ -446,12 +446,12 @@ describe('SetupScreen: a way chosen that is not in effect yet', () => {
446
446
  describe('SetupScreen: a way chosen by the environment', () => {
447
447
  it('shows the other ways as not the screen to choose, and says which variable chose', async () => {
448
448
  show({ mode: 'managed', pinned: 'GIT_MODE', variant: 'settings' });
449
- expect(tab('Managed for you')).toHaveAttribute('aria-selected', 'true');
450
- expect(tab('Managed for you')).toBeEnabled();
449
+ expect(tab('Hexis takes care of it')).toHaveAttribute('aria-selected', 'true');
450
+ expect(tab('Hexis takes care of it')).toBeEnabled();
451
451
  expect(tab('Address and token')).toBeDisabled();
452
452
  expect(screen.getByTestId('repository-pinned')).toHaveTextContent('Set by the GIT_MODE environment variable');
453
453
  await userEvent.click(tab('Address and token'));
454
- expect(tab('Managed for you')).toHaveAttribute('aria-selected', 'true');
454
+ expect(tab('Hexis takes care of it')).toHaveAttribute('aria-selected', 'true');
455
455
  expect(screen.queryByTestId('repository-change-confirm')).toBeNull();
456
456
  });
457
457
 
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { render, screen, waitFor, within } from '@testing-library/react';
2
+ import { cleanup, render, screen, waitFor, within } from '@testing-library/react';
3
3
  import userEvent from '@testing-library/user-event';
4
4
 
5
5
  const api = vi.hoisted(() => ({
@@ -27,7 +27,6 @@ const facade = vi.hoisted(() => ({
27
27
  }));
28
28
  vi.mock('../../settings/services/github-facade.api', () => facade);
29
29
 
30
- import { agentsFilePointerSentence } from '@bevel-software/platform-shared';
31
30
  import { SetupGate } from '../components/SetupGate';
32
31
  import { SetupScreen } from '../components/SetupScreen';
33
32
  import { KbInitFailed, SettingsProblems, type SettingStatus } from '../services/setup.api';
@@ -42,8 +41,6 @@ const SETTINGS: SettingStatus[] = [
42
41
  { key: 'knowledgeBaseDir', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
43
42
  { key: 'skillsDir', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
44
43
  { key: 'pluginsDir', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
45
- { key: 'agentsFile', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
46
- { key: 'agentsFileLink', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
47
44
  { key: 'defaultBranch', envVar: 'DEFAULT_BRANCH', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
48
45
  { key: 'protectedBranches', envVar: 'PROTECTED_BRANCHES', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
49
46
  { key: 'oidcClientSecret', envVar: 'OIDC_CLIENT_SECRET', section: 'sign-in', source: 'unset', configured: false, secret: true, restartToApply: false },
@@ -368,6 +365,47 @@ describe('SetupScreen', () => {
368
365
  * putting the stored value back changes nothing — the save must not be held
369
366
  * behind a repository test for an edit that no longer exists.
370
367
  */
368
+ /**
369
+ * The leftover-branch cleanup is an on/off setting: a checkbox, ticked while
370
+ * unset (the server's default is on), saved as `true` / `false`.
371
+ */
372
+ it('settings mode: the leftover-branch cleanup is a checkbox, on by default, saved as false when cleared', async () => {
373
+ const stored = [
374
+ ...SETTINGS.map((s) =>
375
+ s.key === 'kbRepoUrl'
376
+ ? { ...s, source: 'stored' as const, value: 'https://example.com/kb.git', configured: true }
377
+ : s.key === 'defaultBranch' || s.key === 'protectedBranches'
378
+ ? { ...s, source: 'stored' as const, value: 'main', configured: true }
379
+ : s,
380
+ ),
381
+ {
382
+ key: 'retireMergedBranches',
383
+ envVar: 'RETIRE_MERGED_BRANCHES',
384
+ section: KB,
385
+ source: 'unset' as const,
386
+ value: '',
387
+ configured: false,
388
+ secret: false,
389
+ restartToApply: false,
390
+ },
391
+ ];
392
+ render(<SetupScreen settings={stored} onSaved={vi.fn()} variant="settings" />);
393
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: stored });
394
+
395
+ // It sits under Advanced, closed by default: opened first, as a person would.
396
+ const advanced = screen.getByText(/^Advanced/, { selector: 'summary' });
397
+ await userEvent.click(advanced);
398
+ expect(advanced.closest('details')).toHaveAttribute('open');
399
+ const box = screen.getByRole('checkbox', { name: 'Remove branches left over from merged change requests' });
400
+ expect(box).toBeChecked();
401
+ await userEvent.click(box);
402
+ expect(box).not.toBeChecked();
403
+ await userEvent.click(screen.getByRole('button', { name: 'Save and continue' }));
404
+
405
+ await waitFor(() => expect(api.saveSettings).toHaveBeenCalled());
406
+ expect(api.saveSettings).toHaveBeenCalledWith(expect.objectContaining({ retireMergedBranches: 'false' }));
407
+ });
408
+
371
409
  it('settings mode: a field restored to its stored value does not gate the save', async () => {
372
410
  const stored = SETTINGS.map((s) =>
373
411
  s.key === 'kbRepoUrl'
@@ -970,13 +1008,13 @@ describe('SetupScreen — remote sync panel', () => {
970
1008
  },
971
1009
  };
972
1010
 
973
- it('shows the address a hook calls on first run, without a Sync now button', () => {
1011
+ it('shows the address a hook calls on first run, without an Update now button', () => {
974
1012
  render(<SetupScreen settings={[...SETTINGS, SYNC_SETTING]} sync={SYNC} onSaved={() => {}} />);
975
1013
  expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
976
- expect(screen.getByRole('button', { name: 'Copy the sync address' })).toBeTruthy();
1014
+ expect(screen.getByRole('button', { name: 'Copy the hook address' })).toBeTruthy();
977
1015
  // The 'setup' variant never offers the button or the history, whatever the
978
1016
  // record says: on first run the repository behind them is not connected yet.
979
- expect(screen.queryByRole('button', { name: 'Sync now' })).toBeNull();
1017
+ expect(screen.queryByRole('button', { name: 'Update now' })).toBeNull();
980
1018
  });
981
1019
 
982
1020
  it('shows the address on the Deployment page too', () => {
@@ -984,7 +1022,7 @@ describe('SetupScreen — remote sync panel', () => {
984
1022
  <SetupScreen settings={[...SETTINGS, SYNC_SETTING]} sync={SYNC} onSaved={() => {}} variant="settings" />,
985
1023
  );
986
1024
  expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
987
- expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
1025
+ expect(screen.getByRole('button', { name: 'Update now' })).toBeTruthy();
988
1026
  });
989
1027
 
990
1028
  it('keeps the panel when the secret is set by the environment', () => {
@@ -994,12 +1032,12 @@ describe('SetupScreen — remote sync panel', () => {
994
1032
  );
995
1033
  // The secret itself is locked, listed under the environment…
996
1034
  expect(screen.getByText('KB_SYNC_SECRET')).toBeTruthy();
997
- // …but the address, the history and Sync now are still there.
1035
+ // …but the address, the history and Update now are still there.
998
1036
  expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
999
- expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
1037
+ expect(screen.getByRole('button', { name: 'Update now' })).toBeTruthy();
1000
1038
  });
1001
1039
 
1002
- it('on the Deployment page: says what the last sync did, and Sync now reports the result', async () => {
1040
+ it('on the Deployment page: says what the last sync did, and Update now reports the result', async () => {
1003
1041
  api.syncNow.mockResolvedValue({
1004
1042
  ok: true,
1005
1043
  status: 'synced',
@@ -1017,10 +1055,10 @@ describe('SetupScreen — remote sync panel', () => {
1017
1055
  variant="settings"
1018
1056
  />,
1019
1057
  );
1020
- expect(screen.getByText(/Last sync .* by github-signature: main updated\./)).toBeTruthy();
1058
+ expect(screen.getByText(/Last update .* by github-signature: main updated\./)).toBeTruthy();
1021
1059
 
1022
- await userEvent.click(screen.getByRole('button', { name: 'Sync now' }));
1023
- await waitFor(() => expect(screen.getByText('Synced: main updated, ali/x up to date.')).toBeTruthy());
1060
+ await userEvent.click(screen.getByRole('button', { name: 'Update now' }));
1061
+ await waitFor(() => expect(screen.getByText('Updated: main updated, ali/x up to date.')).toBeTruthy());
1024
1062
  expect(api.syncNow).toHaveBeenCalledTimes(1);
1025
1063
  // The status carries the last-sync record, so the page refetches it.
1026
1064
  expect(onSaved).toHaveBeenCalled();
@@ -1042,8 +1080,8 @@ describe('SetupScreen — remote sync panel', () => {
1042
1080
  variant="settings"
1043
1081
  />,
1044
1082
  );
1045
- expect(screen.getByText('No sync since this server started.')).toBeTruthy();
1046
- await userEvent.click(screen.getByRole('button', { name: 'Sync now' }));
1083
+ expect(screen.getByText('No updates since this server started.')).toBeTruthy();
1084
+ await userEvent.click(screen.getByRole('button', { name: 'Update now' }));
1047
1085
  await waitFor(() =>
1048
1086
  expect(screen.getByText(/main is not in sync yet: a\.md changed both/)).toBeTruthy(),
1049
1087
  );
@@ -1256,7 +1294,7 @@ describe('SetupScreen — a failed knowledge-base initialization', () => {
1256
1294
  });
1257
1295
 
1258
1296
  describe('SetupScreen — sync panel when the whole knowledge base is env-set', () => {
1259
- it('still renders the address and Sync now, in a section of its own', () => {
1297
+ it('still renders the address and Update now, in a section of its own', () => {
1260
1298
  const KB_FROM_ENV: SettingStatus[] = SETTINGS.map((s) =>
1261
1299
  s.section === 'knowledge-base' ? { ...s, source: 'env', configured: true } : s,
1262
1300
  );
@@ -1272,79 +1310,25 @@ describe('SetupScreen — sync panel when the whole knowledge base is env-set',
1272
1310
  />,
1273
1311
  );
1274
1312
  expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
1275
- expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
1276
- expect(screen.getByRole('heading', { name: 'Repository sync' })).toBeTruthy();
1313
+ expect(screen.getByRole('button', { name: 'Update now' })).toBeTruthy();
1314
+ expect(screen.getByRole('heading', { name: 'Updates from your git host' })).toBeTruthy();
1277
1315
  });
1278
1316
  });
1279
1317
 
1280
1318
  /**
1281
- * The agent guide's file name, and the one thing that rides with it: the
1282
- * sentence the platform would add to the customer's own `AGENTS.md`, and the
1283
- * consent to keep it there.
1319
+ * The agent guide is served by the platform, not written to the repository,
1320
+ * so there is no file name to choose: the field that let an admin rename the
1321
+ * written guide is gone from both screens.
1284
1322
  */
1285
- describe('SetupScreen — the agent guide file', () => {
1286
- async function renderScreen(variant: 'setup' | 'settings' = 'setup') {
1323
+ describe('SetupScreen — the agent guide', () => {
1324
+ it('offers no guide file name, on first run or on the Deployment settings page', async () => {
1287
1325
  api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS });
1288
- if (variant === 'settings') {
1289
- render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1290
- return;
1291
- }
1292
1326
  render(<SetupGate>{APP}</SetupGate>);
1293
1327
  await screen.findByRole('heading', { name: /Set up this deployment/ });
1294
- }
1295
-
1296
- it('offers the field on first run, beside the three folder names', async () => {
1297
- await renderScreen();
1298
- expect(screen.getByLabelText('Agent guide file')).toHaveValue('');
1299
- // Not tucked under Advanced, for the same reason the folders are not: a
1300
- // repository that already has an AGENTS.md loses it unless this is
1301
- // answered before the first boot.
1302
1328
  expect(screen.getByLabelText('Knowledge folder')).toBeInTheDocument();
1303
- });
1304
-
1305
- it('offers it on the Deployment settings page too', async () => {
1306
- await renderScreen('settings');
1307
- expect(screen.getByLabelText('Agent guide file')).toBeInTheDocument();
1308
- });
1309
-
1310
- it('shows nothing about a pointer while the guide is still AGENTS.md', async () => {
1311
- await renderScreen('settings');
1312
- expect(screen.queryByTestId('agents-file-link')).toBeNull();
1313
- await userEvent.type(screen.getByLabelText('Agent guide file'), 'AGENTS.md');
1314
- expect(screen.queryByTestId('agents-file-link')).toBeNull();
1315
- });
1316
-
1317
- it('shows the exact sentence and a ticked box once the name differs', async () => {
1318
- await renderScreen('settings');
1319
- await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.md');
1320
- const panel = within(screen.getByTestId('agents-file-link'));
1321
- // On by default — a renamed guide nothing points at is a guide no coding
1322
- // agent will find.
1323
- expect(panel.getByRole('checkbox')).toBeChecked();
1324
- // The sentence itself, from the same helper the server appends with.
1325
- expect(panel.getByText(agentsFilePointerSentence('HEXIS.md'))).toBeInTheDocument();
1326
- });
1327
-
1328
- it('saves the name and the consent the admin actually gave', async () => {
1329
- api.saveSettings.mockResolvedValue({ restartRequired: true, complete: false, settings: SETTINGS });
1330
- render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1331
- await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.md');
1332
- await userEvent.click(within(screen.getByTestId('agents-file-link')).getByRole('checkbox'));
1333
- await userEvent.click(screen.getByRole('button', { name: /Save/ }));
1334
- await waitFor(() =>
1335
- expect(api.saveSettings).toHaveBeenCalledWith(
1336
- expect.objectContaining({ agentsFile: 'HEXIS.md', agentsFileLink: 'false' }),
1337
- ),
1338
- );
1339
- });
1340
-
1341
- it('shows the server\'s rule against a name it refused', async () => {
1342
- api.saveSettings.mockRejectedValue(
1343
- new SettingsProblems({ agentsFile: 'The name must end in .md.' }),
1344
- );
1329
+ expect(screen.queryByLabelText('Agent guide file')).toBeNull();
1330
+ cleanup();
1345
1331
  render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1346
- await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.txt');
1347
- await userEvent.click(screen.getByRole('button', { name: /Save/ }));
1348
- expect(await screen.findByText('The name must end in .md.')).toBeInTheDocument();
1332
+ expect(screen.queryByLabelText('Agent guide file')).toBeNull();
1349
1333
  });
1350
1334
  });
@@ -0,0 +1,123 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { act, renderHook } from '@testing-library/react';
3
+
4
+ /**
5
+ * The one connection probe both setup screens read: which answer is the
6
+ * answer on screen when requests overlap or the answers change under one.
7
+ * Only the request is mocked; the ordering is the hook's own.
8
+ */
9
+ const api = vi.hoisted(() => ({ testConnection: vi.fn() }));
10
+ vi.mock('../services/setup.api', () => api);
11
+
12
+ import { ConnectionProbeFailed, useConnectionProbe } from '../hooks/useConnectionProbe';
13
+ import type { ConnectionTest } from '../services/setup.api';
14
+
15
+ function deferred<T>() {
16
+ let resolve!: (value: T) => void;
17
+ let reject!: (reason: unknown) => void;
18
+ const promise = new Promise<T>((res, rej) => {
19
+ resolve = res;
20
+ reject = rej;
21
+ });
22
+ return { promise, resolve, reject };
23
+ }
24
+
25
+ const YES = { ok: true, branches: ['main'] } as ConnectionTest;
26
+ const NO = { ok: false, error: 'The host said no.' } as ConnectionTest;
27
+ const ANSWERS = { kbRepoUrl: 'https://example.com/acme/kb.git', gitToken: 't' };
28
+
29
+ type Asked = ReturnType<ReturnType<typeof useConnectionProbe>['ask']>;
30
+
31
+ describe('useConnectionProbe', () => {
32
+ // A queued answer a failed test never consumed must not feed the next one.
33
+ beforeEach(() => api.testConnection.mockReset());
34
+
35
+ it("shows the newest request's answer when two for the same answers land newest-first", async () => {
36
+ const first = deferred<ConnectionTest>();
37
+ const second = deferred<ConnectionTest>();
38
+ api.testConnection.mockReturnValueOnce(first.promise).mockReturnValueOnce(second.promise);
39
+ const { result } = renderHook(() => useConnectionProbe());
40
+
41
+ let older!: Asked;
42
+ let newer!: Asked;
43
+ act(() => {
44
+ older = result.current.ask(ANSWERS);
45
+ newer = result.current.ask(ANSWERS);
46
+ });
47
+ expect(result.current.testing).toBe(true);
48
+
49
+ await act(async () => {
50
+ second.resolve(YES);
51
+ await newer;
52
+ });
53
+ expect(result.current.result).toEqual(YES);
54
+ expect(result.current.proven).toBe(true);
55
+
56
+ // The older request lands last, with a refusal: stale, so it neither
57
+ // replaces the yes on screen nor counts as proof against it.
58
+ await act(async () => {
59
+ first.resolve(NO);
60
+ await expect(older).resolves.toEqual({ result: NO, stale: true });
61
+ });
62
+ expect(result.current.result).toEqual(YES);
63
+ expect(result.current.proven).toBe(true);
64
+ expect(result.current.testing).toBe(false);
65
+ });
66
+
67
+ it('an older request that fails after a newer one answered is a stale failure, and the answer stands', async () => {
68
+ const first = deferred<ConnectionTest>();
69
+ const second = deferred<ConnectionTest>();
70
+ api.testConnection.mockReturnValueOnce(first.promise).mockReturnValueOnce(second.promise);
71
+ const { result } = renderHook(() => useConnectionProbe());
72
+
73
+ let older!: Asked;
74
+ let newer!: Asked;
75
+ act(() => {
76
+ older = result.current.ask(ANSWERS);
77
+ newer = result.current.ask(ANSWERS);
78
+ });
79
+ await act(async () => {
80
+ second.resolve(YES);
81
+ await newer;
82
+ });
83
+
84
+ await act(async () => {
85
+ first.reject(new Error('network down'));
86
+ await expect(older).rejects.toMatchObject({ name: 'ConnectionProbeFailed', message: 'network down', stale: true });
87
+ });
88
+ await expect(older).rejects.toBeInstanceOf(ConnectionProbeFailed);
89
+ expect(result.current.result).toEqual(YES);
90
+ expect(result.current.testing).toBe(false);
91
+ });
92
+
93
+ it('an edit while a request is out makes its answer stale and leaves nothing on screen', async () => {
94
+ const only = deferred<ConnectionTest>();
95
+ api.testConnection.mockReturnValueOnce(only.promise);
96
+ const { result } = renderHook(() => useConnectionProbe());
97
+
98
+ let asked!: Asked;
99
+ act(() => {
100
+ asked = result.current.ask(ANSWERS);
101
+ });
102
+ act(() => result.current.invalidate());
103
+
104
+ await act(async () => {
105
+ only.resolve(YES);
106
+ await expect(asked).resolves.toEqual({ result: YES, stale: true });
107
+ });
108
+ expect(result.current.result).toBeNull();
109
+ expect(result.current.proven).toBe(false);
110
+ expect(result.current.testing).toBe(false);
111
+ });
112
+
113
+ it('a lone request that answers in order is the answer on screen', async () => {
114
+ api.testConnection.mockResolvedValueOnce(YES);
115
+ const { result } = renderHook(() => useConnectionProbe());
116
+ await act(async () => {
117
+ await expect(result.current.ask(ANSWERS)).resolves.toEqual({ result: YES, stale: false });
118
+ });
119
+ expect(result.current.result).toEqual(YES);
120
+ expect(result.current.proven).toBe(true);
121
+ expect(api.testConnection).toHaveBeenLastCalledWith(ANSWERS);
122
+ });
123
+ });