@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
@@ -0,0 +1,93 @@
1
+ import { useCallback, useEffect, useRef, useState } from 'react';
2
+ import { fetchSetupStatus, type SetupStatus } from '../services/setup.api';
3
+
4
+ export interface SetupStatusRead {
5
+ /** The latest status that arrived. A failed read does not clear it. */
6
+ status: SetupStatus | null;
7
+ /** The latest read failed. */
8
+ failed: boolean;
9
+ /** A read has settled at least once. */
10
+ loaded: boolean;
11
+ /** Read the status again — after a save, a sync, or a "Try again". */
12
+ refresh(): void;
13
+ }
14
+
15
+ /**
16
+ * Every mounted reader, so a refresh asked for by one reaches them all. The
17
+ * setup gate stays mounted for the app's whole life while the Deployment page
18
+ * comes and goes; a save on the page that leaves the deployment incomplete
19
+ * has to reach the gate, or the gate keeps showing the app over a server that
20
+ * has shut its setup gate. One status, read by several screens: a refresh is
21
+ * a fact about the deployment, not about the screen that asked.
22
+ */
23
+ const readers = new Set<() => void>();
24
+
25
+ /**
26
+ * The deployment's setup status, read the one way every screen that shows it
27
+ * reads it: the setup gate and the Deployment page.
28
+ *
29
+ * LATEST READ WINS. Reads overlap — the refresh after a failed save can still
30
+ * be out when a retry succeeds and asks again — and answers arrive in any
31
+ * order. An answer to an EARLIER read describes a deployment that has since
32
+ * moved on (it would put back the knowledge-base failure the retry just
33
+ * cleared), so only the latest read's answer, success or failure, lands.
34
+ *
35
+ * A FAILED READ KEEPS THE LAST STATUS and says it failed, so each host decides
36
+ * what that means: the gate lets the app through (the check is a guard, not an
37
+ * authorisation boundary), the Deployment page keeps the form and offers a
38
+ * retry.
39
+ *
40
+ * ONE REFRESH REACHES EVERY READER. `refresh()` re-reads on every mounted
41
+ * instance of this hook, not only the one it was called on, so a screen that
42
+ * changed the deployment cannot leave another showing the state before it.
43
+ *
44
+ * `enabled: false` never reads, and drops a read that was still out when it
45
+ * turned false — for a host that already knows the answer is not for this
46
+ * viewer.
47
+ */
48
+ export function useSetupStatus(enabled = true): SetupStatusRead {
49
+ const [status, setStatus] = useState<SetupStatus | null>(null);
50
+ const [failed, setFailed] = useState(false);
51
+ const [loaded, setLoaded] = useState(false);
52
+ /** The latest read; an answer to any earlier one is out of date. */
53
+ const latest = useRef(0);
54
+
55
+ const read = useCallback(() => {
56
+ if (!enabled) {
57
+ // Disabling outdates any read still out, exactly as a newer read would:
58
+ // its answer is for a viewer this hook no longer serves, and landing it
59
+ // would leave that status waiting for whenever reading is enabled again.
60
+ latest.current += 1;
61
+ return;
62
+ }
63
+ const request = ++latest.current;
64
+ const current = () => request === latest.current;
65
+ fetchSetupStatus()
66
+ .then((s) => {
67
+ if (!current()) return;
68
+ setStatus(s);
69
+ setFailed(false);
70
+ })
71
+ .catch(() => {
72
+ if (current()) setFailed(true);
73
+ })
74
+ .finally(() => {
75
+ if (current()) setLoaded(true);
76
+ });
77
+ }, [enabled]);
78
+
79
+ // Registered for as long as this instance is mounted; the mount reads once.
80
+ useEffect(() => {
81
+ readers.add(read);
82
+ read();
83
+ return () => {
84
+ readers.delete(read);
85
+ };
86
+ }, [read]);
87
+
88
+ const refresh = useCallback(() => {
89
+ for (const reader of readers) reader();
90
+ }, []);
91
+
92
+ return { status, failed, loaded, refresh };
93
+ }
@@ -1,10 +1,15 @@
1
+ import type { BranchSyncOutcome } from '@bevel-software/platform-shared';
1
2
  import { authFetch } from '../../../lib/api';
