@bevel-software/platform-core-frontend 0.26.0 → 0.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. package/package.json +2 -2
  2. package/src/core/CoreAppShell.tsx +87 -25
  3. package/src/core/ProductName.tsx +49 -0
  4. package/src/core/__tests__/ProductName.test.tsx +46 -0
  5. package/src/core/__tests__/ShellRoutes.test.tsx +22 -0
  6. package/src/core/__tests__/core-contributions.test.ts +16 -0
  7. package/src/core/core-contributions.ts +17 -0
  8. package/src/core/maker-url.ts +30 -0
  9. package/src/core/registry.ts +78 -1
  10. package/src/index.css +23 -5
  11. package/src/index.ts +5 -0
  12. package/src/lib/__tests__/latest-request.test.ts +48 -0
  13. package/src/lib/latest-request.ts +45 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.no-sso-invite.test.tsx +222 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +1 -1
  16. package/src/modules/access/api.ts +19 -3
  17. package/src/modules/access/components/ManageAccessDialog.tsx +61 -8
  18. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +16 -1
  19. package/src/modules/admin/__tests__/RolesCorruptedBanner.test.tsx +70 -0
  20. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +284 -39
  21. package/src/modules/admin/components/AdminRolesPage.tsx +13 -14
  22. package/src/modules/admin/components/RolesCorruptedBanner.tsx +9 -4
  23. package/src/modules/admin/components/UserAccountsPage.tsx +91 -107
  24. package/src/modules/admin/services/roles.api.ts +14 -1
  25. package/src/modules/auth/__tests__/LoginScreen.test.tsx +80 -5
  26. package/src/modules/auth/__tests__/sso-strict-probe.test.ts +66 -0
  27. package/src/modules/auth/components/LoginScreen.tsx +101 -73
  28. package/src/modules/auth/services/account.api.ts +59 -3
  29. package/src/modules/auth/services/sso.ts +30 -10
  30. package/src/modules/auth/state/use-sign-in-methods.ts +41 -0
  31. package/src/modules/change-requests/__tests__/ChangeRequestDialog.sync-banner.test.tsx +176 -0
  32. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +68 -0
  33. package/src/modules/change-requests/__tests__/ChangeRequestLink.test.tsx +182 -0
  34. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +1 -1
  35. package/src/modules/change-requests/__tests__/readFileOnBranch.test.ts +79 -0
  36. package/src/modules/change-requests/components/ChangeBox.tsx +6 -1
  37. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +45 -15
  38. package/src/modules/change-requests/components/ChangeRequestLink.tsx +151 -0
  39. package/src/modules/change-requests/components/CrFileTree.tsx +2 -1
  40. package/src/modules/change-requests/components/FileChangeBoxes.tsx +4 -2
  41. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +6 -3
  42. package/src/modules/change-requests/services/change-requests.api.ts +15 -2
  43. package/src/modules/change-requests/utils/readFailure.ts +22 -0
  44. package/src/modules/embed/__tests__/EmbedLinkPage.test.tsx +74 -0
  45. package/src/modules/embed/__tests__/EmbedView.test.tsx +473 -0
  46. package/src/modules/embed/__tests__/embed-config.test.ts +128 -0
  47. package/src/modules/embed/__tests__/embed-host.test.ts +111 -0
  48. package/src/modules/embed/__tests__/mcp-app-view.test.ts +295 -0
  49. package/src/modules/embed/__tests__/mount.test.tsx +157 -0
  50. package/src/modules/embed/components/EmbedLinkPage.tsx +109 -0
  51. package/src/modules/embed/components/EmbedView.tsx +545 -0
  52. package/src/modules/embed/embed-config.ts +132 -0
  53. package/src/modules/embed/embed-host.ts +120 -0
  54. package/src/modules/embed/mount.tsx +80 -0
  55. package/src/modules/embed/services/embed-token.ts +22 -0
  56. package/src/modules/embed/services/embed.api.ts +158 -0
  57. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +202 -4
  58. package/src/modules/git/__tests__/GitSyncFailedBanner.test.tsx +59 -1
  59. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +39 -22
  60. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +7 -2
  61. package/src/modules/git/branch-delete-menu-item.tsx +24 -0
  62. package/src/modules/git/components/BranchSwitcher.tsx +29 -5
  63. package/src/modules/git/components/GitSyncFailedBanner.tsx +53 -15
  64. package/src/modules/git/components/HistoryVersionPreview.tsx +5 -3
  65. package/src/modules/git/components/PullNeededBanner.tsx +15 -49
  66. package/src/modules/git/hooks/useAutoPullUpdates.ts +9 -5
  67. package/src/modules/git/index.ts +15 -0
  68. package/src/modules/git/services/__tests__/error-messages.test.ts +67 -0
  69. package/src/modules/git/services/__tests__/pull-failure.test.ts +36 -0
  70. package/src/modules/git/services/error-messages.ts +58 -1
  71. package/src/modules/git/services/pull-failure.ts +68 -0
  72. package/src/modules/git/state/branch-delete-confirm.ts +46 -0
  73. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +1 -0
  74. package/src/modules/layout/__tests__/breakpoints.test.ts +7 -1
  75. package/src/modules/layout/breakpoints.ts +8 -0
  76. package/src/modules/library/__tests__/PluginExtras.test.tsx +9 -9
  77. package/src/modules/library/__tests__/PluginPage.test.tsx +8 -1
  78. package/src/modules/library/__tests__/SkillsTree.test.tsx +13 -4
  79. package/src/modules/library/components/LibraryPage.tsx +22 -0
  80. package/src/modules/library/components/PluginExtras.tsx +23 -6
  81. package/src/modules/library/components/PluginPage.tsx +6 -1
  82. package/src/modules/library/routes/LibraryRoutes.tsx +8 -7
  83. package/src/modules/library/services/plugins.api.ts +4 -1
  84. package/src/modules/library/state/plugins-revision.ts +28 -0
  85. package/src/modules/onboarding/__tests__/InviteButton.test.tsx +214 -0
  86. package/src/modules/onboarding/__tests__/agent-connection-api.test.ts +55 -0
  87. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +87 -82
  88. package/src/modules/onboarding/__tests__/first-page-prompt.test.ts +164 -0
  89. package/src/modules/onboarding/__tests__/get-started-column.test.tsx +1458 -0
  90. package/src/modules/onboarding/__tests__/invite-dialog.test.tsx +811 -0
  91. package/src/modules/onboarding/__tests__/invite-emails.test.ts +247 -0
  92. package/src/modules/onboarding/__tests__/onboarding.test.tsx +226 -193
  93. package/src/modules/onboarding/__tests__/starter-pack-card.test.tsx +136 -0
  94. package/src/modules/onboarding/components/CreatorWelcomePage.tsx +7 -11
  95. package/src/modules/onboarding/components/EmailChipsInput.tsx +138 -0
  96. package/src/modules/onboarding/components/GetStartedColumn.tsx +670 -0
  97. package/src/modules/onboarding/components/InviteButton.tsx +139 -0
  98. package/src/modules/onboarding/components/InviteDialog.tsx +741 -0
  99. package/src/modules/onboarding/components/RootLanding.tsx +8 -24
  100. package/src/modules/onboarding/components/StarterPackCard.tsx +98 -0
  101. package/src/modules/onboarding/components/WelcomePage.tsx +65 -154
  102. package/src/modules/onboarding/first-page-prompt.ts +123 -0
  103. package/src/modules/onboarding/invite-emails.ts +313 -0
  104. package/src/modules/onboarding/services/agent-connection.api.ts +53 -0
  105. package/src/modules/onboarding/services/starter-packs.api.ts +83 -0
  106. package/src/modules/onboarding/state/agent-connection.ts +167 -0
  107. package/src/modules/onboarding/state/invite-dialog.context.ts +35 -0
  108. package/src/modules/onboarding/state/invite-dialog.tsx +39 -0
  109. package/src/modules/onboarding/state/onboarding.ts +133 -59
  110. package/src/modules/onboarding/state/starter-packs.ts +169 -0
  111. package/src/modules/settings/settings-nav-items.tsx +8 -3
  112. package/src/modules/setup/__tests__/setup.first-run-storage.test.tsx +389 -0
  113. package/src/modules/setup/__tests__/setup.github.test.tsx +5 -5
  114. package/src/modules/setup/__tests__/setup.kept-draft.test.tsx +1 -1
  115. package/src/modules/setup/__tests__/setup.repository-change.test.tsx +1 -1
  116. package/src/modules/setup/__tests__/setup.repository.test.tsx +21 -21
  117. package/src/modules/setup/__tests__/setup.test.tsx +56 -15
  118. package/src/modules/setup/__tests__/useConnectionProbe.test.tsx +123 -0
  119. package/src/modules/setup/components/FirstRunStorage.tsx +560 -0
  120. package/src/modules/setup/components/SetupGate.tsx +46 -1
  121. package/src/modules/setup/components/SetupScreen.tsx +81 -84
  122. package/src/modules/setup/hooks/useConnectionProbe.ts +93 -0
  123. package/src/modules/setup/services/setup.api.ts +3 -3
  124. package/src/modules/setup/utils/suggested-branch.ts +27 -0
  125. package/src/modules/toolbar/commands/__tests__/actions.test.tsx +210 -0
  126. package/src/modules/toolbar/commands/actions.tsx +330 -0
  127. package/src/modules/toolbar/commands/command-menu.ts +44 -0
  128. package/src/modules/toolbar/commands/useCommandActions.ts +71 -0
  129. package/src/modules/toolbar/commands/useCommandShortcuts.ts +121 -0
  130. package/src/modules/toolbar/components/AppSwitcher.tsx +125 -22
  131. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +1 -1
  132. package/src/modules/toolbar/components/ProfileMenu.tsx +9 -4
  133. package/src/modules/toolbar/components/SearchPalette.tsx +540 -0
  134. package/src/modules/toolbar/components/Toolbar.tsx +10 -0
  135. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +230 -52
  136. package/src/modules/toolbar/components/__tests__/ProfileMenu.test.tsx +64 -0
  137. package/src/modules/toolbar/components/__tests__/SearchPalette.test.tsx +864 -0
  138. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +57 -2
  139. package/src/modules/toolbar/search/__tests__/rank.test.ts +93 -0
  140. package/src/modules/toolbar/search/__tests__/sources.test.ts +131 -0
  141. package/src/modules/toolbar/search/rank.ts +111 -0
  142. package/src/modules/toolbar/search/sources.ts +169 -0
  143. package/src/modules/workflow/hooks/useFileLock.ts +10 -7
  144. package/src/modules/workflow/services/__tests__/lock.api.test.ts +41 -0
  145. package/src/modules/workflow/services/lock.api.ts +17 -2
  146. package/src/modules/workspace/__tests__/useWorkspaceState.test.ts +49 -1
  147. package/src/modules/workspace/components/EditorTabs.tsx +39 -15
  148. package/src/modules/workspace/components/FileExplorer.tsx +39 -6
  149. package/src/modules/workspace/components/FilePaneCard.tsx +6 -2
  150. package/src/modules/workspace/components/FileRoute.tsx +12 -7
  151. package/src/modules/workspace/components/FileViewer.tsx +271 -74
  152. package/src/modules/workspace/components/KbPageHeader.tsx +13 -6
  153. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +88 -21
  154. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +92 -4
  155. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +23 -3
  156. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +330 -6
  157. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +17 -2
  158. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +11 -16
  159. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +6 -0
  160. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +23 -21
  161. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +13 -29
  162. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +9 -2
  163. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +8 -0
  164. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +14 -19
  165. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +11 -17
  166. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +35 -7
  167. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -17
  168. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.links.test.tsx +73 -0
  169. package/src/modules/workspace/components/renderers/__tests__/ToolRenderer.scaffold.test.tsx +64 -0
  170. package/src/modules/workspace/components/renderers/__tests__/ToolRenderer.surface.test.tsx +82 -0
  171. package/src/modules/workspace/components/renderers/__tests__/bridgeHarness.ts +99 -0
  172. package/src/modules/workspace/components/renderers/__tests__/htmlSandbox.test.ts +129 -35
  173. package/src/modules/workspace/components/renderers/__tests__/htmlViewsGuide.test.ts +149 -0
  174. package/src/modules/workspace/components/renderers/__tests__/kbMarkdownLinkPolicy.test.tsx +100 -0
  175. package/src/modules/workspace/components/renderers/htmlSandbox.ts +76 -20
  176. package/src/modules/workspace/components/renderers/index.ts +26 -0
  177. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +51 -1
  178. package/src/modules/workspace/components/renderers/rendererRawRead.ts +53 -0
  179. package/src/modules/workspace/components/renderers/rendererSurface.ts +109 -0
  180. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +8 -2
  181. package/src/modules/workspace/hooks/__tests__/useCreatePage.test.ts +137 -0
  182. package/src/modules/workspace/hooks/__tests__/useKnowledgeWriteTarget.test.ts +302 -0
  183. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +126 -21
  184. package/src/modules/workspace/hooks/useCreatePage.ts +206 -0
  185. package/src/modules/workspace/hooks/useKnowledgeWriteTarget.ts +238 -0
  186. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +24 -7
  187. package/src/modules/workspace/hooks/useWorkspaceState.ts +42 -8
  188. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +10 -0
  189. package/src/modules/workspace/routing/__tests__/md-links-parity.test.tsx +113 -0
  190. package/src/modules/workspace/routing/kb-routes.ts +66 -12
  191. package/src/modules/workspace/state/editable-page.ts +42 -0
  192. package/src/modules/workspace/state/workspace.context.ts +13 -4
  193. package/src/modules/workspace/utils/__tests__/display-file-name.test.ts +60 -0
  194. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +75 -0
  195. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +16 -0
  196. package/src/modules/workspace/utils/display-file-name.ts +102 -0
  197. package/src/modules/workspace/utils/fileTree.ts +49 -14
  198. package/src/modules/workspace/utils/treeConfirm.ts +15 -0
  199. package/src/shared/__tests__/no-builtin-confirm.test.ts +102 -0
  200. package/src/shared/components/ConfirmProvider.tsx +156 -0
  201. package/src/shared/components/Dialog.tsx +7 -0
  202. package/src/shared/components/__tests__/ConfirmProvider.test.tsx +198 -0
  203. package/src/shared/components/confirm-context.ts +94 -0
  204. package/src/shared/components/index.ts +3 -0
  205. package/src/modules/onboarding/components/WelcomeRoute.tsx +0 -57
  206. package/src/modules/onboarding/welcome-state.ts +0 -36
