@bevel-software/platform-core-frontend 0.14.0 → 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.
Files changed (360) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +34 -26
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/bootstrap.test.ts +33 -1
  6. package/src/core/__tests__/events.test.ts +43 -0
  7. package/src/core/bootstrap.ts +38 -1
  8. package/src/core/events.ts +85 -3
  9. package/src/core/registry.ts +1 -1
  10. package/src/lib/__tests__/api.test.ts +38 -0
  11. package/src/lib/__tests__/email.test.ts +44 -0
  12. package/src/lib/api.ts +19 -2
  13. package/src/lib/email.ts +37 -1
  14. package/src/lib/utils.ts +2 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  16. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  20. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  21. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  22. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  23. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  24. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +781 -76
  25. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  26. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  27. package/src/modules/access/__tests__/plugin-token.test.ts +21 -0
  28. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  29. package/src/modules/access/api.ts +192 -10
  30. package/src/modules/access/components/ManageAccessDialog.tsx +1337 -570
  31. package/src/modules/access/manage-access-affordance.ts +17 -0
  32. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  33. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  34. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  35. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  36. package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
  37. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  38. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  39. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  40. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  41. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  42. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  43. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  44. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  45. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  46. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  47. package/src/modules/admin/components/group-members-path.ts +32 -0
  48. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  49. package/src/modules/admin/services/roles.api.ts +12 -1
  50. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  51. package/src/modules/auth/components/AccountPage.tsx +73 -54
  52. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  53. package/src/modules/auth/services/account.api.ts +78 -4
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  58. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  59. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  60. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  61. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  62. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  63. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  64. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  65. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  66. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  67. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  68. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  69. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  70. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  71. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  72. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  73. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  74. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  75. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  76. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  77. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  78. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  79. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  80. package/src/modules/change-requests/services/propose.api.ts +97 -8
  81. package/src/modules/change-requests/utils/approval.ts +15 -0
  82. package/src/modules/change-requests/utils/author.ts +32 -0
  83. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  84. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  85. package/src/modules/git/__tests__/GitSyncFailedBanner.test.tsx +65 -1
  86. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  87. package/src/modules/git/components/GitSyncFailedBanner.tsx +68 -5
  88. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  89. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  90. package/src/modules/git/services/error-messages.ts +12 -0
  91. package/src/modules/git/services/pr-prompts.ts +5 -5
  92. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  93. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  94. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  95. package/src/modules/layout/components/AppLayout.tsx +2 -0
  96. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  97. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  98. package/src/modules/layout/components/SidebarFrame.tsx +109 -4
  99. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  100. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  101. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  102. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  103. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  104. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +104 -99
  105. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +136 -0
  106. package/src/modules/library/__tests__/LockedPluginView.test.tsx +103 -7
  107. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +18 -8
  108. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  109. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  110. package/src/modules/library/__tests__/PluginExtras.test.tsx +115 -9
  111. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  112. package/src/modules/library/__tests__/PluginPage.test.tsx +453 -7
  113. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +17 -57
  114. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +161 -97
  115. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  116. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  117. package/src/modules/library/__tests__/SkillPage.test.tsx +391 -78
  118. package/src/modules/library/__tests__/SkillsTree.test.tsx +461 -0
  119. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  120. package/src/modules/library/__tests__/ToolPage.test.tsx +94 -4
  121. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +279 -21
  122. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  123. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  124. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  125. package/src/modules/library/__tests__/library-data.stale.test.tsx +183 -0
  126. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  127. package/src/modules/library/__tests__/library-paths.test.ts +75 -0
  128. package/src/modules/library/__tests__/link-membership.test.ts +129 -0
  129. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  130. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  131. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  132. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  133. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  134. package/src/modules/library/__tests__/plugin-summary.test.ts +67 -0
  135. package/src/modules/library/__tests__/status.test.ts +82 -2
  136. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  137. package/src/modules/library/__tests__/useJoinRequests.test.tsx +46 -0
  138. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  139. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  140. package/src/modules/library/components/AddToPluginDialog.tsx +107 -18
  141. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  142. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  143. package/src/modules/library/components/LibraryCard.tsx +149 -34
  144. package/src/modules/library/components/LibraryLayout.tsx +120 -247
  145. package/src/modules/library/components/LibraryPage.tsx +172 -39
  146. package/src/modules/library/components/LinkSkillPanel.tsx +169 -0
  147. package/src/modules/library/components/LockedPluginView.tsx +63 -35
  148. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  149. package/src/modules/library/components/NewPluginDialog.tsx +19 -5
  150. package/src/modules/library/components/PageActions.tsx +31 -9
  151. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  152. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  153. package/src/modules/library/components/PersonalPluginPage.tsx +123 -23
  154. package/src/modules/library/components/PluginExtras.tsx +143 -18
  155. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  156. package/src/modules/library/components/PluginPage.tsx +234 -38
  157. package/src/modules/library/components/PluginRows.tsx +286 -0
  158. package/src/modules/library/components/PluginsSidebar.tsx +271 -238
  159. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  160. package/src/modules/library/components/RenamePluginDialog.tsx +136 -0
  161. package/src/modules/library/components/ShareButton.tsx +17 -0
  162. package/src/modules/library/components/SkillsTree.tsx +204 -0
  163. package/src/modules/library/components/StatusDot.tsx +1 -0
  164. package/src/modules/library/components/TeamRoute.tsx +15 -0
  165. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  166. package/src/modules/library/components/plugin-page-parts.tsx +132 -23
  167. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +212 -0
  168. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  169. package/src/modules/library/components/skill-page/SkillPage.tsx +337 -121
  170. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  171. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  172. package/src/modules/library/components/tool-page/ToolPage.tsx +116 -17
  173. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  174. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  175. package/src/modules/library/hooks/useJoinRequests.ts +48 -18
  176. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  177. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  178. package/src/modules/library/routes/WorkspaceItemRoute.tsx +229 -82
  179. package/src/modules/library/routes/library-paths.ts +46 -35
  180. package/src/modules/library/services/library.api.ts +89 -17
  181. package/src/modules/library/services/plugins.api.ts +161 -9
  182. package/src/modules/library/services/teams.api.ts +15 -0
  183. package/src/modules/library/services/tools.api.ts +78 -0
  184. package/src/modules/library/state/library-data.tsx +268 -37
  185. package/src/modules/library/utils/personal-plugin.ts +13 -15
  186. package/src/modules/library/utils/plugin-entries.ts +134 -0
  187. package/src/modules/library/utils/plugin-summary.ts +102 -0
  188. package/src/modules/library/utils/status.ts +204 -35
  189. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +11 -3
  190. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  191. package/src/modules/onboarding/agent-clients.ts +55 -23
  192. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  193. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  194. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  195. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  196. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  197. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  198. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  199. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  200. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  201. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  202. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  203. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  204. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  205. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  206. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  207. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  208. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  209. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  210. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  211. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  212. package/src/modules/settings/components/ClaudeConnectionCard.tsx +154 -0
  213. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  214. package/src/modules/settings/components/DeploymentPage.tsx +16 -22
  215. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  216. package/src/modules/settings/components/__tests__/ClaudeConnectionCard.test.tsx +63 -0
  217. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +74 -1
  218. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  219. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  220. package/src/modules/settings/services/github-facade.api.ts +66 -0
  221. package/src/modules/settings/settings-nav-items.tsx +10 -2
  222. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  223. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  224. package/src/modules/setup/__tests__/setup.test.tsx +615 -4
  225. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  226. package/src/modules/setup/components/SetupGate.tsx +16 -16
  227. package/src/modules/setup/components/SetupScreen.tsx +711 -40
  228. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  229. package/src/modules/setup/services/setup.api.ts +218 -3
  230. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  231. package/src/modules/setup/utils/root-folders.ts +46 -0
  232. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  233. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  234. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  235. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  236. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  237. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  238. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  239. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  240. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  241. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  242. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  243. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  244. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  245. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  246. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  247. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  248. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +395 -124
  249. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  250. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  251. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  252. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +659 -36
  253. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  254. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  255. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  256. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  257. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  258. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  259. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  260. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  261. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  262. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  263. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  264. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  265. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  266. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  267. package/src/modules/workspace/__tests__/testFixtures.ts +6 -3
  268. package/src/modules/workspace/components/FileExplorer.tsx +1527 -367
  269. package/src/modules/workspace/components/FileRoute.tsx +376 -22
  270. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  271. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  272. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  273. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  274. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  275. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +768 -16
  276. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +332 -12
  277. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  278. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  279. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  280. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  281. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  282. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  283. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  284. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  285. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  286. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  287. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  288. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  289. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  290. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  291. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  292. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  293. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  294. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  295. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  296. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  297. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  298. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  299. package/src/modules/workspace/components/renderers/index.ts +53 -2
  300. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  301. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  302. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  303. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  304. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  305. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  306. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  307. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +89 -0
  308. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  309. package/src/modules/workspace/hooks/useWorkspaceState.ts +438 -66
  310. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  311. package/src/modules/workspace/routing/kb-routes.ts +207 -30
  312. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  313. package/src/modules/workspace/services/workspace.api.ts +57 -4
  314. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  315. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  316. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  317. package/src/modules/workspace/state/workspace.context.ts +130 -16
  318. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  319. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +234 -5
  320. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  321. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  322. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  323. package/src/modules/workspace/utils/file-trace.ts +50 -0
  324. package/src/modules/workspace/utils/fileTree.ts +126 -52
  325. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  326. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  327. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  328. package/src/modules/workspace/utils/uploadError.ts +29 -0
  329. package/src/shared/__tests__/marketplace-url.test.ts +59 -0
  330. package/src/shared/components/Badge.tsx +3 -1
  331. package/src/shared/components/Banner.tsx +5 -1
  332. package/src/shared/components/Button.tsx +16 -2
  333. package/src/shared/components/Dialog.tsx +27 -11
  334. package/src/shared/components/Menu.tsx +13 -1
  335. package/src/shared/components/PageShell.tsx +13 -8
  336. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  337. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  338. package/src/shared/components/index.ts +2 -0
  339. package/src/shared/components/useDismissableMenu.ts +32 -10
  340. package/src/shared/components/useFocusHandoff.ts +51 -0
  341. package/src/shared/components/useLatestRef.ts +28 -0
  342. package/src/shared/markdown/Markdown.tsx +12 -3
  343. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  344. package/src/shared/markdown/hrefs.ts +50 -0
  345. package/src/shared/marketplace-url.ts +118 -0
  346. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  347. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  348. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  349. package/src/shared/mcp/connect-snippets.ts +14 -9
  350. package/src/shared/mcp/index.ts +1 -1
  351. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  352. package/src/shared/theme/header.ts +75 -0
  353. package/src/shared/theme/measure.ts +7 -4
  354. package/src/shared/theme/tokens.css +34 -0
  355. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  356. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  357. package/src/modules/library/components/PluginsIndexPage.tsx +0 -265
  358. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  359. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  360. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -0,0 +1,461 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { render, screen, fireEvent, within } from '@testing-library/react';
