@bevel-software/platform-core-frontend 0.15.1 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (347) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +20 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  33. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  34. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  35. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  36. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  37. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  38. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  39. package/src/modules/admin/components/group-members-path.ts +32 -0
  40. package/src/modules/admin/services/roles.api.ts +12 -1
  41. package/src/modules/audit/__tests__/AuditLogPage.test.tsx +312 -0
  42. package/src/modules/audit/components/AuditEventsPanel.tsx +319 -0
  43. package/src/modules/audit/components/AuditLogPage.tsx +373 -0
  44. package/src/modules/audit/components/principal-grouping.ts +49 -0
  45. package/src/modules/audit/services/audit.api.ts +98 -0
  46. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  47. package/src/modules/auth/components/AccountPage.tsx +73 -54
  48. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  49. package/src/modules/auth/services/account.api.ts +78 -4
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  58. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  59. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  60. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  61. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  62. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  63. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  64. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  65. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  66. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  67. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  68. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  69. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  70. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  71. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  72. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  73. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  74. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  75. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  76. package/src/modules/change-requests/services/propose.api.ts +97 -8
  77. package/src/modules/change-requests/utils/approval.ts +15 -0
  78. package/src/modules/change-requests/utils/author.ts +32 -0
  79. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  80. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  81. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  82. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  83. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  84. package/src/modules/git/services/error-messages.ts +12 -0
  85. package/src/modules/git/services/pr-prompts.ts +5 -5
  86. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  87. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  88. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  89. package/src/modules/layout/components/AppLayout.tsx +2 -0
  90. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  91. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  92. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  93. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  94. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  95. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  96. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  97. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  98. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  99. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  100. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  101. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  102. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  103. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  104. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  105. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  106. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  107. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  108. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  109. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  110. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  111. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  112. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  113. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  114. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  115. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  116. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  117. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  118. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  119. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  120. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  121. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  122. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  123. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  124. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  125. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  126. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  127. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  128. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  129. package/src/modules/library/__tests__/status.test.ts +82 -2
  130. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  131. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  132. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  133. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  134. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  135. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  136. package/src/modules/library/components/LibraryCard.tsx +146 -45
  137. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  138. package/src/modules/library/components/LibraryPage.tsx +172 -39
  139. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  140. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  141. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  142. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  143. package/src/modules/library/components/PageActions.tsx +11 -9
  144. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  145. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  146. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  147. package/src/modules/library/components/PluginExtras.tsx +140 -17
  148. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  149. package/src/modules/library/components/PluginPage.tsx +157 -41
  150. package/src/modules/library/components/PluginRows.tsx +286 -0
  151. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  152. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  153. package/src/modules/library/components/ShareButton.tsx +17 -0
  154. package/src/modules/library/components/SkillsTree.tsx +141 -28
  155. package/src/modules/library/components/TeamRoute.tsx +15 -0
  156. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  157. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  158. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  159. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  160. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  161. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  162. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  163. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  164. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  165. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  166. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  167. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  168. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  169. package/src/modules/library/routes/library-paths.ts +26 -28
  170. package/src/modules/library/services/library.api.ts +38 -20
  171. package/src/modules/library/services/plugins.api.ts +69 -8
  172. package/src/modules/library/services/teams.api.ts +15 -0
  173. package/src/modules/library/services/tools.api.ts +78 -0
  174. package/src/modules/library/state/library-data.tsx +170 -32
  175. package/src/modules/library/utils/personal-plugin.ts +13 -15
  176. package/src/modules/library/utils/plugin-entries.ts +134 -0
  177. package/src/modules/library/utils/plugin-summary.ts +75 -9
  178. package/src/modules/library/utils/status.ts +135 -33
  179. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  180. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  181. package/src/modules/onboarding/agent-clients.ts +55 -23
  182. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  183. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  184. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  185. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  186. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  187. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  188. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  189. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  190. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  191. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  192. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  193. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  194. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  195. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  196. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  197. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  198. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  199. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  200. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  201. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  202. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  203. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  204. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  205. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  206. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  207. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  208. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +7 -6
  209. package/src/modules/settings/services/github-facade.api.ts +23 -0
  210. package/src/modules/settings/settings-nav-items.tsx +13 -3
  211. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  212. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  213. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  214. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  215. package/src/modules/setup/components/SetupGate.tsx +16 -16
  216. package/src/modules/setup/components/SetupScreen.tsx +532 -43
  217. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  218. package/src/modules/setup/services/setup.api.ts +141 -4
  219. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  220. package/src/modules/setup/utils/root-folders.ts +46 -0
  221. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  232. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  233. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  234. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  235. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  236. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  237. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  238. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  239. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  240. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  241. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  242. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  243. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  244. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  245. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  246. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  247. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  248. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  249. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  250. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  251. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  252. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  254. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  255. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  256. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  257. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  258. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  259. package/src/modules/workspace/components/FileViewer.tsx +172 -46
  260. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  261. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  262. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  263. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2533 -129
  264. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  265. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +381 -12
  266. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  267. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  268. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  269. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  270. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  271. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  272. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  273. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  274. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  275. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  276. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  277. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  279. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  280. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  281. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  282. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  283. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  284. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  285. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  286. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  287. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  288. package/src/modules/workspace/components/renderers/index.ts +53 -2
  289. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  290. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  291. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  292. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  294. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  295. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  296. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  297. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  298. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  299. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  300. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  301. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +134 -1
  302. package/src/modules/workspace/services/workspace.api.ts +57 -4
  303. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  304. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  305. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  306. package/src/modules/workspace/state/workspace.context.ts +125 -19
  307. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  308. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  309. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  310. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  311. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  312. package/src/modules/workspace/utils/file-trace.ts +50 -0
  313. package/src/modules/workspace/utils/fileTree.ts +112 -36
  314. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  315. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  316. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  317. package/src/modules/workspace/utils/uploadError.ts +29 -0
  318. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  319. package/src/shared/components/Button.tsx +16 -2
  320. package/src/shared/components/Dialog.tsx +27 -11
  321. package/src/shared/components/Menu.tsx +13 -1
  322. package/src/shared/components/PageShell.tsx +13 -8
  323. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  324. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  325. package/src/shared/components/index.ts +2 -0
  326. package/src/shared/components/useDismissableMenu.ts +32 -10
  327. package/src/shared/components/useFocusHandoff.ts +51 -0
  328. package/src/shared/components/useLatestRef.ts +28 -0
  329. package/src/shared/markdown/Markdown.tsx +12 -3
  330. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  331. package/src/shared/markdown/hrefs.ts +50 -0
  332. package/src/shared/marketplace-url.ts +33 -5
  333. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  334. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  335. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  336. package/src/shared/mcp/connect-snippets.ts +14 -9
  337. package/src/shared/mcp/index.ts +1 -1
  338. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  339. package/src/shared/theme/header.ts +75 -0
  340. package/src/shared/theme/measure.ts +7 -4
  341. package/src/shared/theme/tokens.css +25 -0
  342. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  343. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  344. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  345. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  346. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  347. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -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
