@bevel-software/platform-core-frontend 0.4.1 → 0.5.1

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 (327) hide show
  1. package/THIRD-PARTY-NOTICES.md +5366 -0
  2. package/package.json +7 -4
  3. package/src/core/CoreAppShell.tsx +195 -56
  4. package/src/core/__tests__/AppChrome.test.tsx +125 -0
  5. package/src/core/__tests__/ShellRoutes.test.tsx +37 -2
  6. package/src/core/__tests__/bootstrap.test.ts +63 -0
  7. package/src/core/bootstrap.ts +73 -0
  8. package/src/core/events.ts +12 -0
  9. package/src/core/registry.ts +58 -9
  10. package/src/index.css +100 -11
  11. package/src/index.ts +24 -23
  12. package/src/lib/utils.ts +93 -117
  13. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
  15. package/src/modules/access/api.ts +49 -0
  16. package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
  17. package/src/modules/access/hooks/useFileAccess.ts +1 -1
  18. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
  19. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +17 -1
  20. package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
  21. package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
  22. package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
  23. package/src/modules/admin/components/UserAccountsPage.tsx +36 -28
  24. package/src/modules/admin/state/admin.context.tsx +15 -6
  25. package/src/modules/auth/components/AccountPage.tsx +11 -11
  26. package/src/modules/auth/components/LoginScreen.tsx +12 -12
  27. package/src/modules/auth/services/sso.ts +47 -1
  28. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
  29. package/src/modules/change-requests/__tests__/author.test.ts +48 -0
  30. package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
  31. package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
  32. package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
  33. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
  34. package/src/modules/change-requests/change-requests.css +22 -0
  35. package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
  36. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
  37. package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
  38. package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
  39. package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
  40. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
  41. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
  42. package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
  43. package/src/modules/change-requests/services/change-requests.api.ts +45 -0
  44. package/src/modules/change-requests/services/propose.api.ts +162 -0
  45. package/src/modules/change-requests/utils/author.ts +47 -0
  46. package/src/modules/change-requests/utils/conflict.ts +38 -0
  47. package/src/modules/change-requests/utils/diff.ts +80 -0
  48. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
  49. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
  50. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
  51. package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
  52. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
  53. package/src/modules/git/components/BranchSwitcher.tsx +68 -31
  54. package/src/modules/git/components/DiffView.tsx +4 -4
  55. package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
  56. package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
  57. package/src/modules/git/components/PullNeededBanner.tsx +6 -13
  58. package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
  59. package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
  60. package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
  61. package/src/modules/git/hooks/useGitState.ts +15 -14
  62. package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
  63. package/src/modules/git/services/error-messages.ts +7 -7
  64. package/src/modules/git/services/git.api.ts +17 -11
  65. package/src/modules/git/services/pr-prompts.ts +2 -2
  66. package/src/modules/git/state/git.context.ts +10 -1
  67. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
  68. package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
  69. package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
  70. package/src/modules/layout/breakpoints.ts +6 -0
  71. package/src/modules/layout/components/AppLayout.tsx +17 -5
  72. package/src/modules/layout/components/DemoBanner.tsx +10 -1
  73. package/src/modules/layout/components/MaintenanceOverlay.tsx +3 -3
  74. package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
  75. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
  76. package/src/modules/layout/components/SidebarFrame.tsx +317 -0
  77. package/src/modules/layout/components/SidebarToggle.tsx +86 -0
  78. package/src/modules/layout/components/SlideOverlay.tsx +1 -1
  79. package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
  80. package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
  81. package/src/modules/layout/state/sidebar.ts +200 -0
  82. package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
  83. package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
  84. package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
  85. package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
  86. package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
  87. package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
  88. package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
  89. package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
  90. package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
  91. package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
  92. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
  93. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
  94. package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
  95. package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
  96. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
  97. package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
  98. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
  99. package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
  100. package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
  101. package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
  102. package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
  103. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
  104. package/src/modules/library/__tests__/auth-harness.tsx +37 -0
  105. package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
  106. package/src/modules/library/__tests__/status.test.ts +113 -20
  107. package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
  108. package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
  109. package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
  110. package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
  111. package/src/modules/library/components/ChangeRequestDock.tsx +52 -28
  112. package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
  113. package/src/modules/library/components/GroupIndexRow.tsx +63 -0
  114. package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
  115. package/src/modules/library/components/GroupPage.tsx +373 -0
  116. package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
  117. package/src/modules/library/components/GroupsSidebar.tsx +338 -0
  118. package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
  119. package/src/modules/library/components/LibraryCard.tsx +123 -102
  120. package/src/modules/library/components/LibraryLayout.tsx +344 -0
  121. package/src/modules/library/components/LibraryPage.tsx +111 -227
  122. package/src/modules/library/components/LockGlyph.tsx +31 -0
  123. package/src/modules/library/components/LockedGroupView.tsx +159 -0
  124. package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
  125. package/src/modules/library/components/NewGroupDialog.tsx +112 -0
  126. package/src/modules/library/components/NewSkillPanel.tsx +151 -0
  127. package/src/modules/library/components/PageActions.tsx +156 -0
  128. package/src/modules/library/components/PendingSkillReview.tsx +63 -0
  129. package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
  130. package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
  131. package/src/modules/library/components/StatusDot.tsx +25 -0
  132. package/src/modules/library/components/ToolLogo.tsx +171 -0
  133. package/src/modules/library/components/group-page-parts.tsx +419 -0
  134. package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
  135. package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
  136. package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
  137. package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
  138. package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
  139. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
  140. package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
  141. package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
  142. package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
  143. package/src/modules/library/hooks/useJoinRequests.ts +114 -0
  144. package/src/modules/library/hooks/useLibraryData.ts +134 -119
  145. package/src/modules/library/hooks/useSkillDetail.ts +119 -74
  146. package/src/modules/library/hooks/useToolPage.ts +145 -0
  147. package/src/modules/library/library.css +33 -245
  148. package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
  149. package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
  150. package/src/modules/library/routes/library-paths.ts +191 -0
  151. package/src/modules/library/services/groups.api.ts +189 -0
  152. package/src/modules/library/services/library.api.ts +291 -164
  153. package/src/modules/library/services/tools.api.ts +60 -0
  154. package/src/modules/library/state/library-context.ts +22 -0
  155. package/src/modules/library/state/library-data.tsx +223 -0
  156. package/src/modules/library/state/toast.context.ts +32 -0
  157. package/src/modules/library/state/toast.tsx +84 -42
  158. package/src/modules/library/utils/clipboard.ts +33 -0
  159. package/src/modules/library/utils/group-summary.ts +68 -0
  160. package/src/modules/library/utils/names.ts +30 -0
  161. package/src/modules/library/utils/navigate-external.ts +15 -0
  162. package/src/modules/library/utils/oauth-fragment.ts +32 -0
  163. package/src/modules/library/utils/personal-group.ts +36 -0
  164. package/src/modules/library/utils/status.ts +108 -25
  165. package/src/modules/library/utils/toast-duration.ts +16 -0
  166. package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
  167. package/src/modules/onboarding/agent-clients.ts +48 -0
  168. package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
  169. package/src/modules/onboarding/components/RootLanding.tsx +54 -0
  170. package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
  171. package/src/modules/onboarding/paths.ts +9 -0
  172. package/src/modules/onboarding/state/onboarding.ts +191 -0
  173. package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
  174. package/src/modules/pr/services/pr-approvals.api.ts +19 -0
  175. package/src/modules/pr/services/pr-cancel.api.ts +11 -0
  176. package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
  177. package/src/modules/review/components/DiffViewer.tsx +4 -4
  178. package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
  179. package/src/modules/review/components/ReviewFileRow.tsx +10 -10
  180. package/src/modules/review/components/ReviewPanel.tsx +49 -17
  181. package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
  182. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
  183. package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
  184. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
  185. package/src/modules/secrets-vault/components/SecretsPage.tsx +147 -110
  186. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
  187. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +35 -4
  188. package/src/modules/secrets-vault/services/connect.api.ts +24 -3
  189. package/src/modules/settings/components/DeploymentPage.tsx +90 -0
  190. package/src/modules/settings/components/SettingsLayout.tsx +135 -0
  191. package/src/modules/settings/components/SettingsNav.tsx +114 -0
  192. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
  193. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
  194. package/src/modules/settings/settings-nav-items.tsx +166 -0
  195. package/src/modules/setup/__tests__/setup.test.tsx +540 -0
  196. package/src/modules/setup/components/SetupGate.tsx +67 -0
  197. package/src/modules/setup/components/SetupScreen.tsx +573 -0
  198. package/src/modules/setup/services/setup.api.ts +106 -0
  199. package/src/modules/setup/utils/git-host.ts +34 -0
  200. package/src/modules/toolbar/components/AppSwitcher.tsx +38 -15
  201. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +50 -50
  202. package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
  203. package/src/modules/toolbar/components/Toolbar.tsx +56 -54
  204. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
  205. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
  206. package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
  207. package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
  208. package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
  209. package/src/modules/workspace/components/EditorTabs.tsx +82 -50
  210. package/src/modules/workspace/components/FileExplorer.tsx +413 -189
  211. package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
  212. package/src/modules/workspace/components/FileRoute.tsx +89 -84
  213. package/src/modules/workspace/components/FileViewer.tsx +700 -294
  214. package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
  215. package/src/modules/workspace/components/KbFileRail.tsx +128 -0
  216. package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
  217. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
  218. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
  219. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
  220. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
  221. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
  222. package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
  223. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
  224. package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
  225. package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
  226. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
  227. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
  228. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
  229. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
  230. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
  231. package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
  232. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
  233. package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
  234. package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
  235. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
  236. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
  237. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
  238. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
  239. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
  240. package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
  241. package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
  242. package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
  243. package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
  244. package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
  245. package/src/modules/workspace/components/renderers/index.ts +78 -2
  246. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
  247. package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
  248. package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
  249. package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
  250. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
  251. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
  252. package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
  253. package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
  254. package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
  255. package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
  256. package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
  257. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
  258. package/src/modules/workspace/services/workspace.api.ts +9 -2
  259. package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
  260. package/src/modules/workspace/state/open-change-requests.tsx +185 -0
  261. package/src/modules/workspace/state/workspace.context.ts +9 -0
  262. package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
  263. package/src/modules/workspace/utils/diff.ts +130 -53
  264. package/src/modules/workspace/utils/fileTree.ts +7 -4
  265. package/src/modules/workspace/workspace.css +28 -0
  266. package/src/shared/components/Badge.tsx +62 -0
  267. package/src/shared/components/Banner.tsx +58 -0
  268. package/src/shared/components/Button.tsx +90 -0
  269. package/src/shared/components/Dialog.tsx +6 -6
  270. package/src/shared/components/Field.tsx +45 -0
  271. package/src/shared/components/IconButton.tsx +74 -0
  272. package/src/shared/components/ListRow.tsx +96 -0
  273. package/src/shared/components/Menu.tsx +88 -0
  274. package/src/shared/components/PageShell.tsx +8 -5
  275. package/src/shared/components/Surface.tsx +86 -0
  276. package/src/shared/components/__tests__/primitives.test.tsx +333 -0
  277. package/src/shared/components/index.ts +48 -0
  278. package/src/shared/components/useDismissableMenu.ts +71 -0
  279. package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
  280. package/src/shared/theme/index.css +12 -0
  281. package/src/shared/theme/measure.ts +64 -0
  282. package/src/shared/theme/shadows.css +34 -0
  283. package/src/shared/theme/tokens.css +193 -0
  284. package/src/test-setup.ts +9 -0
  285. package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
  286. package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
  287. package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
  288. package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
  289. package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
  290. package/src/modules/library/__tests__/diff.test.ts +0 -62
  291. package/src/modules/library/__tests__/loadout.test.tsx +0 -72
  292. package/src/modules/library/components/CompareView.tsx +0 -357
  293. package/src/modules/library/components/DetailDialog.tsx +0 -566
  294. package/src/modules/library/components/GearIcon.tsx +0 -12
  295. package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
  296. package/src/modules/library/components/StatusGem.tsx +0 -21
  297. package/src/modules/library/components/SuggestChange.tsx +0 -171
  298. package/src/modules/library/components/particles.ts +0 -50
  299. package/src/modules/library/state/loadout.tsx +0 -129
  300. package/src/modules/library/utils/diff.ts +0 -102
  301. package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
  302. package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
  303. package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
  304. package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
  305. package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
  306. package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
  307. package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
  308. package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
  309. package/src/modules/pr/components/PrCancelButton.tsx +0 -99
  310. package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
  311. package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
  312. package/src/modules/pr/components/PrCommentThread.tsx +0 -168
  313. package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
  314. package/src/modules/pr/components/PrDiffPane.tsx +0 -425
  315. package/src/modules/pr/components/PrFileRow.tsx +0 -164
  316. package/src/modules/pr/components/PrFilesList.tsx +0 -53
  317. package/src/modules/pr/components/PrHeader.tsx +0 -45
  318. package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
  319. package/src/modules/pr/components/PrMergeButton.tsx +0 -268
  320. package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
  321. package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
  322. package/src/modules/pr/components/PrViewer.tsx +0 -364
  323. package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
  324. package/src/modules/pr/state/pr-viewer.context.ts +0 -34
  325. package/src/modules/pr/utils/bucketize-comments.ts +0 -55
  326. package/src/modules/pr/utils/parsePatch.ts +0 -57
  327. package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
