@bevel-software/platform-core-frontend 0.4.1 → 0.5.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 (326) hide show
  1. package/package.json +5 -3
  2. package/src/core/CoreAppShell.tsx +195 -56
  3. package/src/core/__tests__/AppChrome.test.tsx +125 -0
  4. package/src/core/__tests__/ShellRoutes.test.tsx +37 -2
  5. package/src/core/__tests__/bootstrap.test.ts +63 -0
  6. package/src/core/bootstrap.ts +73 -0
  7. package/src/core/events.ts +12 -0
  8. package/src/core/registry.ts +58 -9
  9. package/src/index.css +100 -11
  10. package/src/index.ts +24 -23
  11. package/src/lib/utils.ts +93 -117
  12. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
  14. package/src/modules/access/api.ts +49 -0
  15. package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
  16. package/src/modules/access/hooks/useFileAccess.ts +1 -1
  17. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
  18. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +17 -1
  19. package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
  20. package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
  21. package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
  22. package/src/modules/admin/components/UserAccountsPage.tsx +36 -28
  23. package/src/modules/admin/state/admin.context.tsx +15 -6
  24. package/src/modules/auth/components/AccountPage.tsx +11 -11
  25. package/src/modules/auth/components/LoginScreen.tsx +12 -12
  26. package/src/modules/auth/services/sso.ts +47 -1
  27. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
  28. package/src/modules/change-requests/__tests__/author.test.ts +48 -0
  29. package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
  30. package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
  31. package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
  32. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
  33. package/src/modules/change-requests/change-requests.css +22 -0
  34. package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
  35. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
  36. package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
  37. package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
  38. package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
  39. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
  40. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
  41. package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
  42. package/src/modules/change-requests/services/change-requests.api.ts +45 -0
  43. package/src/modules/change-requests/services/propose.api.ts +162 -0
  44. package/src/modules/change-requests/utils/author.ts +47 -0
  45. package/src/modules/change-requests/utils/conflict.ts +38 -0
  46. package/src/modules/change-requests/utils/diff.ts +80 -0
  47. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
  48. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
  49. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
  50. package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
  51. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
  52. package/src/modules/git/components/BranchSwitcher.tsx +68 -31
  53. package/src/modules/git/components/DiffView.tsx +4 -4
  54. package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
  55. package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
  56. package/src/modules/git/components/PullNeededBanner.tsx +6 -13
  57. package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
  58. package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
  59. package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
  60. package/src/modules/git/hooks/useGitState.ts +15 -14
  61. package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
  62. package/src/modules/git/services/error-messages.ts +7 -7
  63. package/src/modules/git/services/git.api.ts +17 -11
  64. package/src/modules/git/services/pr-prompts.ts +2 -2
  65. package/src/modules/git/state/git.context.ts +10 -1
  66. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
  67. package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
  68. package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
  69. package/src/modules/layout/breakpoints.ts +6 -0
  70. package/src/modules/layout/components/AppLayout.tsx +17 -5
  71. package/src/modules/layout/components/DemoBanner.tsx +10 -1
  72. package/src/modules/layout/components/MaintenanceOverlay.tsx +3 -3
  73. package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
  74. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
  75. package/src/modules/layout/components/SidebarFrame.tsx +317 -0
  76. package/src/modules/layout/components/SidebarToggle.tsx +86 -0
  77. package/src/modules/layout/components/SlideOverlay.tsx +1 -1
  78. package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
  79. package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
  80. package/src/modules/layout/state/sidebar.ts +200 -0
  81. package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
  82. package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
  83. package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
  84. package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
  85. package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
  86. package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
  87. package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
  88. package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
  89. package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
  90. package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
  91. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
  92. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
  93. package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
  94. package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
  95. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
  96. package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
  97. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
  98. package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
  99. package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
  100. package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
  101. package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
  102. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
  103. package/src/modules/library/__tests__/auth-harness.tsx +37 -0
  104. package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
  105. package/src/modules/library/__tests__/status.test.ts +113 -20
  106. package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
  107. package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
  108. package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
  109. package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
  110. package/src/modules/library/components/ChangeRequestDock.tsx +52 -28
  111. package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
  112. package/src/modules/library/components/GroupIndexRow.tsx +63 -0
  113. package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
  114. package/src/modules/library/components/GroupPage.tsx +373 -0
  115. package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
  116. package/src/modules/library/components/GroupsSidebar.tsx +338 -0
  117. package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
  118. package/src/modules/library/components/LibraryCard.tsx +123 -102
  119. package/src/modules/library/components/LibraryLayout.tsx +344 -0
  120. package/src/modules/library/components/LibraryPage.tsx +111 -227
  121. package/src/modules/library/components/LockGlyph.tsx +31 -0
  122. package/src/modules/library/components/LockedGroupView.tsx +159 -0
  123. package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
  124. package/src/modules/library/components/NewGroupDialog.tsx +112 -0
  125. package/src/modules/library/components/NewSkillPanel.tsx +151 -0
  126. package/src/modules/library/components/PageActions.tsx +156 -0
  127. package/src/modules/library/components/PendingSkillReview.tsx +63 -0
  128. package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
  129. package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
  130. package/src/modules/library/components/StatusDot.tsx +25 -0
  131. package/src/modules/library/components/ToolLogo.tsx +171 -0
  132. package/src/modules/library/components/group-page-parts.tsx +419 -0
  133. package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
  134. package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
  135. package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
  136. package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
  137. package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
  138. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
  139. package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
  140. package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
  141. package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
  142. package/src/modules/library/hooks/useJoinRequests.ts +114 -0
  143. package/src/modules/library/hooks/useLibraryData.ts +134 -119
  144. package/src/modules/library/hooks/useSkillDetail.ts +119 -74
  145. package/src/modules/library/hooks/useToolPage.ts +145 -0
  146. package/src/modules/library/library.css +33 -245
  147. package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
  148. package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
  149. package/src/modules/library/routes/library-paths.ts +191 -0
  150. package/src/modules/library/services/groups.api.ts +189 -0
  151. package/src/modules/library/services/library.api.ts +291 -164
  152. package/src/modules/library/services/tools.api.ts +60 -0
  153. package/src/modules/library/state/library-context.ts +22 -0
  154. package/src/modules/library/state/library-data.tsx +223 -0
  155. package/src/modules/library/state/toast.context.ts +32 -0
  156. package/src/modules/library/state/toast.tsx +84 -42
  157. package/src/modules/library/utils/clipboard.ts +33 -0
  158. package/src/modules/library/utils/group-summary.ts +68 -0
  159. package/src/modules/library/utils/names.ts +30 -0
  160. package/src/modules/library/utils/navigate-external.ts +15 -0
  161. package/src/modules/library/utils/oauth-fragment.ts +32 -0
  162. package/src/modules/library/utils/personal-group.ts +36 -0
  163. package/src/modules/library/utils/status.ts +108 -25
  164. package/src/modules/library/utils/toast-duration.ts +16 -0
  165. package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
  166. package/src/modules/onboarding/agent-clients.ts +48 -0
  167. package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
  168. package/src/modules/onboarding/components/RootLanding.tsx +54 -0
  169. package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
  170. package/src/modules/onboarding/paths.ts +9 -0
  171. package/src/modules/onboarding/state/onboarding.ts +191 -0
  172. package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
  173. package/src/modules/pr/services/pr-approvals.api.ts +19 -0
  174. package/src/modules/pr/services/pr-cancel.api.ts +11 -0
  175. package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
  176. package/src/modules/review/components/DiffViewer.tsx +4 -4
  177. package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
  178. package/src/modules/review/components/ReviewFileRow.tsx +10 -10
  179. package/src/modules/review/components/ReviewPanel.tsx +49 -17
  180. package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
  181. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
  182. package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
  183. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
  184. package/src/modules/secrets-vault/components/SecretsPage.tsx +147 -110
  185. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
  186. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +35 -4
  187. package/src/modules/secrets-vault/services/connect.api.ts +24 -3
  188. package/src/modules/settings/components/DeploymentPage.tsx +90 -0
  189. package/src/modules/settings/components/SettingsLayout.tsx +135 -0
  190. package/src/modules/settings/components/SettingsNav.tsx +114 -0
  191. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
  192. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
  193. package/src/modules/settings/settings-nav-items.tsx +166 -0
  194. package/src/modules/setup/__tests__/setup.test.tsx +540 -0
  195. package/src/modules/setup/components/SetupGate.tsx +67 -0
  196. package/src/modules/setup/components/SetupScreen.tsx +573 -0
  197. package/src/modules/setup/services/setup.api.ts +106 -0
  198. package/src/modules/setup/utils/git-host.ts +34 -0
  199. package/src/modules/toolbar/components/AppSwitcher.tsx +38 -15
  200. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +50 -50
  201. package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
  202. package/src/modules/toolbar/components/Toolbar.tsx +56 -54
  203. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
  204. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
  205. package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
  206. package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
  207. package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
  208. package/src/modules/workspace/components/EditorTabs.tsx +82 -50
  209. package/src/modules/workspace/components/FileExplorer.tsx +413 -189
  210. package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
  211. package/src/modules/workspace/components/FileRoute.tsx +89 -84
  212. package/src/modules/workspace/components/FileViewer.tsx +700 -294
  213. package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
  214. package/src/modules/workspace/components/KbFileRail.tsx +128 -0
  215. package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
  216. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
  217. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
  218. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
  219. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
  220. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
  221. package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
  222. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
  223. package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
  224. package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
  225. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
  226. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
  227. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
  228. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
  229. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
  230. package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
  231. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
  232. package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
  233. package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
  234. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
  235. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
  236. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
  237. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
  238. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
  239. package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
  240. package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
  241. package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
  242. package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
  243. package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
  244. package/src/modules/workspace/components/renderers/index.ts +78 -2
  245. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
  246. package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
  247. package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
  248. package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
  249. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
  250. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
  251. package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
  252. package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
  253. package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
  254. package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
  255. package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
  256. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
  257. package/src/modules/workspace/services/workspace.api.ts +9 -2
  258. package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
  259. package/src/modules/workspace/state/open-change-requests.tsx +185 -0
  260. package/src/modules/workspace/state/workspace.context.ts +9 -0
  261. package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
  262. package/src/modules/workspace/utils/diff.ts +130 -53
  263. package/src/modules/workspace/utils/fileTree.ts +7 -4
  264. package/src/modules/workspace/workspace.css +28 -0
  265. package/src/shared/components/Badge.tsx +62 -0
  266. package/src/shared/components/Banner.tsx +58 -0
  267. package/src/shared/components/Button.tsx +90 -0
  268. package/src/shared/components/Dialog.tsx +6 -6
  269. package/src/shared/components/Field.tsx +45 -0
  270. package/src/shared/components/IconButton.tsx +74 -0
  271. package/src/shared/components/ListRow.tsx +96 -0
  272. package/src/shared/components/Menu.tsx +88 -0
  273. package/src/shared/components/PageShell.tsx +8 -5
  274. package/src/shared/components/Surface.tsx +86 -0
  275. package/src/shared/components/__tests__/primitives.test.tsx +333 -0
  276. package/src/shared/components/index.ts +48 -0
  277. package/src/shared/components/useDismissableMenu.ts +71 -0
  278. package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
  279. package/src/shared/theme/index.css +12 -0
  280. package/src/shared/theme/measure.ts +64 -0
  281. package/src/shared/theme/shadows.css +34 -0
  282. package/src/shared/theme/tokens.css +193 -0
  283. package/src/test-setup.ts +9 -0
  284. package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
  285. package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
  286. package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
  287. package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
  288. package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
  289. package/src/modules/library/__tests__/diff.test.ts +0 -62
  290. package/src/modules/library/__tests__/loadout.test.tsx +0 -72
  291. package/src/modules/library/components/CompareView.tsx +0 -357
  292. package/src/modules/library/components/DetailDialog.tsx +0 -566
  293. package/src/modules/library/components/GearIcon.tsx +0 -12
  294. package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
  295. package/src/modules/library/components/StatusGem.tsx +0 -21
  296. package/src/modules/library/components/SuggestChange.tsx +0 -171
  297. package/src/modules/library/components/particles.ts +0 -50
  298. package/src/modules/library/state/loadout.tsx +0 -129
  299. package/src/modules/library/utils/diff.ts +0 -102
  300. package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
  301. package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
  302. package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
  303. package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
  304. package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
  305. package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
  306. package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
  307. package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
  308. package/src/modules/pr/components/PrCancelButton.tsx +0 -99
  309. package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
  310. package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
  311. package/src/modules/pr/components/PrCommentThread.tsx +0 -168
  312. package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
  313. package/src/modules/pr/components/PrDiffPane.tsx +0 -425
  314. package/src/modules/pr/components/PrFileRow.tsx +0 -164
  315. package/src/modules/pr/components/PrFilesList.tsx +0 -53
  316. package/src/modules/pr/components/PrHeader.tsx +0 -45
  317. package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
  318. package/src/modules/pr/components/PrMergeButton.tsx +0 -268
  319. package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
  320. package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
  321. package/src/modules/pr/components/PrViewer.tsx +0 -364
  322. package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
  323. package/src/modules/pr/state/pr-viewer.context.ts +0 -34
  324. package/src/modules/pr/utils/bucketize-comments.ts +0 -55
  325. package/src/modules/pr/utils/parsePatch.ts +0 -57
  326. package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