+ }
@@ -4,9 +4,13 @@ import { authFetch } from '../../../lib/api';
4
4
  /** One configurable setting, as the server describes it. */
5
5
  export interface SettingStatus {
6
6
  key: string;
7
- /** The environment variable that still wins if it is set. */
8
- envVar: string;
9
- section: 'knowledge-base' | 'sign-in';
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;
13
+ section: 'knowledge-base' | 'sign-in' | 'audit';
10
14
  source: 'env' | 'stored' | 'unset';
11
15
  /** Absent for secrets — the server never sends a stored secret back. */
12
16
  value?: string;
@@ -41,9 +45,41 @@ export interface SyncStatus {
41
45
  last: LastSync | null;
42
46
  }
43
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
+
44
75
  export interface SetupStatus {
45
76
  /** Reachable knowledge base AND a process that can serve it. */
46
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;
47
83
  /**
48
84
  * Answered, but the running process still holds the old branch model. Should
49
85
  * be rare — saving applies it — and means a restart, not another answer.
@@ -54,6 +90,8 @@ export interface SetupStatus {
54
90
  settings?: SettingStatus[];
55
91
  /** Admins only. Absent on a build without the sync module. */
56
92
  sync?: SyncStatus;
93
+ /** Admins only. Absent from an older server. */
94
+ oidcVerification?: OidcVerification;
57
95
  }
58
96
 
59
97
  export interface SaveResult {
@@ -61,6 +99,7 @@ export interface SaveResult {
61
99
  complete: boolean;
62
100
  awaitingRestart?: boolean;
63
101
  settings: SettingStatus[];
102
+ oidcVerification?: OidcVerification;
64
103
  }
65
104
 
66
105
  /** Field-keyed messages, so the form can mark the input that was wrong. */
@@ -76,6 +115,21 @@ export class SettingsProblems extends Error {
76
115
  }
77
116
  }
78
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
+
79
133
  async function readError(res: Response): Promise<never> {
80
134
  let body: unknown;
81
135
  try {
@@ -83,8 +137,9 @@ async function readError(res: Response): Promise<never> {
83
137
  } catch {
84
138
  throw new Error(`Request failed (${res.status})`);
85
139
  }
86
- const data = body as { error?: string; problems?: Record<string, string> };
140
+ const data = body as { error?: string; problems?: Record<string, string>; kbInit?: KbInitFailure };
87
141
  if (data.problems) throw new SettingsProblems(data.problems);
142
+ if (data.kbInit) throw new KbInitFailed(data.kbInit);
88
143
  throw new Error(data.error || `Request failed (${res.status})`);
89
144
  }
90
145
 
@@ -155,7 +210,16 @@ export async function saveSettings(settings: Record<string, string>): Promise<Sa
155
210
  }
156
211
 
157
212
  export interface ConnectionTest {
213
+ /** True only for a connection the host accepts for reading AND writing. */
158
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;
159
223
  /** The remote answered but has no branches yet — a supported starting point. */
160
224
  empty?: boolean;
161
225
  branches?: string[];
@@ -165,6 +229,12 @@ export interface ConnectionTest {
165
229
  * exactly, and being one character off is a failure nobody can see.
166
230
  */
167
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;
168
238
  error?: string;
169
239
  }
170
240
 
@@ -172,6 +242,13 @@ export interface ConnectionTest {
172
242
  * Try the credentials against the real remote before saving anything. Values
173
243
  * are sent as typed so an admin tests what is on screen, not what is stored;
174
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.
175
252
  */
176
253
  export async function testConnection(fields: Record<string, string>): Promise<ConnectionTest> {
177
254
  const res = await authFetch('/api/setup/test-connection', {
@@ -179,6 +256,66 @@ export async function testConnection(fields: Record<string, string>): Promise<Co
179
256
  headers: { 'Content-Type': 'application/json' },
180
257
  body: JSON.stringify(fields),
181
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
+ }
182
273
  if (!res.ok) await readError(res);
183
274
  return (await res.json()) as ConnectionTest;
184
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.