@@ -0,0 +1,1458 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { useEffect } from 'react';
3
+ import { act, render, screen, waitFor, within } from '@testing-library/react';
4
+ import userEvent from '@testing-library/user-event';
5
+ import { MemoryRouter, useLocation, useNavigate, type NavigateFunction } from 'react-router-dom';
6
+ import type { FileTreeEntry } from '@bevel-software/platform-shared';
7
+ import { AuthContext } from '../../auth/state/auth.context';
8
+ import { authValue } from '../../library/__tests__/auth-harness';
9
+ import { AdminContext, type AdminContextValue } from '../../admin/state/admin.context';
10
+ import { WorkspaceContext } from '../../workspace/state/workspace.context';
11
+ import { makeWorkspaceFixture } from '../../workspace/__tests__/testFixtures';
12
+ import { GetStartedColumn } from '../components/GetStartedColumn';
13
+ import { InviteDialogProvider } from '../state/invite-dialog';
14
+ import { resetOnboardingForTests } from '../state/onboarding';
15
+ import { WELCOME_PATH } from '../paths';
16
+ import { WorkspaceApiError } from '../../workspace/services/workspace.api';
17
+ import type { AccountSummary } from '../../auth/services/account.api';
18
+ import type { PluginSummary } from '../../library/services/plugins.api';
19
+ import type { AgentConnection } from '../services/agent-connection.api';
20
+ import { FIRST_PAGE_PROMPT, chatGptPromptUrl, claudePromptUrl } from '../first-page-prompt';
21
+ import type { StarterPacksAnswer } from '../services/starter-packs.api';
22
+ import { SearchPalette } from '../../toolbar/components/SearchPalette';
23
+ import { COMMAND_MENU_SHORTCUT_LABEL } from '../../toolbar/commands/command-menu';
24
+ import { AGENT_RECHECK_MS } from '../state/agent-connection';
25
+ import { notePluginCreated } from '../../library/state/plugins-revision';
26
+
27
+ /**
28
+ * The "Get set up" column: every tick is derived from state the app already
29
+ * has, the admin-only steps stay out of a member's list, and the column gets
30
+ * out of the way — on the welcome page, when narrow, when done, when closed.
31
+ */
32
+
33
+ const { listAccountsMock, listPluginsMock, openWorkspacePathMock, fetchAgentConnectionMock, authFetchMock } =
34
+ vi.hoisted(() => ({
35
+ listAccountsMock: vi.fn<() => Promise<AccountSummary[]>>(),
36
+ listPluginsMock: vi.fn<() => Promise<PluginSummary[]>>(),
37
+ openWorkspacePathMock: vi.fn<(path: string, options?: { edit?: boolean }) => void>(),
38
+ fetchAgentConnectionMock: vi.fn<() => Promise<AgentConnection>>(),
39
+ // The onboarding write (`markDone`) is the only thing that reaches it.
40
+ authFetchMock: vi.fn(async () => ({ ok: true, status: 200 }) as Response),
41
+ }));
42
+
43
+ vi.mock('../../../lib/api', () => ({ authFetch: authFetchMock }));
44
+
45
+ /**
46
+ * The repo-relative folders the person may write, as the batch access
47
+ * endpoint answers them. The top of Knowledge by default — what an admin
48
+ * may, and what every test before this ticket assumed. `readable` is what a
49
+ * draft branch asks the same endpoint instead: there the server's only gate
50
+ * on a new page is that its author may read where it lands.
51
+ */
52
+ type AccessVerb = 'write' | 'owner' | 'read';
53
+ const { access } = vi.hoisted(() => ({
54
+ access: {
55
+ writable: new Set<string>(),
56
+ readable: new Set<string>(),
57
+ batch: vi.fn<(workspaceId: string, paths: string[], verb?: AccessVerb) => Promise<{ results: Record<string, boolean> }>>(),
58
+ },
59
+ }));
60
+ vi.mock('../../access/api', async (importOriginal) => ({
61
+ ...(await importOriginal<typeof import('../../access/api')>()),
62
+ fetchFileAccessBatch: access.batch,
63
+ }));
64
+ vi.mock('../services/agent-connection.api', () => ({ fetchAgentConnection: fetchAgentConnectionMock }));
65
+ const { fetchStarterPacksMock } = vi.hoisted(() => ({
66
+ fetchStarterPacksMock: vi.fn<() => Promise<StarterPacksAnswer>>(),
67
+ }));
68
+ vi.mock('../services/starter-packs.api', async (importOriginal) => ({
69
+ ...(await importOriginal<typeof import('../services/starter-packs.api')>()),
70
+ fetchStarterPacks: fetchStarterPacksMock,
71
+ }));
72
+ vi.mock('../../auth/services/account.api', async (importOriginal) => ({
73
+ ...(await importOriginal<typeof import('../../auth/services/account.api')>()),
74
+ listAccounts: listAccountsMock,
75
+ }));
76
+ vi.mock('../../library/services/library.api', async (importOriginal) => ({
77
+ ...(await importOriginal<typeof import('../../library/services/library.api')>()),
78
+ listSkills: vi.fn(async () => []),
79
+ }));
80
+ vi.mock('../../secrets-vault/services/tool-secrets.api', async (importOriginal) => ({
81
+ ...(await importOriginal<typeof import('../../secrets-vault/services/tool-secrets.api')>()),
82
+ listToolSecrets: vi.fn(async () => []),
83
+ }));
84
+ vi.mock('../../library/services/plugins.api', async (importOriginal) => ({
85
+ ...(await importOriginal<typeof import('../../library/services/plugins.api')>()),
86
+ listPlugins: listPluginsMock,
87
+ }));
88
+ // The real hook needs the git context for its branch; the column only ever
89
+ // asks it to open a workspace path, which is the call these tests assert.
90
+ vi.mock('../../workspace/routing/kb-routes', async (importOriginal) => ({
91
+ ...(await importOriginal<typeof import('../../workspace/routing/kb-routes')>()),
92
+ useFileNav: () => ({
93
+ openFile: vi.fn(),
94
+ openLink: vi.fn(),
95
+ openWorkspacePath: openWorkspacePathMock,
96
+ closeFile: vi.fn(),
97
+ }),
98
+ }));
99
+
100
+ const KB = 'kb';
101
+ const GUIDE = `${KB}/KnowledgeBase/How to get started.md`;
102
+
103
+ /** A workspace tree holding exactly `files` (workspace-relative paths). */
104
+ function treeOf(files: string[]): FileTreeEntry {
105
+ const root: FileTreeEntry = { name: '', relativePath: '', type: 'directory', children: [] };
106
+ for (const file of files) {
107
+ const parts = file.split('/');
108
+ let node = root;
109
+ parts.forEach((name, i) => {
110
+ const relativePath = parts.slice(0, i + 1).join('/');
111
+ const isFile = i === parts.length - 1;
112
+ let child = node.children!.find((c) => c.name === name);
113
+ if (!child) {
114
+ child = isFile
115
+ ? { name, relativePath, type: 'file' }
116
+ : { name, relativePath, type: 'directory', children: [] };
117
+ node.children!.push(child);
118
+ }
119
+ node = child;
120
+ });
121
+ }
122
+ return root;
123
+ }
124
+
125
+ const STARTER_TREE = [GUIDE, `${KB}/KnowledgeBase/.gitkeep`, `${KB}/Plugins/.gitkeep`];
126
+
127
+ function account(email: string, over: Partial<AccountSummary> = {}): AccountSummary {
128
+ return {
129
+ id: email,
130
+ email,
131
+ name: email,
132
+ hasPassword: false,
133
+ isEnvAdmin: false,
134
+ isOwner: false,
135
+ ownerCanBeDeleted: false,
136
+ deactivatedAt: null,
137
+ isSystem: false,
138
+ createdAt: '2026-01-01T00:00:00Z',
139
+ ...over,
140
+ };
141
+ }
142
+
143
+ function plugin(folder: string): PluginSummary {
144
+ return {
145
+ name: folder.split('/').pop()!,
146
+ folders: [folder],
147
+ canRead: true,
148
+ canWrite: true,
149
+ isOwner: true,
150
+ skillCount: 0,
151
+ toolCount: 0,
152
+ owners: { roles: [], users: [] },
153
+ writers: { roles: [], users: [] },
154
+ readers: { roles: [], users: [], restricted: false },
155
+ hasRequested: false,
156
+ requestNumber: null,
157
+ };
158
+ }
159
+
160
+ function adminValue(isAdmin: boolean): AdminContextValue {
161
+ return {
162
+ isAdmin,
163
+ isAdminLoading: false,
164
+ unreadCount: 0,
165
+ lastSeen: null,
166
+ markSeen: () => {},
167
+ refresh: () => {},
168
+ rolesConfigCorrupted: false,
169
+ rolesConfigErrors: [],
170
+ runRolesRecovery: async () => {},
171
+ };
172
+ }
173
+
174
+ function LocationProbe() {
175
+ return <div data-testid="pathname">{useLocation().pathname}</div>;
176
+ }
177
+
178
+ /** The router's `navigate`, handed out so a test can move the app around under the column. */
179
+ let navigateTo: NavigateFunction = () => {};
180
+ function NavigateHandle() {
181
+ const navigate = useNavigate();
182
+ useEffect(() => {
183
+ navigateTo = navigate;
184
+ }, [navigate]);
185
+ return null;
186
+ }
187
+
188
+ function setViewportWidth(width: number): void {
189
+ (window as typeof window & { happyDOM: { setInnerWidth(v: number): void } }).happyDOM.setInnerWidth(width);
190
+ }
191
+
192
+ type MountOptions = {
193
+ admin?: boolean;
194
+ onboardingDone?: boolean;
195
+ /** The workspace's files; null while the tree has not loaded. */
196
+ files?: string[] | null;
197
+ openFilePath?: string | null;
198
+ route?: string;
199
+ createFile?: (relativePath: string, content?: string, options?: { ifAbsent?: boolean }) => Promise<void>;
200
+ /** Mount the toolbar's command menu beside the column, as the app does. */
201
+ withPalette?: boolean;
202
+ /** The branch on screen; the default one (the test setup's) unless a test is about a draft. */
203
+ workspaceBranch?: string | null;
204
+ };
205
+
206
+ /** The default branch the test setup pins: where a starter pack lands. */
207
+ const DEFAULT_BRANCH = 'target-company-state';
208
+
209
+ /** The column in every context it reads; `rerender` it to move the app's state under it. */
210
+ function columnUi({
211
+ admin = false,
212
+ onboardingDone = false,
213
+ files = STARTER_TREE,
214
+ openFilePath = null as string | null,
215
+ route = '/workspace',
216
+ createFile = async () => {},
217
+ withPalette = false,
218
+ workspaceBranch = DEFAULT_BRANCH,
219
+ }: MountOptions = {}) {
220
+ const auth = authValue({ user: sessionUser(onboardingDone) });
221
+ const ui = (
222
+ <MemoryRouter initialEntries={[route]}>
223
+ <AuthContext.Provider value={auth}>
224
+ <AdminContext.Provider value={adminValue(admin)}>
225
+ <WorkspaceContext.Provider
226
+ value={makeWorkspaceFixture({
227
+ kbDirName: KB,
228
+ fileTree: files ? treeOf(files) : null,
229
+ openFilePath,
230
+ createFile,
231
+ workspaceBranch,
232
+ })}
233
+ >
234
+ <InviteDialogProvider>
235
+ {withPalette && <SearchPalette compact />}
236
+ <GetStartedColumn />
237
+ <LocationProbe />
238
+ <NavigateHandle />
239
+ </InviteDialogProvider>
240
+ </WorkspaceContext.Provider>
241
+ </AdminContext.Provider>
242
+ </AuthContext.Provider>
243
+ </MemoryRouter>
244
+ );
245
+ return ui;
246
+ }
247
+
248
+ /**
249
+ * Mount the column and let the question of where New page may write answer
250
+ * (the list waits for it, so nothing is on screen before it does).
251
+ */
252
+ async function mount(options: MountOptions = {}) {
253
+ const ui = columnUi(options);
254
+ const rendered = render(ui);
255
+ await settle();
256
+ return { ...rendered, ui };
257
+ }
258
+
259
+ /** Let pending requests answer: one macrotask runs every queued microtask. */
260
+ async function settle() {
261
+ await act(async () => {
262
+ if (vi.isFakeTimers()) await vi.advanceTimersByTimeAsync(0);
263
+ else await new Promise((resolve) => setTimeout(resolve, 0));
264
+ });
265
+ }
266
+
267
+ /** Longer than the write check's debounce (250 ms, private to the hook). */
268
+ const PAST_WRITE_CHECK_DEBOUNCE_MS = 300;
269
+
270
+ /** Wait past the write check's debounce, so a tree change has been asked about. */
271
+ async function settleRecheck() {
272
+ await act(async () => {
273
+ await new Promise((resolve) => setTimeout(resolve, PAST_WRITE_CHECK_DEBOUNCE_MS));
274
+ });
275
+ await settle();
276
+ }
277
+
278
+ /** The checklist row titled `title`, or null when the column does not list it. */
279
+ function row(title: RegExp | string) {
280
+ const column = screen.getByRole('complementary', { name: 'Get set up' });
281
+ const heading = within(column).queryByText(title);
282
+ return heading ? (heading.closest('li') as HTMLElement) : null;
283
+ }
284
+
285
+ const isDone = (title: RegExp | string) => within(row(title)!).queryByText('(done)') !== null;
286
+
287
+ /**
288
+ * The signed-in user of the test at hand, one object per test and per
289
+ * onboarding state, never mutated: what the app keeps per signed-in user
290
+ * (the starter-pack answer) lives across a rerender, and never leaks into
291
+ * the next test, which signs in afresh.
292
+ */
293
+ type SessionUser = { id: string; email: string; name: string; onboardingDone: boolean };
294
+ let sessionUsers: Record<'done' | 'pending', SessionUser>;
295
+ const sessionUser = (onboardingDone: boolean) => sessionUsers[onboardingDone ? 'done' : 'pending'];
296
+
297
+ beforeEach(() => {
298
+ resetOnboardingForTests();
299
+ const juan = { id: 'u1', email: 'juan@bevel.software', name: 'Juan Viera' };
300
+ sessionUsers = { done: { ...juan, onboardingDone: true }, pending: { ...juan, onboardingDone: false } };
301
+ fetchStarterPacksMock.mockReset().mockResolvedValue({ offered: false, chosen: null, packs: [], chosenPack: null });
302
+ setViewportWidth(1400);
303
+ listAccountsMock.mockReset().mockResolvedValue([account('juan@bevel.software')]);
304
+ listPluginsMock.mockReset().mockResolvedValue([]);
305
+ openWorkspacePathMock.mockReset();
306
+ fetchAgentConnectionMock.mockReset().mockResolvedValue({ connected: false });
307
+ authFetchMock.mockClear();
308
+ access.writable = new Set(['KnowledgeBase']);
309
+ access.readable = new Set(['KnowledgeBase']);
310
+ access.batch.mockReset().mockImplementation(async (_ws, paths, verb = 'write') => ({
311
+ results: Object.fromEntries(paths.map((p) => [p, (verb === 'read' ? access.readable : access.writable).has(p)])),
312
+ }));
313
+ });
314
+
315
+ /** The verb every access check so far asked: `read` on a draft, `write` anywhere else. */
316
+ const accessVerbsAsked = () => new Set(access.batch.mock.calls.map((c) => c[2] ?? 'write'));
317
+
318
+ /** Calls to the onboarding write — the one `markDone` makes. */
319
+ const doneWrites = () =>
320
+ authFetchMock.mock.calls.filter((c) => (c as unknown[])[0] === '/api/auth/onboarding-done').length;
321
+
322
+ describe('GetStartedColumn: what a member sees', () => {
323
+ it('lists the five member steps, hides the admin-only ones, and asks the server nothing', async () => {
324
+ await mount();
325
+ expect(screen.getByText('1 of 5')).toBeInTheDocument();
326
+ expect(row('Create your workspace')).not.toBeNull();
327
+ expect(row('Connect your agent')).not.toBeNull();
328
+ expect(row('Read “How to get started”')).not.toBeNull();
329
+ expect(row('Write your first page')).not.toBeNull();
330
+ expect(row(/^Find or do anything with/)).not.toBeNull();
331
+ expect(row('Choose where your knowledge lives')).toBeNull();
332
+ expect(row('Create a plugin for your team')).toBeNull();
333
+ expect(row('Invite your team')).toBeNull();
334
+ expect(listAccountsMock).not.toHaveBeenCalled();
335
+ expect(listPluginsMock).not.toHaveBeenCalled();
336
+ });
337
+
338
+ it('ticks "Connect your agent" from the server onboarding flag', async () => {
339
+ await mount({ onboardingDone: true });
340
+ expect(isDone('Connect your agent')).toBe(true);
341
+ expect(isDone('Create your workspace')).toBe(true);
342
+ expect(screen.getByText('2 of 5')).toBeInTheDocument();
343
+ });
344
+
345
+ it('sends "Connect" to the welcome page', async () => {
346
+ await mount();
347
+ await userEvent.click(within(row('Connect your agent')!).getByRole('button', { name: 'Connect' }));
348
+ expect(screen.getByTestId('pathname')).toHaveTextContent(WELCOME_PATH);
349
+ });
350
+
351
+ it('opens the starter guide and ticks it', async () => {
352
+ await mount();
353
+ expect(isDone('Read “How to get started”')).toBe(false);
354
+ await userEvent.click(within(row('Read “How to get started”')!).getByRole('button', { name: 'Open it' }));
355
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(GUIDE);
356
+ expect(isDone('Read “How to get started”')).toBe(true);
357
+ });
358
+
359
+ it('ticks the guide when it is opened by any route, and remembers it', async () => {
360
+ const { unmount } = await mount({ openFilePath: GUIDE });
361
+ expect(isDone('Read “How to get started”')).toBe(true);
362
+ unmount();
363
+ await mount();
364
+ expect(isDone('Read “How to get started”')).toBe(true);
365
+ });
366
+
367
+ it('leaves the guide step out when the knowledge base has no such page', async () => {
368
+ await mount({ files: [`${KB}/KnowledgeBase/.gitkeep`] });
369
+ expect(row('Read “How to get started”')).toBeNull();
370
+ expect(screen.getByText('1 of 4')).toBeInTheDocument();
371
+ });
372
+
373
+ it('ticks "Write your first page" only for content other than the starter page', async () => {
374
+ const { unmount } = await mount({ files: [...STARTER_TREE, `${KB}/KnowledgeBase/access.md`] });
375
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalled());
376
+ expect(isDone('Write your first page')).toBe(false);
377
+ expect(
378
+ within(row('Write your first page')!).getByText(
379
+ 'Start one here, or drop files into the file tree.',
380
+ ),
381
+ ).toBeInTheDocument();
382
+ unmount();
383
+ await mount({ files: [...STARTER_TREE, `${KB}/KnowledgeBase/Product/Roadmap.md`] });
384
+ // Ticked once the starter-pack answer is in (none chosen here).
385
+ await waitFor(() => expect(isDone('Write your first page')).toBe(true));
386
+ });
387
+
388
+ it('"New page" creates Untitled.md in the Knowledge folder and opens it for editing', async () => {
389
+ const createFile = vi.fn(async () => {});
390
+ await mount({ createFile });
391
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
392
+ expect(createFile).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
393
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled.md`, { edit: true });
394
+ });
395
+
396
+ it('"New page" takes the next free name when Untitled.md is taken', async () => {
397
+ const createFile = vi.fn(async () => {});
398
+ // Any page would already tick the step and hide the button, so what holds
399
+ // the name here is an (otherwise empty) folder called `Untitled.md` and
400
+ // `Untitled 2.md` — a name the tree has is taken, whatever it is.
401
+ await mount({
402
+ createFile,
403
+ files: [
404
+ ...STARTER_TREE,
405
+ `${KB}/KnowledgeBase/Untitled.md/.gitkeep`,
406
+ `${KB}/KnowledgeBase/Untitled 2.md/.gitkeep`,
407
+ ],
408
+ });
409
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
410
+ expect(createFile).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled 3.md`, '# Untitled\n\n', { ifAbsent: true });
411
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled 3.md`, { edit: true });
412
+ });
413
+
414
+ /**
415
+ * The tree can be a moment behind: a page made elsewhere since it loaded
416
+ * holds the name the column picked. The create is exclusive, so the
417
+ * backend refuses (409) instead of replacing that page, and the column
418
+ * moves on to the next name.
419
+ */
420
+ it('"New page" never overwrites: a name taken since the tree loaded moves on to the next', async () => {
421
+ const taken = new Set([`${KB}/KnowledgeBase/Untitled.md`, `${KB}/KnowledgeBase/Untitled 2.md`]);
422
+ const createFile = vi.fn(async (path: string) => {
423
+ if (taken.has(path)) throw new WorkspaceApiError(409, `"${path}" already exists.`);
424
+ });
425
+ await mount({ createFile });
426
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
427
+ await waitFor(() =>
428
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled 3.md`, { edit: true }),
429
+ );
430
+ expect(createFile.mock.calls.map((c) => c[0])).toEqual([
431
+ `${KB}/KnowledgeBase/Untitled.md`,
432
+ `${KB}/KnowledgeBase/Untitled 2.md`,
433
+ `${KB}/KnowledgeBase/Untitled 3.md`,
434
+ ]);
435
+ expect(within(row('Write your first page')!).queryByRole('alert')).not.toBeInTheDocument();
436
+ });
437
+
438
+ it('"New page" gives up after a few taken names, and says so on the step', async () => {
439
+ const createFile = vi.fn(async (path: string) => {
440
+ throw new WorkspaceApiError(409, `"${path}" already exists.`);
441
+ });
442
+ await mount({ createFile });
443
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
444
+ expect(await within(row('Write your first page')!).findByRole('alert')).toHaveTextContent(
445
+ `Couldn’t create the page: "${KB}/KnowledgeBase/Untitled 5.md" already exists.`,
446
+ );
447
+ expect(createFile).toHaveBeenCalledTimes(5);
448
+ expect(openWorkspacePathMock).not.toHaveBeenCalled();
449
+ });
450
+
451
+ // Mid-switch, the URL names the destination branch while the workspace on
452
+ // screen (and `createFile`) is still the branch being left; a page made in
453
+ // that gap would land on the old branch and open on the new one, nowhere.
454
+ it('"New page" creates nothing while the workspace on screen is not the branch the URL names', async () => {
455
+ const createFile = vi.fn(async () => {});
456
+ await mount({ createFile, route: '/workspace/alice%2Fdraft' });
457
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
458
+ expect(await within(row('Write your first page')!).findByRole('alert')).toHaveTextContent(
459
+ 'Couldn’t create the page: the workspace is still loading.',
460
+ );
461
+ expect(createFile).not.toHaveBeenCalled();
462
+ expect(openWorkspacePathMock).not.toHaveBeenCalled();
463
+ });
464
+
465
+ // A protected branch's gate refuses with 403 too; the fresh access check
466
+ // still says the folder may be written, so the refusal is said as it was.
467
+ it('"New page" goes quietly when a refusal is not about the folder: the check still says it may be written', async () => {
468
+ const createFile = vi.fn(async () => {
469
+ throw new WorkspaceApiError(403, 'Branch "main" is protected — writing is not allowed.');
470
+ });
471
+ const { rerender } = await mount({ createFile });
472
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
473
+ await waitFor(() => expect(row('Write your first page')).toBeNull());
474
+ expect(createFile).toHaveBeenCalledTimes(1);
475
+ expect(access.batch).toHaveBeenCalledTimes(2);
476
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
477
+ expect(screen.queryByText(/protected|not allowed|permission|Eligible/)).not.toBeInTheDocument();
478
+ // It stays gone through a later tree change on the same branch.
479
+ // A folder, not a page: a page would tick the step and hide it on its own.
480
+ const later = [...STARTER_TREE, `${KB}/KnowledgeBase/Notes/.gitkeep`];
481
+ rerender(columnUi({ createFile, files: later }));
482
+ await settleRecheck();
483
+ expect(row('Write your first page')).toBeNull();
484
+ // A switch away and back lifts it: the branch is asked about afresh.
485
+ rerender(columnUi({ createFile, files: later, workspaceBranch: 'alice/draft' }));
486
+ await settle();
487
+ rerender(columnUi({ createFile, files: later }));
488
+ await settle();
489
+ expect(row('Write your first page')).not.toBeNull();
490
+ });
491
+
492
+ it('"New page" says "Creating…" while it works, and says why it failed on the step', async () => {
493
+ let refuse!: (err: Error) => void;
494
+ const createFile = vi.fn(
495
+ () =>
496
+ new Promise<void>((_, reject) => {
497
+ refuse = reject;
498
+ }),
499
+ );
500
+ await mount({ createFile });
501
+ await userEvent.click(within(row('Write your first page')!).getByRole('button', { name: 'New page' }));
502
+ expect(within(row('Write your first page')!).getByRole('button', { name: 'Creating…' })).toBeDisabled();
503
+
504
+ await act(async () => {
505
+ refuse(new Error('The server did not answer.'));
506
+ });
507
+ expect(within(row('Write your first page')!).getByRole('alert')).toHaveTextContent(
508
+ 'Couldn’t create the page: The server did not answer.',
509
+ );
510
+ expect(within(row('Write your first page')!).getByRole('button', { name: 'New page' })).toBeEnabled();
511
+ expect(openWorkspacePathMock).not.toHaveBeenCalled();
512
+ expect(isDone('Write your first page')).toBe(false);
513
+ });
514
+ });
515
+
516
+ /**
517
+ * New page writes where the person may write: the top of Knowledge when they
518
+ * may (admins), else the folder of the page on screen, else the first folder
519
+ * they may write in file tree order — and someone who may write nowhere is
520
+ * not shown the step at all.
521
+ */
522
+ describe('GetStartedColumn: where New page writes', () => {
523
+ const SALES = `${KB}/KnowledgeBase/Sales`;
524
+ const SUPPORT = `${KB}/KnowledgeBase/Support`;
525
+ const PRODUCT = `${KB}/KnowledgeBase/Product`;
526
+ const FOLDERS_TREE = [
527
+ ...STARTER_TREE,
528
+ `${PRODUCT}/.gitkeep`,
529
+ `${SALES}/.gitkeep`,
530
+ `${SALES}/Team/.gitkeep`,
531
+ `${SUPPORT}/.gitkeep`,
532
+ ];
533
+ const STEP = 'Write your first page';
534
+ const newPage = () => within(row(STEP)!).getByRole('button', { name: 'New page' });
535
+
536
+ it('leaves the step out for someone who may write no Knowledge folder, and counts without it', async () => {
537
+ access.writable = new Set();
538
+ await mount({ files: FOLDERS_TREE });
539
+ expect(row(STEP)).toBeNull();
540
+ // Workspace, agent, guide, command menu: one fewer than with the step.
541
+ expect(screen.getByText('1 of 4')).toBeInTheDocument();
542
+ expect(row('Connect your agent')).not.toBeNull();
543
+ });
544
+
545
+ it('completes the list without the step', async () => {
546
+ access.writable = new Set();
547
+ window.localStorage.setItem('bevel.onboarding.commandMenuOpened.juan@bevel.software', '1');
548
+ await mount({ onboardingDone: true, openFilePath: GUIDE });
549
+ expect(await screen.findByRole('heading', { name: 'You’re set up' })).toBeInTheDocument();
550
+ });
551
+
552
+ it('shows nothing until it knows, so the step never appears and then vanishes', async () => {
553
+ let answer!: (a: { results: Record<string, boolean> }) => void;
554
+ access.batch.mockImplementation(() => new Promise((resolve) => (answer = resolve)));
555
+ const seen: boolean[] = [];
556
+ const observer = new MutationObserver(() => seen.push(screen.queryByText(STEP) !== null));
557
+ observer.observe(document.body, { childList: true, subtree: true });
558
+ await mount({ files: FOLDERS_TREE });
559
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
560
+ await act(async () => answer({ results: {} }));
561
+ await settle();
562
+ observer.disconnect();
563
+ expect(screen.getByRole('complementary', { name: 'Get set up' })).toBeInTheDocument();
564
+ expect(row(STEP)).toBeNull();
565
+ expect(seen).not.toContain(true);
566
+ });
567
+
568
+ it('hides the step while the check fails, for an admin too', async () => {
569
+ access.batch.mockRejectedValue(new Error('HTTP 500'));
570
+ await mount({ admin: true });
571
+ await screen.findByRole('complementary', { name: 'Get set up' });
572
+ expect(row(STEP)).toBeNull();
573
+ });
574
+
575
+ it('creates the page at the top of Knowledge for an admin, even with a page open in another folder they may write', async () => {
576
+ access.writable = new Set(['KnowledgeBase', 'KnowledgeBase/Support']);
577
+ const createFile = vi.fn(async () => {});
578
+ await mount({ admin: true, createFile, files: FOLDERS_TREE, openFilePath: `${SUPPORT}/FAQ.md` });
579
+ await userEvent.click(newPage());
580
+ expect(createFile).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
581
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled.md`, { edit: true });
582
+ });
583
+
584
+ it('otherwise uses the first folder they may write, in file tree order', async () => {
585
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
586
+ const createFile = vi.fn(async () => {});
587
+ await mount({ createFile, files: FOLDERS_TREE });
588
+ // The step reads as today, wording and all.
589
+ expect(within(row(STEP)!).getByText('Start one here, or drop files into the file tree.')).toBeInTheDocument();
590
+ expect(within(row(STEP)!).getByText('Connect your agent and it can write pages for you.')).toBeInTheDocument();
591
+ await userEvent.click(newPage());
592
+ expect(createFile).toHaveBeenCalledWith(`${SALES}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
593
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${SALES}/Untitled.md`, { edit: true });
594
+ // One question for the lot: the top, then every folder in tree order.
595
+ expect(access.batch.mock.calls[0]![1]).toEqual([
596
+ 'KnowledgeBase',
597
+ 'KnowledgeBase/Product',
598
+ 'KnowledgeBase/Sales',
599
+ 'KnowledgeBase/Sales/Team',
600
+ 'KnowledgeBase/Support',
601
+ ]);
602
+ });
603
+
604
+ it('prefers the folder of the page on screen when they may write it', async () => {
605
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
606
+ const createFile = vi.fn(async () => {});
607
+ await mount({ createFile, files: FOLDERS_TREE, openFilePath: `${SUPPORT}/FAQ.md` });
608
+ await userEvent.click(newPage());
609
+ expect(createFile).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
610
+ });
611
+
612
+ it('passes over the folder on screen when they may not write it', async () => {
613
+ access.writable = new Set(['KnowledgeBase/Support']);
614
+ const createFile = vi.fn(async () => {});
615
+ await mount({ createFile, files: FOLDERS_TREE, openFilePath: `${PRODUCT}/Roadmap.md` });
616
+ await userEvent.click(newPage());
617
+ expect(createFile).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
618
+ });
619
+
620
+ it('finds a folder nested inside one they may only read', async () => {
621
+ access.writable = new Set(['KnowledgeBase/Sales/Team']);
622
+ const createFile = vi.fn(async () => {});
623
+ await mount({ createFile, files: FOLDERS_TREE });
624
+ await userEvent.click(newPage());
625
+ expect(createFile).toHaveBeenCalledWith(`${SALES}/Team/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
626
+ });
627
+
628
+ it('brings the step once a folder shared later shows in the tree, without a remount', async () => {
629
+ access.writable = new Set();
630
+ const { rerender } = await mount();
631
+ expect(row(STEP)).toBeNull();
632
+ // An admin shares Sales: the tree now shows it, and it may be written.
633
+ access.writable = new Set(['KnowledgeBase/Sales']);
634
+ rerender(columnUi({ files: [...STARTER_TREE, `${SALES}/.gitkeep`] }));
635
+ await settleRecheck();
636
+ expect(row(STEP)).not.toBeNull();
637
+ expect(screen.getByText('1 of 5')).toBeInTheDocument();
638
+ });
639
+
640
+ it('shows the step with the list for someone who may write only a folder below, asking once the tree is in', async () => {
641
+ access.writable = new Set(['KnowledgeBase/Sales/Team']);
642
+ const { rerender } = await mount({ files: null });
643
+ expect(access.batch).not.toHaveBeenCalled();
644
+ rerender(columnUi({ files: FOLDERS_TREE }));
645
+ // No debounce to wait out: the first answer for this workspace is asked at once.
646
+ await settle();
647
+ expect(row(STEP)).not.toBeNull();
648
+ expect(access.batch).toHaveBeenCalledTimes(1);
649
+ expect(access.batch.mock.calls[0]![1]).toContain('KnowledgeBase/Sales/Team');
650
+ });
651
+
652
+ it('asks again before writing when the page on screen changed since the last answer', async () => {
653
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
654
+ const createFile = vi.fn(async () => {});
655
+ const { rerender } = await mount({ createFile, files: FOLDERS_TREE, openFilePath: `${SALES}/Leads.md` });
656
+ // Straight to Support and New page, inside the debounce: the answer on hand is Sales's.
657
+ rerender(columnUi({ createFile, files: FOLDERS_TREE, openFilePath: `${SUPPORT}/FAQ.md` }));
658
+ await userEvent.click(newPage());
659
+ await waitFor(() => expect(createFile).toHaveBeenCalled());
660
+ expect(createFile).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
661
+ expect(createFile).toHaveBeenCalledTimes(1);
662
+ });
663
+
664
+ it('asks again before writing after a switch of branch, not writing where the last branch allowed', async () => {
665
+ access.writable = new Set(['KnowledgeBase/Sales']);
666
+ const createFile = vi.fn(async () => {});
667
+ const { rerender } = await mount({ createFile, files: FOLDERS_TREE });
668
+ access.writable = new Set(['KnowledgeBase/Support']);
669
+ // Every answer for the new branch — the switch's own check and the one
670
+ // New page asks before writing — is held until the test lets it through.
671
+ let release!: () => void;
672
+ const gate = new Promise<void>((resolve) => (release = resolve));
673
+ const real = access.batch.getMockImplementation()!;
674
+ access.batch.mockImplementation(async (ws, paths, verb) => {
675
+ await gate;
676
+ return real(ws, paths, verb);
677
+ });
678
+ // The other protected branch: a draft asks about reading instead.
679
+ rerender(columnUi({ createFile, files: FOLDERS_TREE, workspaceBranch: 'current-company-state' }));
680
+ await userEvent.click(newPage());
681
+ await settle();
682
+ // The answer on hand still says Sales, but it was for the other branch: nothing is written yet.
683
+ expect(createFile).not.toHaveBeenCalled();
684
+ await act(async () => release());
685
+ await waitFor(() => expect(createFile).toHaveBeenCalled());
686
+ expect(createFile).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
687
+ expect(createFile).toHaveBeenCalledTimes(1);
688
+ });
689
+
690
+ it('on a draft branch writes at the top of Knowledge for anyone who can read it, asking no write check', async () => {
691
+ // Writes nothing on the protected branches — but a draft takes any
692
+ // reader's write, as the server's read-before-write gate does.
693
+ access.writable = new Set();
694
+ const createFile = vi.fn(async () => {});
695
+ await mount({ createFile, files: FOLDERS_TREE, workspaceBranch: 'alice/draft' });
696
+ await userEvent.click(newPage());
697
+ expect(createFile).toHaveBeenCalledWith(`${KB}/KnowledgeBase/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
698
+ expect(access.batch.mock.calls[0]![1]).toContain('KnowledgeBase');
699
+ expect(accessVerbsAsked()).toEqual(new Set(['read']));
700
+ });
701
+
702
+ // Local Testing at db782b2f: the tree shows Knowledge because Product is
703
+ // shared with John, yet the top itself is not readable, and the server
704
+ // refused KnowledgeBase/Untitled.md ("You don't have read access").
705
+ it('on a draft branch passes over a top of Knowledge shown only for a folder inside it', async () => {
706
+ access.writable = new Set();
707
+ access.readable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
708
+ const createFile = vi.fn(async () => {});
709
+ await mount({ createFile, files: FOLDERS_TREE, workspaceBranch: 'alice/draft' });
710
+ await userEvent.click(newPage());
711
+ expect(createFile).toHaveBeenCalledWith(`${SALES}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
712
+ expect(createFile).toHaveBeenCalledTimes(1);
713
+ expect(accessVerbsAsked()).toEqual(new Set(['read']));
714
+ });
715
+
716
+ it('on a draft branch prefers the folder of the page on screen when they may read it', async () => {
717
+ access.readable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
718
+ const createFile = vi.fn(async () => {});
719
+ await mount({ createFile, files: FOLDERS_TREE, workspaceBranch: 'alice/draft', openFilePath: `${SUPPORT}/FAQ.md` });
720
+ await userEvent.click(newPage());
721
+ expect(createFile).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true });
722
+ });
723
+
724
+ // Mia at db782b2f: shown the step on a draft where she reads nothing in
725
+ // Knowledge; a click was refused and the step vanished.
726
+ it('on a draft branch leaves the step out for someone who may read no Knowledge folder', async () => {
727
+ access.readable = new Set();
728
+ await mount({ files: FOLDERS_TREE, workspaceBranch: 'alice/draft' });
729
+ await screen.findByRole('complementary', { name: 'Get set up' });
730
+ expect(row(STEP)).toBeNull();
731
+ expect(screen.getByText('1 of 4')).toBeInTheDocument();
732
+ });
733
+
734
+ it('on a draft branch offers nothing when the tree shows no Knowledge folder, asking nothing', async () => {
735
+ await mount({ files: [`${KB}/Skills/.gitkeep`], workspaceBranch: 'alice/draft' });
736
+ await screen.findByRole('complementary', { name: 'Get set up' });
737
+ expect(row(STEP)).toBeNull();
738
+ expect(access.batch).not.toHaveBeenCalled();
739
+ });
740
+
741
+ it('a refusal whose recheck answers after a switch of branch withdraws nothing there or back', async () => {
742
+ access.writable = new Set(['KnowledgeBase/Sales']);
743
+ let release!: () => void;
744
+ let held = false;
745
+ const gate = new Promise<void>((resolve) => (release = resolve));
746
+ const real = access.batch.getMockImplementation()!;
747
+ access.batch.mockImplementation(async (ws, paths, verb) => {
748
+ if (held) await gate;
749
+ return real(ws, paths, verb);
750
+ });
751
+ const createFile = vi.fn(async (path: string) => {
752
+ // Refused although the check keeps saying Sales may be written; the
753
+ // check that would withdraw New page is held past a switch.
754
+ held = true;
755
+ throw new WorkspaceApiError(403, `You don't have permission to write to "${path}". Eligible: Admin.`);
756
+ });
757
+ const { rerender } = await mount({ createFile, files: FOLDERS_TREE });
758
+ await userEvent.click(newPage());
759
+ await settle();
760
+ rerender(columnUi({ createFile, files: FOLDERS_TREE, workspaceBranch: 'current-company-state' }));
761
+ await act(async () => release());
762
+ await settle();
763
+ // The withdrawal was for the branch left behind: the one on screen keeps New page…
764
+ expect(row(STEP)).not.toBeNull();
765
+ // …and so does the branch it was for, once the person comes back.
766
+ rerender(columnUi({ createFile, files: FOLDERS_TREE }));
767
+ await settle();
768
+ expect(row(STEP)).not.toBeNull();
769
+ expect(screen.queryByText(/Eligible|permission/)).not.toBeInTheDocument();
770
+ });
771
+
772
+ it('a refused write asks again and moves to the next folder they may write, with no permission text', async () => {
773
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
774
+ const createFile = vi.fn(async (path: string) => {
775
+ if (path.startsWith(`${SALES}/`)) {
776
+ // Sales was taken away since the check.
777
+ access.writable = new Set(['KnowledgeBase/Support']);
778
+ throw new WorkspaceApiError(
779
+ 403,
780
+ 'You don\'t have permission to write to "KnowledgeBase/Sales/Untitled.md". Eligible: Admin.',
781
+ );
782
+ }
783
+ });
784
+ await mount({ createFile, files: FOLDERS_TREE });
785
+ await userEvent.click(newPage());
786
+ await waitFor(() =>
787
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, { edit: true }),
788
+ );
789
+ expect(createFile.mock.calls.map((c) => c[0])).toEqual([`${SALES}/Untitled.md`, `${SUPPORT}/Untitled.md`]);
790
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
791
+ expect(screen.queryByText(/Eligible|permission/)).not.toBeInTheDocument();
792
+ });
793
+
794
+ it('a refused write with nowhere left removes the step, with no permission text', async () => {
795
+ access.writable = new Set(['KnowledgeBase/Sales']);
796
+ const createFile = vi.fn(async () => {
797
+ access.writable = new Set();
798
+ throw new WorkspaceApiError(
799
+ 403,
800
+ 'You don\'t have permission to write to "KnowledgeBase/Sales/Untitled.md". Eligible: Admin.',
801
+ );
802
+ });
803
+ await mount({ createFile, files: FOLDERS_TREE });
804
+ await userEvent.click(newPage());
805
+ await waitFor(() => expect(row(STEP)).toBeNull());
806
+ expect(createFile).toHaveBeenCalledTimes(1);
807
+ expect(openWorkspacePathMock).not.toHaveBeenCalled();
808
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
809
+ expect(screen.queryByText(/Eligible|permission/)).not.toBeInTheDocument();
810
+ });
811
+
812
+ it('a fallback write refused too asks again once more and moves on, with no permission text', async () => {
813
+ access.writable = new Set(['KnowledgeBase/Product', 'KnowledgeBase/Sales', 'KnowledgeBase/Support']);
814
+ const refuse = (path: string) =>
815
+ new WorkspaceApiError(403, `You don't have permission to write to "${path}". Eligible: Admin.`);
816
+ const createFile = vi.fn(async (path: string) => {
817
+ // Product, then Sales, are taken away between the check and the write.
818
+ if (path.startsWith(`${PRODUCT}/`)) {
819
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
820
+ throw refuse(path);
821
+ }
822
+ if (path.startsWith(`${SALES}/`)) {
823
+ access.writable = new Set(['KnowledgeBase/Support']);
824
+ throw refuse(path);
825
+ }
826
+ });
827
+ await mount({ createFile, files: FOLDERS_TREE });
828
+ await userEvent.click(newPage());
829
+ await waitFor(() =>
830
+ expect(openWorkspacePathMock).toHaveBeenCalledWith(`${SUPPORT}/Untitled.md`, { edit: true }),
831
+ );
832
+ expect(createFile.mock.calls.map((c) => c[0])).toEqual([
833
+ `${PRODUCT}/Untitled.md`,
834
+ `${SALES}/Untitled.md`,
835
+ `${SUPPORT}/Untitled.md`,
836
+ ]);
837
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
838
+ expect(screen.queryByText(/Eligible|permission/)).not.toBeInTheDocument();
839
+ });
840
+
841
+ it('a fallback write refused where the check still allows it removes the step, with no permission text', async () => {
842
+ access.writable = new Set(['KnowledgeBase/Sales', 'KnowledgeBase/Support']);
843
+ const createFile = vi.fn(async (path: string) => {
844
+ if (path.startsWith(`${SALES}/`)) access.writable = new Set(['KnowledgeBase/Support']);
845
+ // Support is refused although the check keeps saying it may be written.
846
+ throw new WorkspaceApiError(403, `You don't have permission to write to "${path}". Eligible: Admin.`);
847
+ });
848
+ await mount({ createFile, files: FOLDERS_TREE });
849
+ await userEvent.click(newPage());
850
+ await waitFor(() => expect(row(STEP)).toBeNull());
851
+ expect(createFile.mock.calls.map((c) => c[0])).toEqual([`${SALES}/Untitled.md`, `${SUPPORT}/Untitled.md`]);
852
+ expect(openWorkspacePathMock).not.toHaveBeenCalled();
853
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
854
+ expect(screen.queryByText(/Eligible|permission/)).not.toBeInTheDocument();
855
+ });
856
+
857
+ it('names the folder in the agent’s request when the page goes below the top of Knowledge', async () => {
858
+ access.writable = new Set(['KnowledgeBase/Sales']);
859
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
860
+ await mount({ files: FOLDERS_TREE });
861
+ const ask = await within(row(STEP)!).findByRole('link', { name: 'Ask Claude to write it' });
862
+ const inSales = FIRST_PAGE_PROMPT.replace('write a page in Knowledge', 'write a page in Knowledge/Sales');
863
+ expect(inSales).toContain('write a page in Knowledge/Sales about our company');
864
+ expect(ask).toHaveAttribute('href', claudePromptUrl(inSales));
865
+ });
866
+
867
+ it('leaves an admin’s request as it was', async () => {
868
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
869
+ await mount({ admin: true, files: FOLDERS_TREE });
870
+ const ask = await within(row(STEP)!).findByRole('link', { name: 'Ask Claude to write it' });
871
+ expect(ask).toHaveAttribute('href', claudePromptUrl(FIRST_PAGE_PROMPT));
872
+ });
873
+
874
+ it('offers no New page in the command menu, and C does nothing, when there is nowhere to write', async () => {
875
+ access.writable = new Set();
876
+ const createFile = vi.fn(async () => {});
877
+ const user = userEvent.setup();
878
+ const { rerender } = await mount({ withPalette: true, createFile, files: STARTER_TREE });
879
+ await user.keyboard('c');
880
+ expect(createFile).not.toHaveBeenCalled();
881
+ await user.keyboard('{Control>}k{/Control}');
882
+ expect(screen.queryByRole('option', { name: /^New page/ })).not.toBeInTheDocument();
883
+ expect(screen.getByRole('option', { name: 'Connect your agent' })).toBeInTheDocument();
884
+ await user.keyboard('{Escape}');
885
+
886
+ // A folder shared later brings the command, and its key, too.
887
+ access.writable = new Set(['KnowledgeBase/Sales']);
888
+ rerender(columnUi({ withPalette: true, createFile, files: [...STARTER_TREE, `${SALES}/.gitkeep`] }));
889
+ await settleRecheck();
890
+ await user.keyboard('{Control>}k{/Control}');
891
+ expect(screen.getByRole('option', { name: /^New page/ })).toBeInTheDocument();
892
+ await user.keyboard('{Escape}');
893
+ await user.keyboard('c');
894
+ await waitFor(() =>
895
+ expect(createFile).toHaveBeenCalledWith(`${SALES}/Untitled.md`, '# Untitled\n\n', { ifAbsent: true }),
896
+ );
897
+ });
898
+ });
899
+
900
+ /**
901
+ * The agent-connection answer, asked once: it ticks "Connect your agent" for
902
+ * someone who connected without ever opening the welcome page (and concludes
903
+ * the onboarding for them), and it is what puts the one-click prompt on
904
+ * "Write your first page".
905
+ */
906
+ describe('GetStartedColumn: a connected agent', () => {
907
+ it('ticks "Connect your agent" from the endpoint, and concludes the onboarding once', async () => {
908
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
909
+ await mount();
910
+ await waitFor(() => expect(isDone('Connect your agent')).toBe(true));
911
+ expect(doneWrites()).toBe(1);
912
+ await act(async () => {});
913
+ expect(doneWrites()).toBe(1);
914
+ });
915
+
916
+ it('asks once, not on a timer', async () => {
917
+ vi.useFakeTimers();
918
+ try {
919
+ await mount();
920
+ await act(async () => {
921
+ await vi.advanceTimersByTimeAsync(30_000);
922
+ });
923
+ expect(fetchAgentConnectionMock).toHaveBeenCalledTimes(1);
924
+ expect(isDone('Connect your agent')).toBe(false);
925
+ expect(doneWrites()).toBe(0);
926
+ } finally {
927
+ vi.useRealTimers();
928
+ }
929
+ });
930
+
931
+ /**
932
+ * Connecting somewhere else — another window, the External agent access
933
+ * page — still ticks the list: it asks again when the person comes back to
934
+ * the tab, though not more than once in a while.
935
+ */
936
+ it('asks again when you come back to the tab, at most once in a while', async () => {
937
+ vi.useFakeTimers();
938
+ try {
939
+ await mount();
940
+ await act(async () => {
941
+ await vi.advanceTimersByTimeAsync(0);
942
+ });
943
+ expect(fetchAgentConnectionMock).toHaveBeenCalledTimes(1);
944
+ // Straight back: too soon to ask again.
945
+ act(() => {
946
+ window.dispatchEvent(new Event('focus'));
947
+ });
948
+ expect(fetchAgentConnectionMock).toHaveBeenCalledTimes(1);
949
+
950
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
951
+ await act(async () => {
952
+ await vi.advanceTimersByTimeAsync(AGENT_RECHECK_MS);
953
+ });
954
+ expect(fetchAgentConnectionMock).toHaveBeenCalledTimes(1);
955
+ await act(async () => {
956
+ document.dispatchEvent(new Event('visibilitychange'));
957
+ await vi.advanceTimersByTimeAsync(0);
958
+ });
959
+ expect(fetchAgentConnectionMock).toHaveBeenCalledTimes(2);
960
+ expect(isDone('Connect your agent')).toBe(true);
961
+ } finally {
962
+ vi.useRealTimers();
963
+ }
964
+ });
965
+
966
+ it('does not conclude again for an account the server already concluded', async () => {
967
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
968
+ await mount({ onboardingDone: true });
969
+ await waitFor(() => expect(row('Write your first page')).not.toBeNull());
970
+ await act(async () => {});
971
+ expect(doneWrites()).toBe(0);
972
+ });
973
+
974
+ it('asks nothing once the column was closed', async () => {
975
+ window.localStorage.setItem('bevel.onboarding.setupDismissed.juan@bevel.software', '1');
976
+ await mount();
977
+ await act(async () => {});
978
+ expect(fetchAgentConnectionMock).not.toHaveBeenCalled();
979
+ });
980
+
981
+ it('keeps the one-click prompt out of "Write your first page" until an agent is connected', async () => {
982
+ await mount();
983
+ await act(async () => {});
984
+ const page = row('Write your first page')!;
985
+ expect(within(page).queryByRole('link', { name: 'Ask Claude to write it' })).not.toBeInTheDocument();
986
+ expect(within(page).queryByRole('link', { name: 'Open in ChatGPT' })).not.toBeInTheDocument();
987
+ expect(within(page).queryByRole('button', { name: 'Copy prompt' })).not.toBeInTheDocument();
988
+ expect(within(page).getByRole('button', { name: 'New page' })).toBeInTheDocument();
989
+ expect(within(page).getByText('Connect your agent and it can write pages for you.')).toBeInTheDocument();
990
+ });
991
+
992
+ it('offers "Ask Claude to write it" first once connected, keeping New page beside it', async () => {
993
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
994
+ await mount();
995
+ const ask = await within(row('Write your first page')!).findByRole('link', { name: 'Ask Claude to write it' });
996
+ expect(ask).toHaveAttribute('href', claudePromptUrl(FIRST_PAGE_PROMPT));
997
+ expect(ask).toHaveAttribute('target', '_blank');
998
+ expect(ask).toHaveAttribute('rel', 'noopener noreferrer');
999
+
1000
+ const page = row('Write your first page')!;
1001
+ const chatGpt = within(page).getByRole('link', { name: 'Open in ChatGPT' });
1002
+ expect(chatGpt).toHaveAttribute('href', chatGptPromptUrl(FIRST_PAGE_PROMPT));
1003
+ expect(chatGpt).toHaveAttribute('target', '_blank');
1004
+ expect(chatGpt).toHaveAttribute('rel', 'noopener noreferrer');
1005
+ expect(within(page).getByRole('button', { name: 'New page' })).toBeInTheDocument();
1006
+ expect(within(page).queryByText('Connect your agent and it can write pages for you.')).not.toBeInTheDocument();
1007
+ });
1008
+
1009
+ /**
1010
+ * A team that chose a starter pack gets the pack's own request, and the
1011
+ * pack's pages — placeholders until someone fills one in — do not count as
1012
+ * the first page.
1013
+ */
1014
+ describe('after a starter pack', () => {
1015
+ const SALES_PAGES = [`${KB}/KnowledgeBase/Customers.md`, `${KB}/KnowledgeBase/Pricing.md`];
1016
+ const SALES_PROMPT = 'Using our Hexis knowledge base, fill in the Customers page.';
1017
+ const chosen = (starterPages: string[]): StarterPacksAnswer => ({
1018
+ offered: false,
1019
+ chosen: 'sales',
1020
+ packs: [],
1021
+ chosenPack: { id: 'sales', name: 'Sales', firstPagePrompt: `${SALES_PROMPT}\n`, starterPages },
1022
+ });
1023
+
1024
+ it("asks the agent with the pack's prompt", async () => {
1025
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1026
+ fetchStarterPacksMock.mockResolvedValue(chosen(SALES_PAGES));
1027
+ await mount({ files: [...STARTER_TREE, ...SALES_PAGES] });
1028
+ const page = row('Write your first page')!;
1029
+ await waitFor(() =>
1030
+ expect(within(page).getByRole('link', { name: 'Ask Claude to write it' })).toHaveAttribute(
1031
+ 'href',
1032
+ claudePromptUrl(SALES_PROMPT),
1033
+ ),
1034
+ );
1035
+ expect(within(page).getByRole('link', { name: 'Open in ChatGPT' })).toHaveAttribute(
1036
+ 'href',
1037
+ chatGptPromptUrl(SALES_PROMPT),
1038
+ );
1039
+ });
1040
+
1041
+ it("leaves the step open while the pack's pages are untouched, and ticks it once one is filled in", async () => {
1042
+ fetchStarterPacksMock.mockResolvedValue(chosen(SALES_PAGES));
1043
+ const files = [...STARTER_TREE, ...SALES_PAGES];
1044
+ const { rerender } = await mount({ files });
1045
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalledTimes(1));
1046
+ expect(isDone('Write your first page')).toBe(false);
1047
+
1048
+ // Somebody fills in Customers: the tree is fetched again, and the
1049
+ // server no longer lists the page as a placeholder.
1050
+ fetchStarterPacksMock.mockResolvedValue(chosen([SALES_PAGES[1]!]));
1051
+ rerender(columnUi({ files }));
1052
+ await waitFor(() => expect(isDone('Write your first page')).toBe(true));
1053
+ expect(fetchStarterPacksMock).toHaveBeenCalledTimes(2);
1054
+ });
1055
+
1056
+ it('keeps the generic prompt when the team skipped', async () => {
1057
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1058
+ fetchStarterPacksMock.mockResolvedValue({ offered: false, chosen: 'none', packs: [], chosenPack: null });
1059
+ await mount();
1060
+ const ask = await within(row('Write your first page')!).findByRole('link', { name: 'Ask Claude to write it' });
1061
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalled());
1062
+ expect(ask).toHaveAttribute('href', claudePromptUrl(FIRST_PAGE_PROMPT));
1063
+ });
1064
+
1065
+ it('does not tick the step before the answer is in: untouched pack pages are not a first page', async () => {
1066
+ let answer!: (a: StarterPacksAnswer) => void;
1067
+ fetchStarterPacksMock.mockImplementation(() => new Promise((resolve) => (answer = resolve)));
1068
+ await mount({ files: [...STARTER_TREE, ...SALES_PAGES] });
1069
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalled());
1070
+ expect(isDone('Write your first page')).toBe(false);
1071
+ answer(chosen(SALES_PAGES));
1072
+ // Still open: both pages are placeholders. Filling one in would tick it.
1073
+ await act(async () => {});
1074
+ expect(isDone('Write your first page')).toBe(false);
1075
+ });
1076
+
1077
+ it('reads the tree alone on a draft branch, where the default branch’s placeholders do not apply', async () => {
1078
+ fetchStarterPacksMock.mockResolvedValue(chosen(SALES_PAGES));
1079
+ await mount({ files: [...STARTER_TREE, ...SALES_PAGES], workspaceBranch: 'alice/draft' });
1080
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalled());
1081
+ await waitFor(() => expect(isDone('Write your first page')).toBe(true));
1082
+ });
1083
+
1084
+ it('asks again for a tree change that lands while the previous answer is still on its way', async () => {
1085
+ const resolvers: ((a: StarterPacksAnswer) => void)[] = [];
1086
+ fetchStarterPacksMock.mockImplementation(() => new Promise((resolve) => resolvers.push(resolve)));
1087
+ const files = [...STARTER_TREE, ...SALES_PAGES];
1088
+ const { rerender } = await mount({ files });
1089
+ await waitFor(() => expect(resolvers).toHaveLength(1));
1090
+ resolvers[0]!(chosen(SALES_PAGES));
1091
+ await waitFor(() => expect(isDone('Write your first page')).toBe(false));
1092
+
1093
+ // Two tree changes in a row: the first starts a request, the second
1094
+ // lands while it is out. One more request follows, and it is that one
1095
+ // which reports the page filled in.
1096
+ rerender(columnUi({ files: [...files] }));
1097
+ await waitFor(() => expect(resolvers).toHaveLength(2));
1098
+ rerender(columnUi({ files: [...files] }));
1099
+ resolvers[1]!(chosen(SALES_PAGES));
1100
+ await waitFor(() => expect(resolvers).toHaveLength(3));
1101
+ resolvers[2]!(chosen([SALES_PAGES[1]!]));
1102
+ await waitFor(() => expect(isDone('Write your first page')).toBe(true));
1103
+ });
1104
+ });
1105
+
1106
+ it('leads with "Ask ChatGPT to write it" for a ChatGPT connection, Claude quiet beside Copy prompt', async () => {
1107
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'ChatGPT', kind: 'agent' });
1108
+ await mount();
1109
+ const ask = await within(row('Write your first page')!).findByRole('link', { name: 'Ask ChatGPT to write it' });
1110
+ expect(ask).toHaveAttribute('href', chatGptPromptUrl(FIRST_PAGE_PROMPT));
1111
+ const page = row('Write your first page')!;
1112
+ expect(within(page).getByRole('link', { name: 'Open in Claude' })).toHaveAttribute(
1113
+ 'href',
1114
+ claudePromptUrl(FIRST_PAGE_PROMPT),
1115
+ );
1116
+ expect(within(page).getByRole('button', { name: 'Copy prompt' })).toBeInTheDocument();
1117
+ expect(within(page).queryByRole('link', { name: 'Ask Claude to write it' })).not.toBeInTheDocument();
1118
+ expect(within(page).queryByText(/Paste it into/)).not.toBeInTheDocument();
1119
+ });
1120
+
1121
+ it('leads with Copy prompt for an agent no link opens, and says where to paste it', async () => {
1122
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude Code · local server on LAPTOP-1', kind: 'agent' });
1123
+ const writeText = vi.fn().mockResolvedValue(undefined);
1124
+ const original = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
1125
+ Object.defineProperty(navigator, 'clipboard', { value: { writeText }, configurable: true });
1126
+ try {
1127
+ await mount();
1128
+ const copy = await within(row('Write your first page')!).findByRole('button', { name: 'Copy prompt' });
1129
+ const page = row('Write your first page')!;
1130
+ expect(within(page).getByText('Paste it into Claude Code.')).toBeInTheDocument();
1131
+ expect(within(page).getByRole('link', { name: 'Open in Claude' })).toBeInTheDocument();
1132
+ expect(within(page).getByRole('link', { name: 'Open in ChatGPT' })).toBeInTheDocument();
1133
+ expect(within(page).queryByRole('link', { name: /to write it/ })).not.toBeInTheDocument();
1134
+ expect(within(page).getByRole('button', { name: 'New page' })).toBeInTheDocument();
1135
+ await userEvent.click(copy);
1136
+ expect(writeText).toHaveBeenCalledWith(FIRST_PAGE_PROMPT);
1137
+ expect(within(row('Write your first page')!).getByRole('status')).toHaveTextContent('Prompt copied');
1138
+ } finally {
1139
+ if (original) Object.defineProperty(navigator, 'clipboard', original);
1140
+ else Reflect.deleteProperty(navigator, 'clipboard');
1141
+ }
1142
+ });
1143
+
1144
+ it('leads with Copy prompt for a connection key, whatever its label says', async () => {
1145
+ // A key's label is free text: "ChatGPT CLI" names the key, not an app
1146
+ // that a chatgpt.com link would reach.
1147
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'ChatGPT CLI', kind: 'key' });
1148
+ await mount();
1149
+ const page = await waitFor(() => {
1150
+ const r = row('Write your first page')!;
1151
+ within(r).getByRole('button', { name: 'Copy prompt' });
1152
+ return r;
1153
+ });
1154
+ expect(within(page).queryByRole('link', { name: /to write it/ })).not.toBeInTheDocument();
1155
+ expect(within(page).getByText('Paste it into your agent.')).toBeInTheDocument();
1156
+ });
1157
+
1158
+ it('says "your agent" when the connection has no name to offer', async () => {
1159
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Unnamed agent', kind: 'agent' });
1160
+ await mount();
1161
+ expect(await within(row('Write your first page')!).findByText('Paste it into your agent.')).toBeInTheDocument();
1162
+ });
1163
+
1164
+ it('copies the prompt and says so', async () => {
1165
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1166
+ const writeText = vi.fn().mockResolvedValue(undefined);
1167
+ const original = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
1168
+ Object.defineProperty(navigator, 'clipboard', { value: { writeText }, configurable: true });
1169
+ try {
1170
+ await mount();
1171
+ const copy = await within(row('Write your first page')!).findByRole('button', { name: 'Copy prompt' });
1172
+ await userEvent.click(copy);
1173
+ expect(writeText).toHaveBeenCalledWith(FIRST_PAGE_PROMPT);
1174
+ expect(within(row('Write your first page')!).getByRole('status')).toHaveTextContent('Prompt copied');
1175
+ } finally {
1176
+ if (original) Object.defineProperty(navigator, 'clipboard', original);
1177
+ else Reflect.deleteProperty(navigator, 'clipboard');
1178
+ }
1179
+ });
1180
+
1181
+ it('ticks the page step by itself when the agent’s page lands, whoever wrote it', async () => {
1182
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1183
+ await mount({ files: [...STARTER_TREE, `${KB}/KnowledgeBase/About us.md`] });
1184
+ await waitFor(() => expect(isDone('Connect your agent')).toBe(true));
1185
+ expect(isDone('Write your first page')).toBe(true);
1186
+ expect(screen.queryByRole('link', { name: 'Ask Claude to write it' })).not.toBeInTheDocument();
1187
+ });
1188
+ });
1189
+
1190
+ describe('GetStartedColumn: what an admin sees', () => {
1191
+ it('lists all eight steps, storage already done', async () => {
1192
+ await mount({ admin: true });
1193
+ await screen.findByRole('complementary', { name: 'Get set up' });
1194
+ expect(screen.getByText('2 of 8')).toBeInTheDocument();
1195
+ expect(isDone('Choose where your knowledge lives')).toBe(true);
1196
+ expect(isDone('Create a plugin for your team')).toBe(false);
1197
+ expect(isDone('Invite your team')).toBe(false);
1198
+ });
1199
+
1200
+ it('ticks the plugin step for a team plugin, not a personal shelf', async () => {
1201
+ listPluginsMock.mockResolvedValue([plugin('Plugins/personal-juan')]);
1202
+ const { unmount } = await mount({ admin: true });
1203
+ await screen.findByRole('complementary', { name: 'Get set up' });
1204
+ expect(isDone('Create a plugin for your team')).toBe(false);
1205
+ unmount();
1206
+
1207
+ listPluginsMock.mockResolvedValue([plugin('Plugins/GTM')]);
1208
+ await mount({ admin: true });
1209
+ await waitFor(() => expect(isDone('Create a plugin for your team')).toBe(true));
1210
+ });
1211
+
1212
+ it('ticks the invite step for a second person, never for a system account', async () => {
1213
+ listAccountsMock.mockResolvedValue([
1214
+ account('juan@bevel.software'),
1215
+ account('recovery-bot@bevel.local', { isSystem: true }),
1216
+ ]);
1217
+ const { unmount } = await mount({ admin: true });
1218
+ await screen.findByRole('complementary', { name: 'Get set up' });
1219
+ expect(isDone('Invite your team')).toBe(false);
1220
+ unmount();
1221
+
1222
+ listAccountsMock.mockResolvedValue([account('juan@bevel.software'), account('ana@bevel.software')]);
1223
+ await mount({ admin: true });
1224
+ await waitFor(() => expect(isDone('Invite your team')).toBe(true));
1225
+ });
1226
+
1227
+ it('does not count a switched-off account as a teammate', async () => {
1228
+ listAccountsMock.mockResolvedValue([
1229
+ account('juan@bevel.software'),
1230
+ account('ana@bevel.software', { deactivatedAt: '2026-09-01T00:00:00Z' }),
1231
+ ]);
1232
+ await mount({ admin: true });
1233
+ await screen.findByRole('complementary', { name: 'Get set up' });
1234
+ expect(isDone('Invite your team')).toBe(false);
1235
+ });
1236
+
1237
+ /**
1238
+ * The plugin question is asked on entering Skills & Tools and when this tab
1239
+ * creates a plugin — not on every move between Library pages.
1240
+ */
1241
+ it('asks for plugins again on entering Skills & Tools and on a plugin created, not on every Library page', async () => {
1242
+ await mount({ admin: true });
1243
+ await screen.findByRole('complementary', { name: 'Get set up' });
1244
+ expect(listPluginsMock).toHaveBeenCalledTimes(1);
1245
+
1246
+ await act(async () => navigateTo('/skills-and-tools'));
1247
+ await waitFor(() => expect(listPluginsMock).toHaveBeenCalledTimes(2));
1248
+ await act(async () => navigateTo('/skills-and-tools/owned'));
1249
+ await act(async () => navigateTo('/skills-and-tools/plugins/GTM'));
1250
+ expect(listPluginsMock).toHaveBeenCalledTimes(2);
1251
+
1252
+ listPluginsMock.mockResolvedValue([plugin('Plugins/GTM')]);
1253
+ act(() => notePluginCreated());
1254
+ await waitFor(() => expect(isDone('Create a plugin for your team')).toBe(true));
1255
+ expect(listPluginsMock).toHaveBeenCalledTimes(3);
1256
+
1257
+ // Found is final: leaving and coming back asks nothing more.
1258
+ await act(async () => navigateTo('/workspace'));
1259
+ await act(async () => navigateTo('/skills-and-tools'));
1260
+ expect(listPluginsMock).toHaveBeenCalledTimes(3);
1261
+ });
1262
+
1263
+ it('opens the invite dialog from the invite step', async () => {
1264
+ await mount({ admin: true });
1265
+ await screen.findByRole('complementary', { name: 'Get set up' });
1266
+ await userEvent.click(within(row('Invite your team')!).getByRole('button', { name: 'Invite people' }));
1267
+ expect(screen.getByRole('dialog', { name: 'Invite your team' })).toBeInTheDocument();
1268
+ });
1269
+
1270
+ });
1271
+
1272
+ /**
1273
+ * Finishing the list is a moment, not a disappearance: the column says
1274
+ * "You're set up" — when the last tick lands, or on arrival for a list that
1275
+ * was finished and never celebrated — and goes for good once that is closed.
1276
+ */
1277
+ describe('GetStartedColumn: all done', () => {
1278
+ const WITH_PAGE = [...STARTER_TREE, `${KB}/KnowledgeBase/Notes.md`];
1279
+ const complete = () => screen.queryByRole('heading', { name: 'You’re set up' });
1280
+
1281
+ // The command menu has been opened, by whatever route.
1282
+ beforeEach(() => {
1283
+ window.localStorage.setItem('bevel.onboarding.commandMenuOpened.juan@bevel.software', '1');
1284
+ });
1285
+
1286
+ it('says "You’re set up" when the last step ticks, in place of the list', async () => {
1287
+ listPluginsMock.mockResolvedValue([plugin('Plugins/GTM')]);
1288
+ listAccountsMock.mockResolvedValue([account('juan@bevel.software'), account('ana@bevel.software')]);
1289
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1290
+ const everythingBut = { admin: true, onboardingDone: true, openFilePath: GUIDE };
1291
+ // One step short, the settled column shows the seven it has...
1292
+ const { rerender } = await mount(everythingBut);
1293
+ expect(await screen.findByText('7 of 8')).toBeInTheDocument();
1294
+ expect(complete()).toBeNull();
1295
+ // ...and the page landing in the tree finishes it.
1296
+ rerender(columnUi({ ...everythingBut, files: WITH_PAGE }));
1297
+ expect(await screen.findByRole('heading', { name: 'You’re set up' })).toBeInTheDocument();
1298
+ const column = screen.getByRole('complementary', { name: 'Get set up' });
1299
+ expect(within(column).getByRole('status')).toHaveTextContent(
1300
+ 'Your agent can read and write your knowledge base, and your team can join you.',
1301
+ );
1302
+ expect(within(column).queryByRole('list')).not.toBeInTheDocument();
1303
+ expect(within(column).queryByRole('progressbar')).not.toBeInTheDocument();
1304
+ });
1305
+
1306
+ it('celebrates a list finished elsewhere on arrival, and does not mention a team to a member', async () => {
1307
+ fetchAgentConnectionMock.mockResolvedValue({ connected: true, client: 'Claude', kind: 'agent' });
1308
+ await mount({ onboardingDone: true, openFilePath: GUIDE, files: WITH_PAGE });
1309
+ expect(await screen.findByRole('heading', { name: 'You’re set up' })).toBeInTheDocument();
1310
+ expect(screen.getByText('Your agent can read and write your knowledge base.')).toBeInTheDocument();
1311
+ expect(screen.queryByText(/your team/)).not.toBeInTheDocument();
1312
+ });
1313
+
1314
+ /**
1315
+ * "Connect your agent" also ticks when the onboarding was concluded with no
1316
+ * agent ever calling in (the pill's ×), so the line does not claim one.
1317
+ */
1318
+ it('claims no agent when none has connected', async () => {
1319
+ await mount({ onboardingDone: true, openFilePath: GUIDE, files: WITH_PAGE });
1320
+ expect(await screen.findByRole('heading', { name: 'You’re set up' })).toBeInTheDocument();
1321
+ expect(screen.getByText('Your knowledge base is ready.')).toBeInTheDocument();
1322
+ expect(screen.queryByText(/Your agent can/)).not.toBeInTheDocument();
1323
+ });
1324
+
1325
+ it('Close retires the column for good, and remembers it per account', async () => {
1326
+ const { unmount } = await mount({ onboardingDone: true, openFilePath: GUIDE, files: WITH_PAGE });
1327
+ await userEvent.click(await screen.findByRole('button', { name: 'Close' }));
1328
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1329
+ expect(window.localStorage.getItem('bevel.onboarding.setupCompleteClosed.juan@bevel.software')).toBe('1');
1330
+ unmount();
1331
+ // Not shown again — not even if a step comes undone later.
1332
+ fetchAgentConnectionMock.mockClear();
1333
+ await mount({ onboardingDone: true, openFilePath: GUIDE });
1334
+ await act(async () => {});
1335
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1336
+ expect(fetchAgentConnectionMock).not.toHaveBeenCalled();
1337
+ });
1338
+ });
1339
+
1340
+ /**
1341
+ * The command menu is taught by being opened: "Try it" opens it, and the
1342
+ * step ticks once it has been opened by any route — and stays ticked.
1343
+ */
1344
+ describe('GetStartedColumn: the command menu', () => {
1345
+ const STEP = `Find or do anything with ${COMMAND_MENU_SHORTCUT_LABEL}`;
1346
+
1347
+ it('is a step for everyone, named with this platform’s keys', async () => {
1348
+ await mount();
1349
+ expect(row(STEP)).not.toBeNull();
1350
+ expect(isDone(STEP)).toBe(false);
1351
+ expect(
1352
+ within(row(STEP)!).getByText('Type what you want: a page, a skill, or an action like Invite people.'),
1353
+ ).toBeInTheDocument();
1354
+ });
1355
+
1356
+ it('"Try it" opens the command menu, and that ticks the step', async () => {
1357
+ const user = userEvent.setup();
1358
+ await mount({ withPalette: true });
1359
+ await user.click(within(row(STEP)!).getByRole('button', { name: 'Try it' }));
1360
+ expect(screen.getByRole('combobox', { name: 'Search or run a command' })).toHaveFocus();
1361
+ await user.keyboard('{Escape}');
1362
+ expect(isDone(STEP)).toBe(true);
1363
+ });
1364
+
1365
+ it('ticks when the menu is opened any other way, and remembers it per account', async () => {
1366
+ const user = userEvent.setup();
1367
+ const { unmount } = await mount({ withPalette: true });
1368
+ await user.keyboard('{Control>}k{/Control}');
1369
+ expect(screen.getByRole('combobox', { name: 'Search or run a command' })).toBeInTheDocument();
1370
+ expect(isDone(STEP)).toBe(true);
1371
+ expect(window.localStorage.getItem('bevel.onboarding.commandMenuOpened.juan@bevel.software')).toBe('1');
1372
+ unmount();
1373
+ await mount();
1374
+ expect(isDone(STEP)).toBe(true);
1375
+ });
1376
+ });
1377
+
1378
+ /**
1379
+ * The first-page step reads the file tree. Until the tree is in, the guide
1380
+ * looks absent and the first page unwritten, so the list waits for it rather
1381
+ * than showing a shorter, falsely open one.
1382
+ */
1383
+ describe('GetStartedColumn: the file tree', () => {
1384
+ it('stays hidden until the tree has loaded', async () => {
1385
+ const { rerender } = await mount({ files: null });
1386
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1387
+ // Nothing is asked about where a page may go before the tree says what is there.
1388
+ expect(access.batch).not.toHaveBeenCalled();
1389
+ rerender(columnUi({}));
1390
+ await settle();
1391
+ expect(screen.getByRole('complementary', { name: 'Get set up' })).toBeInTheDocument();
1392
+ expect(row('Read “How to get started”')).not.toBeNull();
1393
+ });
1394
+
1395
+ it('skips exactly `access.md`, the name the platform reserves — not another spelling', async () => {
1396
+ const { unmount } = await mount({ files: [...STARTER_TREE, `${KB}/KnowledgeBase/Sales/access.md`] });
1397
+ await waitFor(() => expect(fetchStarterPacksMock).toHaveBeenCalled());
1398
+ expect(isDone('Write your first page')).toBe(false);
1399
+ unmount();
1400
+ await mount({ files: [...STARTER_TREE, `${KB}/KnowledgeBase/Sales/Access.md`] });
1401
+ await waitFor(() => expect(isDone('Write your first page')).toBe(true));
1402
+ });
1403
+ });
1404
+
1405
+ describe('GetStartedColumn: getting out of the way', () => {
1406
+ it('stays dismissed once closed, across remounts', async () => {
1407
+ const { unmount } = await mount();
1408
+ await userEvent.click(screen.getByRole('button', { name: 'Dismiss Get set up' }));
1409
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1410
+ expect(window.localStorage.getItem('bevel.onboarding.setupDismissed.juan@bevel.software')).toBe('1');
1411
+ unmount();
1412
+ await mount();
1413
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1414
+ });
1415
+
1416
+ /**
1417
+ * The notes are per browser, so a tab already open hears another tab's
1418
+ * close through `storage` — not at its next reload.
1419
+ */
1420
+ it('goes when another tab closes it', async () => {
1421
+ await mount();
1422
+ expect(screen.getByRole('complementary', { name: 'Get set up' })).toBeInTheDocument();
1423
+ const key = 'bevel.onboarding.setupDismissed.juan@bevel.software';
1424
+ window.localStorage.setItem(key, '1');
1425
+ act(() => {
1426
+ window.dispatchEvent(new StorageEvent('storage', { key, newValue: '1' }));
1427
+ });
1428
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1429
+ });
1430
+
1431
+ it('ticks the guide when another tab opened it', async () => {
1432
+ await mount();
1433
+ expect(isDone('Read “How to get started”')).toBe(false);
1434
+ const key = 'bevel.onboarding.readGuide.juan@bevel.software';
1435
+ window.localStorage.setItem(key, '1');
1436
+ act(() => {
1437
+ window.dispatchEvent(new StorageEvent('storage', { key, newValue: '1' }));
1438
+ });
1439
+ expect(isDone('Read “How to get started”')).toBe(true);
1440
+ });
1441
+
1442
+ it('is not shown on the welcome page', async () => {
1443
+ await mount({ route: WELCOME_PATH });
1444
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1445
+ });
1446
+
1447
+ it('is shown in an ordinary laptop window', async () => {
1448
+ setViewportWidth(1000);
1449
+ await mount();
1450
+ expect(screen.getByRole('complementary', { name: 'Get set up' })).toBeInTheDocument();
1451
+ });
1452
+
1453
+ it('is not shown at or below 900px, where the sidebar turns into a drawer', async () => {
1454
+ setViewportWidth(900);
1455
+ await mount();
1456
+ expect(screen.queryByRole('complementary', { name: 'Get set up' })).not.toBeInTheDocument();
1457
+ });
1458
+ });