@bevel-software/platform-core-frontend 0.15.1 → 0.20.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 (347) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +20 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  33. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  34. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  35. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  36. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  37. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  38. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  39. package/src/modules/admin/components/group-members-path.ts +32 -0
  40. package/src/modules/admin/services/roles.api.ts +12 -1
  41. package/src/modules/audit/__tests__/AuditLogPage.test.tsx +312 -0
  42. package/src/modules/audit/components/AuditEventsPanel.tsx +319 -0
  43. package/src/modules/audit/components/AuditLogPage.tsx +373 -0
  44. package/src/modules/audit/components/principal-grouping.ts +49 -0
  45. package/src/modules/audit/services/audit.api.ts +98 -0
  46. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  47. package/src/modules/auth/components/AccountPage.tsx +73 -54
  48. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  49. package/src/modules/auth/services/account.api.ts +78 -4
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  58. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  59. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  60. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  61. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  62. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  63. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  64. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  65. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  66. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  67. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  68. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  69. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  70. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  71. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  72. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  73. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  74. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  75. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  76. package/src/modules/change-requests/services/propose.api.ts +97 -8
  77. package/src/modules/change-requests/utils/approval.ts +15 -0
  78. package/src/modules/change-requests/utils/author.ts +32 -0
  79. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  80. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  81. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  82. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  83. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  84. package/src/modules/git/services/error-messages.ts +12 -0
  85. package/src/modules/git/services/pr-prompts.ts +5 -5
  86. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  87. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  88. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  89. package/src/modules/layout/components/AppLayout.tsx +2 -0
  90. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  91. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  92. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  93. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  94. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  95. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  96. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  97. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  98. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  99. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  100. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  101. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  102. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  103. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  104. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  105. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  106. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  107. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  108. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  109. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  110. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  111. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  112. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  113. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  114. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  115. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  116. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  117. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  118. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  119. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  120. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  121. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  122. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  123. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  124. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  125. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  126. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  127. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  128. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  129. package/src/modules/library/__tests__/status.test.ts +82 -2
  130. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  131. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  132. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  133. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  134. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  135. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  136. package/src/modules/library/components/LibraryCard.tsx +146 -45
  137. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  138. package/src/modules/library/components/LibraryPage.tsx +172 -39
  139. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  140. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  141. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  142. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  143. package/src/modules/library/components/PageActions.tsx +11 -9
  144. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  145. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  146. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  147. package/src/modules/library/components/PluginExtras.tsx +140 -17
  148. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  149. package/src/modules/library/components/PluginPage.tsx +157 -41
  150. package/src/modules/library/components/PluginRows.tsx +286 -0
  151. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  152. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  153. package/src/modules/library/components/ShareButton.tsx +17 -0
  154. package/src/modules/library/components/SkillsTree.tsx +141 -28
  155. package/src/modules/library/components/TeamRoute.tsx +15 -0
  156. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  157. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  158. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  159. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  160. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  161. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  162. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  163. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  164. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  165. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  166. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  167. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  168. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  169. package/src/modules/library/routes/library-paths.ts +26 -28
  170. package/src/modules/library/services/library.api.ts +38 -20
  171. package/src/modules/library/services/plugins.api.ts +69 -8
  172. package/src/modules/library/services/teams.api.ts +15 -0
  173. package/src/modules/library/services/tools.api.ts +78 -0
  174. package/src/modules/library/state/library-data.tsx +170 -32
  175. package/src/modules/library/utils/personal-plugin.ts +13 -15
  176. package/src/modules/library/utils/plugin-entries.ts +134 -0
  177. package/src/modules/library/utils/plugin-summary.ts +75 -9
  178. package/src/modules/library/utils/status.ts +135 -33
  179. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  180. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  181. package/src/modules/onboarding/agent-clients.ts +55 -23
  182. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  183. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  184. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  185. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  186. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  187. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  188. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  189. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  190. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  191. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  192. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  193. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  194. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  195. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  196. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  197. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  198. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  199. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  200. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  201. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  202. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  203. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  204. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  205. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  206. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  207. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  208. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +7 -6
  209. package/src/modules/settings/services/github-facade.api.ts +23 -0
  210. package/src/modules/settings/settings-nav-items.tsx +13 -3
  211. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  212. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  213. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  214. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  215. package/src/modules/setup/components/SetupGate.tsx +16 -16
  216. package/src/modules/setup/components/SetupScreen.tsx +532 -43
  217. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  218. package/src/modules/setup/services/setup.api.ts +141 -4
  219. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  220. package/src/modules/setup/utils/root-folders.ts +46 -0
  221. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  232. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  233. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  234. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  235. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  236. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  237. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  238. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  239. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  240. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  241. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  242. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  243. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  244. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  245. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  246. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  247. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  248. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  249. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  250. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  251. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  252. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  254. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  255. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  256. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  257. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  258. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  259. package/src/modules/workspace/components/FileViewer.tsx +172 -46
  260. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  261. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  262. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  263. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2533 -129
  264. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  265. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +381 -12
  266. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  267. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  268. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  269. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  270. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  271. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  272. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  273. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  274. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  275. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  276. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  277. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  279. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  280. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  281. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  282. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  283. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  284. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  285. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  286. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  287. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  288. package/src/modules/workspace/components/renderers/index.ts +53 -2
  289. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  290. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  291. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  292. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  294. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  295. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  296. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  297. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  298. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  299. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  300. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  301. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +134 -1
  302. package/src/modules/workspace/services/workspace.api.ts +57 -4
  303. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  304. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  305. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  306. package/src/modules/workspace/state/workspace.context.ts +125 -19
  307. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  308. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  309. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  310. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  311. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  312. package/src/modules/workspace/utils/file-trace.ts +50 -0
  313. package/src/modules/workspace/utils/fileTree.ts +112 -36
  314. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  315. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  316. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  317. package/src/modules/workspace/utils/uploadError.ts +29 -0
  318. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  319. package/src/shared/components/Button.tsx +16 -2
  320. package/src/shared/components/Dialog.tsx +27 -11
  321. package/src/shared/components/Menu.tsx +13 -1
  322. package/src/shared/components/PageShell.tsx +13 -8
  323. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  324. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  325. package/src/shared/components/index.ts +2 -0
  326. package/src/shared/components/useDismissableMenu.ts +32 -10
  327. package/src/shared/components/useFocusHandoff.ts +51 -0
  328. package/src/shared/components/useLatestRef.ts +28 -0
  329. package/src/shared/markdown/Markdown.tsx +12 -3
  330. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  331. package/src/shared/markdown/hrefs.ts +50 -0
  332. package/src/shared/marketplace-url.ts +33 -5
  333. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  334. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  335. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  336. package/src/shared/mcp/connect-snippets.ts +14 -9
  337. package/src/shared/mcp/index.ts +1 -1
  338. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  339. package/src/shared/theme/header.ts +75 -0
  340. package/src/shared/theme/measure.ts +7 -4
  341. package/src/shared/theme/tokens.css +25 -0
  342. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  343. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  344. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  345. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  346. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  347. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import { render, screen, waitFor } from '@testing-library/react';
