@bevel-software/platform-core-frontend 0.15.1 → 0.19.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/THIRD-PARTY-NOTICES.md +2 -2
- package/package.json +3 -3
- package/src/core/CoreAppShell.tsx +16 -9
- package/src/core/__tests__/AppChrome.test.tsx +0 -3
- package/src/core/__tests__/events.test.ts +43 -0
- package/src/core/bootstrap.ts +11 -3
- package/src/core/events.ts +85 -3
- package/src/core/registry.ts +1 -1
- package/src/lib/__tests__/email.test.ts +44 -0
- package/src/lib/email.ts +37 -1
- package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
- package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
- package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
- package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
- package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
- package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
- package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
- package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
- package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
- package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
- package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
- package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
- package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
- package/src/modules/access/api.ts +140 -6
- package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
- package/src/modules/access/manage-access-affordance.ts +17 -0
- package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
- package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
- package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
- package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
- package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
- package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
- package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
- package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
- package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
- package/src/modules/admin/components/AddMemberInput.tsx +268 -0
- package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
- package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
- package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
- package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
- package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
- package/src/modules/admin/components/group-members-path.ts +32 -0
- package/src/modules/admin/services/connection-keys.api.ts +47 -0
- package/src/modules/admin/services/roles.api.ts +12 -1
- package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
- package/src/modules/auth/components/AccountPage.tsx +73 -54
- package/src/modules/auth/components/LoginScreen.tsx +1 -0
- package/src/modules/auth/services/account.api.ts +78 -4
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
- package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
- package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
- package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
- package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
- package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
- package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
- package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
- package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
- package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
- package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
- package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
- package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
- package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
- package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
- package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
- package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
- package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
- package/src/modules/change-requests/services/change-requests.api.ts +57 -1
- package/src/modules/change-requests/services/denied-file.api.ts +53 -0
- package/src/modules/change-requests/services/propose.api.ts +97 -8
- package/src/modules/change-requests/utils/approval.ts +15 -0
- package/src/modules/change-requests/utils/author.ts +32 -0
- package/src/modules/change-requests/utils/readFailure.ts +110 -0
- package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
- package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
- package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
- package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
- package/src/modules/git/services/error-messages.ts +12 -0
- package/src/modules/git/services/pr-prompts.ts +5 -5
- package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
- package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
- package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
- package/src/modules/layout/components/AppLayout.tsx +2 -0
- package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
- package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
- package/src/modules/layout/components/SidebarFrame.tsx +108 -3
- package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
- package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
- package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
- package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
- package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
- package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
- package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
- package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
- package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
- package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
- package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
- package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
- package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
- package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
- package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
- package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
- package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
- package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
- package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
- package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
- package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
- package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
- package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
- package/src/modules/library/__tests__/auth-harness.tsx +9 -9
- package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
- package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
- package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
- package/src/modules/library/__tests__/library-data.test.ts +7 -0
- package/src/modules/library/__tests__/library-paths.test.ts +47 -4
- package/src/modules/library/__tests__/link-membership.test.ts +13 -4
- package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
- package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
- package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
- package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
- package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
- package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
- package/src/modules/library/__tests__/status.test.ts +82 -2
- package/src/modules/library/__tests__/tools.api.test.ts +44 -1
- package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
- package/src/modules/library/components/AddDialogTabs.tsx +103 -0
- package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
- package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
- package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
- package/src/modules/library/components/LibraryCard.tsx +146 -45
- package/src/modules/library/components/LibraryLayout.tsx +119 -256
- package/src/modules/library/components/LibraryPage.tsx +172 -39
- package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
- package/src/modules/library/components/LockedPluginView.tsx +62 -34
- package/src/modules/library/components/NameWithBadges.tsx +164 -0
- package/src/modules/library/components/NewPluginDialog.tsx +16 -2
- package/src/modules/library/components/PageActions.tsx +11 -9
- package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
- package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
- package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
- package/src/modules/library/components/PluginExtras.tsx +140 -17
- package/src/modules/library/components/PluginIndexRow.tsx +47 -12
- package/src/modules/library/components/PluginPage.tsx +157 -41
- package/src/modules/library/components/PluginRows.tsx +286 -0
- package/src/modules/library/components/PluginsSidebar.tsx +239 -263
- package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
- package/src/modules/library/components/ShareButton.tsx +17 -0
- package/src/modules/library/components/SkillsTree.tsx +141 -28
- package/src/modules/library/components/TeamRoute.tsx +15 -0
- package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
- package/src/modules/library/components/plugin-page-parts.tsx +103 -17
- package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
- package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
- package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
- package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
- package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
- package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
- package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
- package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
- package/src/modules/library/hooks/useLibraryData.ts +92 -19
- package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
- package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
- package/src/modules/library/routes/library-paths.ts +26 -28
- package/src/modules/library/services/library.api.ts +38 -20
- package/src/modules/library/services/plugins.api.ts +69 -8
- package/src/modules/library/services/teams.api.ts +15 -0
- package/src/modules/library/services/tools.api.ts +78 -0
- package/src/modules/library/state/library-data.tsx +170 -32
- package/src/modules/library/utils/personal-plugin.ts +13 -15
- package/src/modules/library/utils/plugin-entries.ts +134 -0
- package/src/modules/library/utils/plugin-summary.ts +75 -9
- package/src/modules/library/utils/status.ts +135 -33
- package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
- package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
- package/src/modules/onboarding/agent-clients.ts +55 -23
- package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
- package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
- package/src/modules/pr/services/pr-merge.api.ts +2 -1
- package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
- package/src/modules/review/components/ReviewPanel.tsx +15 -17
- package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
- package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
- package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
- package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
- package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
- package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
- package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
- package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
- package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
- package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
- package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
- package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
- package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
- package/src/modules/secrets-vault/services/connect.api.ts +36 -5
- package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
- package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
- package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
- package/src/modules/settings/components/DeploymentPage.tsx +10 -30
- package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
- package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
- package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
- package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
- package/src/modules/settings/services/github-facade.api.ts +23 -0
- package/src/modules/settings/settings-nav-items.tsx +10 -2
- package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
- package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
- package/src/modules/setup/__tests__/setup.test.tsx +497 -4
- package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
- package/src/modules/setup/components/SetupGate.tsx +16 -16
- package/src/modules/setup/components/SetupScreen.tsx +521 -43
- package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
- package/src/modules/setup/services/setup.api.ts +140 -3
- package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
- package/src/modules/setup/utils/root-folders.ts +46 -0
- package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
- package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
- package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
- package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
- package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
- package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
- package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
- package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
- package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
- package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
- package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
- package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
- package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
- package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
- package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
- package/src/modules/toolbar/components/deployment-address.ts +29 -0
- package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
- package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
- package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
- package/src/modules/toolbar/services/external-api-keys.api.ts +6 -0
- package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
- package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
- package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
- package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
- package/src/modules/workflow/state/event-bus.context.ts +10 -0
- package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
- package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
- package/src/modules/workspace/components/FileRoute.tsx +353 -36
- package/src/modules/workspace/components/FileViewer.tsx +166 -45
- package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
- package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
- package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
- package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
- package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
- package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +331 -12
- package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
- package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
- package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
- package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
- package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
- package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
- package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
- package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
- package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
- package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
- package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
- package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
- package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
- package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
- package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
- package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
- package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
- package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
- package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
- package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
- package/src/modules/workspace/components/renderers/index.ts +53 -2
- package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
- package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
- package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
- package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
- package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
- package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
- package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
- package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
- package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
- package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
- package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
- package/src/modules/workspace/routing/kb-routes.ts +206 -29
- package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
- package/src/modules/workspace/services/workspace.api.ts +57 -4
- package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
- package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
- package/src/modules/workspace/state/open-change-requests.tsx +100 -12
- package/src/modules/workspace/state/workspace.context.ts +125 -19
- package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
- package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
- package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
- package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
- package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
- package/src/modules/workspace/utils/file-trace.ts +50 -0
- package/src/modules/workspace/utils/fileTree.ts +112 -36
- package/src/modules/workspace/utils/frontmatter.ts +8 -4
- package/src/modules/workspace/utils/pasteLink.ts +90 -0
- package/src/modules/workspace/utils/treeConfirm.ts +338 -0
- package/src/modules/workspace/utils/uploadError.ts +29 -0
- package/src/shared/__tests__/marketplace-url.test.ts +6 -1
- package/src/shared/components/Button.tsx +16 -2
- package/src/shared/components/Dialog.tsx +27 -11
- package/src/shared/components/Menu.tsx +13 -1
- package/src/shared/components/PageShell.tsx +13 -8
- package/src/shared/components/__tests__/primitives.test.tsx +116 -2
- package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
- package/src/shared/components/index.ts +2 -0
- package/src/shared/components/useDismissableMenu.ts +32 -10
- package/src/shared/components/useFocusHandoff.ts +51 -0
- package/src/shared/components/useLatestRef.ts +28 -0
- package/src/shared/markdown/Markdown.tsx +12 -3
- package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
- package/src/shared/markdown/hrefs.ts +50 -0
- package/src/shared/marketplace-url.ts +33 -5
- package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
- package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
- package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
- package/src/shared/mcp/connect-snippets.ts +14 -9
- package/src/shared/mcp/index.ts +1 -1
- package/src/shared/theme/__tests__/header-band.test.ts +197 -0
- package/src/shared/theme/header.ts +75 -0
- package/src/shared/theme/measure.ts +7 -4
- package/src/shared/theme/tokens.css +25 -0
- package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
- package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
- package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
- package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
- package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
- package/src/modules/update-check/services/update-check.api.ts +0 -24
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import { useCallback, useEffect, useRef, useState } from 'react';
|
|
2
|
+
import { fetchSetupStatus, type SetupStatus } from '../services/setup.api';
|
|
3
|
+
|
|
4
|
+
export interface SetupStatusRead {
|
|
5
|
+
/** The latest status that arrived. A failed read does not clear it. */
|
|
6
|
+
status: SetupStatus | null;
|
|
7
|
+
/** The latest read failed. */
|
|
8
|
+
failed: boolean;
|
|
9
|
+
/** A read has settled at least once. */
|
|
10
|
+
loaded: boolean;
|
|
11
|
+
/** Read the status again — after a save, a sync, or a "Try again". */
|
|
12
|
+
refresh(): void;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Every mounted reader, so a refresh asked for by one reaches them all. The
|
|
17
|
+
* setup gate stays mounted for the app's whole life while the Deployment page
|
|
18
|
+
* comes and goes; a save on the page that leaves the deployment incomplete
|
|
19
|
+
* has to reach the gate, or the gate keeps showing the app over a server that
|
|
20
|
+
* has shut its setup gate. One status, read by several screens: a refresh is
|
|
21
|
+
* a fact about the deployment, not about the screen that asked.
|
|
22
|
+
*/
|
|
23
|
+
const readers = new Set<() => void>();
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* The deployment's setup status, read the one way every screen that shows it
|
|
27
|
+
* reads it: the setup gate and the Deployment page.
|
|
28
|
+
*
|
|
29
|
+
* LATEST READ WINS. Reads overlap — the refresh after a failed save can still
|
|
30
|
+
* be out when a retry succeeds and asks again — and answers arrive in any
|
|
31
|
+
* order. An answer to an EARLIER read describes a deployment that has since
|
|
32
|
+
* moved on (it would put back the knowledge-base failure the retry just
|
|
33
|
+
* cleared), so only the latest read's answer, success or failure, lands.
|
|
34
|
+
*
|
|
35
|
+
* A FAILED READ KEEPS THE LAST STATUS and says it failed, so each host decides
|
|
36
|
+
* what that means: the gate lets the app through (the check is a guard, not an
|
|
37
|
+
* authorisation boundary), the Deployment page keeps the form and offers a
|
|
38
|
+
* retry.
|
|
39
|
+
*
|
|
40
|
+
* ONE REFRESH REACHES EVERY READER. `refresh()` re-reads on every mounted
|
|
41
|
+
* instance of this hook, not only the one it was called on, so a screen that
|
|
42
|
+
* changed the deployment cannot leave another showing the state before it.
|
|
43
|
+
*
|
|
44
|
+
* `enabled: false` never reads, and drops a read that was still out when it
|
|
45
|
+
* turned false — for a host that already knows the answer is not for this
|
|
46
|
+
* viewer.
|
|
47
|
+
*/
|
|
48
|
+
export function useSetupStatus(enabled = true): SetupStatusRead {
|
|
49
|
+
const [status, setStatus] = useState<SetupStatus | null>(null);
|
|
50
|
+
const [failed, setFailed] = useState(false);
|
|
51
|
+
const [loaded, setLoaded] = useState(false);
|
|
52
|
+
/** The latest read; an answer to any earlier one is out of date. */
|
|
53
|
+
const latest = useRef(0);
|
|
54
|
+
|
|
55
|
+
const read = useCallback(() => {
|
|
56
|
+
if (!enabled) {
|
|
57
|
+
// Disabling outdates any read still out, exactly as a newer read would:
|
|
58
|
+
// its answer is for a viewer this hook no longer serves, and landing it
|
|
59
|
+
// would leave that status waiting for whenever reading is enabled again.
|
|
60
|
+
latest.current += 1;
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
const request = ++latest.current;
|
|
64
|
+
const current = () => request === latest.current;
|
|
65
|
+
fetchSetupStatus()
|
|
66
|
+
.then((s) => {
|
|
67
|
+
if (!current()) return;
|
|
68
|
+
setStatus(s);
|
|
69
|
+
setFailed(false);
|
|
70
|
+
})
|
|
71
|
+
.catch(() => {
|
|
72
|
+
if (current()) setFailed(true);
|
|
73
|
+
})
|
|
74
|
+
.finally(() => {
|
|
75
|
+
if (current()) setLoaded(true);
|
|
76
|
+
});
|
|
77
|
+
}, [enabled]);
|
|
78
|
+
|
|
79
|
+
// Registered for as long as this instance is mounted; the mount reads once.
|
|
80
|
+
useEffect(() => {
|
|
81
|
+
readers.add(read);
|
|
82
|
+
read();
|
|
83
|
+
return () => {
|
|
84
|
+
readers.delete(read);
|
|
85
|
+
};
|
|
86
|
+
}, [read]);
|
|
87
|
+
|
|
88
|
+
const refresh = useCallback(() => {
|
|
89
|
+
for (const reader of readers) reader();
|
|
90
|
+
}, []);
|
|
91
|
+
|
|
92
|
+
return { status, failed, loaded, refresh };
|
|
93
|
+
}
|
|
@@ -4,8 +4,12 @@ import { authFetch } from '../../../lib/api';
|
|
|
4
4
|
/** One configurable setting, as the server describes it. */
|
|
5
5
|
export interface SettingStatus {
|
|
6
6
|
key: string;
|
|
7
|
-
/**
|
|
8
|
-
|
|
7
|
+
/**
|
|
8
|
+
* The environment variable that still wins if it is set. Absent for a
|
|
9
|
+
* setting no variable can override — the knowledge-base layout, which is
|
|
10
|
+
* entered here and nowhere else.
|
|
11
|
+
*/
|
|
12
|
+
envVar?: string;
|
|
9
13
|
section: 'knowledge-base' | 'sign-in';
|
|
10
14
|
source: 'env' | 'stored' | 'unset';
|
|
11
15
|
/** Absent for secrets — the server never sends a stored secret back. */
|
|
@@ -41,9 +45,41 @@ export interface SyncStatus {
|
|
|
41
45
|
last: LastSync | null;
|
|
42
46
|
}
|
|
43
47
|
|
|
48
|
+
/**
|
|
49
|
+
* Whether the single sign-on configuration in effect is known to work: proven
|
|
50
|
+
* against the provider (or by a sign-in), configured but unproven, absent — or
|
|
51
|
+
* configured with SECRETS_ENC_KEY unset (`unrecordable`), when no
|
|
52
|
+
* verification can be kept.
|
|
53
|
+
*/
|
|
54
|
+
export type OidcVerification = 'verified' | 'unverified' | 'not-configured' | 'unrecordable';
|
|
55
|
+
|
|
56
|
+
/** Why the setup-time knowledge-base initialization failed — mirrors the backend's `GitFailureKind`. */
|
|
57
|
+
export type KbInitFailureKind =
|
|
58
|
+
| 'credentials-rejected'
|
|
59
|
+
| 'not-found'
|
|
60
|
+
| 'unreachable'
|
|
61
|
+
| 'write-refused'
|
|
62
|
+
| 'push-refused-by-policy'
|
|
63
|
+
| 'step-failed'
|
|
64
|
+
| 'unknown';
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* A failed initialization, as the server classifies it. `cause` is a sentence
|
|
68
|
+
* telling the admin what to do; the raw error never leaves the server log.
|
|
69
|
+
*/
|
|
70
|
+
export interface KbInitFailure {
|
|
71
|
+
kind: KbInitFailureKind;
|
|
72
|
+
cause: string;
|
|
73
|
+
}
|
|
74
|
+
|
|
44
75
|
export interface SetupStatus {
|
|
45
76
|
/** Reachable knowledge base AND a process that can serve it. */
|
|
46
77
|
complete: boolean;
|
|
78
|
+
/**
|
|
79
|
+
* Admins only: the setup-completing save stored the settings, but the
|
|
80
|
+
* knowledge base could not be initialized. Present while that failure stands.
|
|
81
|
+
*/
|
|
82
|
+
kbInit?: KbInitFailure;
|
|
47
83
|
/**
|
|
48
84
|
* Answered, but the running process still holds the old branch model. Should
|
|
49
85
|
* be rare — saving applies it — and means a restart, not another answer.
|
|
@@ -54,6 +90,8 @@ export interface SetupStatus {
|
|
|
54
90
|
settings?: SettingStatus[];
|
|
55
91
|
/** Admins only. Absent on a build without the sync module. */
|
|
56
92
|
sync?: SyncStatus;
|
|
93
|
+
/** Admins only. Absent from an older server. */
|
|
94
|
+
oidcVerification?: OidcVerification;
|
|
57
95
|
}
|
|
58
96
|
|
|
59
97
|
export interface SaveResult {
|
|
@@ -61,6 +99,7 @@ export interface SaveResult {
|
|
|
61
99
|
complete: boolean;
|
|
62
100
|
awaitingRestart?: boolean;
|
|
63
101
|
settings: SettingStatus[];
|
|
102
|
+
oidcVerification?: OidcVerification;
|
|
64
103
|
}
|
|
65
104
|
|
|
66
105
|
/** Field-keyed messages, so the form can mark the input that was wrong. */
|
|
@@ -76,6 +115,21 @@ export class SettingsProblems extends Error {
|
|
|
76
115
|
}
|
|
77
116
|
}
|
|
78
117
|
|
|
118
|
+
/**
|
|
119
|
+
* The save went through, but the knowledge-base initialization it triggered
|
|
120
|
+
* did not. Distinct from a failed save: the values are stored, and retrying
|
|
121
|
+
* needs none of them re-entered.
|
|
122
|
+
*/
|
|
123
|
+
export class KbInitFailed extends Error {
|
|
124
|
+
readonly kbInit: KbInitFailure;
|
|
125
|
+
|
|
126
|
+
constructor(kbInit: KbInitFailure) {
|
|
127
|
+
super('Saved, but the knowledge base could not be initialized.');
|
|
128
|
+
this.name = 'KbInitFailed';
|
|
129
|
+
this.kbInit = kbInit;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
|
|
79
133
|
async function readError(res: Response): Promise<never> {
|
|
80
134
|
let body: unknown;
|
|
81
135
|
try {
|
|
@@ -83,8 +137,9 @@ async function readError(res: Response): Promise<never> {
|
|
|
83
137
|
} catch {
|
|
84
138
|
throw new Error(`Request failed (${res.status})`);
|
|
85
139
|
}
|
|
86
|
-
const data = body as { error?: string; problems?: Record<string, string
|
|
140
|
+
const data = body as { error?: string; problems?: Record<string, string>; kbInit?: KbInitFailure };
|
|
87
141
|
if (data.problems) throw new SettingsProblems(data.problems);
|
|
142
|
+
if (data.kbInit) throw new KbInitFailed(data.kbInit);
|
|
88
143
|
throw new Error(data.error || `Request failed (${res.status})`);
|
|
89
144
|
}
|
|
90
145
|
|
|
@@ -155,7 +210,16 @@ export async function saveSettings(settings: Record<string, string>): Promise<Sa
|
|
|
155
210
|
}
|
|
156
211
|
|
|
157
212
|
export interface ConnectionTest {
|
|
213
|
+
/** True only for a connection the host accepts for reading AND writing. */
|
|
158
214
|
ok: boolean;
|
|
215
|
+
/**
|
|
216
|
+
* Which of the three answers this is: read and write; reads but may not
|
|
217
|
+
* push (`error` names the permission to grant); or turned down before it
|
|
218
|
+
* could read — bad credentials, no repository, unreachable host.
|
|
219
|
+
*/
|
|
220
|
+
outcome?: 'connected' | 'read-only' | 'rejected';
|
|
221
|
+
/** The field a failure is about, when the server says. */
|
|
222
|
+
field?: string;
|
|
159
223
|
/** The remote answered but has no branches yet — a supported starting point. */
|
|
160
224
|
empty?: boolean;
|
|
161
225
|
branches?: string[];
|
|
@@ -165,6 +229,12 @@ export interface ConnectionTest {
|
|
|
165
229
|
* exactly, and being one character off is a failure nobody can see.
|
|
166
230
|
*/
|
|
167
231
|
defaultBranch?: string | null;
|
|
232
|
+
/**
|
|
233
|
+
* The repository's top-level folder names on that branch — empty for an
|
|
234
|
+
* empty repository, null (or absent, from an older server) when they could
|
|
235
|
+
* not be listed. The screen checks the three root folder fields against it.
|
|
236
|
+
*/
|
|
237
|
+
rootFolders?: string[] | null;
|
|
168
238
|
error?: string;
|
|
169
239
|
}
|
|
170
240
|
|
|
@@ -172,6 +242,13 @@ export interface ConnectionTest {
|
|
|
172
242
|
* Try the credentials against the real remote before saving anything. Values
|
|
173
243
|
* are sent as typed so an admin tests what is on screen, not what is stored;
|
|
174
244
|
* omitted fields fall back to what is already in effect.
|
|
245
|
+
*
|
|
246
|
+
* A 400 is an ANSWER, not a failure to ask: the server looked at these values
|
|
247
|
+
* and refused them ("enter the access token for that repository", "the URL
|
|
248
|
+
* must start with https://"). It comes back as the rejection it is, so no
|
|
249
|
+
* caller can mistake it for "could not check" and carry on past it. Any other
|
|
250
|
+
* failure throws — a 401/403 is about the session, not the repository, and
|
|
251
|
+
* must not be shown as the host refusing these values.
|
|
175
252
|
*/
|
|
176
253
|
export async function testConnection(fields: Record<string, string>): Promise<ConnectionTest> {
|
|
177
254
|
const res = await authFetch('/api/setup/test-connection', {
|
|
@@ -179,6 +256,66 @@ export async function testConnection(fields: Record<string, string>): Promise<Co
|
|
|
179
256
|
headers: { 'Content-Type': 'application/json' },
|
|
180
257
|
body: JSON.stringify(fields),
|
|
181
258
|
});
|
|
259
|
+
if (res.status === 400) {
|
|
260
|
+
let data: { error?: string; field?: string } = {};
|
|
261
|
+
try {
|
|
262
|
+
data = (await res.json()) as typeof data;
|
|
263
|
+
} catch {
|
|
264
|
+
// No body worth reading — the status alone still says "refused".
|
|
265
|
+
}
|
|
266
|
+
return {
|
|
267
|
+
ok: false,
|
|
268
|
+
outcome: 'rejected',
|
|
269
|
+
field: data.field,
|
|
270
|
+
error: data.error || `The connection check was refused (${res.status}).`,
|
|
271
|
+
};
|
|
272
|
+
}
|
|
182
273
|
if (!res.ok) await readError(res);
|
|
183
274
|
return (await res.json()) as ConnectionTest;
|
|
184
275
|
}
|
|
276
|
+
|
|
277
|
+
export interface OidcTest {
|
|
278
|
+
/** True for credentials the provider accepted, or an issuer checked on its own. */
|
|
279
|
+
ok: boolean;
|
|
280
|
+
/**
|
|
281
|
+
* `verified`: the provider accepted the application ID and secret.
|
|
282
|
+
* `issuer-verified`: the address is a sign-in provider; no credentials to try yet.
|
|
283
|
+
* `unverified`: the provider is fine, but its answer said nothing definite
|
|
284
|
+
* about the credentials — saving is allowed and shows as Unverified.
|
|
285
|
+
* `rejected`: the address or the credentials were turned down (`field` says which).
|
|
286
|
+
*/
|
|
287
|
+
outcome?: 'verified' | 'issuer-verified' | 'unverified' | 'rejected';
|
|
288
|
+
field?: string;
|
|
289
|
+
error?: string;
|
|
290
|
+
/** The configuration in effect, after this test. */
|
|
291
|
+
oidcVerification?: OidcVerification;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* Try the single sign-on values against the provider before saving them. As
|
|
296
|
+
* with {@link testConnection}, a 400 is the server refusing these values and
|
|
297
|
+
* comes back as a rejection; any other failure throws.
|
|
298
|
+
*/
|
|
299
|
+
export async function testOidc(fields: Record<string, string>): Promise<OidcTest> {
|
|
300
|
+
const res = await authFetch('/api/setup/test-oidc', {
|
|
301
|
+
method: 'POST',
|
|
302
|
+
headers: { 'Content-Type': 'application/json' },
|
|
303
|
+
body: JSON.stringify(fields),
|
|
304
|
+
});
|
|
305
|
+
if (res.status === 400) {
|
|
306
|
+
let data: { error?: string; field?: string } = {};
|
|
307
|
+
try {
|
|
308
|
+
data = (await res.json()) as typeof data;
|
|
309
|
+
} catch {
|
|
310
|
+
// The status alone still says "refused".
|
|
311
|
+
}
|
|
312
|
+
return {
|
|
313
|
+
ok: false,
|
|
314
|
+
outcome: 'rejected',
|
|
315
|
+
field: data.field,
|
|
316
|
+
error: data.error || `The sign-in check was refused (${res.status}).`,
|
|
317
|
+
};
|
|
318
|
+
}
|
|
319
|
+
if (!res.ok) await readError(res);
|
|
320
|
+
return (await res.json()) as OidcTest;
|
|
321
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { describe, expect, it } from 'vitest';
|
|
2
|
+
import { isRootFolderSuggestion, rootFolderState } from '../root-folders';
|
|
3
|
+
|
|
4
|
+
describe('rootFolderState', () => {
|
|
5
|
+
it('is found only on an exact match', () => {
|
|
6
|
+
expect(rootFolderState('Skills', ['KnowledgeBase', 'Skills'])).toEqual({ kind: 'found' });
|
|
7
|
+
expect(rootFolderState(' Skills ', ['Skills'])).toEqual({ kind: 'found' });
|
|
8
|
+
});
|
|
9
|
+
|
|
10
|
+
it('names a folder that differs only by case', () => {
|
|
11
|
+
expect(rootFolderState('Skills', ['skills'])).toEqual({
|
|
12
|
+
kind: 'variant',
|
|
13
|
+
candidate: 'skills',
|
|
14
|
+
difference: 'case',
|
|
15
|
+
});
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
it('names a folder that differs by case and a trailing s, either way round', () => {
|
|
19
|
+
expect(rootFolderState('Skills', ['skill'])).toEqual({
|
|
20
|
+
kind: 'variant',
|
|
21
|
+
candidate: 'skill',
|
|
22
|
+
difference: 'case-and-trailing-s',
|
|
23
|
+
});
|
|
24
|
+
expect(rootFolderState('Plugin', ['plugins'])).toEqual({
|
|
25
|
+
kind: 'variant',
|
|
26
|
+
candidate: 'plugins',
|
|
27
|
+
difference: 'case-and-trailing-s',
|
|
28
|
+
});
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
it('names a folder that differs only by a trailing s, either way round', () => {
|
|
32
|
+
expect(rootFolderState('Skills', ['Skill'])).toEqual({
|
|
33
|
+
kind: 'variant',
|
|
34
|
+
candidate: 'Skill',
|
|
35
|
+
difference: 'trailing-s',
|
|
36
|
+
});
|
|
37
|
+
expect(rootFolderState('plugin', ['plugins'])).toEqual({
|
|
38
|
+
kind: 'variant',
|
|
39
|
+
candidate: 'plugins',
|
|
40
|
+
difference: 'trailing-s',
|
|
41
|
+
});
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
it('prefers the case-only match when both are there', () => {
|
|
45
|
+
expect(rootFolderState('Skills', ['skill', 'SKILLS'])).toEqual({
|
|
46
|
+
kind: 'variant',
|
|
47
|
+
candidate: 'SKILLS',
|
|
48
|
+
difference: 'case',
|
|
49
|
+
});
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
it('is missing when nothing is like it', () => {
|
|
53
|
+
expect(rootFolderState('Plugins', ['KnowledgeBase', 'Skills', 'Data'])).toEqual({ kind: 'missing' });
|
|
54
|
+
expect(rootFolderState('Skills', [])).toEqual({ kind: 'missing' });
|
|
55
|
+
});
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
describe('isRootFolderSuggestion', () => {
|
|
59
|
+
it('offers names a root may take', () => {
|
|
60
|
+
expect(['KnowledgeBase', 'skills', 'docs-2'].filter(isRootFolderSuggestion)).toEqual([
|
|
61
|
+
'KnowledgeBase',
|
|
62
|
+
'skills',
|
|
63
|
+
'docs-2',
|
|
64
|
+
]);
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
it('holds back names the save would refuse: dot-folders and the reserved roots', () => {
|
|
68
|
+
for (const name of ['.github', '.bevel', 'Data', 'agents', 'PIPELINES']) {
|
|
69
|
+
expect(isRootFolderSuggestion(name)).toBe(false);
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
});
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { AGENTS_DIR, DATA_DIR, PIPELINES_DIR, validateKbRootName } from '@bevel-software/platform-shared';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* What the repository holds for one configured root folder, judged against
|
|
5
|
+
* the top-level folder names the connection test listed.
|
|
6
|
+
*
|
|
7
|
+
* - `found`: a folder with exactly that name.
|
|
8
|
+
* - `missing`: nothing like it; the initialization phase will create it.
|
|
9
|
+
* - `variant`: no exact match, but a folder that is plainly the same one
|
|
10
|
+
* spelled differently — by case (`skills` for `Skills`), by a trailing `s`
|
|
11
|
+
* (`Skill`), or by both (`skill`). Exactly the repository that got an empty
|
|
12
|
+
* `Skills/` scaffolded beside its real `skills/` and imported nothing.
|
|
13
|
+
*/
|
|
14
|
+
export type RootFolderState =
|
|
15
|
+
| { kind: 'found' }
|
|
16
|
+
| { kind: 'missing' }
|
|
17
|
+
| { kind: 'variant'; candidate: string; difference: 'case' | 'trailing-s' | 'case-and-trailing-s' };
|
|
18
|
+
|
|
19
|
+
const withoutTrailingS = (name: string) => name.replace(/s$/i, '');
|
|
20
|
+
|
|
21
|
+
export function rootFolderState(configured: string, rootFolders: readonly string[]): RootFolderState {
|
|
22
|
+
const name = configured.trim();
|
|
23
|
+
if (rootFolders.includes(name)) return { kind: 'found' };
|
|
24
|
+
const byCase = rootFolders.find((folder) => folder.toLowerCase() === name.toLowerCase());
|
|
25
|
+
if (byCase) return { kind: 'variant', candidate: byCase, difference: 'case' };
|
|
26
|
+
const byPlural = rootFolders.find(
|
|
27
|
+
(folder) => withoutTrailingS(folder).toLowerCase() === withoutTrailingS(name).toLowerCase(),
|
|
28
|
+
);
|
|
29
|
+
if (!byPlural) return { kind: 'missing' };
|
|
30
|
+
return {
|
|
31
|
+
kind: 'variant',
|
|
32
|
+
candidate: byPlural,
|
|
33
|
+
difference: withoutTrailingS(byPlural) === withoutTrailingS(name) ? 'trailing-s' : 'case-and-trailing-s',
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
const RESERVED_ROOTS = [DATA_DIR, AGENTS_DIR, PIPELINES_DIR].map((name) => name.toLowerCase());
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Whether a listed folder may be offered as a root name: one the save would
|
|
41
|
+
* accept on its own — not `.github`, not a reserved root like `Data`. Taking a
|
|
42
|
+
* suggestion should never produce a validation error.
|
|
43
|
+
*/
|
|
44
|
+
export function isRootFolderSuggestion(name: string): boolean {
|
|
45
|
+
return !validateKbRootName(name) && !RESERVED_ROOTS.includes(name.trim().toLowerCase());
|
|
46
|
+
}
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Cowork setup screenshots
|
|
2
|
+
|
|
3
|
+
The eleven shots behind the "Cowork and claude.ai" steps — the personal
|
|
4
|
+
carousel on the External agent access page, and the registration carousel in
|
|
5
|
+
Deployment → Marketplace, which ends on the same connector slide.
|
|
6
|
+
`../../components/claude-setup-shots.ts` pairs each with its alt text and the
|
|
7
|
+
percentage rectangle drawn over the control to click.
|
|
8
|
+
|
|
9
|
+
`01` through `09` were captured on a real deployment (Claude's admin
|
|
10
|
+
settings, Claude Code on the web, then Cowork), so the recipe below is what a
|
|
11
|
+
re-shoot has to repeat.
|
|
12
|
+
|
|
13
|
+
## Processing
|
|
14
|
+
|
|
15
|
+
Source frames `01` through `08` are full-window mockups, 1999x1588, with a
|
|
16
|
+
device frame on a black field.
|
|
17
|
+
|
|
18
|
+
1. **Redact.** This package is published, so every deployment shows these.
|
|
19
|
+
Gaussian blur, radius 9, over: the account row in the sidebar footer of
|
|
20
|
+
all eight, the two "Linked by ..." lines and the personal-account and
|
|
21
|
+
third-party organisation rows in `03`, and the organisation chips in `01`.
|
|
22
|
+
The vendor's own organisation stays legible; nothing else does.
|
|
23
|
+
2. **Crop** to the window, `(99, 72, 1901, 1462)`, dropping the frame.
|
|
24
|
+
3. **Scale** to 1400px wide (Lanczos) and encode webp at q80. That is about
|
|
25
|
+
35 to 65 KB each, and roughly 2x the ~700px column they render into.
|
|
26
|
+
|
|
27
|
+
Redact before scaling: blur radius is in source pixels.
|
|
28
|
+
|
|
29
|
+
`09-select-repository.webp` came from an 1806x1376 Claude Code screenshot.
|
|
30
|
+
Blur the personal name in the greeting and account row, then crop away the
|
|
31
|
+
outer device frame and shadow so the Claude viewport runs edge to edge like
|
|
32
|
+
shots `01` through `08`. Crop the normalized source at `(67, 55, 1277, 989)`,
|
|
33
|
+
scale that 1210x934 viewport to 1400x1080, and encode it as webp at q80.
|
|
34
|
+
|
|
35
|
+
## The two connector shots
|
|
36
|
+
|
|
37
|
+
`10-connector-not-added.webp` and `11-add-custom-connector.webp` are
|
|
38
|
+
**placeholder renderings**, not captures: they were drawn to the layout of the
|
|
39
|
+
screens they describe rather than photographed on a deployment. Replace them
|
|
40
|
+
with real captures when the connector flow is next in front of a camera. Until
|
|
41
|
+
then the alt text, not the pixels, is what the step relies on.
|
|
42
|
+
|
|
43
|
+
Both carry `illustration: true` in `claude-setup-shots.ts`, so the carousel
|
|
44
|
+
prints a line under each frame telling the reader it is a drawing. That flag
|
|
45
|
+
is not a label on the file, it is the promise the page makes: a real capture
|
|
46
|
+
means deleting it, re-measuring the two boxes against the new pixels, and
|
|
47
|
+
updating the intrinsic size if the shape changed. Shipping a capture while
|
|
48
|
+
the flag stays on tells readers to distrust a true picture; leaving the flag
|
|
49
|
+
off while the drawing stays sends them looking for a row that is not where
|
|
50
|
+
the picture puts it.
|
|
51
|
+
|
|
52
|
+
They are 1400x700, not 1400x1080: a plugin panel and a dialog are not the
|
|
53
|
+
shape of a full window, and padding them to the window shots' height would
|
|
54
|
+
reserve a column of empty space before the bytes land. That is what the
|
|
55
|
+
optional `width`/`height` on `Shot` is for — a shot that omits them is the
|
|
56
|
+
default 1400x1080. A re-shoot may land on any size, as long as the file and
|
|
57
|
+
the two numbers agree.
|
|
58
|
+
|
|
59
|
+
Same processing otherwise: redact first, then scale to 1400px wide (Lanczos)
|
|
60
|
+
and encode webp at q80.
|
|
61
|
+
|
|
62
|
+
## Highlights
|
|
63
|
+
|
|
64
|
+
Measure against the final image at its own size and convert each box to
|
|
65
|
+
percentages, with 6px of padding on each side. Percentages keep the callout
|
|
66
|
+
aligned when the shot renders in a narrower column. When a shot is replaced,
|
|
67
|
+
re-measure and update `claude-setup-shots.ts`; nothing reads the numbers from
|
|
68
|
+
the file.
|