@@ -0,0 +1,134 @@
1
+ import { Navigate, Route, Routes, useLocation, useParams } from 'react-router-dom';
2
+ import { LibraryToastProvider } from '../state/toast';
3
+ import { LibraryProvider, useLibrary } from '../state/library-data';
4
+ import { useWorkspace } from '../../workspace/state/workspace.context';
5
+ import { LibraryLayout } from '../components/LibraryLayout';
6
+ import { LibraryPage } from '../components/LibraryPage';
7
+ import { GroupPage } from '../components/GroupPage';
8
+ import { GroupsIndexPage } from '../components/GroupsIndexPage';
9
+ import { PersonalGroupPage } from '../components/PersonalGroupPage';
10
+ import { WelcomePage } from '../../onboarding/components/WelcomePage';
11
+ import { WorkspaceItemRoute } from './WorkspaceItemRoute';
12
+ import { decodeGroupSegment, LIBRARY_ROOT, urlForItemFile, urlForSkillFile } from './library-paths';
13
+
14
+ /**
15
+ * The Skills & Tools surface — everything under `/skills-and-tools/*`.
16
+ *
17
+ * The shell mounts this once (`CORE_APPS`), so the toast host and the data
18
+ * provider wrap the WHOLE surface rather than one page: navigating between the
19
+ * gallery, a group and an item must not refetch the catalog or drop a toast
20
+ * mid-flight.
21
+ *
22
+ * Paths below are RELATIVE — the shell already matched `/skills-and-tools/*`.
23
+ *
24
+ * URL is the single source of truth for selection. There is no filter state
25
+ * anywhere in the Library: `LibraryLayout` derives what the sidebar shows from
26
+ * the path, and a click navigates. That is what makes deep links, the back
27
+ * button and the item pages' links all land on the same thing.
28
+ */
29
+ export function LibraryRoutes() {
30
+ return (
31
+ <LibraryToastProvider>
32
+ <LibraryProvider>
33
+ <Routes>
34
+ <Route element={<LibraryLayout />}>
35
+ {/* The Library OPENS on its groups. A group is where skills and
36
+ tools live and who they are for, so the index of them is the
37
+ orienting view; the undifferentiated card grid is a lens on
38
+ the same catalog and keeps its own row and URL below. */}
39
+ <Route index element={<GroupsIndexPage />} />
40
+
41
+ {/* The whole catalog as cards, with the library-wide search. */}
42
+ <Route path="everything" element={<LibraryPage filter={{ kind: 'all' }} />} />
43
+
44
+ {/* The connect-your-agent welcome — inside the layout, so the
45
+ sidebar (and the pill's selected state) is on screen with it.
46
+ Auto-reached once, on first sign-in (see `RootLanding`);
47
+ reachable forever through the pill and by URL. */}
48
+ <Route path="welcome" element={<WelcomePage />} />
49
+
50
+ <Route path="owned" element={<LibraryPage filter={{ kind: 'owned' }} />} />
51
+
52
+ {/* `yours` is a GROUP page, not a gallery filter — the items in no
53
+ folder, given the same page the folders get. The sidebar still
54
+ lights it through the `ungrouped` filter, so the URL and the
55
+ selection stay the pair they were. */}
56
+ <Route path="yours" element={<PersonalGroupPage />} />
57
+
58
+ {/* A group is a PLACE: `groups/:group` is a real page with a real
59
+ URL, and `GroupPage` — not the router — decides whether the
60
+ caller gets the member view or the locked one. */}
61
+ {/* The index moved to the root. This path is where every older
62
+ link points, so it redirects rather than 404s or duplicates
63
+ the page at a second URL. */}
64
+ <Route path="groups" element={<Navigate to={LIBRARY_ROOT} replace />} />
65
+ <Route path="groups/:group" element={<GroupPage />} />
66
+
67
+ {/* The canonical item addresses. This surface is mounted at TWO
68
+ shell paths (`/skills-and-tools/*` and, for default-branch
69
+ `Groups/` URLs, `/workspace/*` — see `isLibraryLocation` and
70
+ the shell's `CoreSurfaces`), and under the second the remainder
71
+ is `<branch>/<kbDir>/Groups/...`. Matching it HERE, inside the
72
+ layout route, is what makes a skill page share the exact
73
+ sidebar instance the reader browsed in with — one surface, not
74
+ a second implementation of it. Static siblings above outrank
75
+ the param, so no `/skills-and-tools` page is shadowed. */}
76
+ <Route path=":branch/*" element={<WorkspaceItemRoute />} />
77
+ </Route>
78
+
79
+ {/* LEGACY item addresses. The canonical URL of a skill or tool is
80
+ its workspace file URL (`urlForItemFile` — one URL system for
81
+ humans and agents; `WorkspaceItemGate` renders the pages there).
82
+ These name-based routes survive as redirects because links to
83
+ them exist in the wild, the Secrets/Connect pages still build
84
+ them by slug, and `tools/:slug` is the server-validated OAuth
85
+ `returnTo` — the redirect carries the callback's `#…` fragment
86
+ along. Outside the layout route: a redirect never paints a
87
+ sidebar on its way through. */}
88
+ <Route path="tools/:slug" element={<LegacyToolRedirect />} />
89
+ <Route path="skills/:name" element={<LegacySkillRedirect />} />
90
+
91
+ {/* An unknown subpath is a stale or mistyped link, not an error page —
92
+ send it home. Outside the layout route so a redirect never paints
93
+ a sidebar on its way through. */}
94
+ <Route path="*" element={<Navigate to={LIBRARY_ROOT} replace />} />
95
+ </Routes>
96
+ </LibraryProvider>
97
+ </LibraryToastProvider>
98
+ );
99
+ }
100
+
101
+ /** `skills/:name` → the skill's canonical workspace URL (its SKILL.md). */
102
+ function LegacySkillRedirect() {
103
+ const { name = '' } = useParams<{ name: string }>();
104
+ const data = useLibrary();
105
+ const { kbDirName } = useWorkspace();
106
+ const decoded = decodeGroupSegment(name);
107
+ const skill = data.items.find((i) => i.kind === 'skill' && i.id === decoded);
108
+ if (skill && kbDirName) return <Navigate to={urlForSkillFile(kbDirName, skill.path)} replace />;
109
+ if (kbDirName === null) return null;
110
+ if (data.loading) return null;
111
+ return <Navigate to={LIBRARY_ROOT} replace />;
112
+ }
113
+
114
+ /**
115
+ * `tools/:slug` → the manual's canonical workspace URL. The `#…` fragment is
116
+ * carried along explicitly — this route is the OAuth callback's landing
117
+ * target, and the fragment is the outcome it came back with.
118
+ */
119
+ function LegacyToolRedirect() {
120
+ const { slug = '' } = useParams<{ slug: string }>();
121
+ const location = useLocation();
122
+ const data = useLibrary();
123
+ const { kbDirName } = useWorkspace();
124
+ const decoded = decodeGroupSegment(slug);
125
+ const tool = data.items.find((i) => i.kind === 'integration' && i.id === decoded);
126
+ if (kbDirName === null) return null;
127
+ if (tool) {
128
+ return (
129
+ <Navigate to={{ pathname: urlForItemFile(kbDirName, tool.path), hash: location.hash }} replace />
130
+ );
131
+ }
132
+ if (data.loading) return null;
133
+ return <Navigate to={LIBRARY_ROOT} replace />;
134
+ }
@@ -0,0 +1,74 @@
1
+ import { Navigate, useParams } from 'react-router-dom';
2
+ import { DEFAULT_BRANCH, GROUPS_DIR } from '@bevel-software/platform-shared';
3
+ import { useWorkspace } from '../../workspace/state/workspace.context';
4
+ import { useLibrary } from '../state/library-data';
5
+ import { SkillPage } from '../components/skill-page/SkillPage';
6
+ import { ToolPage } from '../components/tool-page/ToolPage';
7
+ import { LIBRARY_ROOT, pathForGroup } from './library-paths';
8
+
9
+ /**
10
+ * The library page behind a canonical workspace URL —
11
+ * `/workspace/<default>/<kbDir>/Groups/<group>/<...>` — rendered INSIDE the
12
+ * same `LibraryLayout` route tree as every other library page, so the sidebar
13
+ * is the one the reader already had and nothing remounts on the way in.
14
+ *
15
+ * Resolution is STRUCTURAL, not a catalog lookup: under `Groups/<group>/`, a
16
+ * `*.tool` file is a tool page, any other direct FILE (an extension, no
17
+ * segments below it — `access.md`) belongs to the group page, and everything
18
+ * else is a skill FOLDER whose name is the skill's id — the same identity the
19
+ * old name-based route used. That is what makes a skill created a moment ago
20
+ * open instantly: its URL says everything the page needs, and `SkillPage`
21
+ * fetches the skill by name itself. Waiting on the catalog here raced every
22
+ * reload and lost (the just-created skill bounced to its group's page).
23
+ *
24
+ * The catalog is consulted only to REFINE a tool's slug (a `.tool` may
25
+ * declare an explicit id different from its filename); the filename is the
26
+ * fallback, which is also the default the backend derives.
27
+ */
28
+ export function WorkspaceItemRoute() {
29
+ const params = useParams<{ branch: string; '*': string }>();
30
+ const splat = params['*'] ?? '';
31
+ const branch = safeDecode(params.branch ?? '');
32
+ const { kbDirName } = useWorkspace();
33
+ const data = useLibrary();
34
+
35
+ // Shape re-validation: the route pattern (`:branch/*`) is broader than the
36
+ // shape the shell dispatches here, and a stray URL must not read as a page.
37
+ const segments = splat.split('/').filter(Boolean).map(safeDecode);
38
+ if (branch !== DEFAULT_BRANCH || segments[1] !== GROUPS_DIR || segments.length < 3) {
39
+ return <Navigate to={LIBRARY_ROOT} replace />;
40
+ }
41
+ if (kbDirName !== null && segments[0] !== kbDirName) {
42
+ return <Navigate to={LIBRARY_ROOT} replace />;
43
+ }
44
+
45
+ const [, , group, entry, ...rest] = segments;
46
+ if (!group || !entry) {
47
+ return <Navigate to={LIBRARY_ROOT} replace />;
48
+ }
49
+
50
+ if (rest.length === 0 && entry.toLowerCase().endsWith('.tool')) {
51
+ const repoRel = `${GROUPS_DIR}/${group}/${entry}`;
52
+ const catalogSlug = data.items.find(
53
+ (i) => i.kind === 'integration' && i.path === repoRel,
54
+ )?.id;
55
+ return <ToolPage slug={catalogSlug ?? entry.slice(0, -'.tool'.length)} />;
56
+ }
57
+
58
+ // A direct FILE in the group folder (`access.md`, a stray upload) is the
59
+ // group's business, not a page of its own.
60
+ if (rest.length === 0 && /\.[a-z0-9]+$/i.test(entry)) {
61
+ return <Navigate to={pathForGroup(group)} replace />;
62
+ }
63
+
64
+ return <SkillPage name={entry} activeFile={rest.join('/') || 'SKILL.md'} />;
65
+ }
66
+
67
+ /** A malformed escape is a bad link, not a crash — fall back to the raw segment. */
68
+ function safeDecode(raw: string): string {
69
+ try {
70
+ return decodeURIComponent(raw);
71
+ } catch {
72
+ return raw;
73
+ }
74
+ }
@@ -0,0 +1,191 @@
1
+ import { DEFAULT_BRANCH, GROUPS_DIR, groupOfPath, isPersonalGroupFolder } from '@bevel-software/platform-shared';
2
+ import { matchPath } from 'react-router-dom';
3
+ import { kbFileUrl } from '../../workspace/routing/kb-routes';
4
+ import type { LibraryFilter } from '../utils/status';
5
+
6
+ /**
7
+ * The Library's URL↔selection mapping, in one place and in both directions.
8
+ *
9
+ * Pure functions rather than logic inside the layout, because three surfaces
10
+ * need them: the layout (to light the right sidebar row), every page that links
11
+ * to a group, and the tests. Keeping the pair together is what makes the round
12
+ * trip auditable — a path that maps to a filter must map back to itself.
13
+ */
14
+
15
+ /** The Library's mount point inside the shell (`CORE_APPS` `skills-tools`). */
16
+ export const LIBRARY_ROOT = '/skills-and-tools';
17
+
18
+ /**
19
+ * What the sidebar should show as selected for a path. `null` on the pages that
20
+ * are not a filtered view of the catalog — the all-groups index (the root, see
21
+ * `isGroupsIndexPath`) and the item pages — where the gallery rows are all
22
+ * inactive.
23
+ *
24
+ * `matchPath` hands params back RAW (react-router decodes neither here nor in
25
+ * `useParams`), so a group named `Sales & Ops` arrives as `Sales%20%26%20Ops`
26
+ * and has to be decoded to match the catalog's folder name. The group page owes
27
+ * the same decode on `useParams().group`.
28
+ */
29
+ export function libraryFilterForPath(pathname: string): LibraryFilter | null {
30
+ if (matchPath({ path: `${LIBRARY_ROOT}/everything`, end: true }, pathname)) return { kind: 'all' };
31
+ if (matchPath({ path: `${LIBRARY_ROOT}/owned`, end: true }, pathname)) return { kind: 'owned' };
32
+ if (matchPath({ path: `${LIBRARY_ROOT}/yours`, end: true }, pathname)) return { kind: 'ungrouped' };
33
+ const group = matchPath({ path: `${LIBRARY_ROOT}/groups/:group`, end: true }, pathname);
34
+ if (group?.params.group) return { kind: 'group', group: decodeSegment(group.params.group) };
35
+ return null;
36
+ }
37
+
38
+ /** The path a sidebar selection navigates to. */
39
+ export function pathForLibraryFilter(filter: LibraryFilter): string {
40
+ switch (filter.kind) {
41
+ case 'all':
42
+ return `${LIBRARY_ROOT}/everything`;
43
+ case 'owned':
44
+ return `${LIBRARY_ROOT}/owned`;
45
+ case 'ungrouped':
46
+ return `${LIBRARY_ROOT}/yours`;
47
+ case 'group':
48
+ return pathForGroup(filter.group);
49
+ }
50
+ }
51
+
52
+ /** The route for one group — member view or locked view, the page decides. */
53
+ export function pathForGroup(group: string): string {
54
+ return `${LIBRARY_ROOT}/groups/${encodeURIComponent(group)}`;
55
+ }
56
+
57
+ /**
58
+ * The all-groups index — the Library's HOME. Groups are the structure of this
59
+ * surface, so the index of them is what the root shows; `groups` is kept as a
60
+ * redirect so the links that used to name it still land.
61
+ */
62
+ export function pathForGroupsIndex(): string {
63
+ return LIBRARY_ROOT;
64
+ }
65
+
66
+ /**
67
+ * Read a `:group` route param. React-router 7 hands params back RAW from both
68
+ * `matchPath` and `useParams`, so every reader owes this decode — and a
69
+ * malformed escape (`%zz`, from a hand-edited or truncated link) THROWS, which
70
+ * would blank the page. A bad link is a bad link, not a crash: fall back to the
71
+ * raw segment and let the group simply not be found.
72
+ */
73
+ export function decodeGroupSegment(raw: string): string {
74
+ return decodeSegment(raw);
75
+ }
76
+
77
+ /**
78
+ * The CANONICAL URL of a library item: its workspace file URL on the default
79
+ * branch — `/workspace/main/<kbDir>/<repo path>`. One URL system for humans
80
+ * and agents: the address a card navigates to is the address an agent can
81
+ * derive from the repo path it already works with, and the Knowledge tree's
82
+ * link to the same file lands on the same page. `WorkspaceItemGate` is what
83
+ * makes these URLs render the library surface instead of the raw file view.
84
+ *
85
+ * For a skill, pass the FILE inside the folder (`<skillPath>/SKILL.md`, a
86
+ * reference doc, a script) — each file of a multi-file skill has its own URL,
87
+ * and the page opens on that tab. A bare skill-folder URL opens SKILL.md.
88
+ */
89
+ export function urlForItemFile(kbDirName: string, repoRelativePath: string): string {
90
+ return kbFileUrl(DEFAULT_BRANCH, `${kbDirName}/${repoRelativePath}`);
91
+ }
92
+
93
+ /** The canonical URL of one file of a skill (default: its SKILL.md). */
94
+ export function urlForSkillFile(kbDirName: string, skillPath: string, file = 'SKILL.md'): string {
95
+ return urlForItemFile(kbDirName, `${skillPath}/${file}`);
96
+ }
97
+
98
+ /**
99
+ * Whether a location belongs to the LIBRARY surface — decided by URL SHAPE
100
+ * alone, never by catalog contents: `/skills-and-tools/...`, or a
101
+ * default-branch workspace URL under `Groups/`
102
+ * (`/workspace/<default>/<kbDir>/Groups/<group>/...`). KnowledgeBase paths go
103
+ * to the Knowledge surface, Groups paths to Skills & Tools — the two roots ARE
104
+ * the two apps. A shape rule means a just-created skill routes correctly
105
+ * before any catalog has heard of it.
106
+ *
107
+ * Non-default branches stay with Knowledge deliberately: the library pages
108
+ * speak the default branch, and a draft's file is reviewed raw.
109
+ */
110
+ export function isLibraryLocation(pathname: string): boolean {
111
+ if (pathname === LIBRARY_ROOT || pathname.startsWith(`${LIBRARY_ROOT}/`)) return true;
112
+ const segments = pathname.split('/').filter(Boolean).map(decodeSegment);
113
+ return (
114
+ segments[0] === 'workspace' &&
115
+ segments[1] === DEFAULT_BRANCH &&
116
+ segments[3] === GROUPS_DIR &&
117
+ segments.length >= 6 // workspace/<branch>/<kbDir>/Groups/<group>/<item>
118
+ );
119
+ }
120
+
121
+ /**
122
+ * The LEGACY route for one tool — now a redirect to the canonical workspace
123
+ * URL (`urlForItemFile`), preserving any `#…` the OAuth callback appended.
124
+ * Still built in three places, deliberately: the Secrets and Connect pages
125
+ * link it by slug (they don't carry the repo path), and the tool page's own
126
+ * OAuth `returnTo` MUST stay this shape — the server validates it.
127
+ *
128
+ * Returns the BARE path: never append `#…` to it. The OAuth start route rejects
129
+ * a `returnTo` containing `#`, and the callback is what puts the fragment on.
130
+ */
131
+ export function pathForTool(slug: string): string {
132
+ return `${LIBRARY_ROOT}/tools/${encodeURIComponent(slug)}`;
133
+ }
134
+
135
+ /**
136
+ * The LEGACY route for one skill — now a redirect to the canonical workspace
137
+ * URL. Kept so old links and name-only callers still land; new code should
138
+ * build `urlForSkillFile` from the catalog's path instead.
139
+ */
140
+ export function pathForSkill(name: string): string {
141
+ return `${LIBRARY_ROOT}/skills/${encodeURIComponent(name)}`;
142
+ }
143
+
144
+ /**
145
+ * Whether a path is the all-groups index — the one path that lights the "All
146
+ * groups" row. It is not a `LibraryFilter`: the index lists PLACES, not a
147
+ * filtered slice of the catalog, which is why selection for it travels beside
148
+ * the filter rather than inside it.
149
+ *
150
+ * `groups` answers true as well even though it only ever redirects, so the row
151
+ * is already lit while the redirect resolves.
152
+ */
153
+ export function isGroupsIndexPath(pathname: string): boolean {
154
+ return (
155
+ matchPath({ path: LIBRARY_ROOT, end: true }, pathname) !== null ||
156
+ matchPath({ path: `${LIBRARY_ROOT}/groups`, end: true }, pathname) !== null
157
+ );
158
+ }
159
+
160
+ /** A malformed escape is a bad link, not a crash — fall back to the raw segment. */
161
+ function decodeSegment(raw: string): string {
162
+ try {
163
+ return decodeURIComponent(raw);
164
+ } catch {
165
+ return raw;
166
+ }
167
+ }
168
+
169
+ /**
170
+ * Where an item's back link points: the page the item LIVES on.
171
+ *
172
+ * `‹ All skills & tools` used to be the one answer, and it stopped being
173
+ * true the day the Library's root became the all-groups index — a skill
174
+ * opened from its group page went "back" to a page the reader had never
175
+ * been on. The honest destination is derivable from the path alone: the
176
+ * group page for a grouped item, the personal page for a personal one, and
177
+ * the root only for the legacy shapes that live in neither.
178
+ */
179
+ export function libraryHomeForItemPath(repoRelativePath: string): {
180
+ label: string;
181
+ path: string;
182
+ } {
183
+ const group = groupOfPath(repoRelativePath);
184
+ if (group !== null && !isPersonalGroupFolder(group)) {
185
+ return { label: group, path: pathForGroup(group) };
186
+ }
187
+ if (group !== null) {
188
+ return { label: 'Yours', path: `${LIBRARY_ROOT}/yours` };
189
+ }
190
+ return { label: 'All skills & tools', path: LIBRARY_ROOT };
191
+ }
@@ -0,0 +1,189 @@
1
+ import { authFetch } from '../../../lib/api';
2
+ import { handleApiResponse } from '../../git/services/git.api';
3
+
4
+ /**
5
+ * Group enumeration + join requests — the browser half of the backend's
6
+ * `modules/groups`.
7
+ *
8
+ * Enumeration is fail-closed with three ordinary access verdicts: a listed
9
+ * group is one the caller is a MEMBER of (`canRead`), MANAGES (`canWrite`,
10
+ * admin-rescued), or may DISCOVER (they can read the group's `access.md`
11
+ * file — granted by its own `read: everyone` frontmatter). A group with no
12
+ * verdict is absent. Asking to join opens a plain change request; nothing
13
+ * request-shaped is stored anywhere else.
14
+ *
15
+ * Every type below MIRRORS the backend contract (`groups.contract.ts`). Keep
16
+ * them in step.
17
+ */
18
+
19
+ export interface GroupPrincipals {
20
+ roles: string[];
21
+ users: { name: string; email: string }[];
22
+ }
23
+
24
+ export interface GroupReaders extends GroupPrincipals {
25
+ /** False when `read: everyone` applies cleanly (the lists are then empty). */
26
+ restricted: boolean;
27
+ }
28
+
29
+ export interface GroupSummary {
30
+ /** Group folder name, e.g. `GTM`. */
31
+ name: string;
32
+ /** Repo-relative constituent folders, e.g. `['Groups/GTM']`. */
33
+ folders: string[];
34
+ /** Per-caller: can read the folder (membership). Locked === !canRead. */
35
+ canRead: boolean;
36
+ /** Per-caller; true ⇒ may manage the group's access (admin-rescue applies). */
37
+ canWrite: boolean;
38
+ /**
39
+ * Per-caller: holds the `owner` verb on the folder (owner-lists only, no
40
+ * admin rescue). Deleting the group is the owner's verb — the DELETE route
41
+ * enforces this same verdict, so it also decides who sees the affordance.
42
+ */
43
+ isOwner: boolean;
44
+ /** The group's TOTALS, not the caller's slice. */
45
+ skillCount: number;
46
+ toolCount: number;
47
+ owners: GroupPrincipals;
48
+ writers: GroupPrincipals;
49
+ readers: GroupReaders;
50
+ /** The caller has an OPEN join change request for this group. */
51
+ hasRequested: boolean;
52
+ /** That CR's number when `hasRequested` (deep-links the review UI). */
53
+ requestNumber: number | null;
54
+ }
55
+
56
+ export async function listGroups(): Promise<GroupSummary[]> {
57
+ const res = await authFetch('/api/groups');
58
+ if (!res.ok) throw new Error("Couldn't load groups.");
59
+ const data = (await res.json()) as { groups: GroupSummary[] };
60
+ return data.groups;
61
+ }
62
+
63
+ /**
64
+ * Create a group — the dedicated provisioning endpoint, not a workspace
65
+ * write. The server owns name validation and the collision verdict (its
66
+ * check is against the live tree, ours against a stale catalog), commits the
67
+ * seeded `access.md` before answering, and refuses with its own words —
68
+ * worth surfacing verbatim.
69
+ */
70
+ export async function createGroup(name: string): Promise<{ folder: string }> {
71
+ const res = await authFetch('/api/groups', {
72
+ method: 'POST',
73
+ headers: { 'Content-Type': 'application/json' },
74
+ body: JSON.stringify({ name }),
75
+ });
76
+ if (!res.ok) {
77
+ const body = (await res.json().catch(() => ({}))) as { error?: string };
78
+ throw new Error(body.error ?? "Couldn't create that group.");
79
+ }
80
+ return (await res.json()) as { folder: string };
81
+ }
82
+
83
+ /**
84
+ * Delete a group — the whole folder, skills and tools included, in one
85
+ * commit. Owner-gated server-side (the `owner` verdict on the folder); a
86
+ * refusal names the rule and is worth surfacing verbatim. Fail-closed: a
87
+ * group the caller doesn't own answers exactly like one that doesn't exist.
88
+ */
89
+ export async function deleteGroup(name: string): Promise<void> {
90
+ const res = await authFetch(`/api/groups/${encodeURIComponent(name)}`, { method: 'DELETE' });
91
+ if (!res.ok) {
92
+ const body = (await res.json().catch(() => ({}))) as { error?: string };
93
+ throw new Error(body.error ?? "Couldn't delete that group.");
94
+ }
95
+ }
96
+
97
+ /**
98
+ * Ensure the caller's personal folder (`Groups/personal-<id>/`) exists.
99
+ * Idempotent; the server answers only after the folder's access.md is
100
+ * COMMITTED, so a write into the folder may follow immediately.
101
+ */
102
+ export async function ensurePersonalGroup(): Promise<{ folder: string; created: boolean }> {
103
+ const res = await authFetch('/api/groups/personal', { method: 'POST' });
104
+ if (!res.ok) {
105
+ const body = (await res.json().catch(() => ({}))) as { error?: string };
106
+ throw new Error(body.error ?? "Couldn't prepare your personal folder.");
107
+ }
108
+ return (await res.json()) as { folder: string; created: boolean };
109
+ }
110
+
111
+ /**
112
+ * Thrown when a join request is refused because access already landed —
113
+ * between the page load and the click. Not an error to show: the right
114
+ * response is to reload the library and let the group appear unlocked.
115
+ */
116
+ export class AlreadyReadableError extends Error {
117
+ constructor() {
118
+ super('You can already read this group');
119
+ this.name = 'AlreadyReadableError';
120
+ }
121
+ }
122
+
123
+ /** Open (or return the existing) join change request. Idempotent server-side. */
124
+ export async function requestGroupAccess(name: string): Promise<{ number: number }> {
125
+ const res = await authFetch(`/api/groups/${encodeURIComponent(name)}/join-request`, {
126
+ method: 'POST',
127
+ });
128
+ if (res.status === 409) {
129
+ // Read from a CLONE: this probes one specific conflict; any other 409
130
+ // falls through to `handleApiResponse` with its body intact.
131
+ const body = (await res
132
+ .clone()
133
+ .json()
134
+ .catch(() => ({}))) as { kind?: string };
135
+ if (body.kind === 'already-readable') throw new AlreadyReadableError();
136
+ }
137
+ return handleApiResponse<{ ok: true; number: number }>(res);
138
+ }
139
+
140
+ /**
141
+ * ONE grant a join request is proposing — a principal and the verb it would
142
+ * get. Mirrors the backend's `JoinProposal`; `principal` is the shape the
143
+ * access-grant API takes, so accepting is a plain grant.
144
+ */
145
+ export interface JoinProposal {
146
+ verb: 'read' | 'write' | 'owner' | 'download';
147
+ /** Canonical identity (lowercased email / canonical role) — a stable key. */
148
+ id: string;
149
+ principal:
150
+ | { kind: 'user'; email: string; displayName: string }
151
+ | { kind: 'role'; role: string };
152
+ label: string;
153
+ }
154
+
155
+ export interface JoinRequest {
156
+ number: number;
157
+ branch: string;
158
+ requesterName: string;
159
+ createdAt: string;
160
+ /** Still-pending proposals; a request with none left is already closed. */
161
+ proposals: JoinProposal[];
162
+ }
163
+
164
+ /**
165
+ * Open join requests for a group the caller MANAGES, each with what it still
166
+ * proposes. Non-managers get `[]` (never a 403), so the caller may ask
167
+ * unconditionally — the same posture every other group surface takes.
168
+ */
169
+ export async function listJoinRequests(name: string): Promise<JoinRequest[]> {
170
+ const data = await handleApiResponse<{ requests: JoinRequest[] }>(
171
+ await authFetch(`/api/groups/${encodeURIComponent(name)}/join-requests`),
172
+ );
173
+ return data.requests;
174
+ }
175
+
176
+ /**
177
+ * Ask the server to settle a request whose proposals have all landed. Called
178
+ * after a grant so the banner updates now rather than on the next listing —
179
+ * which reconciles anyway, so a failure here only delays it.
180
+ */
181
+ export async function reconcileJoinRequest(name: string, number: number): Promise<boolean> {
182
+ const data = await handleApiResponse<{ closed: boolean }>(
183
+ await authFetch(
184
+ `/api/groups/${encodeURIComponent(name)}/join-requests/${number}/reconcile`,
185
+ { method: 'POST' },
186
+ ),
187
+ );
188
+ return data.closed;
189
+ }