@bevel-software/platform-core-frontend 0.14.0 → 0.19.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 (360) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +34 -26
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/bootstrap.test.ts +33 -1
  6. package/src/core/__tests__/events.test.ts +43 -0
  7. package/src/core/bootstrap.ts +38 -1
  8. package/src/core/events.ts +85 -3
  9. package/src/core/registry.ts +1 -1
  10. package/src/lib/__tests__/api.test.ts +38 -0
  11. package/src/lib/__tests__/email.test.ts +44 -0
  12. package/src/lib/api.ts +19 -2
  13. package/src/lib/email.ts +37 -1
  14. package/src/lib/utils.ts +2 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  16. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  20. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  21. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  22. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  23. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  24. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +781 -76
  25. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  26. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  27. package/src/modules/access/__tests__/plugin-token.test.ts +21 -0
  28. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  29. package/src/modules/access/api.ts +192 -10
  30. package/src/modules/access/components/ManageAccessDialog.tsx +1337 -570
  31. package/src/modules/access/manage-access-affordance.ts +17 -0
  32. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  33. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  34. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  35. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  36. package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
  37. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  38. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  39. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  40. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  41. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  42. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  43. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  44. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  45. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  46. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  47. package/src/modules/admin/components/group-members-path.ts +32 -0
  48. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  49. package/src/modules/admin/services/roles.api.ts +12 -1
  50. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  51. package/src/modules/auth/components/AccountPage.tsx +73 -54
  52. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  53. package/src/modules/auth/services/account.api.ts +78 -4
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  58. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  59. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  60. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  61. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  62. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  63. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  64. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  65. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  66. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  67. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  68. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  69. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  70. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  71. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  72. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  73. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  74. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  75. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  76. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  77. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  78. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  79. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  80. package/src/modules/change-requests/services/propose.api.ts +97 -8
  81. package/src/modules/change-requests/utils/approval.ts +15 -0
  82. package/src/modules/change-requests/utils/author.ts +32 -0
  83. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  84. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  85. package/src/modules/git/__tests__/GitSyncFailedBanner.test.tsx +65 -1
  86. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  87. package/src/modules/git/components/GitSyncFailedBanner.tsx +68 -5
  88. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  89. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  90. package/src/modules/git/services/error-messages.ts +12 -0
  91. package/src/modules/git/services/pr-prompts.ts +5 -5
  92. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  93. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  94. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  95. package/src/modules/layout/components/AppLayout.tsx +2 -0
  96. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  97. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  98. package/src/modules/layout/components/SidebarFrame.tsx +109 -4
  99. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  100. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  101. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  102. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  103. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  104. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +104 -99
  105. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +136 -0
  106. package/src/modules/library/__tests__/LockedPluginView.test.tsx +103 -7
  107. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +18 -8
  108. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  109. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  110. package/src/modules/library/__tests__/PluginExtras.test.tsx +115 -9
  111. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  112. package/src/modules/library/__tests__/PluginPage.test.tsx +453 -7
  113. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +17 -57
  114. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +161 -97
  115. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  116. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  117. package/src/modules/library/__tests__/SkillPage.test.tsx +391 -78
  118. package/src/modules/library/__tests__/SkillsTree.test.tsx +461 -0
  119. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  120. package/src/modules/library/__tests__/ToolPage.test.tsx +94 -4
  121. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +279 -21
  122. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  123. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  124. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  125. package/src/modules/library/__tests__/library-data.stale.test.tsx +183 -0
  126. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  127. package/src/modules/library/__tests__/library-paths.test.ts +75 -0
  128. package/src/modules/library/__tests__/link-membership.test.ts +129 -0
  129. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  130. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  131. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  132. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  133. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  134. package/src/modules/library/__tests__/plugin-summary.test.ts +67 -0
  135. package/src/modules/library/__tests__/status.test.ts +82 -2
  136. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  137. package/src/modules/library/__tests__/useJoinRequests.test.tsx +46 -0
  138. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  139. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  140. package/src/modules/library/components/AddToPluginDialog.tsx +107 -18
  141. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  142. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  143. package/src/modules/library/components/LibraryCard.tsx +149 -34
  144. package/src/modules/library/components/LibraryLayout.tsx +120 -247
  145. package/src/modules/library/components/LibraryPage.tsx +172 -39
  146. package/src/modules/library/components/LinkSkillPanel.tsx +169 -0
  147. package/src/modules/library/components/LockedPluginView.tsx +63 -35
  148. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  149. package/src/modules/library/components/NewPluginDialog.tsx +19 -5
  150. package/src/modules/library/components/PageActions.tsx +31 -9
  151. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  152. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  153. package/src/modules/library/components/PersonalPluginPage.tsx +123 -23
  154. package/src/modules/library/components/PluginExtras.tsx +143 -18
  155. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  156. package/src/modules/library/components/PluginPage.tsx +234 -38
  157. package/src/modules/library/components/PluginRows.tsx +286 -0
  158. package/src/modules/library/components/PluginsSidebar.tsx +271 -238
  159. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  160. package/src/modules/library/components/RenamePluginDialog.tsx +136 -0
  161. package/src/modules/library/components/ShareButton.tsx +17 -0
  162. package/src/modules/library/components/SkillsTree.tsx +204 -0
  163. package/src/modules/library/components/StatusDot.tsx +1 -0
  164. package/src/modules/library/components/TeamRoute.tsx +15 -0
  165. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  166. package/src/modules/library/components/plugin-page-parts.tsx +132 -23
  167. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +212 -0
  168. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  169. package/src/modules/library/components/skill-page/SkillPage.tsx +337 -121
  170. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  171. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  172. package/src/modules/library/components/tool-page/ToolPage.tsx +116 -17
  173. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  174. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  175. package/src/modules/library/hooks/useJoinRequests.ts +48 -18
  176. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  177. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  178. package/src/modules/library/routes/WorkspaceItemRoute.tsx +229 -82
  179. package/src/modules/library/routes/library-paths.ts +46 -35
  180. package/src/modules/library/services/library.api.ts +89 -17
  181. package/src/modules/library/services/plugins.api.ts +161 -9
  182. package/src/modules/library/services/teams.api.ts +15 -0
  183. package/src/modules/library/services/tools.api.ts +78 -0
  184. package/src/modules/library/state/library-data.tsx +268 -37
  185. package/src/modules/library/utils/personal-plugin.ts +13 -15
  186. package/src/modules/library/utils/plugin-entries.ts +134 -0
  187. package/src/modules/library/utils/plugin-summary.ts +102 -0
  188. package/src/modules/library/utils/status.ts +204 -35
  189. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +11 -3
  190. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  191. package/src/modules/onboarding/agent-clients.ts +55 -23
  192. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  193. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  194. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  195. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  196. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  197. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  198. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  199. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  200. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  201. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  202. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  203. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  204. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  205. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  206. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  207. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  208. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  209. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  210. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  211. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  212. package/src/modules/settings/components/ClaudeConnectionCard.tsx +154 -0
  213. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  214. package/src/modules/settings/components/DeploymentPage.tsx +16 -22
  215. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  216. package/src/modules/settings/components/__tests__/ClaudeConnectionCard.test.tsx +63 -0
  217. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +74 -1
  218. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  219. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  220. package/src/modules/settings/services/github-facade.api.ts +66 -0
  221. package/src/modules/settings/settings-nav-items.tsx +10 -2
  222. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  223. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  224. package/src/modules/setup/__tests__/setup.test.tsx +615 -4
  225. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  226. package/src/modules/setup/components/SetupGate.tsx +16 -16
  227. package/src/modules/setup/components/SetupScreen.tsx +711 -40
  228. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  229. package/src/modules/setup/services/setup.api.ts +218 -3
  230. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  231. package/src/modules/setup/utils/root-folders.ts +46 -0
  232. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  233. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  234. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  235. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  236. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  237. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  238. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  239. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  240. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  241. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  242. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  243. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  244. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  245. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  246. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  247. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  248. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +395 -124
  249. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  250. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  251. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  252. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +659 -36
  253. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  254. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  255. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  256. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  257. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  258. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  259. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  260. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  261. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  262. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  263. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  264. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  265. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  266. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  267. package/src/modules/workspace/__tests__/testFixtures.ts +6 -3
  268. package/src/modules/workspace/components/FileExplorer.tsx +1527 -367
  269. package/src/modules/workspace/components/FileRoute.tsx +376 -22
  270. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  271. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  272. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  273. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  274. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  275. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +768 -16
  276. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +332 -12
  277. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  278. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  279. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  280. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  281. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  282. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  283. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  284. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  285. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  286. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  287. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  288. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  289. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  290. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  291. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  292. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  293. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  294. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  295. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  296. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  297. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  298. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  299. package/src/modules/workspace/components/renderers/index.ts +53 -2
  300. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  301. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  302. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  303. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  304. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  305. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  306. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  307. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +89 -0
  308. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  309. package/src/modules/workspace/hooks/useWorkspaceState.ts +438 -66
  310. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  311. package/src/modules/workspace/routing/kb-routes.ts +207 -30
  312. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  313. package/src/modules/workspace/services/workspace.api.ts +57 -4
  314. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  315. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  316. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  317. package/src/modules/workspace/state/workspace.context.ts +130 -16
  318. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  319. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +234 -5
  320. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  321. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  322. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  323. package/src/modules/workspace/utils/file-trace.ts +50 -0
  324. package/src/modules/workspace/utils/fileTree.ts +126 -52
  325. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  326. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  327. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  328. package/src/modules/workspace/utils/uploadError.ts +29 -0
  329. package/src/shared/__tests__/marketplace-url.test.ts +59 -0
  330. package/src/shared/components/Badge.tsx +3 -1
  331. package/src/shared/components/Banner.tsx +5 -1
  332. package/src/shared/components/Button.tsx +16 -2
  333. package/src/shared/components/Dialog.tsx +27 -11
  334. package/src/shared/components/Menu.tsx +13 -1
  335. package/src/shared/components/PageShell.tsx +13 -8
  336. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  337. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  338. package/src/shared/components/index.ts +2 -0
  339. package/src/shared/components/useDismissableMenu.ts +32 -10
  340. package/src/shared/components/useFocusHandoff.ts +51 -0
  341. package/src/shared/components/useLatestRef.ts +28 -0
  342. package/src/shared/markdown/Markdown.tsx +12 -3
  343. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  344. package/src/shared/markdown/hrefs.ts +50 -0
  345. package/src/shared/marketplace-url.ts +118 -0
  346. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  347. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  348. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  349. package/src/shared/mcp/connect-snippets.ts +14 -9
  350. package/src/shared/mcp/index.ts +1 -1
  351. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  352. package/src/shared/theme/header.ts +75 -0
  353. package/src/shared/theme/measure.ts +7 -4
  354. package/src/shared/theme/tokens.css +34 -0
  355. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  356. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  357. package/src/modules/library/components/PluginsIndexPage.tsx +0 -265
  358. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  359. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  360. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -1,11 +1,12 @@
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(() => ({
6
6
  fetchSetupStatus: vi.fn(),
7
7
  saveSettings: vi.fn(),
8
8
  testConnection: vi.fn(),
9
+ syncNow: vi.fn(),
9
10
  }));
