@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.
- package/THIRD-PARTY-NOTICES.md +5366 -0
- package/package.json +7 -4
- package/src/core/CoreAppShell.tsx +195 -56
- package/src/core/__tests__/AppChrome.test.tsx +125 -0
- package/src/core/__tests__/ShellRoutes.test.tsx +37 -2
- package/src/core/__tests__/bootstrap.test.ts +63 -0
- package/src/core/bootstrap.ts +73 -0
- package/src/core/events.ts +12 -0
- package/src/core/registry.ts +58 -9
- package/src/index.css +100 -11
- package/src/index.ts +24 -23
- package/src/lib/utils.ts +93 -117
- package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
- package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
- package/src/modules/access/api.ts +49 -0
- package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
- package/src/modules/access/hooks/useFileAccess.ts +1 -1
- package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
- package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +17 -1
- package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
- package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
- package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
- package/src/modules/admin/components/UserAccountsPage.tsx +36 -28
- package/src/modules/admin/state/admin.context.tsx +15 -6
- package/src/modules/auth/components/AccountPage.tsx +11 -11
- package/src/modules/auth/components/LoginScreen.tsx +12 -12
- package/src/modules/auth/services/sso.ts +47 -1
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
- package/src/modules/change-requests/__tests__/author.test.ts +48 -0
- package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
- package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
- package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
- package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
- package/src/modules/change-requests/change-requests.css +22 -0
- package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
- package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
- package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
- package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
- package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
- package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
- package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
- package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
- package/src/modules/change-requests/services/change-requests.api.ts +45 -0
- package/src/modules/change-requests/services/propose.api.ts +162 -0
- package/src/modules/change-requests/utils/author.ts +47 -0
- package/src/modules/change-requests/utils/conflict.ts +38 -0
- package/src/modules/change-requests/utils/diff.ts +80 -0
- package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
- package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
- package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
- package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
- package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
- package/src/modules/git/components/BranchSwitcher.tsx +68 -31
- package/src/modules/git/components/DiffView.tsx +4 -4
- package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
- package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
- package/src/modules/git/components/PullNeededBanner.tsx +6 -13
- package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
- package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
- package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
- package/src/modules/git/hooks/useGitState.ts +15 -14
- package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
- package/src/modules/git/services/error-messages.ts +7 -7
- package/src/modules/git/services/git.api.ts +17 -11
- package/src/modules/git/services/pr-prompts.ts +2 -2
- package/src/modules/git/state/git.context.ts +10 -1
- package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
- package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
- package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
- package/src/modules/layout/breakpoints.ts +6 -0
- package/src/modules/layout/components/AppLayout.tsx +17 -5
- package/src/modules/layout/components/DemoBanner.tsx +10 -1
- package/src/modules/layout/components/MaintenanceOverlay.tsx +3 -3
- package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
- package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
- package/src/modules/layout/components/SidebarFrame.tsx +317 -0
- package/src/modules/layout/components/SidebarToggle.tsx +86 -0
- package/src/modules/layout/components/SlideOverlay.tsx +1 -1
- package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
- package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
- package/src/modules/layout/state/sidebar.ts +200 -0
- package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
- package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
- package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
- package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
- package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
- package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
- package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
- package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
- package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
- package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
- package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
- package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
- package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
- package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
- package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
- package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
- package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
- package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
- package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
- package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
- package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
- package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
- package/src/modules/library/__tests__/auth-harness.tsx +37 -0
- package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
- package/src/modules/library/__tests__/status.test.ts +113 -20
- package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
- package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
- package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
- package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
- package/src/modules/library/components/ChangeRequestDock.tsx +52 -28
- package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
- package/src/modules/library/components/GroupIndexRow.tsx +63 -0
- package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
- package/src/modules/library/components/GroupPage.tsx +373 -0
- package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
- package/src/modules/library/components/GroupsSidebar.tsx +338 -0
- package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
- package/src/modules/library/components/LibraryCard.tsx +123 -102
- package/src/modules/library/components/LibraryLayout.tsx +344 -0
- package/src/modules/library/components/LibraryPage.tsx +111 -227
- package/src/modules/library/components/LockGlyph.tsx +31 -0
- package/src/modules/library/components/LockedGroupView.tsx +159 -0
- package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
- package/src/modules/library/components/NewGroupDialog.tsx +112 -0
- package/src/modules/library/components/NewSkillPanel.tsx +151 -0
- package/src/modules/library/components/PageActions.tsx +156 -0
- package/src/modules/library/components/PendingSkillReview.tsx +63 -0
- package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
- package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
- package/src/modules/library/components/StatusDot.tsx +25 -0
- package/src/modules/library/components/ToolLogo.tsx +171 -0
- package/src/modules/library/components/group-page-parts.tsx +419 -0
- package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
- package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
- package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
- package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
- package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
- package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
- package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
- package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
- package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
- package/src/modules/library/hooks/useJoinRequests.ts +114 -0
- package/src/modules/library/hooks/useLibraryData.ts +134 -119
- package/src/modules/library/hooks/useSkillDetail.ts +119 -74
- package/src/modules/library/hooks/useToolPage.ts +145 -0
- package/src/modules/library/library.css +33 -245
- package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
- package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
- package/src/modules/library/routes/library-paths.ts +191 -0
- package/src/modules/library/services/groups.api.ts +189 -0
- package/src/modules/library/services/library.api.ts +291 -164
- package/src/modules/library/services/tools.api.ts +60 -0
- package/src/modules/library/state/library-context.ts +22 -0
- package/src/modules/library/state/library-data.tsx +223 -0
- package/src/modules/library/state/toast.context.ts +32 -0
- package/src/modules/library/state/toast.tsx +84 -42
- package/src/modules/library/utils/clipboard.ts +33 -0
- package/src/modules/library/utils/group-summary.ts +68 -0
- package/src/modules/library/utils/names.ts +30 -0
- package/src/modules/library/utils/navigate-external.ts +15 -0
- package/src/modules/library/utils/oauth-fragment.ts +32 -0
- package/src/modules/library/utils/personal-group.ts +36 -0
- package/src/modules/library/utils/status.ts +108 -25
- package/src/modules/library/utils/toast-duration.ts +16 -0
- package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
- package/src/modules/onboarding/agent-clients.ts +48 -0
- package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
- package/src/modules/onboarding/components/RootLanding.tsx +54 -0
- package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
- package/src/modules/onboarding/paths.ts +9 -0
- package/src/modules/onboarding/state/onboarding.ts +191 -0
- package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
- package/src/modules/pr/services/pr-approvals.api.ts +19 -0
- package/src/modules/pr/services/pr-cancel.api.ts +11 -0
- package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
- package/src/modules/review/components/DiffViewer.tsx +4 -4
- package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
- package/src/modules/review/components/ReviewFileRow.tsx +10 -10
- package/src/modules/review/components/ReviewPanel.tsx +49 -17
- package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
- package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
- package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
- package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
- package/src/modules/secrets-vault/components/SecretsPage.tsx +147 -110
- package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
- package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +35 -4
- package/src/modules/secrets-vault/services/connect.api.ts +24 -3
- package/src/modules/settings/components/DeploymentPage.tsx +90 -0
- package/src/modules/settings/components/SettingsLayout.tsx +135 -0
- package/src/modules/settings/components/SettingsNav.tsx +114 -0
- package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
- package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
- package/src/modules/settings/settings-nav-items.tsx +166 -0
- package/src/modules/setup/__tests__/setup.test.tsx +540 -0
- package/src/modules/setup/components/SetupGate.tsx +67 -0
- package/src/modules/setup/components/SetupScreen.tsx +573 -0
- package/src/modules/setup/services/setup.api.ts +106 -0
- package/src/modules/setup/utils/git-host.ts +34 -0
- package/src/modules/toolbar/components/AppSwitcher.tsx +38 -15
- package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +50 -50
- package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
- package/src/modules/toolbar/components/Toolbar.tsx +56 -54
- package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
- package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
- package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
- package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
- package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
- package/src/modules/workspace/components/EditorTabs.tsx +82 -50
- package/src/modules/workspace/components/FileExplorer.tsx +413 -189
- package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
- package/src/modules/workspace/components/FileRoute.tsx +89 -84
- package/src/modules/workspace/components/FileViewer.tsx +700 -294
- package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
- package/src/modules/workspace/components/KbFileRail.tsx +128 -0
- package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
- package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
- package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
- package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
- package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
- package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
- package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
- package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
- package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
- package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
- package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
- package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
- package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
- package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
- package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
- package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
- package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
- package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
- package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
- package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
- package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
- package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
- package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
- package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
- package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
- package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
- package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
- package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
- package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
- package/src/modules/workspace/components/renderers/index.ts +78 -2
- package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
- package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
- package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
- package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
- package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
- package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
- package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
- package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
- package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
- package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
- package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
- package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
- package/src/modules/workspace/services/workspace.api.ts +9 -2
- package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
- package/src/modules/workspace/state/open-change-requests.tsx +185 -0
- package/src/modules/workspace/state/workspace.context.ts +9 -0
- package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
- package/src/modules/workspace/utils/diff.ts +130 -53
- package/src/modules/workspace/utils/fileTree.ts +7 -4
- package/src/modules/workspace/workspace.css +28 -0
- package/src/shared/components/Badge.tsx +62 -0
- package/src/shared/components/Banner.tsx +58 -0
- package/src/shared/components/Button.tsx +90 -0
- package/src/shared/components/Dialog.tsx +6 -6
- package/src/shared/components/Field.tsx +45 -0
- package/src/shared/components/IconButton.tsx +74 -0
- package/src/shared/components/ListRow.tsx +96 -0
- package/src/shared/components/Menu.tsx +88 -0
- package/src/shared/components/PageShell.tsx +8 -5
- package/src/shared/components/Surface.tsx +86 -0
- package/src/shared/components/__tests__/primitives.test.tsx +333 -0
- package/src/shared/components/index.ts +48 -0
- package/src/shared/components/useDismissableMenu.ts +71 -0
- package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
- package/src/shared/theme/index.css +12 -0
- package/src/shared/theme/measure.ts +64 -0
- package/src/shared/theme/shadows.css +34 -0
- package/src/shared/theme/tokens.css +193 -0
- package/src/test-setup.ts +9 -0
- package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
- package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
- package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
- package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
- package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
- package/src/modules/library/__tests__/diff.test.ts +0 -62
- package/src/modules/library/__tests__/loadout.test.tsx +0 -72
- package/src/modules/library/components/CompareView.tsx +0 -357
- package/src/modules/library/components/DetailDialog.tsx +0 -566
- package/src/modules/library/components/GearIcon.tsx +0 -12
- package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
- package/src/modules/library/components/StatusGem.tsx +0 -21
- package/src/modules/library/components/SuggestChange.tsx +0 -171
- package/src/modules/library/components/particles.ts +0 -50
- package/src/modules/library/state/loadout.tsx +0 -129
- package/src/modules/library/utils/diff.ts +0 -102
- package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
- package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
- package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
- package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
- package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
- package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
- package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
- package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
- package/src/modules/pr/components/PrCancelButton.tsx +0 -99
- package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
- package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
- package/src/modules/pr/components/PrCommentThread.tsx +0 -168
- package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
- package/src/modules/pr/components/PrDiffPane.tsx +0 -425
- package/src/modules/pr/components/PrFileRow.tsx +0 -164
- package/src/modules/pr/components/PrFilesList.tsx +0 -53
- package/src/modules/pr/components/PrHeader.tsx +0 -45
- package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
- package/src/modules/pr/components/PrMergeButton.tsx +0 -268
- package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
- package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
- package/src/modules/pr/components/PrViewer.tsx +0 -364
- package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
- package/src/modules/pr/state/pr-viewer.context.ts +0 -34
- package/src/modules/pr/utils/bucketize-comments.ts +0 -55
- package/src/modules/pr/utils/parsePatch.ts +0 -57
- 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
|
+
}
|