2
3
 
3
4
  /** One configurable setting, as the server describes it. */
4
5
  export interface SettingStatus {
5
6
  key: string;
6
- /** The environment variable that still wins if it is set. */
7
- envVar: string;
7
+ /**
8
+ * The environment variable that still wins if it is set. Absent for a
9
+ * setting no variable can override — the knowledge-base layout, which is
10
+ * entered here and nowhere else.
11
+ */
12
+ envVar?: string;
8
13
  section: 'knowledge-base' | 'sign-in';
9
14
  source: 'env' | 'stored' | 'unset';
10
15
  /** Absent for secrets — the server never sends a stored secret back. */
@@ -15,9 +20,66 @@ export interface SettingStatus {
15
20
  restartToApply: boolean;
16
21
  }
17
22
 
23
+ /** One branch's part in a remote sync, as `POST /api/sync` reports it — the shared union, so this cannot drift from the server. */
24
+ export type SyncBranchOutcome = BranchSyncOutcome;
25
+
26
+ /** The message a failed branch carries, if its outcome has one. */
27
+ export function syncOutcomeError(r: SyncBranchOutcome): string | undefined {
28
+ return r.outcome === 'conflict' || r.outcome === 'error' ? r.error : undefined;
29
+ }
30
+
31
+ /** What the most recent remote sync did — from the server's memory, so "none yet" after a restart. */
32
+ export interface LastSync {
33
+ /** Epoch ms. */
34
+ at: number;
35
+ /** A credential kind (`bearer`, `github-signature`, …) or an admin's email. */
36
+ by: string;
37
+ status: 'synced' | 'partial';
38
+ results: SyncBranchOutcome[];
39
+ }
40
+
41
+ /** The remote-sync facts shown beside the sync secret. Admins only. */
42
+ export interface SyncStatus {
43
+ /** `<backend>/api/sync` — a hook appends `/<branch>`. */
44
+ url: string;
45
+ last: LastSync | null;
46
+ }
47
+
48
+ /**
49
+ * Whether the single sign-on configuration in effect is known to work: proven
50
+ * against the provider (or by a sign-in), configured but unproven, absent — or
51
+ * configured with SECRETS_ENC_KEY unset (`unrecordable`), when no
52
+ * verification can be kept.
53
+ */
54
+ export type OidcVerification = 'verified' | 'unverified' | 'not-configured' | 'unrecordable';
55
+
56
+ /** Why the setup-time knowledge-base initialization failed — mirrors the backend's `GitFailureKind`. */
57
+ export type KbInitFailureKind =
58
+ | 'credentials-rejected'
59
+ | 'not-found'
60
+ | 'unreachable'
61
+ | 'write-refused'
62
+ | 'push-refused-by-policy'
63
+ | 'step-failed'
64
+ | 'unknown';
65
+
66
+ /**
67
+ * A failed initialization, as the server classifies it. `cause` is a sentence
68
+ * telling the admin what to do; the raw error never leaves the server log.
69
+ */
70
+ export interface KbInitFailure {
71
+ kind: KbInitFailureKind;
72
+ cause: string;
73
+ }
74
+
18
75
  export interface SetupStatus {
19
76
  /** Reachable knowledge base AND a process that can serve it. */
20
77
  complete: boolean;
78
+ /**
79
+ * Admins only: the setup-completing save stored the settings, but the
80
+ * knowledge base could not be initialized. Present while that failure stands.
81
+ */
82
+ kbInit?: KbInitFailure;
21
83
  /**
22
84
  * Answered, but the running process still holds the old branch model. Should
23
85
  * be rare — saving applies it — and means a restart, not another answer.
@@ -26,6 +88,10 @@ export interface SetupStatus {
26
88
  isAdmin: boolean;
27
89
  /** Admins only — nobody else is told what is missing. */
28
90
  settings?: SettingStatus[];
91
+ /** Admins only. Absent on a build without the sync module. */
92
+ sync?: SyncStatus;
93
+ /** Admins only. Absent from an older server. */
94
+ oidcVerification?: OidcVerification;
29
95
  }
30
96
 
31
97
  export interface SaveResult {
@@ -33,6 +99,7 @@ export interface SaveResult {
33
99
  complete: boolean;
34
100
  awaitingRestart?: boolean;
35
101
  settings: SettingStatus[];
102
+ oidcVerification?: OidcVerification;
36
103
  }
37
104
 
38
105
  /** Field-keyed messages, so the form can mark the input that was wrong. */
@@ -48,6 +115,21 @@ export class SettingsProblems extends Error {
48
115
  }
49
116
  }
50
117
 
118
+ /**
119
+ * The save went through, but the knowledge-base initialization it triggered
120
+ * did not. Distinct from a failed save: the values are stored, and retrying
121
+ * needs none of them re-entered.
122
+ */
123
+ export class KbInitFailed extends Error {
124
+ readonly kbInit: KbInitFailure;
125
+
126
+ constructor(kbInit: KbInitFailure) {
127
+ super('Saved, but the knowledge base could not be initialized.');
128
+ this.name = 'KbInitFailed';
129
+ this.kbInit = kbInit;
130
+ }
131
+ }
132
+
51
133
  async function readError(res: Response): Promise<never> {
52
134
  let body: unknown;
53
135
  try {
@@ -55,11 +137,62 @@ async function readError(res: Response): Promise<never> {
55
137
  } catch {
56
138
  throw new Error(`Request failed (${res.status})`);
57
139
  }
58
- const data = body as { error?: string; problems?: Record<string, string> };
140
+ const data = body as { error?: string; problems?: Record<string, string>; kbInit?: KbInitFailure };
59
141
  if (data.problems) throw new SettingsProblems(data.problems);
142
+ if (data.kbInit) throw new KbInitFailed(data.kbInit);
60
143
  throw new Error(data.error || `Request failed (${res.status})`);
61
144
  }
62
145
 
146
+ /**
147
+ * The header the sync endpoint stamps on every response it writes, so the
148
+ * client can tell its 503 ("a branch could not be pulled") from a reverse
149
+ * proxy's 503 ("the backend is down"). Mirrors `SYNC_RESPONSE_HEADER` in the
150
+ * backend's `kb-sync.routes.ts`.
151
+ */
152
+ const SYNC_RESPONSE_HEADER = 'x-hexis-sync';
153
+ const SYNC_RESPONSE_MARKER = 'result';
154
+
155
+ /** What "Sync now" came back with. A 409 or 503 still carries per-branch results. */
156
+ export interface SyncNowResult {
157
+ /** True for 200 — every branch current. */
158
+ ok: boolean;
159
+ status?: 'synced' | 'partial';
160
+ results: SyncBranchOutcome[];
161
+ /** Set when the server answered with an error body instead of results. */
162
+ error?: string;
163
+ }
164
+
165
+ /**
166
+ * Run a sync of every cloned branch with the admin's own session — the same
167
+ * thing a hook does, from the page where the hook is being wired up, so an
168
+ * admin can prove the deployment reaches the repository before trusting the
169
+ * hook to.
170
+ */
171
+ export async function syncNow(): Promise<SyncNowResult> {
172
+ // The endpoint answers 503 when a branch could not be pulled — an ordinary
173
+ // result here, not the backend being down. It marks every response it
174
+ // writes with `X-Hexis-Sync: result`, which a reverse proxy answering for a
175
+ // dead backend never sets, so only a 503 carrying that marker is exempted
176
+ // from the maintenance-overlay signal. A proxy 503, a 502/504 or a network
177
+ // failure still signals, as for every other call.
178
+ const res = await authFetch(
179
+ '/api/sync',
180
+ { method: 'POST' },
181
+ { isApplicationResponse: (r) => r.headers.get(SYNC_RESPONSE_HEADER) === SYNC_RESPONSE_MARKER },
182
+ );
183
+ let body: unknown;
184
+ try {
185
+ body = await res.json();
186
+ } catch {
187
+ throw new Error(`Sync failed (${res.status})`);
188
+ }
189
+ const data = body as { status?: 'synced' | 'partial'; results?: SyncBranchOutcome[]; error?: string };
190
+ if (!Array.isArray(data.results)) {
191
+ return { ok: false, results: [], error: data.error || `Sync failed (${res.status})` };
192
+ }
193
+ return { ok: res.status === 200, status: data.status, results: data.results };
194
+ }
195
+
63
196
  export async function fetchSetupStatus(): Promise<SetupStatus> {
64
197
  const res = await authFetch('/api/setup/status');
65
198
  if (!res.ok) await readError(res);
@@ -77,7 +210,16 @@ export async function saveSettings(settings: Record<string, string>): Promise<Sa
77
210
  }
78
211
 
79
212
  export interface ConnectionTest {
213
+ /** True only for a connection the host accepts for reading AND writing. */
80
214
  ok: boolean;
215
+ /**
216
+ * Which of the three answers this is: read and write; reads but may not
217
+ * push (`error` names the permission to grant); or turned down before it
218
+ * could read — bad credentials, no repository, unreachable host.
219
+ */
220
+ outcome?: 'connected' | 'read-only' | 'rejected';
221
+ /** The field a failure is about, when the server says. */
222
+ field?: string;
81
223
  /** The remote answered but has no branches yet — a supported starting point. */
82
224
  empty?: boolean;
83
225
  branches?: string[];
@@ -87,6 +229,12 @@ export interface ConnectionTest {
87
229
  * exactly, and being one character off is a failure nobody can see.
88
230
  */
89
231
  defaultBranch?: string | null;
232
+ /**
233
+ * The repository's top-level folder names on that branch — empty for an
234
+ * empty repository, null (or absent, from an older server) when they could
235
+ * not be listed. The screen checks the three root folder fields against it.
236
+ */
237
+ rootFolders?: string[] | null;
90
238
  error?: string;
91
239
  }
92
240
 
@@ -94,6 +242,13 @@ export interface ConnectionTest {
94
242
  * Try the credentials against the real remote before saving anything. Values
95
243
  * are sent as typed so an admin tests what is on screen, not what is stored;
96
244
  * omitted fields fall back to what is already in effect.
245
+ *
246
+ * A 400 is an ANSWER, not a failure to ask: the server looked at these values
247
+ * and refused them ("enter the access token for that repository", "the URL
248
+ * must start with https://"). It comes back as the rejection it is, so no
249
+ * caller can mistake it for "could not check" and carry on past it. Any other
250
+ * failure throws — a 401/403 is about the session, not the repository, and
251
+ * must not be shown as the host refusing these values.
97
252
  */
98
253
  export async function testConnection(fields: Record<string, string>): Promise<ConnectionTest> {
99
254
  const res = await authFetch('/api/setup/test-connection', {
@@ -101,6 +256,66 @@ export async function testConnection(fields: Record<string, string>): Promise<Co
101
256
  headers: { 'Content-Type': 'application/json' },
102
257
  body: JSON.stringify(fields),
103
258
  });
259
+ if (res.status === 400) {
260
+ let data: { error?: string; field?: string } = {};
261
+ try {
262
+ data = (await res.json()) as typeof data;
263
+ } catch {
264
+ // No body worth reading — the status alone still says "refused".
265
+ }
266
+ return {
267
+ ok: false,
268
+ outcome: 'rejected',
269
+ field: data.field,
270
+ error: data.error || `The connection check was refused (${res.status}).`,
271
+ };
272
+ }
104
273
  if (!res.ok) await readError(res);
105
274
  return (await res.json()) as ConnectionTest;
106
275
  }
276
+
277
+ export interface OidcTest {
278
+ /** True for credentials the provider accepted, or an issuer checked on its own. */
279
+ ok: boolean;
280
+ /**
281
+ * `verified`: the provider accepted the application ID and secret.
282
+ * `issuer-verified`: the address is a sign-in provider; no credentials to try yet.
283
+ * `unverified`: the provider is fine, but its answer said nothing definite
284
+ * about the credentials — saving is allowed and shows as Unverified.
285
+ * `rejected`: the address or the credentials were turned down (`field` says which).
286
+ */
287
+ outcome?: 'verified' | 'issuer-verified' | 'unverified' | 'rejected';
288
+ field?: string;
289
+ error?: string;
290
+ /** The configuration in effect, after this test. */
291
+ oidcVerification?: OidcVerification;
292
+ }
293
+
294
+ /**
295
+ * Try the single sign-on values against the provider before saving them. As
296
+ * with {@link testConnection}, a 400 is the server refusing these values and
297
+ * comes back as a rejection; any other failure throws.
298
+ */
299
+ export async function testOidc(fields: Record<string, string>): Promise<OidcTest> {
300
+ const res = await authFetch('/api/setup/test-oidc', {
301
+ method: 'POST',
302
+ headers: { 'Content-Type': 'application/json' },
303
+ body: JSON.stringify(fields),
304
+ });
305
+ if (res.status === 400) {
306
+ let data: { error?: string; field?: string } = {};
307
+ try {
308
+ data = (await res.json()) as typeof data;
309
+ } catch {
310
+ // The status alone still says "refused".
311
+ }
312
+ return {
313
+ ok: false,
314
+ outcome: 'rejected',
315
+ field: data.field,
316
+ error: data.error || `The sign-in check was refused (${res.status}).`,
317
+ };
318
+ }
319
+ if (!res.ok) await readError(res);
320
+ return (await res.json()) as OidcTest;
321
+ }
@@ -0,0 +1,72 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { isRootFolderSuggestion, rootFolderState } from '../root-folders';
3
+
4
+ describe('rootFolderState', () => {
5
+ it('is found only on an exact match', () => {
6
+ expect(rootFolderState('Skills', ['KnowledgeBase', 'Skills'])).toEqual({ kind: 'found' });
7
+ expect(rootFolderState(' Skills ', ['Skills'])).toEqual({ kind: 'found' });
8
+ });
9
+
10
+ it('names a folder that differs only by case', () => {
11
+ expect(rootFolderState('Skills', ['skills'])).toEqual({
12
+ kind: 'variant',
13
+ candidate: 'skills',
14
+ difference: 'case',
15
+ });
16
+ });
17
+
18
+ it('names a folder that differs by case and a trailing s, either way round', () => {
19
+ expect(rootFolderState('Skills', ['skill'])).toEqual({
20
+ kind: 'variant',
21
+ candidate: 'skill',
22
+ difference: 'case-and-trailing-s',
23
+ });
24
+ expect(rootFolderState('Plugin', ['plugins'])).toEqual({
25
+ kind: 'variant',
26
+ candidate: 'plugins',
27
+ difference: 'case-and-trailing-s',
28
+ });
29
+ });
30
+
31
+ it('names a folder that differs only by a trailing s, either way round', () => {
32
+ expect(rootFolderState('Skills', ['Skill'])).toEqual({
33
+ kind: 'variant',
34
+ candidate: 'Skill',
35
+ difference: 'trailing-s',
36
+ });
37
+ expect(rootFolderState('plugin', ['plugins'])).toEqual({
38
+ kind: 'variant',
39
+ candidate: 'plugins',
40
+ difference: 'trailing-s',
41
+ });
42
+ });
43
+
44
+ it('prefers the case-only match when both are there', () => {
45
+ expect(rootFolderState('Skills', ['skill', 'SKILLS'])).toEqual({
46
+ kind: 'variant',
47
+ candidate: 'SKILLS',
48
+ difference: 'case',
49
+ });
50
+ });
51
+
52
+ it('is missing when nothing is like it', () => {
53
+ expect(rootFolderState('Plugins', ['KnowledgeBase', 'Skills', 'Data'])).toEqual({ kind: 'missing' });
54
+ expect(rootFolderState('Skills', [])).toEqual({ kind: 'missing' });
55
+ });
56
+ });
57
+
58
+ describe('isRootFolderSuggestion', () => {
59
+ it('offers names a root may take', () => {
60
+ expect(['KnowledgeBase', 'skills', 'docs-2'].filter(isRootFolderSuggestion)).toEqual([
61
+ 'KnowledgeBase',
62
+ 'skills',
63
+ 'docs-2',
64
+ ]);
65
+ });
66
+
67
+ it('holds back names the save would refuse: dot-folders and the reserved roots', () => {
68
+ for (const name of ['.github', '.bevel', 'Data', 'agents', 'PIPELINES']) {
69
+ expect(isRootFolderSuggestion(name)).toBe(false);
70
+ }
71
+ });
72
+ });
@@ -0,0 +1,46 @@
1
+ import { AGENTS_DIR, DATA_DIR, PIPELINES_DIR, validateKbRootName } from '@bevel-software/platform-shared';
2
+
3
+ /**
4
+ * What the repository holds for one configured root folder, judged against
5
+ * the top-level folder names the connection test listed.
6
+ *
7
+ * - `found`: a folder with exactly that name.
8
+ * - `missing`: nothing like it; the initialization phase will create it.
9
+ * - `variant`: no exact match, but a folder that is plainly the same one
10
+ * spelled differently — by case (`skills` for `Skills`), by a trailing `s`
11
+ * (`Skill`), or by both (`skill`). Exactly the repository that got an empty
12
+ * `Skills/` scaffolded beside its real `skills/` and imported nothing.
13
+ */
14
+ export type RootFolderState =
15
+ | { kind: 'found' }
16
+ | { kind: 'missing' }
17
+ | { kind: 'variant'; candidate: string; difference: 'case' | 'trailing-s' | 'case-and-trailing-s' };
18
+
19
+ const withoutTrailingS = (name: string) => name.replace(/s$/i, '');
20
+
21
+ export function rootFolderState(configured: string, rootFolders: readonly string[]): RootFolderState {
22
+ const name = configured.trim();
23
+ if (rootFolders.includes(name)) return { kind: 'found' };
24
+ const byCase = rootFolders.find((folder) => folder.toLowerCase() === name.toLowerCase());
25
+ if (byCase) return { kind: 'variant', candidate: byCase, difference: 'case' };
26
+ const byPlural = rootFolders.find(
27
+ (folder) => withoutTrailingS(folder).toLowerCase() === withoutTrailingS(name).toLowerCase(),
28
+ );
29
+ if (!byPlural) return { kind: 'missing' };
30
+ return {
31
+ kind: 'variant',
32
+ candidate: byPlural,
33
+ difference: withoutTrailingS(byPlural) === withoutTrailingS(name) ? 'trailing-s' : 'case-and-trailing-s',
34
+ };
35
+ }
36
+
37
+ const RESERVED_ROOTS = [DATA_DIR, AGENTS_DIR, PIPELINES_DIR].map((name) => name.toLowerCase());
38
+
39
+ /**
40
+ * Whether a listed folder may be offered as a root name: one the save would
41
+ * accept on its own — not `.github`, not a reserved root like `Data`. Taking a
42
+ * suggestion should never produce a validation error.
43
+ */
44
+ export function isRootFolderSuggestion(name: string): boolean {
45
+ return !validateKbRootName(name) && !RESERVED_ROOTS.includes(name.trim().toLowerCase());
46
+ }
@@ -0,0 +1,68 @@
1
+ # Cowork setup screenshots
2
+
3
+ The eleven shots behind the "Cowork and claude.ai" steps — the personal
4
+ carousel on the External agent access page, and the registration carousel in
5
+ Deployment → Marketplace, which ends on the same connector slide.
6
+ `../../components/claude-setup-shots.ts` pairs each with its alt text and the
7
+ percentage rectangle drawn over the control to click.
8
+
9
+ `01` through `09` were captured on a real deployment (Claude's admin
10
+ settings, Claude Code on the web, then Cowork), so the recipe below is what a
11
+ re-shoot has to repeat.
12
+
13
+ ## Processing
14
+
15
+ Source frames `01` through `08` are full-window mockups, 1999x1588, with a
16
+ device frame on a black field.
17
+
18
+ 1. **Redact.** This package is published, so every deployment shows these.
19
+ Gaussian blur, radius 9, over: the account row in the sidebar footer of
20
+ all eight, the two "Linked by ..." lines and the personal-account and
21
+ third-party organisation rows in `03`, and the organisation chips in `01`.
22
+ The vendor's own organisation stays legible; nothing else does.
23
+ 2. **Crop** to the window, `(99, 72, 1901, 1462)`, dropping the frame.
24
+ 3. **Scale** to 1400px wide (Lanczos) and encode webp at q80. That is about
25
+ 35 to 65 KB each, and roughly 2x the ~700px column they render into.
26
+
27
+ Redact before scaling: blur radius is in source pixels.
28
+
29
+ `09-select-repository.webp` came from an 1806x1376 Claude Code screenshot.
30
+ Blur the personal name in the greeting and account row, then crop away the
31
+ outer device frame and shadow so the Claude viewport runs edge to edge like
32
+ shots `01` through `08`. Crop the normalized source at `(67, 55, 1277, 989)`,
33
+ scale that 1210x934 viewport to 1400x1080, and encode it as webp at q80.
34
+
35
+ ## The two connector shots
36
+
37
+ `10-connector-not-added.webp` and `11-add-custom-connector.webp` are
38
+ **placeholder renderings**, not captures: they were drawn to the layout of the
39
+ screens they describe rather than photographed on a deployment. Replace them
40
+ with real captures when the connector flow is next in front of a camera. Until
41
+ then the alt text, not the pixels, is what the step relies on.
42
+
43
+ Both carry `illustration: true` in `claude-setup-shots.ts`, so the carousel
44
+ prints a line under each frame telling the reader it is a drawing. That flag
45
+ is not a label on the file, it is the promise the page makes: a real capture
46
+ means deleting it, re-measuring the two boxes against the new pixels, and
47
+ updating the intrinsic size if the shape changed. Shipping a capture while
48
+ the flag stays on tells readers to distrust a true picture; leaving the flag
49
+ off while the drawing stays sends them looking for a row that is not where
50
+ the picture puts it.
51
+
52
+ They are 1400x700, not 1400x1080: a plugin panel and a dialog are not the
53
+ shape of a full window, and padding them to the window shots' height would
54
+ reserve a column of empty space before the bytes land. That is what the
55
+ optional `width`/`height` on `Shot` is for — a shot that omits them is the
56
+ default 1400x1080. A re-shoot may land on any size, as long as the file and
57
+ the two numbers agree.
58
+
59
+ Same processing otherwise: redact first, then scale to 1400px wide (Lanczos)
60
+ and encode webp at q80.
61
+
62
+ ## Highlights
63
+
64
+ Measure against the final image at its own size and convert each box to
65
+ percentages, with 6px of padding on each side. Percentages keep the callout
66
+ aligned when the shot renders in a narrower column. When a shot is replaced,
67
+ re-measure and update `claude-setup-shots.ts`; nothing reads the numbers from
68
+ the file.