10
11
  vi.mock('../services/setup.api', async () => {
11
12
  // The error class is real — the screen distinguishes field problems from a
@@ -16,9 +17,20 @@ vi.mock('../services/setup.api', async () => {
16
17
  return { ...actual, ...api };
17
18
  });
18
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';
19
31
  import { SetupGate } from '../components/SetupGate';
20
32
  import { SetupScreen } from '../components/SetupScreen';
21
- import { SettingsProblems, type SettingStatus } from '../services/setup.api';
33
+ import { KbInitFailed, SettingsProblems, type SettingStatus } from '../services/setup.api';
22
34
 
23
35
  const KB = 'knowledge-base' as const;
24
36
  const SETTINGS: SettingStatus[] = [
@@ -26,9 +38,15 @@ const SETTINGS: SettingStatus[] = [
26
38
  { key: 'gitToken', envVar: 'GIT_TOKEN', section: KB, source: 'unset', configured: false, secret: true, restartToApply: false },
27
39
  { key: 'gitUsername', envVar: 'GIT_USERNAME', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: false },
28
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 },
29
47
  { key: 'defaultBranch', envVar: 'DEFAULT_BRANCH', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
30
48
  { key: 'protectedBranches', envVar: 'PROTECTED_BRANCHES', section: KB, source: 'unset', value: '', configured: false, secret: false, restartToApply: true },
31
- { 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 },
32
50
  ];
33
51
 
34
52
  /**
@@ -43,6 +61,7 @@ beforeEach(() => {
43
61
  api.fetchSetupStatus.mockReset();
44
62
  api.saveSettings.mockReset();
45
63
  api.testConnection.mockReset();
64
+ api.syncNow.mockReset();
46
65
  reload = vi.fn();
47
66
  Object.defineProperty(window, 'location', {
48
67
  configurable: true,
@@ -126,6 +145,34 @@ describe('SetupScreen', () => {
126
145
  await waitFor(() => expect(reload).toHaveBeenCalled());
127
146
  });
128
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
+
129
176
  /**
130
177
  * The whole reason a form beats an environment variable: it can ask the host
131
178
  * whether the answer is right, and say which part was wrong — before anything
@@ -344,6 +391,34 @@ describe('SetupScreen', () => {
344
391
  expect(api.testConnection).not.toHaveBeenCalled();
345
392
  });
346
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
+
347
422
  /** An empty repository is a supported starting point, not a failure. */
348
423
  it('treats an empty repository as a success', async () => {
349
424
  await renderScreen();
@@ -729,7 +804,9 @@ describe('SetupScreen', () => {
729
804
  /** Single sign-on is skippable, and the screen has to say so. */
730
805
  it('marks the optional section optional', async () => {
731
806
  await renderScreen();
732
- 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();
733
810
  });
734
811
 
735
812
  it('says so when a saved setting needs a restart', async () => {
@@ -741,3 +818,537 @@ describe('SetupScreen', () => {
741
818
  expect(await screen.findByText(/restart it when convenient/)).toBeInTheDocument();
742
819
  });
743
820
  });
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
+
963
+ describe('SetupScreen — remote sync panel', () => {
964
+ const SYNC_SETTING: SettingStatus = {
965
+ key: 'kbSyncSecret', envVar: 'KB_SYNC_SECRET', section: KB, source: 'unset', configured: false, secret: true, restartToApply: false,
966
+ };
967
+ const SYNC = {
968
+ url: 'https://hexis.example.test/api/sync',
969
+ last: {
970
+ at: Date.UTC(2026, 8, 4, 12, 0, 0),
971
+ by: 'github-signature',
972
+ status: 'synced' as const,
973
+ results: [{ branch: 'main', outcome: 'updated' as const, from: 'aaa', to: 'bbb' }],
974
+ },
975
+ };
976
+
977
+ it('shows the address a hook calls on first run, without a Sync now button', () => {
978
+ render(<SetupScreen settings={[...SETTINGS, SYNC_SETTING]} sync={SYNC} onSaved={() => {}} />);
979
+ expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
980
+ expect(screen.getByRole('button', { name: 'Copy the sync address' })).toBeTruthy();
981
+ // The 'setup' variant never offers the button or the history, whatever the
982
+ // record says: on first run the repository behind them is not connected yet.
983
+ expect(screen.queryByRole('button', { name: 'Sync now' })).toBeNull();
984
+ });
985
+
986
+ it('shows the address on the Deployment page too', () => {
987
+ render(
988
+ <SetupScreen settings={[...SETTINGS, SYNC_SETTING]} sync={SYNC} onSaved={() => {}} variant="settings" />,
989
+ );
990
+ expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
991
+ expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
992
+ });
993
+
994
+ it('keeps the panel when the secret is set by the environment', () => {
995
+ const fromEnv: SettingStatus = { ...SYNC_SETTING, source: 'env', configured: true };
996
+ render(
997
+ <SetupScreen settings={[...SETTINGS, fromEnv]} sync={SYNC} onSaved={() => {}} variant="settings" />,
998
+ );
999
+ // The secret itself is locked, listed under the environment…
1000
+ expect(screen.getByText('KB_SYNC_SECRET')).toBeTruthy();
1001
+ // …but the address, the history and Sync now are still there.
1002
+ expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
1003
+ expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
1004
+ });
1005
+
1006
+ it('on the Deployment page: says what the last sync did, and Sync now reports the result', async () => {
1007
+ api.syncNow.mockResolvedValue({
1008
+ ok: true,
1009
+ status: 'synced',
1010
+ results: [
1011
+ { branch: 'main', outcome: 'updated' },
1012
+ { branch: 'ali/x', outcome: 'up-to-date' },
1013
+ ],
1014
+ });
1015
+ const onSaved = vi.fn();
1016
+ render(
1017
+ <SetupScreen
1018
+ settings={[...SETTINGS, SYNC_SETTING]}
1019
+ sync={SYNC}
1020
+ onSaved={onSaved}
1021
+ variant="settings"
1022
+ />,
1023
+ );
1024
+ expect(screen.getByText(/Last sync .* by github-signature: main updated\./)).toBeTruthy();
1025
+
1026
+ await userEvent.click(screen.getByRole('button', { name: 'Sync now' }));
1027
+ await waitFor(() => expect(screen.getByText('Synced: main updated, ali/x up to date.')).toBeTruthy());
1028
+ expect(api.syncNow).toHaveBeenCalledTimes(1);
1029
+ // The status carries the last-sync record, so the page refetches it.
1030
+ expect(onSaved).toHaveBeenCalled();
1031
+ });
1032
+
1033
+ it('a conflict comes back as the branch’s own message', async () => {
1034
+ api.syncNow.mockResolvedValue({
1035
+ ok: false,
1036
+ status: 'partial',
1037
+ results: [
1038
+ { branch: 'main', outcome: 'conflict', error: 'main is not in sync yet: a.md changed both in Hexis and on the git host.' },
1039
+ ],
1040
+ });
1041
+ render(
1042
+ <SetupScreen
1043
+ settings={[...SETTINGS, SYNC_SETTING]}
1044
+ sync={{ ...SYNC, last: null }}
1045
+ onSaved={() => {}}
1046
+ variant="settings"
1047
+ />,
1048
+ );
1049
+ expect(screen.getByText('No sync since this server started.')).toBeTruthy();
1050
+ await userEvent.click(screen.getByRole('button', { name: 'Sync now' }));
1051
+ await waitFor(() =>
1052
+ expect(screen.getByText(/main is not in sync yet: a\.md changed both/)).toBeTruthy(),
1053
+ );
1054
+ });
1055
+ });
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
+
1262
+ describe('SetupScreen — sync panel when the whole knowledge base is env-set', () => {
1263
+ it('still renders the address and Sync now, in a section of its own', () => {
1264
+ const KB_FROM_ENV: SettingStatus[] = SETTINGS.map((s) =>
1265
+ s.section === 'knowledge-base' ? { ...s, source: 'env', configured: true } : s,
1266
+ );
1267
+ const syncFromEnv: SettingStatus = {
1268
+ key: 'kbSyncSecret', envVar: 'KB_SYNC_SECRET', section: 'knowledge-base', source: 'env', configured: true, secret: true, restartToApply: false,
1269
+ };
1270
+ render(
1271
+ <SetupScreen
1272
+ settings={[...KB_FROM_ENV, syncFromEnv]}
1273
+ sync={{ url: 'https://hexis.example.test/api/sync', last: null }}
1274
+ onSaved={() => {}}
1275
+ variant="settings"
1276
+ />,
1277
+ );
1278
+ expect(screen.getByText('https://hexis.example.test/api/sync/<branch>')).toBeTruthy();
1279
+ expect(screen.getByRole('button', { name: 'Sync now' })).toBeTruthy();
1280
+ expect(screen.getByRole('heading', { name: 'Repository sync' })).toBeTruthy();
1281
+ });
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
+ });