@@ -0,0 +1,533 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { render, renderHook, screen, cleanup, waitFor } from '@testing-library/react';
3
+ import userEvent from '@testing-library/user-event';
4
+ import { MemoryRouter, Route, Routes, useLocation } from 'react-router-dom';
5
+ import { AuthContext } from '../../auth/state/auth.context';
6
+ import { authValue } from '../../library/__tests__/auth-harness';
7
+ import { LibraryToastProvider } from '../../library/state/toast';
8
+ import { WelcomePage } from '../components/WelcomePage';
9
+ import { ConnectAgentPill } from '../components/ConnectAgentPill';
10
+ import { RootLanding } from '../components/RootLanding';
11
+ import { POST_LOGIN_REDIRECT_KEY } from '../../auth/services/sso';
12
+ import { WELCOME_PATH } from '../paths';
13
+ import { resetOnboardingForTests } from '../state/onboarding';
14
+ import { setSidebarCollapsed, useSidebar } from '../../layout/state/sidebar';
15
+
16
+ /**
17
+ * The onboarding contract, end to end on the client:
18
+ *
19
+ * - `/` redirects to the welcome page ONCE, on an account the server says is
20
+ * not onboarded — and never hijacks anything after that first greeting.
21
+ * - the pill outlives the redirect: it stays until × or Done, exactly two.
22
+ * - Done concludes (server write + navigation); the skip link and the copy
23
+ * button conclude NOTHING — leaving and copying are not promises.
24
+ */
25
+
26
+ // No parameters: the mock never reads its arguments, and `vi.fn` records every
27
+ // call regardless of the implementation's signature — so the call assertions
28
+ // below keep working while lint stays clean.
29
+ const { authFetchMock } = vi.hoisted(() => ({
30
+ authFetchMock: vi.fn(async () => ({ ok: true, status: 200 }) as Response),
31
+ }));
32
+ vi.mock('../../../lib/api', () => ({ authFetch: authFetchMock }));
33
+
34
+ /**
35
+ * The `RequestInit` of a recorded `authFetch` call.
36
+ *
37
+ * The mock declares no parameters — deliberately, so lint stays clean — which
38
+ * leaves `mock.calls` typed as an empty tuple even though the calls really do
39
+ * carry two arguments. Naming that gap ONCE, here, is better than a cast at
40
+ * every assertion that wants to read a request body.
41
+ */
42
+ function fetchInit(call = 0): RequestInit | undefined {
43
+ return (authFetchMock.mock.calls[call] as unknown as [string, RequestInit] | undefined)?.[1];
44
+ }
45
+
46
+ /** A user the server considers NOT onboarded (the explicit false matters). */
47
+ const newUser = () => authValue({ user: { id: 'u1', email: 'juan@bevel.software', name: 'Juan Viera', onboardingDone: false } });
48
+ /** The same account after the server has recorded the onboarding as done. */
49
+ const doneUser = () => authValue({ user: { id: 'u1', email: 'juan@bevel.software', name: 'Juan Viera', onboardingDone: true } });
50
+
51
+ /** Reads the sidebar store the way a component would. */
52
+ function sidebarState() {
53
+ return renderHook(() => useSidebar()).result.current;
54
+ }
55
+
56
+ /** Where we are, whether we got here by being greeted, and any carried link. */
57
+ function LocationProbe() {
58
+ const { pathname, state } = useLocation();
59
+ const s = state as { greeting?: boolean; returnTo?: string | null } | null;
60
+ return (
61
+ <>
62
+ <div data-testid="pathname">{pathname}</div>
63
+ <div data-testid="greeting">{String(s?.greeting === true)}</div>
64
+ <div data-testid="returnTo">{s?.returnTo ?? ''}</div>
65
+ </>
66
+ );
67
+ }
68
+
69
+ /** The welcome page as the first-sign-in redirect leaves it: greeted. */
70
+ const greeted = { pathname: WELCOME_PATH, state: { greeting: true } };
71
+
72
+ /**
73
+ * Render `ui` inside the three contexts the onboarding actually reads — a
74
+ * router at `route`, an auth context holding `auth`, and the toast provider —
75
+ * plus the location probe every redirect assertion below looks at. `route`
76
+ * takes a location object when a test needs to arrive as the greeting does.
77
+ */
78
+ function mount(
79
+ ui: React.ReactNode,
80
+ auth = newUser(),
81
+ route: string | { pathname: string; state?: unknown } = '/',
82
+ ) {
83
+ return render(
84
+ <MemoryRouter initialEntries={[route]}>
85
+ <AuthContext.Provider value={auth}>
86
+ <LibraryToastProvider>
87
+ {ui}
88
+ <LocationProbe />
89
+ </LibraryToastProvider>
90
+ </AuthContext.Provider>
91
+ </MemoryRouter>,
92
+ );
93
+ }
94
+
95
+ const landingRoutes = (
96
+ <Routes>
97
+ <Route path="/" element={<RootLanding />} />
98
+ <Route path={WELCOME_PATH} element={<div>welcome page</div>} />
99
+ <Route path="/workspace" element={<div>knowledge</div>} />
100
+ </Routes>
101
+ );
102
+
103
+ beforeEach(() => {
104
+ resetOnboardingForTests();
105
+ authFetchMock.mockClear();
106
+ sessionStorage.clear();
107
+ });
108
+
109
+ /**
110
+ * jsdom ships no `navigator.clipboard`, so a copy test has to install one —
111
+ * but only THAT property, never a replacement `navigator`: the rest of the
112
+ * object (`userAgent`, `language`, whatever a library reaches for next) has no
113
+ * business changing because one test wanted a spy.
114
+ */
115
+ let restoreClipboard: (() => void) | null = null;
116
+
117
+ function stubClipboard() {
118
+ const writeText = vi.fn().mockResolvedValue(undefined);
119
+ const original = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
120
+ Object.defineProperty(navigator, 'clipboard', { value: { writeText }, configurable: true });
121
+ restoreClipboard = () => {
122
+ if (original) Object.defineProperty(navigator, 'clipboard', original);
123
+ else Reflect.deleteProperty(navigator, 'clipboard');
124
+ };
125
+ return writeText;
126
+ }
127
+
128
+ // In a hook, not at the end of a test body: a failing assertion would otherwise
129
+ // leave the stub installed for every test after it.
130
+ afterEach(() => {
131
+ restoreClipboard?.();
132
+ restoreClipboard = null;
133
+ vi.unstubAllGlobals();
134
+ });
135
+
136
+ describe('RootLanding: the one-time greeting', () => {
137
+ it('sends a brand-new account to the welcome page', () => {
138
+ mount(landingRoutes);
139
+ expect(screen.getByTestId('pathname')).toHaveTextContent(WELCOME_PATH);
140
+ });
141
+
142
+ // The flag the page reads to know this arrival is a ceremony rather than a
143
+ // visit — the sidebar collapse hangs off it, and only this navigation sets it.
144
+ it('marks the automatic redirect as a greeting', () => {
145
+ mount(landingRoutes);
146
+ expect(screen.getByTestId('greeting')).toHaveTextContent('true');
147
+ });
148
+
149
+ it('sends everyone the server marked done straight to Knowledge', () => {
150
+ mount(landingRoutes, doneUser());
151
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/workspace');
152
+ });
153
+
154
+ // Optional-field semantics: an ABSENT flag (old fixture, cached session)
155
+ // must never resurrect the welcome flow. Only an explicit false onboards.
156
+ it('treats a missing flag as done, not as new', () => {
157
+ mount(landingRoutes, authValue());
158
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/workspace');
159
+ });
160
+
161
+ /**
162
+ * The SSO round-trip returns to a fixed callback URL, so a deep link
163
+ * someone clicked dies in transit unless `startSsoLogin` stashed it. These
164
+ * prove the far side: the stash is honoured, exactly once, and can never
165
+ * point off-site.
166
+ */
167
+ it('sends an existing account straight to the stashed deep link, once', () => {
168
+ const DEEP = '/workspace/main/knowledge-base/KnowledgeBase/Start here.md';
169
+ sessionStorage.setItem(POST_LOGIN_REDIRECT_KEY, DEEP);
170
+ mount(landingRoutes, doneUser());
171
+ expect(screen.getByTestId('pathname')).toHaveTextContent(DEEP);
172
+ // Taken, not peeked: the next front-door visit is an ordinary one.
173
+ expect(sessionStorage.getItem(POST_LOGIN_REDIRECT_KEY)).toBeNull();
174
+ });
175
+
176
+ it('greets a brand-new account first, handing the link to the welcome page', () => {
177
+ const DEEP = '/workspace/main/knowledge-base/KnowledgeBase/Start here.md';
178
+ sessionStorage.setItem(POST_LOGIN_REDIRECT_KEY, DEEP);
179
+ mount(landingRoutes);
180
+ expect(screen.getByTestId('pathname')).toHaveTextContent(WELCOME_PATH);
181
+ expect(screen.getByTestId('greeting')).toHaveTextContent('true');
182
+ expect(screen.getByTestId('returnTo')).toHaveTextContent(DEEP);
183
+ });
184
+
185
+ it('discards a stash that is not an in-app path — never an off-site redirect', () => {
186
+ sessionStorage.setItem(POST_LOGIN_REDIRECT_KEY, '//evil.example/phish');
187
+ mount(landingRoutes, doneUser());
188
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/workspace');
189
+ });
190
+
191
+ it('greets ONCE: after the welcome page has been seen, / goes to Knowledge', async () => {
192
+ mount(
193
+ <Routes>
194
+ <Route path="/" element={<RootLanding />} />
195
+ <Route path={WELCOME_PATH} element={<WelcomePage />} />
196
+ <Route path="/workspace" element={<div>knowledge</div>} />
197
+ </Routes>,
198
+ );
199
+ // Landed on the real page, which marks `welcomed` on mount.
200
+ await screen.findByRole('heading', { name: /Welcome, Juan/ });
201
+ cleanup();
202
+ // A fresh visit to `/` — same account, same browser.
203
+ mount(landingRoutes);
204
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/workspace');
205
+ });
206
+ });
207
+
208
+ describe('WelcomePage', () => {
209
+ // Default: the ordinary visit, from the sidebar pill. The greeting — the
210
+ // one-time redirect — is the special case, and says so at each call site.
211
+ const mountPage = (auth = newUser(), route: string | typeof greeted = WELCOME_PATH) =>
212
+ mount(
213
+ <Routes>
214
+ <Route path={WELCOME_PATH} element={<WelcomePage />} />
215
+ <Route path="/skills-and-tools" element={<div>library</div>} />
216
+ <Route path="/skills-and-tools/yours" element={<div>your group</div>} />
217
+ </Routes>,
218
+ auth,
219
+ route,
220
+ );
221
+
222
+ it('addresses the person by first name', () => {
223
+ mountPage();
224
+ expect(screen.getByRole('heading', { name: 'Welcome, Juan' })).toBeInTheDocument();
225
+ });
226
+
227
+ /**
228
+ * The entrance must BEGIN on a painted frame. A CSS animation runs on the
229
+ * document timeline whether or not the browser is producing frames, so an
230
+ * animation attached at mount can elapse entirely during a cold boot and
231
+ * never be seen — the bug that made this page "just appear" at every
232
+ * duration we tried. Held invisible first, animating second.
233
+ */
234
+ it('starts its entrance on a painted frame, not at mount', async () => {
235
+ mountPage(newUser(), greeted);
236
+ const title = screen.getByRole('heading', { name: 'Welcome, Juan' });
237
+ const body = screen.getByText(/company’s shared library/).parentElement!;
238
+ // An inline style, deliberately — a utility class would depend on Tailwind
239
+ // having compiled it, and that is exactly what failed silently before.
240
+ expect(title.style.opacity).toBe('0');
241
+ expect(body.style.opacity).toBe('0');
242
+ await waitFor(() => {
243
+ expect(title.className).toContain('animate-onboarding-greeting');
244
+ expect(body.className).toContain('animate-onboarding-body');
245
+ });
246
+ // …and never both at once: held invisible and animating would fight.
247
+ expect(title.style.opacity).toBe('');
248
+ expect(body.style.opacity).toBe('');
249
+ });
250
+
251
+ /**
252
+ * Being welcomed happens once. Opening the same page from the pill later is
253
+ * a visit, and a 2.6s arrival every time you come back to copy your MCP
254
+ * snippet is a page you learn to dread — so there is no hold and no fade,
255
+ * only the page.
256
+ */
257
+ it('does not replay the entrance when you open it from the pill', () => {
258
+ mountPage();
259
+ const title = screen.getByRole('heading', { name: 'Welcome, Juan' });
260
+ expect(title.style.opacity).toBe('');
261
+ expect(title.className).not.toContain('animate-onboarding-greeting');
262
+ });
263
+
264
+ // However the sign-in record spells it. The page addressed to one person is
265
+ // the last place that should get their name wrong.
266
+ it('capitalizes the name whatever the account holds', () => {
267
+ mountPage(authValue({ user: { id: 'u1', email: 'j@bevel.software', name: 'juan viera', onboardingDone: false } }));
268
+ expect(screen.getByRole('heading', { name: 'Welcome, Juan' })).toBeInTheDocument();
269
+ });
270
+
271
+ it('greets someone with no name at all', () => {
272
+ mountPage(authValue({ user: { id: 'u1', email: 'j@bevel.software', name: '', onboardingDone: false } }));
273
+ expect(screen.getByRole('heading', { name: 'Welcome, there' })).toBeInTheDocument();
274
+ });
275
+
276
+ /**
277
+ * The nav gets out of the way for the greeting and STAYS out — there is no
278
+ * restore. Putting it back meant leaving a screen with no nav and arriving
279
+ * at one where the nav had opened itself, which is the app rearranging a
280
+ * page you asked for. Whether the sidebar shows is the toolbar toggle's to
281
+ * say, and after the greeting it says whatever it said last.
282
+ */
283
+ it('collapses the sidebar for the greeting, without animating it', () => {
284
+ setSidebarCollapsed(false);
285
+ mountPage(newUser(), greeted);
286
+ expect(sidebarState()).toMatchObject({ collapsed: true, instant: true });
287
+ });
288
+
289
+ it('leaves it collapsed when you go to your own group', async () => {
290
+ setSidebarCollapsed(false);
291
+ mountPage(newUser(), greeted);
292
+ await userEvent.click(screen.getByRole('button', { name: /Go to your skills/ }));
293
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/skills-and-tools/yours');
294
+ expect(sidebarState().collapsed).toBe(true);
295
+ });
296
+
297
+ it('leaves it collapsed after Done too', async () => {
298
+ setSidebarCollapsed(false);
299
+ mountPage(newUser(), greeted);
300
+ await userEvent.click(screen.getByRole('button', { name: 'Done' }));
301
+ expect(sidebarState().collapsed).toBe(true);
302
+ });
303
+
304
+ /**
305
+ * The one case where the nav is showing on the way out: you opened it
306
+ * yourself while you were here. The page collapses once, on arrival, and
307
+ * never touches the store again — so your gesture is the last word.
308
+ */
309
+ it('respects a sidebar you opened yourself while reading the page', async () => {
310
+ setSidebarCollapsed(false);
311
+ mountPage(newUser(), greeted);
312
+ expect(sidebarState().collapsed).toBe(true);
313
+ setSidebarCollapsed(false); // …the toolbar toggle, from the user's hand
314
+ await userEvent.click(screen.getByRole('button', { name: 'Done' }));
315
+ expect(sidebarState().collapsed).toBe(false);
316
+ });
317
+
318
+ it('leaves it collapsed for someone who arrived that way', () => {
319
+ setSidebarCollapsed(true);
320
+ const { unmount } = mountPage(newUser(), greeted);
321
+ expect(sidebarState().collapsed).toBe(true);
322
+ unmount();
323
+ expect(sidebarState().collapsed).toBe(true);
324
+ });
325
+
326
+ // Reached from the pill it is a page, not a ceremony: the nav it was just
327
+ // clicked in stays exactly where it is.
328
+ it('leaves the sidebar alone when you open it from the pill', () => {
329
+ setSidebarCollapsed(false);
330
+ const { unmount } = mountPage();
331
+ expect(sidebarState().collapsed).toBe(false);
332
+ unmount();
333
+ expect(sidebarState().collapsed).toBe(false);
334
+ });
335
+
336
+ it('shows one snippet at a time, following the picker', async () => {
337
+ mountPage();
338
+ // Claude default: the bare URL.
339
+ expect(screen.getByText(/\/api\/mcp$/)).toBeInTheDocument();
340
+ expect(screen.queryByText(/mcpServers/)).toBeNull();
341
+ await userEvent.click(screen.getByRole('radio', { name: 'Cursor & Others' }));
342
+ expect(screen.getByText(/mcpServers/)).toBeInTheDocument();
343
+ });
344
+
345
+ it('copies the visible snippet without concluding anything', async () => {
346
+ const writeText = stubClipboard();
347
+ mountPage();
348
+ await userEvent.click(screen.getByRole('button', { name: 'Copy' }));
349
+ expect(writeText).toHaveBeenCalledWith(expect.stringContaining('/api/mcp'));
350
+ // Copying is not Done: no server write, no navigation.
351
+ expect(authFetchMock).not.toHaveBeenCalled();
352
+ expect(screen.getByTestId('pathname')).toHaveTextContent(WELCOME_PATH);
353
+ });
354
+
355
+ // Exact, not a substring: `/skills-and-tools` is a PREFIX of the personal
356
+ // group's path, so a loose match would pass even if Done dropped someone in
357
+ // the whole company's catalog instead of their own shelf.
358
+ it('Done concludes: server write + landing in your own group', async () => {
359
+ mountPage();
360
+ await userEvent.click(screen.getByRole('button', { name: 'Done' }));
361
+ expect(authFetchMock).toHaveBeenCalledWith(
362
+ '/api/auth/onboarding-done',
363
+ expect.objectContaining({ method: 'POST' }),
364
+ );
365
+ expect(screen.getByTestId('pathname')).toHaveTextContent(/^\/skills-and-tools\/yours$/);
366
+ });
367
+
368
+ // Both exits, one destination — stated as its own fact so a future change to
369
+ // either button has to face the question deliberately.
370
+ it('sends you to the same place whether you finish or skip', async () => {
371
+ mountPage();
372
+ await userEvent.click(screen.getByRole('button', { name: 'Done' }));
373
+ const afterDone = screen.getByTestId('pathname').textContent;
374
+ cleanup();
375
+ mountPage();
376
+ await userEvent.click(screen.getByRole('button', { name: /Go to your skills/ }));
377
+ expect(screen.getByTestId('pathname')).toHaveTextContent(afterDone!);
378
+ });
379
+
380
+ // Exclusive-choice semantics: `radio` says one of these is always chosen
381
+ // and the others are not. Three `aria-pressed` toggles said any combination,
382
+ // including none, was possible.
383
+ it('presents the client picker as an exclusive choice', async () => {
384
+ mountPage();
385
+ const group = screen.getByRole('radiogroup', { name: 'Your agent' });
386
+ const options = screen.getAllByRole('radio');
387
+ expect(group).toContainElement(options[0]!);
388
+ expect(options.map((o) => o.getAttribute('aria-checked'))).toEqual(['true', 'false', 'false']);
389
+ await userEvent.click(screen.getByRole('radio', { name: 'ChatGPT' }));
390
+ expect(screen.getAllByRole('radio').map((o) => o.getAttribute('aria-checked'))).toEqual([
391
+ 'false',
392
+ 'true',
393
+ 'false',
394
+ ]);
395
+ });
396
+
397
+ /**
398
+ * `role="radiogroup"` is a promise about the keyboard, not just a label for
399
+ * a screen reader: arrows select, and selection follows focus. The group
400
+ * wraps, because three options in a row have no edge worth stopping at.
401
+ */
402
+ it('drives the picker with the arrow keys, wrapping at both ends', async () => {
403
+ mountPage();
404
+ const checked = () =>
405
+ screen.getAllByRole('radio').find((o) => o.getAttribute('aria-checked') === 'true');
406
+
407
+ screen.getByRole('radio', { name: 'Claude' }).focus();
408
+ await userEvent.keyboard('{ArrowRight}');
409
+ expect(checked()).toHaveAccessibleName('ChatGPT');
410
+ expect(checked()).toHaveFocus();
411
+
412
+ // Off the end and round to the first.
413
+ await userEvent.keyboard('{ArrowRight}{ArrowRight}');
414
+ expect(checked()).toHaveAccessibleName('Claude');
415
+
416
+ // And backwards past the start, to the last.
417
+ await userEvent.keyboard('{ArrowLeft}');
418
+ expect(checked()).toHaveAccessibleName('Cursor & Others');
419
+ });
420
+
421
+ // Roving tabindex: the picker is ONE tab stop, not one per client.
422
+ it('offers a single tab stop for the whole picker', () => {
423
+ mountPage();
424
+ expect(screen.getAllByRole('radio').map((o) => o.getAttribute('tabindex'))).toEqual([
425
+ '0',
426
+ '-1',
427
+ '-1',
428
+ ]);
429
+ });
430
+
431
+ // Into the person's OWN group, not the whole catalog — the same place the
432
+ // sidebar's personal row goes.
433
+ it('the skip link leaves for your own group, without concluding', async () => {
434
+ mountPage();
435
+ await userEvent.click(screen.getByRole('button', { name: /Go to your skills/ }));
436
+ expect(authFetchMock).not.toHaveBeenCalled();
437
+ expect(screen.getByTestId('pathname')).toHaveTextContent('/skills-and-tools/yours');
438
+ });
439
+
440
+ /**
441
+ * A deep link that survived the SSO round-trip retargets BOTH exits: the
442
+ * greeting concluded by discarding the page someone was sent would cost
443
+ * them the reason they came. The skip label says where it now goes.
444
+ */
445
+ it('keeps a carried deep link: Done lands on it, and the skip link says so', async () => {
446
+ const DEEP = '/workspace/main/knowledge-base/KnowledgeBase/Start here.md';
447
+ const arrivedWithLink = { pathname: WELCOME_PATH, state: { greeting: true, returnTo: DEEP } };
448
+ mountPage(newUser(), arrivedWithLink);
449
+ expect(screen.getByRole('button', { name: /Continue to your link/ })).toBeInTheDocument();
450
+ await userEvent.click(screen.getByRole('button', { name: 'Done' }));
451
+ expect(authFetchMock).toHaveBeenCalledWith(
452
+ '/api/auth/onboarding-done',
453
+ expect.objectContaining({ method: 'POST' }),
454
+ );
455
+ expect(screen.getByTestId('pathname')).toHaveTextContent(DEEP);
456
+ });
457
+ });
458
+
459
+ describe('ConnectAgentPill', () => {
460
+ const mountPill = (auth = newUser(), route = '/skills-and-tools') =>
461
+ mount(
462
+ <Routes>
463
+ <Route path="*" element={<ConnectAgentPill />} />
464
+ </Routes>,
465
+ auth,
466
+ route,
467
+ );
468
+
469
+ it('shows for a not-onboarded account and leads to the welcome page', async () => {
470
+ mountPill();
471
+ await userEvent.click(screen.getByRole('button', { name: 'Connect your agent' }));
472
+ expect(screen.getByTestId('pathname')).toHaveTextContent(WELCOME_PATH);
473
+ // …as a plain visit. The pill opens the page; it does not re-run the
474
+ // first-sign-in ceremony that folds the nav it lives in away.
475
+ expect(screen.getByTestId('greeting')).toHaveTextContent('false');
476
+ });
477
+
478
+ it('renders nothing once the server says done', () => {
479
+ mountPill(doneUser());
480
+ expect(screen.queryByRole('button', { name: 'Connect your agent' })).toBeNull();
481
+ });
482
+
483
+ // `page`, not `true` — the pill navigates, so the value that means "this is
484
+ // the page you are on" is the one a screen reader announces as such.
485
+ it('wears the selected state on the welcome page itself', () => {
486
+ mountPill(newUser(), WELCOME_PATH);
487
+ expect(screen.getByRole('button', { name: 'Connect your agent' })).toHaveAttribute(
488
+ 'aria-current',
489
+ 'page',
490
+ );
491
+ });
492
+
493
+ it('claims no current page anywhere else', () => {
494
+ mountPill();
495
+ expect(screen.getByRole('button', { name: 'Connect your agent' })).not.toHaveAttribute(
496
+ 'aria-current',
497
+ );
498
+ });
499
+
500
+ it('the × concludes: same field as Done. And the pill goes', async () => {
501
+ mountPill();
502
+ await userEvent.click(screen.getByRole('button', { name: /^Dismiss/ }));
503
+ expect(authFetchMock).toHaveBeenCalledWith(
504
+ '/api/auth/onboarding-done',
505
+ expect.objectContaining({ method: 'POST' }),
506
+ );
507
+ expect(screen.queryByRole('button', { name: 'Connect your agent' })).toBeNull();
508
+ });
509
+
510
+ // The stale-tab guard's client half: the request states which account it
511
+ // means, so the server can refuse to conclude somebody else's onboarding.
512
+ it('states which account it is concluding', async () => {
513
+ mountPill();
514
+ await userEvent.click(screen.getByRole('button', { name: /^Dismiss/ }));
515
+ expect(JSON.parse(String(fetchInit()?.body))).toEqual({ userId: 'u1' });
516
+ });
517
+
518
+ /**
519
+ * A write that never landed must not leave the UI claiming it did. The pill
520
+ * comes back immediately, rather than mysteriously reappearing at the next
521
+ * sign-in with no account of why it left.
522
+ */
523
+ it('brings the pill back when the server refuses the write', async () => {
524
+ authFetchMock.mockResolvedValueOnce({ ok: false, status: 409 } as Response);
525
+ const errors = vi.spyOn(console, 'error').mockImplementation(() => {});
526
+ mountPill();
527
+ await userEvent.click(screen.getByRole('button', { name: /^Dismiss/ }));
528
+ expect(
529
+ await screen.findByRole('button', { name: 'Connect your agent' }),
530
+ ).toBeInTheDocument();
531
+ errors.mockRestore();
532
+ });
533
+ });
@@ -0,0 +1,48 @@
1
+ /**
2
+ * The three ways an agent connects, named by PRODUCT rather than surface —
3
+ * someone knows which assistant they use before they know which build of it
4
+ * they are in (prototype `AGENT_CLIENTS`).
5
+ *
6
+ * The endpoint is derived from the page's own origin, exactly as the
7
+ * External agent access page derives it (`ExternalAgentAccessPage.tsx`), so
8
+ * the welcome page and the settings page can never hand out different URLs.
9
+ * Passed in rather than read from `window` here, so tests can pin it.
10
+ */
11
+
12
+ export interface AgentClient {
13
+ id: 'claude' | 'chatgpt' | 'other';
14
+ label: string;
15
+ /** Where the snippet goes, said as the path through that client's own UI. */
16
+ hint: string;
17
+ /** What the copy button carries for this client. */
18
+ snip(mcpUrl: string): string;
19
+ }
20
+
21
+ export const AGENT_CLIENTS: AgentClient[] = [
22
+ {
23
+ id: 'claude',
24
+ label: 'Claude',
25
+ hint: 'claude.ai or Claude Desktop: Settings → Connectors → Add custom connector, then paste this. In Claude Code, `claude mcp add` takes the same URL.',
26
+ snip: (url) => url,
27
+ },
28
+ {
29
+ id: 'chatgpt',
30
+ label: 'ChatGPT',
31
+ hint: 'Settings → Connectors → Create, then paste this.',
32
+ snip: (url) => url,
33
+ },
34
+ {
35
+ id: 'other',
36
+ label: 'Cursor & Others',
37
+ hint: 'For clients that read their servers from a JSON config, like Cursor, Windsurf and Cline.',
38
+ snip: (url) =>
39
+ JSON.stringify({ mcpServers: { 'knowledge-base': { type: 'http', url } } }, null, 2),
40
+ },
41
+ ];
42
+
43
+ /**
44
+ * The MCP endpoint for a given page origin — the one URL every snippet above
45
+ * is built from. Derived rather than configured, so a deployment on any host
46
+ * hands out its own address without anyone remembering to update a constant.
47
+ */
48
+ export const mcpUrlFromOrigin = (origin: string): string => `${origin}/api/mcp`;