2
+ import { 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(() => ({
@@ -17,9 +17,20 @@ vi.mock('../services/setup.api', async () => {
17
17
  return { ...actual, ...api };
18
18
  });
19
19
 
20
+ // The Marketplace section renders on first run too. Registration state is
21
+ // read on mount; the credentials only once its drawer opens.
22
+ const facade = vi.hoisted(() => ({
23
+ fetchGitHubFacade: vi.fn(),
24
+ rotateGitHubFacade: vi.fn(),
25
+ fetchMarketplaceRegistration: vi.fn(async () => false),
26
+ setMarketplaceRegistration: vi.fn(),
27
+ }));
28
+ vi.mock('../../settings/services/github-facade.api', () => facade);
29
+
30
+ import { agentsFilePointerSentence } from '@bevel-software/platform-shared';
20
31
  import { SetupGate } from '../components/SetupGate';
21
32
  import { SetupScreen } from '../components/SetupScreen';
22
- import { SettingsProblems, type SettingStatus } from '../services/setup.api';
33
+ import { KbInitFailed, SettingsProblems, type SettingStatus } from '../services/setup.api';
23
34
 
24
35
  const KB = 'knowledge-base' as const;
25
36
  const SETTINGS: SettingStatus[] = [
@@ -27,9 +38,15 @@ const SETTINGS: SettingStatus[] = [
27
38
  { key: 'gitToken', envVar: 'GIT_TOKEN', section: KB, source: 'unset', configured: false, secret: true, restartToApply: false },
28
39
  { key: 'gitUsername', envVar: 'GIT_USERNAME', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: false },
29
40
  { key: 'kbDirName', envVar: 'KB_DIR_NAME', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
41
+ // The layout settings carry no `envVar`: they are entered here and nowhere else.
42
+ { key: 'knowledgeBaseDir', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
43
+ { key: 'skillsDir', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
44
+ { 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 },
30
47
  { key: 'defaultBranch', envVar: 'DEFAULT_BRANCH', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
31
48
  { key: 'protectedBranches', envVar: 'PROTECTED_BRANCHES', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
32
- { key: 'oidcClientSecret', envVar: 'OIDC_CLIENT_SECRET', section: 'sign-in', source: 'unset', configured: false, secret: true, restartToApply: true },
49
+ { key: 'oidcClientSecret', envVar: 'OIDC_CLIENT_SECRET', section: 'sign-in', source: 'unset', configured: false, secret: true, restartToApply: false },
33
50
  ];
34
51
 
35
52
  /**
@@ -128,6 +145,34 @@ describe('SetupScreen', () => {
128
145
  await waitFor(() => expect(reload).toHaveBeenCalled());
129
146
  });
130
147
 
148
+ /**
149
+ * The first-run host of the Marketplace section: marked optional and never
150
+ * in the way — setup finishes without anyone touching it, and nothing in it
151
+ * is fetched or saved on the way. There is no skip control to press: an
152
+ * admin ignores the section the way they ignore single sign-on, by leaving
153
+ * it alone. Because "Save and continue" now sits BELOW this section and is
154
+ * tied to the form by `form=`, this also proves that out-of-form submit
155
+ * still saves.
156
+ */
157
+ it('offers the Marketplace section as optional, and finishes setup having ignored it', async () => {
158
+ facade.fetchGitHubFacade.mockClear();
159
+ facade.setMarketplaceRegistration.mockClear();
160
+ await renderScreen();
161
+ const section = await screen.findByTestId('marketplace-deployment-section');
162
+ expect(section).toHaveTextContent('Optional');
163
+ expect(screen.getByRole('heading', { name: 'Marketplace' })).toBeInTheDocument();
164
+ expect(screen.getByText('Register this deployment with your Claude organization')).toBeInTheDocument();
165
+ expect(screen.queryByRole('button', { name: 'Skip for now' })).toBeNull();
166
+
167
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: SETTINGS });
168
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://example.com/kb.git');
169
+ await userEvent.type(screen.getByLabelText('Access token'), 'ghp_secret');
170
+ await userEvent.click(screen.getByRole('button', { name: 'Save and continue' }));
171
+ await waitFor(() => expect(reload).toHaveBeenCalled());
172
+ expect(facade.fetchGitHubFacade).not.toHaveBeenCalled();
173
+ expect(facade.setMarketplaceRegistration).not.toHaveBeenCalled();
174
+ });
175
+
131
176
  /**
132
177
  * The whole reason a form beats an environment variable: it can ask the host
133
178
  * whether the answer is right, and say which part was wrong — before anything
@@ -346,6 +391,34 @@ describe('SetupScreen', () => {
346
391
  expect(api.testConnection).not.toHaveBeenCalled();
347
392
  });
348
393
 
394
+ /**
395
+ * The third outcome: the host lets the token read, but not push. That is not
396
+ * "connected" — every save anyone makes would fail — and not "rejected"
397
+ * either: the fix is a permission, and the screen has to say which.
398
+ */
399
+ it('shows a token that can read but not write as its own outcome, and will not save it', async () => {
400
+ await renderScreen();
401
+ api.testConnection.mockResolvedValue({
402
+ ok: false,
403
+ outcome: 'read-only',
404
+ field: 'gitToken',
405
+ error:
406
+ 'This token can read the repository but cannot write to it. Grant it write access: on GitHub, “Contents: Read and write” for this repository.',
407
+ branches: ['main'],
408
+ defaultBranch: 'main',
409
+ empty: false,
410
+ });
411
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://github.com/acme/kb.git');
412
+ await userEvent.type(screen.getByLabelText('Access token'), 'ghp_readonly');
413
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
414
+
415
+ expect(await screen.findByText(/Contents: Read and write/)).toBeInTheDocument();
416
+ expect(screen.queryByText(/Connected/)).toBeNull();
417
+ expect(screen.getByRole('button', { name: 'Save and continue' })).toBeDisabled();
418
+ expect(screen.getByText(/can read the repository but cannot write to it\. Grant write access/)).toBeInTheDocument();
419
+ expect(api.saveSettings).not.toHaveBeenCalled();
420
+ });
421
+
349
422
  /** An empty repository is a supported starting point, not a failure. */
350
423
  it('treats an empty repository as a success', async () => {
351
424
  await renderScreen();
@@ -731,7 +804,9 @@ describe('SetupScreen', () => {
731
804
  /** Single sign-on is skippable, and the screen has to say so. */
732
805
  it('marks the optional section optional', async () => {
733
806
  await renderScreen();
734
- expect(screen.getByText('Optional')).toBeInTheDocument();
807
+ // Scoped: the Marketplace section below the form is optional too.
808
+ const signIn = screen.getByRole('heading', { name: 'Single sign-on' }).closest('section')!;
809
+ expect(within(signIn).getByText('Optional')).toBeInTheDocument();
735
810
  });
736
811
 
737
812
  it('says so when a saved setting needs a restart', async () => {
@@ -744,6 +819,147 @@ describe('SetupScreen', () => {
744
819
  });
745
820
  });
746
821
 
822
+ /**
823
+ * A repository whose skills lived in `skills/` connected, got an empty
824
+ * `Skills/` scaffolded beside it and imported nothing, with no word anywhere.
825
+ * The folder fields are now in plain sight and checked against what the
826
+ * repository actually has.
827
+ */
828
+ describe('SetupScreen — the three root folders', () => {
829
+ const FOLDER_LABELS = ['Knowledge folder', 'Skills folder', 'Plugins folder'];
830
+ const LISTED = {
831
+ ok: true,
832
+ empty: false,
833
+ branches: ['main'],
834
+ defaultBranch: 'main',
835
+ rootFolders: ['KnowledgeBase', 'skills', 'Data'],
836
+ };
837
+ const stateOf = (key: string) => document.getElementById(`${key}-repo-state`);
838
+
839
+ function expectInMainSection() {
840
+ const card = screen.getByRole('heading', { name: 'Knowledge, skills & tools' }).closest('section')!;
841
+ const advanced = card.querySelector('details')!;
842
+ for (const label of FOLDER_LABELS) {
843
+ const field = screen.getByLabelText(label);
844
+ expect(card).toContainElement(field);
845
+ expect(advanced).not.toContainElement(field);
846
+ }
847
+ }
848
+
849
+ it('shows the fields in the main section on first run', async () => {
850
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS });
851
+ render(<SetupGate>{APP}</SetupGate>);
852
+ await screen.findByRole('heading', { name: /Set up this deployment/ });
853
+ expectInMainSection();
854
+ expect(screen.getByText(/The three folder names must differ\. Case matters/)).toBeInTheDocument();
855
+ });
856
+
857
+ it('shows the fields in the main section on the Deployment page', () => {
858
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
859
+ expectInMainSection();
860
+ });
861
+
862
+ it('says found, will be created, or names the folder that differs only by case', async () => {
863
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
864
+ api.testConnection.mockResolvedValue(LISTED);
865
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://x/y.git');
866
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
867
+ await screen.findByText(/Found 1 branch/);
868
+
869
+ expect(stateOf('knowledgeBaseDir')).toHaveTextContent('KnowledgeBase found in the repository.');
870
+ expect(stateOf('pluginsDir')).toHaveTextContent(
871
+ 'Plugins is not in the repository yet — it will be created.',
872
+ );
873
+ expect(stateOf('skillsDir')).toHaveTextContent(
874
+ 'Not found — the repository has skills (differs only by case): set this field to skills or rename the folder.',
875
+ );
876
+
877
+ // Taking the advice says found at once.
878
+ await userEvent.type(screen.getByLabelText('Skills folder'), 'skills');
879
+ expect(stateOf('skillsDir')).toHaveTextContent('skills found in the repository.');
880
+ });
881
+
882
+ it('names a folder that differs by case and a trailing s', async () => {
883
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
884
+ api.testConnection.mockResolvedValue({ ...LISTED, rootFolders: ['skill'] });
885
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
886
+ await waitFor(() =>
887
+ expect(stateOf('skillsDir')).toHaveTextContent(
888
+ 'Not found — the repository has skill (differs by case and a trailing s)',
889
+ ),
890
+ );
891
+ });
892
+
893
+ it('names a folder that differs only by a trailing s', async () => {
894
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
895
+ api.testConnection.mockResolvedValue({ ...LISTED, rootFolders: ['Skill'] });
896
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
897
+ await waitFor(() =>
898
+ expect(stateOf('skillsDir')).toHaveTextContent(
899
+ 'Not found — the repository has Skill (differs only by a trailing s): set this field to Skill or rename the folder.',
900
+ ),
901
+ );
902
+ });
903
+
904
+ it('offers the listed folders as suggestions on the three fields, less the ones no root may take', async () => {
905
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
906
+ expect(screen.getByLabelText('Skills folder')).not.toHaveAttribute('list');
907
+ api.testConnection.mockResolvedValue({ ...LISTED, rootFolders: ['.github', ...LISTED.rootFolders, 'Agents'] });
908
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
909
+ await screen.findByText(/Found 1 branch/);
910
+ for (const label of FOLDER_LABELS) {
911
+ const list = screen.getByLabelText(label).getAttribute('list');
912
+ expect(list).toBeTruthy();
913
+ const options = [...document.querySelectorAll(`#${list} option`)].map((o) => o.getAttribute('value'));
914
+ // `.github`, `Data` and `Agents` would each fail the save's validation.
915
+ expect(options).toEqual(['KnowledgeBase', 'skills']);
916
+ }
917
+ });
918
+
919
+ it('shows only the empty-repository message for an empty repository', async () => {
920
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
921
+ api.testConnection.mockResolvedValue({ ok: true, empty: true, branches: [], defaultBranch: null, rootFolders: [] });
922
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
923
+ expect(await screen.findByText(/repository is empty; it will be set up for you/)).toBeInTheDocument();
924
+ expect(screen.queryByText(/will be created/)).toBeNull();
925
+ for (const key of ['knowledgeBaseDir', 'skillsDir', 'pluginsDir']) expect(stateOf(key)).toBeNull();
926
+ });
927
+
928
+ it('says nothing about the folders when they could not be listed', async () => {
929
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
930
+ api.testConnection.mockResolvedValue({ ...LISTED, rootFolders: null });
931
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
932
+ await screen.findByText(/Found 1 branch/);
933
+ expect(stateOf('skillsDir')).toBeNull();
934
+ });
935
+
936
+ it('never blocks the save over a folder warning', async () => {
937
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
938
+ api.testConnection.mockResolvedValue(LISTED);
939
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: SETTINGS });
940
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://x/y.git');
941
+ await userEvent.type(screen.getByLabelText('Access token'), 'ghp_x');
942
+ await userEvent.click(screen.getByRole('button', { name: 'Test connection' }));
943
+ await waitFor(() => expect(stateOf('skillsDir')).toHaveTextContent(/differs only by case/));
944
+
945
+ const save = screen.getByRole('button', { name: 'Save and continue' });
946
+ expect(save).toBeEnabled();
947
+ await userEvent.click(save);
948
+ await waitFor(() => expect(api.saveSettings).toHaveBeenCalled());
949
+ });
950
+
951
+ it('checks the folders on a save that proves the connection', async () => {
952
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} />);
953
+ api.testConnection.mockResolvedValue(LISTED);
954
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: false, settings: SETTINGS });
955
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://x/y.git');
956
+ await userEvent.click(screen.getByRole('button', { name: 'Save and continue' }));
957
+ await waitFor(() => expect(api.saveSettings).toHaveBeenCalled());
958
+ expect(stateOf('skillsDir')).toHaveTextContent(/the repository has skills/);
959
+ expect(stateOf('pluginsDir')).toHaveTextContent(/will be created/);
960
+ });
961
+ });
962
+
747
963
  describe('SetupScreen — remote sync panel', () => {
748
964
  const SYNC_SETTING: SettingStatus = {
749
965
  key: 'kbSyncSecret', envVar: 'KB_SYNC_SECRET', section: KB, source: 'unset', configured: false, secret: true, restartToApply: false,
@@ -838,6 +1054,211 @@ describe('SetupScreen — remote sync panel', () => {
838
1054
  });
839
1055
  });
840
1056
 
1057
+ /**
1058
+ * The completing save stored everything, but the knowledge base behind the
1059
+ * gate could not be initialized. The admin is told what to fix — the server's
1060
+ * classified sentence, never git's raw words — and can retry without typing
1061
+ * anything again.
1062
+ */
1063
+ describe('SetupScreen — a failed knowledge-base initialization', () => {
1064
+ const WRITE_REFUSED = {
1065
+ kind: 'write-refused' as const,
1066
+ cause: 'The token can read the repository but not write to it — grant it write (push) access to the repository, then retry.',
1067
+ };
1068
+ const POLICY = {
1069
+ kind: 'push-refused-by-policy' as const,
1070
+ cause: "A branch protection rule or hook on the repository refused the initialization push — allow the deployment's account to push to the protected branches, then retry.",
1071
+ };
1072
+ const HEADLINE = 'Saved, but the knowledge base could not be initialized';
1073
+
1074
+ it('shows a standing failure when the screen is opened, without a new save', async () => {
1075
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS, kbInit: WRITE_REFUSED });
1076
+ render(<SetupGate>{APP}</SetupGate>);
1077
+ const banner = await screen.findByTestId('kb-init-failure');
1078
+ expect(banner).toHaveTextContent(HEADLINE);
1079
+ expect(banner).toHaveTextContent(WRITE_REFUSED.cause);
1080
+ expect(within(banner).getByRole('button', { name: 'Retry initialization' })).toBeEnabled();
1081
+ expect(api.saveSettings).not.toHaveBeenCalled();
1082
+ // Nothing tells the admin that restarting is the remedy.
1083
+ expect(banner).not.toHaveTextContent(/restart/i);
1084
+ });
1085
+
1086
+ it('shows the classified banner right after the failing save, not a generic error', async () => {
1087
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS });
1088
+ api.testConnection.mockResolvedValue({ ok: true, branches: ['main'], defaultBranch: 'main' });
1089
+ render(<SetupGate>{APP}</SetupGate>);
1090
+ await screen.findByRole('heading', { name: /Set up this deployment/ });
1091
+ api.saveSettings.mockRejectedValue(new KbInitFailed(POLICY));
1092
+ // The refetch after the save carries the same standing failure.
1093
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS, kbInit: POLICY });
1094
+
1095
+ await userEvent.type(screen.getByLabelText('Repository address'), 'https://x/y.git');
1096
+ await userEvent.type(screen.getByLabelText('Access token'), 'ghp_x');
1097
+ await userEvent.click(screen.getByRole('button', { name: 'Save and continue' }));
1098
+
1099
+ const banner = await screen.findByTestId('kb-init-failure');
1100
+ expect(banner).toHaveTextContent(HEADLINE);
1101
+ expect(banner).toHaveTextContent(POLICY.cause);
1102
+ // One banner, not the failure AND a generic "could not save".
1103
+ expect(screen.getAllByRole('alert')).toHaveLength(1);
1104
+ expect(reload).not.toHaveBeenCalled();
1105
+ });
1106
+
1107
+ it('retry: re-runs with nothing re-entered, shows it running, then opens the app', async () => {
1108
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS, kbInit: WRITE_REFUSED });
1109
+ render(<SetupGate>{APP}</SetupGate>);
1110
+ await screen.findByTestId('kb-init-failure');
1111
+ let finish!: (v: unknown) => void;
1112
+ api.saveSettings.mockReturnValue(new Promise((r) => (finish = r)));
1113
+
1114
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1115
+
1116
+ expect(api.saveSettings).toHaveBeenCalledWith({});
1117
+ const running = screen.getByRole('button', { name: 'Initializing…' });
1118
+ expect(running).toBeDisabled();
1119
+ // The form's own save cannot race the run.
1120
+ expect(screen.getByRole('button', { name: 'Save and continue' })).toBeDisabled();
1121
+
1122
+ finish({ restartRequired: false, complete: true, settings: SETTINGS });
1123
+ await waitFor(() => expect(reload).toHaveBeenCalled());
1124
+ });
1125
+
1126
+ it('retry: a fresh failure replaces the banner, and the button can be pressed again', async () => {
1127
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS, kbInit: WRITE_REFUSED });
1128
+ render(<SetupGate>{APP}</SetupGate>);
1129
+ await screen.findByTestId('kb-init-failure');
1130
+ api.saveSettings.mockRejectedValue(new KbInitFailed(POLICY));
1131
+
1132
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1133
+
1134
+ const banner = await screen.findByTestId('kb-init-failure');
1135
+ await waitFor(() => expect(banner).toHaveTextContent(POLICY.cause));
1136
+ expect(banner).not.toHaveTextContent(WRITE_REFUSED.cause);
1137
+ expect(within(banner).getByRole('button', { name: 'Retry initialization' })).toBeEnabled();
1138
+ expect(reload).not.toHaveBeenCalled();
1139
+ });
1140
+
1141
+ it('settings mode: a retry that succeeds clears the banner and refreshes', async () => {
1142
+ const onSaved = vi.fn();
1143
+ render(<SetupScreen settings={SETTINGS} onSaved={onSaved} variant="settings" kbInit={WRITE_REFUSED} />);
1144
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: SETTINGS });
1145
+
1146
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1147
+
1148
+ await waitFor(() => expect(screen.queryByTestId('kb-init-failure')).toBeNull());
1149
+ expect(onSaved).toHaveBeenCalled();
1150
+ expect(reload).not.toHaveBeenCalled();
1151
+ });
1152
+
1153
+ it('settings mode: a retry that lands awaiting a restart still refreshes the host', async () => {
1154
+ const onSaved = vi.fn();
1155
+ render(<SetupScreen settings={SETTINGS} onSaved={onSaved} variant="settings" kbInit={WRITE_REFUSED} />);
1156
+ api.saveSettings.mockResolvedValue({ restartRequired: true, complete: false, awaitingRestart: true, settings: SETTINGS });
1157
+
1158
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1159
+
1160
+ expect(await screen.findByText(/needs a restart/)).toBeInTheDocument();
1161
+ expect(onSaved).toHaveBeenCalled();
1162
+ expect(screen.queryByTestId('kb-init-failure')).toBeNull();
1163
+ });
1164
+
1165
+ it('retry waits while the form has unsaved changes — Save is the retry that carries them', async () => {
1166
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" kbInit={WRITE_REFUSED} />);
1167
+ const retry = screen.getByRole('button', { name: 'Retry initialization' });
1168
+ expect(retry).toBeEnabled();
1169
+
1170
+ await userEvent.type(screen.getByLabelText('Access token'), 'ghp_corrected');
1171
+
1172
+ expect(retry).toBeDisabled();
1173
+ expect(screen.getByTestId('kb-init-failure')).toHaveTextContent(/unsaved changes/i);
1174
+ await userEvent.click(retry);
1175
+ expect(api.saveSettings).not.toHaveBeenCalled();
1176
+ });
1177
+
1178
+ it('retry comes back once an edit is put back — an unchanged value is not an unsaved change', async () => {
1179
+ const REPO = 'https://github.com/acme/kb.git';
1180
+ const stored = SETTINGS.map((s) =>
1181
+ s.key === 'kbRepoUrl'
1182
+ ? { ...s, source: 'stored' as const, value: REPO, configured: true }
1183
+ : s.key === 'gitUsername'
1184
+ ? { ...s, source: 'stored' as const, value: 'x-access-token', configured: true }
1185
+ : s,
1186
+ );
1187
+ render(<SetupScreen settings={stored} onSaved={vi.fn()} variant="settings" kbInit={WRITE_REFUSED} />);
1188
+ const address = screen.getByLabelText('Repository address');
1189
+ const retry = screen.getByRole('button', { name: 'Retry initialization' });
1190
+
1191
+ await userEvent.type(address, '-old');
1192
+ expect(retry).toBeDisabled();
1193
+ await userEvent.type(address, '{Backspace}{Backspace}{Backspace}{Backspace}');
1194
+
1195
+ expect(retry).toBeEnabled();
1196
+ expect(screen.getByTestId('kb-init-failure')).not.toHaveTextContent(/unsaved changes/i);
1197
+ });
1198
+
1199
+ it('a username filled in from the address is not an unsaved change of its own', async () => {
1200
+ // Stored username blank: the address fills in x-access-token, which differs from it.
1201
+ const stored = SETTINGS.map((s) =>
1202
+ s.key === 'kbRepoUrl' ? { ...s, source: 'stored' as const, value: 'https://github.com/acme/kb.git', configured: true } : s,
1203
+ );
1204
+ render(<SetupScreen settings={stored} onSaved={vi.fn()} variant="settings" kbInit={WRITE_REFUSED} />);
1205
+ const address = screen.getByLabelText('Repository address');
1206
+ const retry = screen.getByRole('button', { name: 'Retry initialization' });
1207
+
1208
+ // Inside the closed Advanced block, but in the form all the same.
1209
+ const username = screen.getByLabelText('Token username');
1210
+ expect(username).toHaveValue('');
1211
+
1212
+ await userEvent.type(address, '-x');
1213
+ // The address DID fill the username in — that is what this test is about.
1214
+ expect(username).toHaveValue('x-access-token');
1215
+ expect(retry).toBeDisabled();
1216
+ await userEvent.type(address, '{Backspace}{Backspace}');
1217
+ expect(retry).toBeEnabled();
1218
+
1219
+ // Cleared, the address means "leave it alone". The username it filled in
1220
+ // stays filled in, and is still not an edit.
1221
+ await userEvent.clear(address);
1222
+ expect(username).toHaveValue('x-access-token');
1223
+ expect(retry).toBeEnabled();
1224
+ });
1225
+
1226
+ it('a late status answer cannot bring back a failure this screen just saw cleared', async () => {
1227
+ const onSaved = vi.fn();
1228
+ const screenWith = (kbInit?: typeof WRITE_REFUSED | typeof POLICY) => (
1229
+ <SetupScreen settings={SETTINGS} onSaved={onSaved} variant="settings" kbInit={kbInit} />
1230
+ );
1231
+ const { rerender } = render(screenWith(WRITE_REFUSED));
1232
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: SETTINGS });
1233
+
1234
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1235
+ await waitFor(() => expect(screen.queryByTestId('kb-init-failure')).toBeNull());
1236
+
1237
+ // The read sent before the retry answers now: a new object, the same failure.
1238
+ rerender(screenWith({ ...WRITE_REFUSED }));
1239
+ expect(screen.queryByTestId('kb-init-failure')).toBeNull();
1240
+ // A DIFFERENT failure is news, and shows.
1241
+ rerender(screenWith(POLICY));
1242
+ expect(screen.getByTestId('kb-init-failure')).toHaveTextContent(POLICY.cause);
1243
+ });
1244
+
1245
+ it('after a read agrees the failure cleared, the same failure reported again is shown', async () => {
1246
+ const onSaved = vi.fn();
1247
+ const screenWith = (kbInit?: typeof WRITE_REFUSED) => (
1248
+ <SetupScreen settings={SETTINGS} onSaved={onSaved} variant="settings" kbInit={kbInit} />
1249
+ );
1250
+ const { rerender } = render(screenWith(WRITE_REFUSED));
1251
+ api.saveSettings.mockResolvedValue({ restartRequired: false, complete: true, settings: SETTINGS });
1252
+ await userEvent.click(screen.getByRole('button', { name: 'Retry initialization' }));
1253
+ await waitFor(() => expect(screen.queryByTestId('kb-init-failure')).toBeNull());
1254
+
1255
+ rerender(screenWith(undefined));
1256
+ rerender(screenWith({ ...WRITE_REFUSED }));
1257
+
1258
+ expect(screen.getByTestId('kb-init-failure')).toHaveTextContent(WRITE_REFUSED.cause);
1259
+ });
1260
+ });
1261
+
841
1262
  describe('SetupScreen — sync panel when the whole knowledge base is env-set', () => {
842
1263
  it('still renders the address and Sync now, in a section of its own', () => {
843
1264
  const KB_FROM_ENV: SettingStatus[] = SETTINGS.map((s) =>
@@ -859,3 +1280,75 @@ describe('SetupScreen — sync panel when the whole knowledge base is env-set',
859
1280
  expect(screen.getByRole('heading', { name: 'Repository sync' })).toBeTruthy();
860
1281
  });
861
1282
  });
1283
+
1284
+ /**
1285
+ * The agent guide's file name, and the one thing that rides with it: the
1286
+ * sentence the platform would add to the customer's own `AGENTS.md`, and the
1287
+ * consent to keep it there.
1288
+ */
1289
+ describe('SetupScreen — the agent guide file', () => {
1290
+ async function renderScreen(variant: 'setup' | 'settings' = 'setup') {
1291
+ api.fetchSetupStatus.mockResolvedValue({ complete: false, isAdmin: true, settings: SETTINGS });
1292
+ if (variant === 'settings') {
1293
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1294
+ return;
1295
+ }
1296
+ render(<SetupGate>{APP}</SetupGate>);
1297
+ await screen.findByRole('heading', { name: /Set up this deployment/ });
1298
+ }
1299
+
1300
+ it('offers the field on first run, beside the three folder names', async () => {
1301
+ await renderScreen();
1302
+ expect(screen.getByLabelText('Agent guide file')).toHaveValue('');
1303
+ // Not tucked under Advanced, for the same reason the folders are not: a
1304
+ // repository that already has an AGENTS.md loses it unless this is
1305
+ // answered before the first boot.
1306
+ expect(screen.getByLabelText('Knowledge folder')).toBeInTheDocument();
1307
+ });
1308
+
1309
+ it('offers it on the Deployment settings page too', async () => {
1310
+ await renderScreen('settings');
1311
+ expect(screen.getByLabelText('Agent guide file')).toBeInTheDocument();
1312
+ });
1313
+
1314
+ it('shows nothing about a pointer while the guide is still AGENTS.md', async () => {
1315
+ await renderScreen('settings');
1316
+ expect(screen.queryByTestId('agents-file-link')).toBeNull();
1317
+ await userEvent.type(screen.getByLabelText('Agent guide file'), 'AGENTS.md');
1318
+ expect(screen.queryByTestId('agents-file-link')).toBeNull();
1319
+ });
1320
+
1321
+ it('shows the exact sentence and a ticked box once the name differs', async () => {
1322
+ await renderScreen('settings');
1323
+ await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.md');
1324
+ const panel = within(screen.getByTestId('agents-file-link'));
1325
+ // On by default — a renamed guide nothing points at is a guide no coding
1326
+ // agent will find.
1327
+ expect(panel.getByRole('checkbox')).toBeChecked();
1328
+ // The sentence itself, from the same helper the server appends with.
1329
+ expect(panel.getByText(agentsFilePointerSentence('HEXIS.md'))).toBeInTheDocument();
1330
+ });
1331
+
1332
+ it('saves the name and the consent the admin actually gave', async () => {
1333
+ api.saveSettings.mockResolvedValue({ restartRequired: true, complete: false, settings: SETTINGS });
1334
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1335
+ await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.md');
1336
+ await userEvent.click(within(screen.getByTestId('agents-file-link')).getByRole('checkbox'));
1337
+ await userEvent.click(screen.getByRole('button', { name: /Save/ }));
1338
+ await waitFor(() =>
1339
+ expect(api.saveSettings).toHaveBeenCalledWith(
1340
+ expect.objectContaining({ agentsFile: 'HEXIS.md', agentsFileLink: 'false' }),
1341
+ ),
1342
+ );
1343
+ });
1344
+
1345
+ it('shows the server\'s rule against a name it refused', async () => {
1346
+ api.saveSettings.mockRejectedValue(
1347
+ new SettingsProblems({ agentsFile: 'The name must end in .md.' }),
1348
+ );
1349
+ render(<SetupScreen settings={SETTINGS} onSaved={vi.fn()} variant="settings" />);
1350
+ await userEvent.type(screen.getByLabelText('Agent guide file'), 'HEXIS.txt');
1351
+ await userEvent.click(screen.getByRole('button', { name: /Save/ }));
1352
+ expect(await screen.findByText('The name must end in .md.')).toBeInTheDocument();
1353
+ });
1354
+ });