3
+ import { MemoryRouter, useLocation } from 'react-router-dom';
4
+ import { DEFAULT_BRANCH, type FileTreeEntry } from '@bevel-software/platform-shared';
5
+ import { WorkspaceContext, type WorkspaceContextValue } from '../../workspace/state/workspace.context';
6
+ import { makeWorkspaceFixture } from '../../workspace/__tests__/testFixtures';
7
+ import { PluginsTree, SkillsTree } from '../components/SkillsTree';
8
+
9
+ /**
10
+ * The Skills section of the Library nav: the shared root as Knowledge's tree
11
+ * rows, the root itself a collapsible folder row like Knowledge and Data in
12
+ * the explorer, with the two things that differ from Knowledge — where a
13
+ * click goes (the skill page, on the default branch) and which row is
14
+ * current (the file the URL names).
15
+ */
16
+
17
+ const KB = 'knowledge-base';
18
+
19
+ const file = (rel: string): FileTreeEntry => ({ name: rel.split('/').pop()!, relativePath: rel, type: 'file' });
20
+ const dir = (rel: string, children: FileTreeEntry[]): FileTreeEntry => ({
21
+ name: rel.split('/').pop()!,
22
+ relativePath: rel,
23
+ type: 'directory',
24
+ children,
25
+ });
26
+
27
+ const TREE: FileTreeEntry = dir('.', [
28
+ dir(KB, [
29
+ dir(`${KB}/KnowledgeBase`, [file(`${KB}/KnowledgeBase/Handbook.md`)]),
30
+ dir(`${KB}/Skills`, [
31
+ dir(`${KB}/Skills/Engineering`, [
32
+ dir(`${KB}/Skills/Engineering/deploy`, [file(`${KB}/Skills/Engineering/deploy/SKILL.md`)]),
33
+ ]),
34
+ dir(`${KB}/Skills/Sales`, [
35
+ dir(`${KB}/Skills/Sales/discovery-call`, [
36
+ file(`${KB}/Skills/Sales/discovery-call/SKILL.md`),
37
+ file(`${KB}/Skills/Sales/discovery-call/checklist.md`),
38
+ ]),
39
+ ]),
40
+ ]),
41
+ ]),
42
+ ]);
43
+
44
+ function LocationProbe() {
45
+ const location = useLocation();
46
+ return <div aria-label="pathname">{location.pathname}</div>;
47
+ }
48
+
49
+ function renderTree(url: string, over: Partial<WorkspaceContextValue> = {}) {
50
+ const workspace = makeWorkspaceFixture({ fileTree: TREE, kbDirName: KB, ...over });
51
+ const view = render(
52
+ <MemoryRouter initialEntries={[url]}>
53
+ <WorkspaceContext.Provider value={workspace}>
54
+ <SkillsTree />
55
+ <LocationProbe />
56
+ </WorkspaceContext.Provider>
57
+ </MemoryRouter>,
58
+ );
59
+ return { workspace, ...view };
60
+ }
61
+
62
+ const row = (name: string) => screen.getByRole('button', { name });
63
+
64
+ describe('SkillsTree', () => {
65
+ it('draws the root as a folder row, open with its scopes collapsed under it', () => {
66
+ renderTree('/skills-and-tools');
67
+ expect(row('Skills')).toHaveAttribute('aria-expanded', 'true');
68
+ // The scopes sit under the root, collapsed until opened.
69
+ expect(row('Engineering')).toBeInTheDocument();
70
+ expect(row('Sales')).toBeInTheDocument();
71
+ expect(screen.queryByText('deploy')).not.toBeInTheDocument();
72
+ expect(screen.queryByText('discovery-call')).not.toBeInTheDocument();
73
+ });
74
+
75
+ it('collapses and reopens like any folder — Knowledge and Data get the same row', () => {
76
+ renderTree('/skills-and-tools');
77
+ fireEvent.click(row('Skills'));
78
+ expect(row('Skills')).toHaveAttribute('aria-expanded', 'false');
79
+ expect(screen.queryByRole('button', { name: 'Engineering' })).not.toBeInTheDocument();
80
+ fireEvent.click(row('Skills'));
81
+ expect(row('Engineering')).toBeInTheDocument();
82
+ });
83
+
84
+ it('reveals and marks the file the URL names — the Library never sets an open tab', () => {
85
+ renderTree(`/workspace/${DEFAULT_BRANCH}/${KB}/Skills/Sales/discovery-call/checklist.md`, {
86
+ openFilePath: null,
87
+ });
88
+ expect(row('checklist.md')).toHaveAttribute('aria-current', 'true');
89
+ expect(row('SKILL.md')).toHaveAttribute('aria-current', 'false');
90
+ // The other scope stays shut: only the named file's folders open.
91
+ expect(screen.queryByText('deploy')).not.toBeInTheDocument();
92
+ });
93
+
94
+ it('opens a clicked file on its skill page, on the default branch, whatever is checked out', () => {
95
+ renderTree('/skills-and-tools');
96
+ fireEvent.click(row('Sales'));
97
+ fireEvent.click(row('discovery-call'));
98
+ fireEvent.click(row('SKILL.md'));
99
+ expect(screen.getByLabelText('pathname')).toHaveTextContent(
100
+ `/workspace/${DEFAULT_BRANCH}/${KB}/Skills/Sales/discovery-call/SKILL.md`,
101
+ );
102
+ });
103
+
104
+ it('draws the Skills folder even when the knowledge base has none yet, and creates it on first use', () => {
105
+ const noSkills = dir('.', [dir(KB, [dir(`${KB}/KnowledgeBase`, [])])]);
106
+ const createDirectory = vi.fn().mockResolvedValue(undefined);
107
+ const dispatchUpload = vi.fn().mockResolvedValue(undefined);
108
+ renderTree('/skills-and-tools', { fileTree: noSkills, createDirectory, dispatchUpload });
109
+ // The row is there, empty: nothing beneath it but the muted "Empty" row
110
+ // the open folder shows — a folder, caret and all, not a file.
111
+ const skills = row('Skills');
112
+ expect(skills).toBeInTheDocument();
113
+ expect(skills).toHaveAttribute('aria-expanded', 'true');
114
+ expect(skills.querySelectorAll('svg')).toHaveLength(1);
115
+ expect(screen.getByText('Empty')).toBeInTheDocument();
116
+ expect(screen.queryByRole('button', { name: 'Engineering' })).not.toBeInTheDocument();
117
+ // What writes is offered; what would read a folder that is not there is not.
118
+ fireEvent.contextMenu(skills);
119
+ const menu = screen.getByRole('menu', { name: 'Actions for Skills' });
120
+ expect(within(menu).getByRole('menuitem', { name: /New folder/ })).toBeInTheDocument();
121
+ expect(within(menu).queryByRole('menuitem', { name: /Download/ })).not.toBeInTheDocument();
122
+ fireEvent.keyDown(document, { key: 'Escape' });
123
+
124
+ // A new scope goes to the folder's future path — the write creates it.
125
+ fireEvent.click(screen.getByRole('button', { name: 'New folder in Skills' }));
126
+ const input = screen.getByPlaceholderText('folder name');
127
+ fireEvent.change(input, { target: { value: 'Marketing' } });
128
+ fireEvent.keyDown(input, { key: 'Enter' });
129
+ expect(createDirectory).toHaveBeenCalledWith(`${KB}/Skills/Marketing`);
130
+
131
+ // So does a drop — stamped with the tree that took it, so the upload's
132
+ // banners appear here and not in the Plugins tree below.
133
+ const dropped = new File(['x'], 'SKILL.md');
134
+ fireEvent.drop(skills, { dataTransfer: { getData: () => '', items: undefined, files: [dropped] } });
135
+ expect(dispatchUpload).toHaveBeenCalledWith(
136
+ { kind: 'files', files: [dropped] },
137
+ `${KB}/Skills`,
138
+ 'library:Skills',
139
+ );
140
+ });
141
+
142
+ it('renders nothing while the tree has not loaded', () => {
143
+ renderTree('/skills-and-tools', { fileTree: null });
144
+ expect(screen.queryByText('Skills')).not.toBeInTheDocument();
145
+ });
146
+
147
+ it('takes a drop on the root row, uploading into Skills/', () => {
148
+ const dispatchUpload = vi.fn().mockResolvedValue(undefined);
149
+ renderTree('/skills-and-tools', { dispatchUpload });
150
+ const dropped = new File(['x'], 'notes.md');
151
+ fireEvent.drop(row('Skills'), {
152
+ dataTransfer: { getData: () => '', items: undefined, files: [dropped] },
153
+ });
154
+ expect(dispatchUpload).toHaveBeenCalledWith(
155
+ { kind: 'files', files: [dropped] },
156
+ `${KB}/Skills`,
157
+ 'library:Skills',
158
+ );
159
+ });
160
+
161
+ it('cannot be dragged away — a reserved root stays where the platform put it', () => {
162
+ renderTree('/skills-and-tools');
163
+ expect(row('Skills').closest('[draggable]')).toHaveAttribute('draggable', 'false');
164
+ expect(row('Engineering').closest('[draggable]')).toHaveAttribute('draggable', 'true');
165
+ });
166
+
167
+ it("opens the folder's menu on the root row, minus what a reserved root must not do", () => {
168
+ renderTree('/skills-and-tools');
169
+ fireEvent.contextMenu(row('Skills'));
170
+ const menu = screen.getByRole('menu', { name: 'Actions for Skills' });
171
+ expect(within(menu).getByRole('menuitem', { name: /New folder/ })).toBeInTheDocument();
172
+ expect(within(menu).getByRole('menuitem', { name: /Manage access/ })).toBeInTheDocument();
173
+ expect(within(menu).queryByRole('menuitem', { name: /Rename/ })).not.toBeInTheDocument();
174
+ expect(within(menu).queryByRole('menuitem', { name: /Delete/ })).not.toBeInTheDocument();
175
+ expect(within(menu).queryByRole('menuitem', { name: /Pin/ })).not.toBeInTheDocument();
176
+ });
177
+
178
+ it('hands focus back to the root row when its menu closes on Escape', () => {
179
+ renderTree('/skills-and-tools');
180
+ fireEvent.contextMenu(row('Skills'));
181
+ screen.getByRole('menu', { name: 'Actions for Skills' });
182
+ fireEvent.keyDown(document, { key: 'Escape' });
183
+ expect(screen.queryByRole('menu', { name: 'Actions for Skills' })).not.toBeInTheDocument();
184
+ expect(document.activeElement).toBe(row('Skills'));
185
+ });
186
+
187
+ it('keeps a right-click anywhere in the section from reaching the nav behind it', () => {
188
+ const onNav = vi.fn();
189
+ const workspace = makeWorkspaceFixture({ fileTree: TREE, kbDirName: KB });
190
+ render(
191
+ <MemoryRouter initialEntries={['/skills-and-tools']}>
192
+ <WorkspaceContext.Provider value={workspace}>
193
+ <div onContextMenu={onNav}>
194
+ <SkillsTree />
195
+ </div>
196
+ </WorkspaceContext.Provider>
197
+ </MemoryRouter>,
198
+ );
199
+ fireEvent.contextMenu(row('Skills'));
200
+ fireEvent.contextMenu(screen.getByTestId('skills-tree'));
201
+ expect(onNav).not.toHaveBeenCalled();
202
+ });
203
+
204
+ it("the root row's New folder button creates a scope directly under the root", () => {
205
+ const createDirectory = vi.fn().mockResolvedValue(undefined);
206
+ renderTree('/skills-and-tools', { createDirectory });
207
+ fireEvent.click(screen.getByRole('button', { name: 'New folder in Skills' }));
208
+ const input = screen.getByPlaceholderText('folder name');
209
+ fireEvent.change(input, { target: { value: 'Marketing' } });
210
+ fireEvent.keyDown(input, { key: 'Enter' });
211
+ expect(createDirectory).toHaveBeenCalledWith(`${KB}/Skills/Marketing`);
212
+ });
213
+ });
214
+
215
+ /**
216
+ * The same tree, holding the OTHER root: `Plugins/` exactly as it is on disk,
217
+ * manifests and all. One component, one set of rows; what differs is the
218
+ * folder it is handed.
219
+ */
220
+ describe('PluginsTree', () => {
221
+ const PLUGINS: FileTreeEntry = dir('.', [
222
+ dir(KB, [
223
+ dir(`${KB}/Plugins`, [
224
+ dir(`${KB}/Plugins/GTM`, [
225
+ file(`${KB}/Plugins/GTM/plugin.json`),
226
+ file(`${KB}/Plugins/GTM/mcp.json`),
227
+ dir(`${KB}/Plugins/GTM/skills`, [
228
+ dir(`${KB}/Plugins/GTM/skills/outreach`, [file(`${KB}/Plugins/GTM/skills/outreach/SKILL.md`)]),
229
+ ]),
230
+ ]),
231
+ dir(`${KB}/Plugins/personal-u1`, [file(`${KB}/Plugins/personal-u1/plugin.json`)]),
232
+ ]),
233
+ ]),
234
+ ]);
235
+
236
+ function renderPlugins(
237
+ url: string,
238
+ over: Partial<WorkspaceContextValue> = {},
239
+ onCreatePlugin?: (parent: string) => void,
240
+ isGroupingFolder?: (rel: string) => boolean,
241
+ ) {
242
+ const workspace = makeWorkspaceFixture({ fileTree: PLUGINS, kbDirName: KB, ...over });
243
+ return render(
244
+ <MemoryRouter initialEntries={[url]}>
245
+ <WorkspaceContext.Provider value={workspace}>
246
+ <PluginsTree onCreatePlugin={onCreatePlugin} isGroupingFolder={isGroupingFolder} />
247
+ <LocationProbe />
248
+ </WorkspaceContext.Provider>
249
+ </MemoryRouter>,
250
+ );
251
+ }
252
+
253
+ it('draws the Plugins root as a reserved folder row, its plugins collapsed under it', () => {
254
+ renderPlugins('/skills-and-tools');
255
+ expect(screen.getByTestId('plugins-tree')).toBeInTheDocument();
256
+ expect(row('Plugins')).toHaveAttribute('aria-expanded', 'true');
257
+ expect(row('Plugins').closest('[draggable]')).toHaveAttribute('draggable', 'false');
258
+ expect(row('GTM')).toBeInTheDocument();
259
+ expect(row('personal-u1')).toBeInTheDocument();
260
+ expect(screen.queryByText('plugin.json')).not.toBeInTheDocument();
261
+ });
262
+
263
+ it("opens a plugin's files at their canonical default-branch URL — the item route decides the page", () => {
264
+ renderPlugins('/skills-and-tools');
265
+ fireEvent.click(row('GTM'));
266
+ fireEvent.click(row('plugin.json'));
267
+ expect(screen.getByLabelText('pathname')).toHaveTextContent(
268
+ `/workspace/${DEFAULT_BRANCH}/${KB}/Plugins/GTM/plugin.json`,
269
+ );
270
+ });
271
+
272
+ it('draws the folder even when the knowledge base has none yet', () => {
273
+ const none = dir('.', [dir(KB, [dir(`${KB}/KnowledgeBase`, [])])]);
274
+ renderPlugins('/skills-and-tools', { fileTree: none });
275
+ expect(row('Plugins')).toBeInTheDocument();
276
+ expect(row('Plugins')).toHaveAttribute('aria-expanded', 'true');
277
+ // The same row component as Knowledge: an open empty folder says so.
278
+ expect(screen.getByText('Empty')).toBeInTheDocument();
279
+ fireEvent.click(row('Plugins'));
280
+ expect(screen.queryByText('Empty')).not.toBeInTheDocument();
281
+ });
282
+
283
+ it("offers New plugin on every folder's menu when wired — after the tree's own create items — and on no file's", () => {
284
+ const onCreatePlugin = vi.fn();
285
+ renderPlugins('/skills-and-tools', {}, onCreatePlugin);
286
+
287
+ fireEvent.contextMenu(row('Plugins'));
288
+ const rootMenu = screen.getByRole('menu', { name: 'Actions for Plugins' });
289
+ const labels = within(rootMenu).getAllByRole('menuitem').map((i) => i.textContent);
290
+ expect(labels.indexOf('New plugin')).toBeGreaterThan(labels.indexOf('New folder'));
291
+ fireEvent.click(within(rootMenu).getByRole('menuitem', { name: 'New plugin' }));
292
+ // The root: the plugin goes at the top of Plugins/.
293
+ expect(onCreatePlugin).toHaveBeenLastCalledWith('');
294
+ expect(screen.queryByRole('menu')).toBeNull();
295
+
296
+ // A folder below it: the plugin goes INSIDE, named by its path below the root.
297
+ fireEvent.contextMenu(row('GTM'));
298
+ fireEvent.click(within(screen.getByRole('menu', { name: 'Actions for GTM' })).getByRole('menuitem', { name: 'New plugin' }));
299
+ expect(onCreatePlugin).toHaveBeenLastCalledWith('GTM');
300
+
301
+ fireEvent.click(row('GTM'));
302
+ fireEvent.contextMenu(row('plugin.json'));
303
+ expect(within(screen.getByRole('menu', { name: 'Actions for plugin.json' })).queryByRole('menuitem', { name: 'New plugin' })).toBeNull();
304
+ });
305
+
306
+ it('offers New plugin only where a plugin may be made — the root and grouping folders, never a plugin or what is inside one', () => {
307
+ const onCreatePlugin = vi.fn();
308
+ // The layout's answer, from membership: the fixture's two plugin folders
309
+ // (the shared GTM and the personal space) own everything beneath them.
310
+ const pluginFolders = ['Plugins/GTM', 'Plugins/personal-u1'];
311
+ const isGroupingFolder = (rel: string) => !pluginFolders.some((f) => rel === f || rel.startsWith(`${f}/`));
312
+ renderPlugins('/skills-and-tools', {}, onCreatePlugin, isGroupingFolder);
313
+ fireEvent.contextMenu(row('Plugins'));
314
+ expect(within(screen.getByRole('menu', { name: 'Actions for Plugins' })).getByRole('menuitem', { name: 'New plugin' })).toBeInTheDocument();
315
+ fireEvent.keyDown(document, { key: 'Escape' });
316
+ for (const folder of ['GTM', 'personal-u1']) {
317
+ fireEvent.contextMenu(row(folder));
318
+ expect(within(screen.getByRole('menu', { name: `Actions for ${folder}` })).queryByRole('menuitem', { name: 'New plugin' })).toBeNull();
319
+ fireEvent.keyDown(document, { key: 'Escape' });
320
+ }
321
+ fireEvent.click(row('GTM'));
322
+ fireEvent.contextMenu(row('skills'));
323
+ expect(within(screen.getByRole('menu', { name: 'Actions for skills' })).queryByRole('menuitem', { name: 'New plugin' })).toBeNull();
324
+ });
325
+
326
+ it('offers no New plugin when nothing is wired — the tree grows no verb of its own', () => {
327
+ renderPlugins('/skills-and-tools');
328
+ fireEvent.contextMenu(row('Plugins'));
329
+ expect(within(screen.getByRole('menu', { name: 'Actions for Plugins' })).queryByRole('menuitem', { name: 'New plugin' })).toBeNull();
330
+ });
331
+ });
332
+
333
+ describe('SkillsTree: menu', () => {
334
+ it('is the folder menu alone — New plugin is the Plugins tree\'s injection, not the tree\'s', () => {
335
+ renderTree('/skills-and-tools');
336
+ fireEvent.contextMenu(row('Engineering'));
337
+ expect(within(screen.getByRole('menu', { name: 'Actions for Engineering' })).queryByRole('menuitem', { name: 'New plugin' })).toBeNull();
338
+ });
339
+ });
340
+
341
+ /**
342
+ * The Skills tree reads the same filtered listing as Knowledge's explorer, so
343
+ * it answers the same way — for ITS root. The server counts what it withheld
344
+ * per folder, and the notice reads the Skills folder's own count: what was
345
+ * kept out of Knowledge says nothing about Skills.
346
+ */
347
+ describe('SkillsTree: an empty tree says why', () => {
348
+ const EMPTY_KB = (withheld: { listing?: number; skills?: number } = {}): FileTreeEntry => {
349
+ const skills: FileTreeEntry = { ...dir(`${KB}/Skills`, []), ...(withheld.skills ? { withheld: withheld.skills } : {}) };
350
+ return {
351
+ ...dir('.', [dir(KB, [dir(`${KB}/KnowledgeBase`, []), dir(`${KB}/Plugins`, []), skills])]),
352
+ ...(withheld.listing ? { withheld: withheld.listing } : {}),
353
+ };
354
+ };
355
+
356
+ it('says nothing is shared when entries were withheld from the Skills folder', () => {
357
+ // The folder's own count alone decides; the listing total is not consulted.
358
+ renderTree('/skills-and-tools', { fileTree: EMPTY_KB({ skills: 4 }) });
359
+ expect(screen.getByTestId('tree-empty-notice')).toHaveTextContent(
360
+ 'Nothing here is shared with you yet. Ask an admin to grant you access.',
361
+ );
362
+ });
363
+
364
+ it('says the knowledge base is empty, with the create hint for a writer, when nothing was withheld', () => {
365
+ renderTree('/skills-and-tools', { fileTree: EMPTY_KB() });
366
+ expect(screen.getByTestId('tree-empty-notice')).toHaveTextContent(/^This knowledge base is empty\./);
367
+ expect(screen.getByTestId('tree-empty-create-hint')).toBeInTheDocument();
368
+ });
369
+
370
+ it('says empty, not "nothing shared", when what was withheld lies elsewhere in the listing', () => {
371
+ renderTree('/skills-and-tools', { fileTree: EMPTY_KB({ listing: 4 }) });
372
+ expect(screen.getByTestId('tree-empty-notice')).toHaveTextContent(/^This knowledge base is empty\./);
373
+ expect(screen.queryByText(/Nothing here is shared/)).not.toBeInTheDocument();
374
+ });
375
+
376
+ it('shows neither message once one entry is visible', () => {
377
+ renderTree('/skills-and-tools', { fileTree: { ...TREE, withheld: 2 } });
378
+ expect(screen.queryByTestId('tree-empty-notice')).not.toBeInTheDocument();
379
+ });
380
+ });
381
+
382
+ /**
383
+ * WHERE the two Library trees take their roots from. `Skills/` and `Plugins/`
384
+ * are children of the checkout — the `<kbDirName>/` folder the deployment
385
+ * names — and of nothing else. On core-staging a stray `Plugins/` beside the
386
+ * checkout became the whole Plugins tree (one plugin instead of ten) and the
387
+ * Skills tree, finding no `Skills/` there, showed Empty.
388
+ */
389
+ describe('The Library trees root at the checkout', () => {
390
+ /** What sat beside the checkout on core-staging on 2026-09-22. */
391
+ const STRAYS: FileTreeEntry[] = [
392
+ dir('KnowledgeBase', [file('KnowledgeBase/Planted.md')]),
393
+ dir('Plugins', [dir('Plugins/zz-stray', [file('Plugins/zz-stray/plugin.json')])]),
394
+ dir('Skills', [dir('Skills/stray-scope', [file('Skills/stray-scope/SKILL.md')])]),
395
+ file('Stray.docx'),
396
+ ];
397
+
398
+ /** One checkout holding both roots, so one fixture serves both trees. */
399
+ const CHECKOUT = dir(KB, [
400
+ dir(`${KB}/KnowledgeBase`, [file(`${KB}/KnowledgeBase/Handbook.md`)]),
401
+ dir(`${KB}/Skills`, [dir(`${KB}/Skills/Engineering`, [])]),
402
+ dir(`${KB}/Plugins`, [dir(`${KB}/Plugins/GTM`, []), dir(`${KB}/Plugins/Product`, [])]),
403
+ ]);
404
+
405
+ function renderBoth(tree: FileTreeEntry | null) {
406
+ const workspace = makeWorkspaceFixture({ fileTree: tree, kbDirName: KB });
407
+ return render(
408
+ <MemoryRouter initialEntries={['/skills-and-tools']}>
409
+ <WorkspaceContext.Provider value={workspace}>
410
+ <SkillsTree />
411
+ <PluginsTree />
412
+ </WorkspaceContext.Provider>
413
+ </MemoryRouter>,
414
+ );
415
+ }
416
+
417
+ /** Every row on screen, by the path it addresses. */
418
+ const paths = () =>
419
+ Array.from(document.querySelectorAll('[data-tree-path]')).map(
420
+ (el) => (el as HTMLElement).dataset.treePath!,
421
+ );
422
+
423
+ it('renders the checkout\'s Skills and Plugins, and exactly those with strays beside them', () => {
424
+ const { unmount } = renderBoth(dir('.', [CHECKOUT]));
425
+ const clean = paths();
426
+ expect(clean).toContain(`${KB}/Skills`);
427
+ expect(clean).toContain(`${KB}/Plugins`);
428
+ unmount();
429
+
430
+ renderBoth(dir('.', [...STRAYS, CHECKOUT]));
431
+ expect(paths()).toEqual(clean);
432
+ });
433
+
434
+ it('renders no row outside the checkout — the stray plugin and scope are not theirs', () => {
435
+ renderBoth(dir('.', [...STRAYS, CHECKOUT]));
436
+ for (const p of paths()) expect(p.startsWith(`${KB}/`)).toBe(true);
437
+ expect(screen.queryByText('zz-stray')).toBeNull();
438
+ expect(screen.queryByText('stray-scope')).toBeNull();
439
+ expect(screen.getByText('GTM')).toBeInTheDocument();
440
+ expect(screen.getByText('Engineering')).toBeInTheDocument();
441
+ });
442
+
443
+ it('shows the empty state naming the missing checkout in both trees, and no row at all', () => {
444
+ renderBoth(dir('.', STRAYS));
445
+ const notices = screen.getAllByTestId('tree-empty-notice');
446
+ expect(notices).toHaveLength(2);
447
+ for (const n of notices) {
448
+ expect(n).toHaveTextContent('Nothing to show here: the repository checkout is missing.');
449
+ }
450
+ expect(paths()).toEqual([]);
451
+ expect(screen.queryByText('Skills')).toBeNull();
452
+ expect(screen.queryByText('Plugins')).toBeNull();
453
+ });
454
+
455
+ it('still renders nothing at all while the tree is loading', () => {
456
+ renderBoth(null);
457
+ expect(screen.queryByTestId('tree-empty-notice')).toBeNull();
458
+ expect(screen.queryByTestId('skills-tree')).toBeNull();
459
+ expect(screen.queryByTestId('plugins-tree')).toBeNull();
460
+ });
461
+ });