@kabmo-labs/kabmo 0.8.0 → 0.10.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 (391) hide show
  1. package/README.md +52 -0
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +336 -336
  4. package/dist/client/static/js/index-18xe7655.css +1 -0
  5. package/dist/client/static/js/{index-qwpvd9fv.js → index-nxpe7835.js} +933 -898
  6. package/package.json +11 -1
  7. package/src/client/components/common/code-surface/bracket-guide.test.ts +249 -0
  8. package/src/client/components/common/code-surface/bracket-guide.ts +131 -0
  9. package/src/client/components/common/code-surface/documents.test.ts +122 -0
  10. package/src/client/components/common/code-surface/documents.ts +286 -0
  11. package/src/client/components/common/code-surface/extensions.test.ts +115 -0
  12. package/src/client/components/common/code-surface/extensions.ts +295 -0
  13. package/src/client/components/common/code-surface/fold-stack.test.ts +218 -0
  14. package/src/client/components/common/code-surface/fold.test.ts +148 -0
  15. package/src/client/components/common/code-surface/fold.ts +118 -0
  16. package/src/client/components/common/code-surface/handle.ts +102 -0
  17. package/src/client/components/common/code-surface/indent-guide.ts +104 -0
  18. package/src/client/components/common/code-surface/indent.test.ts +239 -0
  19. package/src/client/components/common/code-surface/indent.ts +124 -0
  20. package/src/client/components/common/code-surface/index.tsx +283 -314
  21. package/src/client/components/common/code-surface/keymap.test.ts +133 -0
  22. package/src/client/components/common/code-surface/keymap.ts +256 -0
  23. package/src/client/components/common/code-surface/line-commands.test.ts +90 -0
  24. package/src/client/components/common/code-surface/line-commands.ts +103 -0
  25. package/src/client/components/common/code-surface/marks.ts +74 -0
  26. package/src/client/components/common/code-surface/props.ts +87 -0
  27. package/src/client/components/common/code-surface/shiki.ts +234 -0
  28. package/src/client/components/common/code-surface/stream-language.test.ts +118 -0
  29. package/src/client/components/common/code-surface/stream-language.ts +123 -0
  30. package/src/client/components/common/code-surface/sync.test.ts +185 -0
  31. package/src/client/components/common/code-surface/sync.ts +58 -0
  32. package/src/client/components/common/code-surface/theme.test.ts +237 -0
  33. package/src/client/components/common/code-surface/theme.ts +224 -0
  34. package/src/client/components/common/code-surface/typing.test.ts +97 -0
  35. package/src/client/components/common/code-surface/typing.ts +111 -0
  36. package/src/client/components/common/editor-view-buttons/index.test.tsx +148 -0
  37. package/src/client/components/common/editor-view-buttons/index.tsx +109 -0
  38. package/src/client/components/common/shell-update-button/Modal.tsx +163 -0
  39. package/src/client/components/common/shell-update-button/index.test.tsx +251 -0
  40. package/src/client/components/common/shell-update-button/index.tsx +125 -0
  41. package/src/client/components/common/toolbar-row/index.test.tsx +215 -0
  42. package/src/client/components/common/toolbar-row/index.tsx +260 -0
  43. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +58 -78
  44. package/src/client/components/layout/desktop-layout/index.tsx +65 -67
  45. package/src/client/components/layout/desktop-layout/resizer/index.tsx +6 -3
  46. package/src/client/components/layout/session-sidebar/Footer.tsx +8 -15
  47. package/src/client/components/mobile/LayoutWrapper.tsx +1 -0
  48. package/src/client/components/mobile/mobile-right-sidebar/FullDiff.tsx +3 -0
  49. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +98 -71
  50. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +20 -1
  51. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.test.tsx +137 -0
  52. package/src/client/components/mobile/mobile-right-sidebar/OutlineButton.tsx +14 -3
  53. package/src/client/components/mobile/mobile-right-sidebar/editor-props.ts +25 -0
  54. package/src/client/components/mobile/mobile-session-sidebar/Footer.tsx +9 -21
  55. package/src/client/components/settings/Modal.tsx +8 -0
  56. package/src/client/components/settings/categories/AppearanceSettings.tsx +9 -0
  57. package/src/client/components/settings/categories/appearance-settings/EditorIndentSection.tsx +87 -0
  58. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.test.tsx +167 -0
  59. package/src/client/components/settings/categories/appearance-settings/EditorThemeSection.tsx +184 -0
  60. package/src/client/components/settings/categories/appearance-settings/EditorTypingSection.tsx +99 -0
  61. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +8 -2
  62. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +16 -8
  63. package/src/client/components/workspace/chat-timeline/SystemNotice.tsx +9 -4
  64. package/src/client/components/workspace/chat-timeline/TaskResultContent.tsx +9 -7
  65. package/src/client/components/workspace/chat-timeline/chat-input/expansion.ts +9 -4
  66. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +15 -11
  67. package/src/client/components/workspace/chat-timeline/chat-input/stretch-send.test.tsx +165 -0
  68. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.test.tsx +132 -0
  69. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +120 -0
  70. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.test.tsx +319 -0
  71. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +285 -0
  72. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/index.test.ts +2 -0
  73. package/src/client/components/workspace/chat-timeline/tool-renderers/hashline-patch/index.tsx +34 -29
  74. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/AstEdit.tsx +11 -9
  75. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +10 -7
  76. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Edit.tsx +25 -8
  77. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Eval.tsx +8 -11
  78. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.test.ts +114 -0
  79. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/FileMatches.tsx +111 -0
  80. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +7 -7
  81. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/SearchTool.tsx +9 -59
  82. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactBody.tsx +2 -7
  83. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.test.ts +43 -30
  84. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/DiffView.tsx +49 -32
  85. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ExcerptCode.tsx +8 -8
  86. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/HighlightedCode.tsx +35 -0
  87. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/JsonCodeBlock.tsx +4 -4
  88. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +179 -0
  89. package/src/client/components/workspace/diff-panel/ThemedMergeDiffView.tsx +24 -0
  90. package/src/client/components/workspace/diff-panel/Toolbar.tsx +224 -186
  91. package/src/client/components/workspace/diff-panel/ToolbarSegments.tsx +98 -0
  92. package/src/client/components/workspace/diff-panel/index.tsx +76 -145
  93. package/src/client/components/workspace/diff-panel/merge.ts +315 -0
  94. package/src/client/components/workspace/editor/Body.tsx +28 -7
  95. package/src/client/components/workspace/editor/CommandPalette.tsx +6 -6
  96. package/src/client/components/workspace/editor/ConflictStrip.tsx +77 -0
  97. package/src/client/components/workspace/editor/Dialogs.tsx +53 -0
  98. package/src/client/components/workspace/editor/EmptyEditor.tsx +23 -0
  99. package/src/client/components/workspace/editor/ExternalChangeStrip.tsx +61 -0
  100. package/src/client/components/workspace/editor/FileDocument.tsx +146 -63
  101. package/src/client/components/workspace/editor/FilePane.tsx +47 -7
  102. package/src/client/components/workspace/editor/FindWidget.test.ts +9 -5
  103. package/src/client/components/workspace/editor/FindWidget.tsx +36 -2
  104. package/src/client/components/workspace/editor/GoToLineModal.tsx +123 -0
  105. package/src/client/components/workspace/editor/Notices.tsx +71 -0
  106. package/src/client/components/workspace/editor/Pane.tsx +118 -0
  107. package/src/client/components/workspace/editor/PluginColumn.tsx +32 -0
  108. package/src/client/components/workspace/editor/QuickOpenModal.tsx +146 -0
  109. package/src/client/components/workspace/editor/SaveAsModal.tsx +175 -0
  110. package/src/client/components/workspace/editor/SplitColumn.tsx +98 -0
  111. package/src/client/components/workspace/editor/SplitPane.tsx +57 -0
  112. package/src/client/components/workspace/editor/StatusBar.tsx +106 -0
  113. package/src/client/components/workspace/editor/TabContextMenu.tsx +75 -0
  114. package/src/client/components/workspace/editor/Tabs.tsx +195 -18
  115. package/src/client/components/workspace/editor/Toolbar.tsx +110 -140
  116. package/src/client/components/workspace/editor/index.tsx +201 -193
  117. package/src/client/components/workspace/editor/props.ts +64 -0
  118. package/src/client/components/workspace/editor/toolbar-clusters.tsx +300 -0
  119. package/src/client/components/workspace/file-explorer/Modals.tsx +14 -1
  120. package/src/client/components/workspace/file-explorer/OutlineSection.test.tsx +18 -0
  121. package/src/client/components/workspace/file-explorer/OutlineSection.tsx +10 -3
  122. package/src/client/components/workspace/file-explorer/TreeItem.tsx +2 -1
  123. package/src/client/components/workspace/file-explorer/clipboard.test.ts +3 -1
  124. package/src/client/components/workspace/file-explorer/index.test.ts +61 -0
  125. package/src/client/components/workspace/file-explorer/index.tsx +10 -48
  126. package/src/client/components/workspace/file-explorer/local-edit.test.ts +8 -3
  127. package/src/client/components/workspace/search-panel/Body.tsx +7 -2
  128. package/src/client/components/workspace/worktree-modal/index.test.tsx +118 -0
  129. package/src/client/hooks/chat/composer/file-drop.ts +22 -37
  130. package/src/client/hooks/chat/composer/pipeline.test.ts +76 -0
  131. package/src/client/hooks/chat/composer/pipeline.ts +12 -1
  132. package/src/client/hooks/chat/omp/reconnect.test.ts +338 -0
  133. package/src/client/hooks/chat/omp/reconnect.ts +187 -0
  134. package/src/client/hooks/chat/omp/run-liveness.test.ts +71 -0
  135. package/src/client/hooks/chat/omp/run-liveness.ts +65 -0
  136. package/src/client/hooks/chat/omp/session-list.activity.test.ts +114 -0
  137. package/src/client/hooks/chat/omp/session-list.test-util.ts +164 -0
  138. package/src/client/hooks/chat/omp/session-list.test.ts +30 -150
  139. package/src/client/hooks/chat/omp/session-list.tsx +69 -9
  140. package/src/client/hooks/chat/timeline/generating.ts +19 -2
  141. package/src/client/hooks/chat/timeline/index.ts +19 -24
  142. package/src/client/hooks/chat/timeline/lost-run.test.ts +329 -0
  143. package/src/client/hooks/chat/timeline/lost-run.ts +177 -0
  144. package/src/client/hooks/chat/timeline/session-load.test-util.ts +205 -0
  145. package/src/client/hooks/chat/timeline/session-load.test.ts +61 -162
  146. package/src/client/hooks/chat/timeline/session-load.ts +69 -37
  147. package/src/client/hooks/chat/timeline/session-switch.test.ts +65 -0
  148. package/src/client/hooks/chat/timeline/session-switch.ts +63 -0
  149. package/src/client/hooks/code/deferred-highlight.test.ts +182 -0
  150. package/src/client/hooks/code/deferred-highlight.ts +129 -0
  151. package/src/client/hooks/editor/caret-position.test.ts +58 -0
  152. package/src/client/hooks/editor/caret-position.ts +48 -0
  153. package/src/client/hooks/editor/file-editor-types.ts +200 -0
  154. package/src/client/hooks/editor/find-history.test.ts +132 -0
  155. package/src/client/hooks/editor/find-history.ts +46 -0
  156. package/src/client/hooks/editor/find-selection-range.test.ts +100 -0
  157. package/src/client/hooks/editor/find-selection-range.ts +49 -0
  158. package/src/client/hooks/editor/find-state.ts +14 -1
  159. package/src/client/hooks/editor/font.test.ts +0 -93
  160. package/src/client/hooks/editor/indent-settings.test.ts +104 -0
  161. package/src/client/hooks/editor/indent-settings.ts +88 -0
  162. package/src/client/hooks/editor/quick-open.test.ts +141 -0
  163. package/src/client/hooks/editor/quick-open.ts +127 -0
  164. package/src/client/hooks/editor/save-as.test.ts +156 -0
  165. package/src/client/hooks/editor/save-as.ts +122 -0
  166. package/src/client/hooks/editor/save-file.test.ts +179 -0
  167. package/src/client/hooks/editor/save-file.ts +73 -28
  168. package/src/client/hooks/editor/theme.test.ts +206 -0
  169. package/src/client/hooks/editor/theme.ts +82 -0
  170. package/src/client/hooks/editor/typing-settings.test.ts +73 -0
  171. package/src/client/hooks/editor/typing-settings.ts +65 -0
  172. package/src/client/hooks/editor/use-close-guard.ts +98 -0
  173. package/src/client/hooks/editor/use-editor-drop-overlay.test.ts +159 -0
  174. package/src/client/hooks/editor/use-editor-drop.shell.test.ts +224 -0
  175. package/src/client/hooks/editor/use-editor-drop.test.ts +101 -0
  176. package/src/client/hooks/editor/use-editor-drop.ts +120 -77
  177. package/src/client/hooks/editor/use-editor-find.test.ts +2 -2
  178. package/src/client/hooks/editor/use-editor-find.ts +45 -10
  179. package/src/client/hooks/editor/use-editor-panel-keys.ts +152 -0
  180. package/src/client/hooks/editor/use-editor-tab-state.ts +71 -0
  181. package/src/client/hooks/editor/use-external-change-notice.ts +71 -0
  182. package/src/client/hooks/editor/use-external-change.test.ts +88 -0
  183. package/src/client/hooks/editor/use-external-change.ts +146 -0
  184. package/src/client/hooks/editor/use-file-editor.ts +83 -116
  185. package/src/client/hooks/editor/use-file-read.ts +16 -8
  186. package/src/client/hooks/editor/use-file-writes.ts +28 -3
  187. package/src/client/hooks/editor/use-mobile-editor-find.ts +69 -0
  188. package/src/client/hooks/editor/use-mobile-reveal.ts +53 -0
  189. package/src/client/hooks/editor/use-outline-view.test.ts +182 -0
  190. package/src/client/hooks/editor/use-outline-view.ts +94 -7
  191. package/src/client/hooks/editor/use-scroll-restore.test.ts +55 -2
  192. package/src/client/hooks/editor/use-scroll-restore.ts +124 -4
  193. package/src/client/hooks/editor/use-search-reveal-jump.ts +57 -0
  194. package/src/client/hooks/editor/use-search-reveal.ts +1 -1
  195. package/src/client/hooks/editor/use-split-editor.test.tsx +169 -0
  196. package/src/client/hooks/editor/use-split-editor.ts +91 -0
  197. package/src/client/hooks/editor/use-unload-guard.tsx +117 -0
  198. package/src/client/hooks/editor/use-write-conflict.test.ts +164 -0
  199. package/src/client/hooks/editor/use-write-conflict.ts +152 -0
  200. package/src/client/hooks/editor/wheel-zoom.test.ts +141 -0
  201. package/src/client/hooks/editor/wheel-zoom.ts +96 -0
  202. package/src/client/hooks/ui/drag-presence.test.ts +193 -0
  203. package/src/client/hooks/ui/drag-presence.ts +108 -0
  204. package/src/client/hooks/ui/settings-modal.test.ts +115 -0
  205. package/src/client/hooks/ui/settings-modal.ts +56 -0
  206. package/src/client/hooks/ui/updates/shell-download.test.ts +2 -0
  207. package/src/client/hooks/ui/updates/shell-download.ts +55 -14
  208. package/src/client/hooks/ui/updates/shell-offer.test.ts +26 -0
  209. package/src/client/hooks/ui/updates/shell-update.test.ts +140 -0
  210. package/src/client/hooks/ui/updates/shell-update.ts +119 -0
  211. package/src/client/hooks/workspace/diff-file.ts +29 -10
  212. package/src/client/hooks/workspace/diff-git-actions.ts +147 -0
  213. package/src/client/hooks/workspace/editor-view.ts +61 -0
  214. package/src/client/hooks/workspace/file-listing.ts +36 -24
  215. package/src/client/hooks/workspace/file-tabs.test.ts +152 -5
  216. package/src/client/hooks/workspace/file-tabs.ts +70 -11
  217. package/src/client/hooks/workspace/file-tree-edits.ts +103 -0
  218. package/src/client/hooks/workspace/navbar-session-actions.ts +72 -0
  219. package/src/client/hooks/workspace/worktree/index.ts +20 -5
  220. package/src/client/lib/desktop/bridge.ts +45 -0
  221. package/src/client/lib/desktop/dropped-paths.ts +83 -0
  222. package/src/client/lib/editor/tab-menu.test.ts +127 -0
  223. package/src/client/lib/editor/tab-menu.ts +127 -0
  224. package/src/client/lib/editor-dirty-tabs.test.ts +102 -0
  225. package/src/client/lib/editor-dirty-tabs.ts +103 -0
  226. package/src/client/lib/native/resume.test.ts +66 -0
  227. package/src/client/lib/native/resume.ts +42 -0
  228. package/src/client/lib/search-reveal.ts +1 -1
  229. package/src/client/main.tsx +13 -1
  230. package/src/client/tailwind.css +75 -8
  231. package/src/server/lib/auth/guard.test.ts +28 -0
  232. package/src/server/lib/auth/guard.ts +10 -0
  233. package/src/server/lib/bundler/css.test.ts +31 -0
  234. package/src/server/lib/fs/listing.test.ts +81 -16
  235. package/src/server/lib/fs/listing.ts +72 -5
  236. package/src/server/lib/fs/worktree/create.ts +2 -3
  237. package/src/server/lib/fs/worktree/list.ts +13 -0
  238. package/src/server/lib/fs/worktree/remove.ts +3 -3
  239. package/src/server/lib/fs/write-conflict.test.ts +68 -0
  240. package/src/server/lib/fs/write-conflict.ts +84 -0
  241. package/src/server/lib/lifecycle/claim-port.test.ts +156 -0
  242. package/src/server/lib/lifecycle/port-guard.test.ts +20 -164
  243. package/src/server/lib/lifecycle/port-guard.ts +39 -7
  244. package/src/server/lib/lifecycle/probe-health.test.ts +166 -0
  245. package/src/server/lib/lifecycle/probe.test.ts +77 -164
  246. package/src/server/lib/lifecycle/probe.ts +121 -13
  247. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +112 -0
  248. package/src/server/lib/omp/rpc/frame-fold.ts +10 -5
  249. package/src/server/lib/omp/session/sidebar-activity.server.test.ts +162 -0
  250. package/src/server/lib/omp/session/sidebar-activity.server.ts +70 -0
  251. package/src/server/lib/omp/session/telemetry/compute.ts +13 -1
  252. package/src/server/lib/omp/session/telemetry.test.ts +33 -0
  253. package/src/server/lib/realtime/signals.server.ts +10 -0
  254. package/src/server/lib/realtime/topics/catalog.server.ts +4 -1
  255. package/src/server/lib/realtime/topics.server.ts +16 -0
  256. package/src/server/lib/updates/shell-assets.ts +94 -3
  257. package/src/server/lib/updates/shell-cache.ts +105 -0
  258. package/src/server/lib/updates/shell-pages.test.ts +33 -2
  259. package/src/server/lib/updates/shell-pages.ts +17 -5
  260. package/src/server/lib/updates/shell-release-desktop.test.ts +166 -0
  261. package/src/server/lib/updates/shell-release.test.ts +10 -27
  262. package/src/server/lib/updates/shell-release.ts +107 -111
  263. package/src/server/routes/fs/action-save-as.test.ts +82 -0
  264. package/src/server/routes/fs/action.test.ts +82 -0
  265. package/src/server/routes/fs/action.ts +54 -1
  266. package/src/server/routes/fs/exists.ts +11 -1
  267. package/src/server/routes/fs/git-merge.test.ts +11 -1
  268. package/src/server/routes/fs/read.test.ts +24 -7
  269. package/src/server/routes/fs/read.ts +6 -1
  270. package/src/server/routes/fs/scope.test.ts +15 -10
  271. package/src/server/routes/fs/scope.ts +3 -14
  272. package/src/server/routes/updates/android.ts +6 -1
  273. package/src/server/routes/updates/desktop.ts +29 -7
  274. package/src/server/routes/updates/ios.ts +5 -1
  275. package/src/server/routes/worktrees/list.ts +11 -1
  276. package/src/server/routes/worktrees/routes.test.ts +17 -0
  277. package/src/shared/lib/chat/timeline/omp-callbacks.test.ts +36 -0
  278. package/src/shared/lib/chat/timeline/omp-callbacks.ts +18 -0
  279. package/src/shared/lib/chat/timeline/run-signals.test.ts +2 -0
  280. package/src/shared/lib/code/editor/comment-syntax.test.ts +37 -0
  281. package/src/shared/lib/code/editor/comment-syntax.ts +55 -0
  282. package/src/shared/lib/code/editor/find-replace.test.ts +134 -0
  283. package/src/shared/lib/code/editor/{find.ts → find-replace.ts} +23 -107
  284. package/src/shared/lib/code/editor/{find.test.ts → find-scan.test.ts} +20 -74
  285. package/src/shared/lib/code/editor/find-scan.ts +198 -0
  286. package/src/shared/lib/code/editor/find-selection.test.ts +56 -0
  287. package/src/shared/lib/code/editor/indent-guide-rule.test.ts +65 -0
  288. package/src/shared/lib/code/editor/indent-guide-rule.ts +47 -0
  289. package/src/shared/lib/code/editor/indent-rules.test.ts +219 -0
  290. package/src/shared/lib/code/editor/indent-rules.ts +198 -0
  291. package/src/shared/lib/code/editor/keymap.test.ts +23 -0
  292. package/src/shared/lib/code/editor/keymap.ts +43 -6
  293. package/src/shared/lib/code/editor/lines.test.ts +7 -55
  294. package/src/shared/lib/code/editor/lines.ts +8 -48
  295. package/src/shared/lib/code/editor/marks.test.ts +4 -5
  296. package/src/shared/lib/code/editor/marks.ts +13 -25
  297. package/src/shared/lib/code/editor/palette.test.ts +25 -2
  298. package/src/shared/lib/code/editor/palette.ts +10 -0
  299. package/src/shared/lib/code/editor/stream-modes.ts +225 -0
  300. package/src/shared/lib/code/editor/theme-loader.ts +97 -0
  301. package/src/shared/lib/code/editor/themes.generated.ts +156 -0
  302. package/src/shared/lib/code/editor/themes.test.ts +165 -0
  303. package/src/shared/lib/code/editor/themes.ts +165 -0
  304. package/src/shared/lib/code/highlight-memo.test.ts +103 -0
  305. package/src/shared/lib/code/highlight-memo.ts +149 -0
  306. package/src/shared/lib/code/highlighter-warmup.ts +112 -0
  307. package/src/shared/lib/code/highlighter.ts +3 -1
  308. package/src/shared/lib/code/idle.ts +37 -0
  309. package/src/shared/lib/code/outline/rows.test.ts +96 -0
  310. package/src/shared/lib/code/outline/rows.ts +94 -0
  311. package/src/shared/lib/code/syntax-highlight.test.ts +2 -80
  312. package/src/shared/lib/code/syntax-highlight.ts +2 -3
  313. package/src/shared/lib/fs/file-kind-classify.test.ts +25 -11
  314. package/src/shared/lib/fs/file-kind.ts +47 -13
  315. package/src/shared/lib/fs/file-tree.test.ts +41 -0
  316. package/src/shared/lib/fs/file-tree.ts +126 -34
  317. package/src/shared/lib/fs/file-url.test.ts +52 -0
  318. package/src/shared/lib/fs/file-url.ts +37 -0
  319. package/src/shared/lib/fs/folder-chain.test.ts +87 -0
  320. package/src/shared/lib/fs/folder-chain.ts +91 -0
  321. package/src/shared/lib/fs/fs-helpers.test.ts +4 -50
  322. package/src/shared/lib/fs/patch-sides.test.ts +114 -0
  323. package/src/shared/lib/fs/patch-sides.ts +139 -0
  324. package/src/shared/lib/realtime/connection.test.ts +5 -1
  325. package/src/shared/lib/realtime/connection.ts +25 -119
  326. package/src/shared/lib/realtime/frozen-recovery.test.ts +93 -0
  327. package/src/shared/lib/realtime/protocol.ts +16 -0
  328. package/src/shared/lib/realtime/resume.ts +223 -0
  329. package/src/shared/lib/realtime/state.ts +22 -0
  330. package/src/shared/lib/realtime/watchdog-wiring.test.ts +224 -0
  331. package/src/shared/lib/realtime/watchdog.test.ts +99 -0
  332. package/src/shared/lib/realtime/watchdog.ts +72 -0
  333. package/src/shared/lib/ui/toolbar-overflow.test.ts +83 -0
  334. package/src/shared/lib/ui/toolbar-overflow.ts +86 -0
  335. package/src/shared/lib/updates/shell-arch.ts +54 -0
  336. package/src/shared/lib/updates/shell-ua.ts +4 -4
  337. package/src/shared/lib/workspace/editor-view-mode.test.ts +70 -0
  338. package/src/shared/lib/workspace/editor-view-mode.ts +48 -0
  339. package/src/shared/lib/workspace/panel-widths.test.ts +30 -0
  340. package/src/shared/lib/workspace/panel-widths.ts +25 -5
  341. package/src/shared/lib/workspace/session-state/cache.ts +159 -0
  342. package/src/shared/lib/workspace/session-state/harness.test-util.ts +55 -0
  343. package/src/shared/lib/workspace/session-state/merge.ts +100 -0
  344. package/src/shared/lib/workspace/session-state/store-load.test.ts +206 -0
  345. package/src/shared/lib/workspace/session-state/store.test.ts +17 -139
  346. package/src/shared/lib/workspace/session-state/store.ts +92 -130
  347. package/src/shared/lib/workspace/split-editor.test.ts +104 -0
  348. package/src/shared/lib/workspace/split-editor.ts +129 -0
  349. package/src/shared/lib/workspace/workspace-panel-widths.ts +124 -0
  350. package/src/shared/types/realtime.ts +29 -0
  351. package/src/shared/types/settings/state.ts +10 -0
  352. package/src/test-support/file-explorer-disk.test-util.ts +30 -3
  353. package/src/test-support/loopback.ts +183 -0
  354. package/src/test-support/pristine-globals.ts +7 -0
  355. package/dist/client/static/js/index-gtbpewr7.css +0 -1
  356. package/src/client/components/common/code-editor/handler.test.ts +0 -274
  357. package/src/client/components/common/code-editor/handler.ts +0 -175
  358. package/src/client/components/common/code-editor/index.tsx +0 -314
  359. package/src/client/components/common/code-surface/measure.ts +0 -148
  360. package/src/client/components/workspace/chat-timeline/target-picker/index.test.tsx +0 -227
  361. package/src/client/components/workspace/chat-timeline/target-picker/index.tsx +0 -260
  362. package/src/client/components/workspace/diff-panel/SplitView.tsx +0 -209
  363. package/src/client/components/workspace/diff-panel/UnifiedView.tsx +0 -150
  364. package/src/client/hooks/editor/scroll-container.test.ts +0 -102
  365. package/src/client/hooks/editor/scroll-container.ts +0 -26
  366. package/src/client/hooks/editor/use-code-window.ts +0 -100
  367. package/src/client/hooks/editor/use-editor-history.test.ts +0 -216
  368. package/src/client/hooks/editor/use-editor-history.ts +0 -134
  369. package/src/client/hooks/editor/use-occurrences.test.ts +0 -236
  370. package/src/client/hooks/editor/use-occurrences.ts +0 -98
  371. package/src/shared/lib/code/editor/commands.test.ts +0 -155
  372. package/src/shared/lib/code/editor/commands.ts +0 -260
  373. package/src/shared/lib/code/editor/edits.test.ts +0 -100
  374. package/src/shared/lib/code/editor/edits.ts +0 -122
  375. package/src/shared/lib/code/editor/history.test.ts +0 -118
  376. package/src/shared/lib/code/editor/history.ts +0 -101
  377. package/src/shared/lib/code/editor/layers.test.ts +0 -77
  378. package/src/shared/lib/code/editor/layers.ts +0 -67
  379. package/src/shared/lib/code/editor/line-edits.test.ts +0 -131
  380. package/src/shared/lib/code/editor/line-edits.ts +0 -159
  381. package/src/shared/lib/code/editor/occurrences.test.ts +0 -117
  382. package/src/shared/lib/code/editor/occurrences.ts +0 -111
  383. package/src/shared/lib/code/editor/reset-css.test.ts +0 -35
  384. package/src/shared/lib/code/editor/reset-css.ts +0 -32
  385. package/src/shared/lib/code/editor/text-commands.test.ts +0 -178
  386. package/src/shared/lib/code/editor/text-commands.ts +0 -154
  387. package/src/shared/lib/code/lazy-window.test.ts +0 -161
  388. package/src/shared/lib/code/lazy-window.ts +0 -156
  389. package/src/shared/lib/code/windowed-highlight.ts +0 -114
  390. package/src/shared/lib/fs/diff-parser.test.ts +0 -116
  391. package/src/shared/lib/fs/diff-parser.ts +0 -213
@@ -0,0 +1,129 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The editor column's SECOND group: two documents side by side.
8
+ *
9
+ * ## Why this does not touch the panel-width model
10
+ *
11
+ * The plan called split editor the most expensive item because it "conflicts with the
12
+ * coupled editor/right-panel width model". It does not have to. The split lives INSIDE the
13
+ * editor panel: that panel keeps its own width (its fraction, its floor, its diff variant),
14
+ * and the two panes divide the space it already has. Nothing about `panel-widths.ts`
15
+ * changes — no new slot, no second pair, no re-derivation of the 0.7 pair cap — because
16
+ * splitting a column is not the same decision as how wide the column is.
17
+ *
18
+ * ## The two panes are TABS, not a second document list
19
+ *
20
+ * The left pane is the active tab; the right pane is another tab the user picked. That is
21
+ * what keeps ONE tab list authoritative: a second list would need its own ordering, its own
22
+ * close semantics and its own persisted state, and the two could disagree about which file
23
+ * is open. Picking the same tab twice is refused (a pane showing its twin is a wide pane
24
+ * with a divider through it).
25
+ *
26
+ * ## A closed pane's tab is NOT closed
27
+ *
28
+ * Splitting is a view, so closing the right pane leaves the tab open in the strip. The
29
+ * reverse also holds: closing the tab that a pane shows collapses the split, because a pane
30
+ * naming a tab that is gone has nothing to draw.
31
+ */
32
+
33
+ /** The split's state, persisted per session beside the rest of the layout. */
34
+ export interface SplitEditorState {
35
+ /** The tab shown in the RIGHT pane, or null when the column is not split. */
36
+ rightFileId: number | string | null;
37
+ /**
38
+ * The divider's position as a share of the editor panel's width, 0–1.
39
+ *
40
+ * A fraction rather than pixels for the same reason the panel widths are: a pixel value
41
+ * is only right on the display it was dragged on.
42
+ */
43
+ fraction: number;
44
+ }
45
+
46
+ export const DEFAULT_SPLIT: SplitEditorState = { rightFileId: null, fraction: 0.5 };
47
+
48
+ /** Bounds on the divider, so neither pane can be squeezed out of existence. */
49
+ export const MIN_SPLIT_FRACTION = 0.2;
50
+ export const MAX_SPLIT_FRACTION = 0.8;
51
+
52
+ /**
53
+ * Split with `rightFileId`, or refuse when it cannot be shown.
54
+ *
55
+ * Refused cases, each of which would otherwise draw an empty or duplicated pane: the id
56
+ * names the tab the LEFT pane already shows, or the id names no open tab (a stale persisted
57
+ * value after a reload).
58
+ */
59
+ export function canSplitTo(
60
+ rightFileId: number | string | null,
61
+ activeFileId: number | string | null,
62
+ openIds: readonly (number | string)[],
63
+ ): boolean {
64
+ if (rightFileId === null) return false;
65
+ if (rightFileId === activeFileId) return false;
66
+ return openIds.includes(rightFileId);
67
+ }
68
+
69
+ /**
70
+ * The tab a bare "split" gesture should put in the right pane: the most recently opened tab
71
+ * that is not the left pane's own.
72
+ *
73
+ * A menu row can name its tab, but a BUTTON cannot — and the button has to exist, because
74
+ * the tab strip folds every non-active tab into the overflow menu at panel width, so a
75
+ * split reachable only by right-clicking another tab is unreachable in the common case. The
76
+ * newest other tab is the one the user just opened, which is what they mean by "show me both".
77
+ *
78
+ * `null` means there is nothing to split with — one tab, and a divider through one document
79
+ * is not two documents.
80
+ */
81
+ export function splitCandidate(
82
+ activeFileId: number | string | null,
83
+ openIds: readonly (number | string)[],
84
+ ): number | string | null {
85
+ for (let index = openIds.length - 1; index >= 0; index -= 1) {
86
+ const id = openIds[index];
87
+ if (id !== activeFileId) return id;
88
+ }
89
+ return null;
90
+ }
91
+
92
+ /**
93
+ * The split state after the ACTIVE tab changed.
94
+ *
95
+ * The left pane follows the active tab, so a switch that lands on the tab the right pane
96
+ * already shows would draw one file twice. The split collapses in that case rather than
97
+ * silently re-picking a different right pane: the user asked to look at that file, and the
98
+ * whole column showing it is the honest answer.
99
+ */
100
+ export function splitAfterActivate(state: SplitEditorState, activeFileId: number | string | null): SplitEditorState {
101
+ if (state.rightFileId === null) return state;
102
+ if (state.rightFileId !== activeFileId) return state;
103
+ return { ...state, rightFileId: null };
104
+ }
105
+
106
+ /** Clamp a dragged divider position into the bounds above. */
107
+ export function clampSplitFraction(fraction: number): number {
108
+ if (!Number.isFinite(fraction)) return DEFAULT_SPLIT.fraction;
109
+ return Math.max(MIN_SPLIT_FRACTION, Math.min(MAX_SPLIT_FRACTION, fraction));
110
+ }
111
+
112
+ /**
113
+ * The split's state read from a session blob, defended.
114
+ *
115
+ * A persisted `rightFileId` for a tab that no longer exists is DROPPED rather than trusted:
116
+ * the split would otherwise open onto a pane that cannot render, and the only way out would
117
+ * be to close a pane nobody can see.
118
+ */
119
+ export function readSplitState(raw: unknown, openIds: readonly (number | string)[]): SplitEditorState {
120
+ if (typeof raw !== 'object' || raw === null) return DEFAULT_SPLIT;
121
+ const value = raw as { rightFileId?: unknown; fraction?: unknown };
122
+ const fraction = typeof value.fraction === 'number' ? clampSplitFraction(value.fraction) : DEFAULT_SPLIT.fraction;
123
+ const rightFileId =
124
+ typeof value.rightFileId === 'string' || typeof value.rightFileId === 'number' ? value.rightFileId : null;
125
+ if (rightFileId === null || !openIds.includes(rightFileId)) {
126
+ return { rightFileId: null, fraction };
127
+ }
128
+ return { rightFileId, fraction };
129
+ }
@@ -0,0 +1,124 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * The desktop workspace group's three panel widths, resolved from one place.
8
+ *
9
+ * `WorkspacePanels` used to compute these inline, which was correct but made the
10
+ * component's own contract hard to read and impossible to unit-test: every rule
11
+ * here — the two-call order, the pair caps, the leftover width a collapsed chat
12
+ * hands the editor — is arithmetic over values the caller already has.
13
+ *
14
+ * Pure: no hooks, no DOM. The caller measures the group and reads the stored
15
+ * widths; this module decides what those mean.
16
+ */
17
+
18
+ import {
19
+ DEFAULT_EDITOR_FRACTIONS,
20
+ DEFAULT_EDITOR_WIDTHS,
21
+ HANDLE_WIDTH,
22
+ MIN_EDITOR_PANEL_WIDTH,
23
+ panelFraction,
24
+ pairMaxSize,
25
+ resolvePanelWidth,
26
+ type EditorWidthMode,
27
+ type PanelWidths,
28
+ } from '@/shared/lib/workspace/panel-widths';
29
+ import { DEFAULT_RIGHT_PANEL_FRACTION } from '@/shared/lib/workspace/right-panels';
30
+
31
+ export interface WorkspacePanelWidthsArgs {
32
+ /** Measured area of the group, or null before the observer reports. */
33
+ available: number | null;
34
+ /** This session's remembered widths. */
35
+ panelWidths: PanelWidths;
36
+ /** Which slot the editor column is using (a diff wants more room). */
37
+ editorWidthMode: EditorWidthMode;
38
+ /** The right panel's active view, whose slot and defaults apply. */
39
+ activeRightPanel: string;
40
+ /** The active view's own defaults and floor, when it has them. */
41
+ activePanel?: { defaultFraction?: number; defaultWidth?: number; minWidth?: number };
42
+ showEditor: boolean;
43
+ showRightPanel: boolean;
44
+ /** The chat column is collapsed, so it holds no floor and no pair share. */
45
+ chatHidden: boolean;
46
+ }
47
+
48
+ export interface WorkspacePanelWidths {
49
+ right: number;
50
+ editor: number;
51
+ /** Drag ceilings; `undefined` before the group is measured. */
52
+ editorMax: number | undefined;
53
+ rightMax: number | undefined;
54
+ /** Separators actually rendered, which also consume width. */
55
+ handleCount: number;
56
+ /** The right panel's floor, which the drag ceiling also reserves. */
57
+ rightMin: number;
58
+ }
59
+
60
+ export function resolveWorkspacePanelWidths(args: WorkspacePanelWidthsArgs): WorkspacePanelWidths {
61
+ const { available, panelWidths, editorWidthMode, activeRightPanel, activePanel, showEditor, showRightPanel, chatHidden } = args;
62
+
63
+ // The separator before the editor is gone while the chat is collapsed: there
64
+ // is nothing on its left to transfer width to, and the drag's neighbour walk
65
+ // skips a collapsed panel, so it would render a handle that does nothing.
66
+ const handleCount = (showEditor && !chatHidden ? 1 : 0) + (showRightPanel ? 1 : 0);
67
+ const rightMin = activePanel?.minWidth ?? MIN_EDITOR_PANEL_WIDTH;
68
+
69
+ // The editor and the right panel are a COUPLED pair: the right panel is
70
+ // resolved first, reserving the editor's WANTED share (the editor has no
71
+ // result yet), and the editor then reserves the right panel's ACTUAL width.
72
+ // That asymmetry is deliberate — an editor asking for more than its default
73
+ // makes the right panel give way first, and the pair still sums to the total.
74
+ const editorFraction = panelFraction(panelWidths[editorWidthMode], DEFAULT_EDITOR_FRACTIONS[editorWidthMode], available);
75
+ const editorReservePx = available != null && available > 0 ? Math.round(editorFraction * available) : 0;
76
+
77
+ const right = resolvePanelWidth({
78
+ stored: panelWidths.right?.[activeRightPanel],
79
+ defaultFraction: activePanel?.defaultFraction ?? DEFAULT_RIGHT_PANEL_FRACTION,
80
+ defaultPx: activePanel?.defaultWidth ?? MIN_EDITOR_PANEL_WIDTH,
81
+ available,
82
+ min: rightMin,
83
+ pairReservePx: showEditor ? editorReservePx : 0,
84
+ // The editor has not been resolved yet, so only its floor can be reserved.
85
+ siblingWidth: showEditor ? MIN_EDITOR_PANEL_WIDTH : 0,
86
+ handleCount,
87
+ chatHidden,
88
+ });
89
+
90
+ // With the chat collapsed the editor takes everything the right panel and the
91
+ // separators do not. Resolving from its remembered FRACTION would leave the
92
+ // freed width as an empty gap, which is the opposite of what the mode
93
+ // promises; the remembered width is untouched, so leaving restores it.
94
+ const editor = chatHidden
95
+ ? Math.max(
96
+ MIN_EDITOR_PANEL_WIDTH,
97
+ available != null && available > 0
98
+ ? Math.floor(available - (showRightPanel ? right : 0) - handleCount * HANDLE_WIDTH)
99
+ : DEFAULT_EDITOR_WIDTHS[editorWidthMode],
100
+ )
101
+ : resolvePanelWidth({
102
+ stored: panelWidths[editorWidthMode],
103
+ defaultFraction: DEFAULT_EDITOR_FRACTIONS[editorWidthMode],
104
+ defaultPx: DEFAULT_EDITOR_WIDTHS[editorWidthMode],
105
+ available,
106
+ min: MIN_EDITOR_PANEL_WIDTH,
107
+ pairReservePx: showRightPanel ? right : 0,
108
+ siblingWidth: showRightPanel ? right : 0,
109
+ handleCount,
110
+ });
111
+
112
+ return {
113
+ right,
114
+ editor,
115
+ // `resolvePanelWidth` caps what it HANDS to `defaultSize`, but a separator
116
+ // drag bypasses it — the resizer transfers pixels between two panels clamped
117
+ // only by their own `maxSize`. Each max is its own cap and the pair total
118
+ // minus the sibling's FLOOR (it gives way down to its minimum mid-drag).
119
+ editorMax: pairMaxSize({ available, siblingMin: rightMin, siblingOpen: showRightPanel, chatHidden }),
120
+ rightMax: pairMaxSize({ available, siblingMin: MIN_EDITOR_PANEL_WIDTH, siblingOpen: showEditor, chatHidden }),
121
+ handleCount,
122
+ rightMin,
123
+ };
124
+ }
@@ -32,3 +32,32 @@ export interface SidebarStatusEntry {
32
32
 
33
33
  /** `sidebar:status` — keyed by session id. Absent id means "no volatile fields". */
34
34
  export type SidebarStatusPayload = Record<string, SidebarStatusEntry>;
35
+
36
+ /**
37
+ * One live session's row fields that can still move between turn boundaries.
38
+ *
39
+ * Exactly two, and the list is closed on purpose: everything else about a row
40
+ * (title, folder, cwd, worktree, archived) only changes on a STRUCTURAL event
41
+ * that publishes the structure for its own reason. These two are the ones a
42
+ * run advances mid-turn — the transcript appends, and a subagent's transcript
43
+ * appears beside it (which is what lights the row's roster chevron).
44
+ */
45
+ export interface SidebarActivityEntry {
46
+ /** Newest transcript entry's ISO timestamp — the row's age and its
47
+ * `LATEST_SESSION` position. */
48
+ updatedAt?: string;
49
+ /** Whether the session has any subagent transcript on disk. */
50
+ hasSubagents?: boolean;
51
+ }
52
+
53
+ /**
54
+ * `sidebar:activity` — session id → the live fields above, for the sessions
55
+ * with a run in flight.
56
+ *
57
+ * Only a running session can move between turn boundaries, so an id that is
58
+ * absent here simply keeps what the structure gave it. Both sides read the same
59
+ * sources (the newest JSONL entry's own `timestamp`, and the subagent
60
+ * transcript directory), so the client merges field by field and lets the
61
+ * newer stamp win.
62
+ */
63
+ export type SidebarActivityPayload = Record<string, SidebarActivityEntry>;
@@ -48,6 +48,16 @@ export interface SettingsState {
48
48
  * cannot render a broken editor, only a different one.
49
49
  */
50
50
  editorFont: string;
51
+ /**
52
+ * Colour theme for the code editor, INDEPENDENT of `theme` above.
53
+ *
54
+ * `auto` (the default) keeps the editor on the app palette. Any other value
55
+ * is a Shiki theme id from `EDITOR_THEMES` — the editor then paints its own
56
+ * surface, gutter, selection and tokens while the console around it keeps the
57
+ * app palette. `resolveEditorTheme` treats an id this build no longer ships
58
+ * as `auto`, so a downgrade renders the app palette rather than half a theme.
59
+ */
60
+ editorTheme: string;
51
61
  /** Generate a session title from the first run. omp suppresses its
52
62
  * own auto-titling under `--mode rpc-ui` (PI_NO_TITLE), so without this a
53
63
  * Kabmo session keeps its `New Session - <timestamp>` placeholder. Asked
@@ -64,13 +64,40 @@ export function diskHas(disk: Disk, path: string): boolean {
64
64
  return (disk[dir] ?? {})[name] !== undefined;
65
65
  }
66
66
 
67
+ /**
68
+ * The directories a single-child folder chain runs through, starting at `path`.
69
+ *
70
+ * Mirrors `folderChain` in `src/server/lib/fs/listing.ts`, including where it
71
+ * stops: a folder holding exactly one FOLDER continues the chain, and a file, a
72
+ * second entry or an empty folder ends it. The harness has to fold like the
73
+ * server does or a spec would assert a tree the real listing never produces.
74
+ */
75
+ function chainFrom(disk: Disk, path: string): string[] {
76
+ const segments = [path.slice(path.lastIndexOf('/') + 1)];
77
+ let current = path;
78
+ for (let depth = 1; depth < 32; depth += 1) {
79
+ const dir = disk[current];
80
+ const entries = Object.keys(dir ?? {});
81
+ if (entries.length !== 1 || dir![entries[0]!] !== null) return segments;
82
+ current = `${current}/${entries[0]}`;
83
+ segments.push(entries[0]!);
84
+ }
85
+ return segments;
86
+ }
87
+
67
88
  /** One directory's entries as the server emits them: folders with `children: null`. */
68
89
  export function entriesOf(disk: Disk, path: string): unknown[] {
69
90
  const dir = disk[path] ?? {};
70
91
  return Object.keys(dir).map((child) => {
71
92
  const rel = path === '.' ? child : `${path}/${child}`;
72
- return dir[child] === null
73
- ? { id: rel, name: child, type: 'folder', path: rel, children: null, ignored: false }
74
- : { id: rel, name: child, type: 'file', path: rel, ignored: false };
93
+ if (dir[child] !== null) return { id: rel, name: child, type: 'file', path: rel, ignored: false };
94
+ // A folder holding exactly one folder is one collapsed row naming the chain,
95
+ // whose path is the DEEPEST directory — the one whose contents it shows.
96
+ const chain = chainFrom(disk, rel);
97
+ if (chain.length > 1) {
98
+ const deep = `${rel}/${chain.slice(1).join('/')}`;
99
+ return { id: deep, name: chain.join('/'), type: 'folder', path: deep, children: null, ignored: false };
100
+ }
101
+ return { id: rel, name: child, type: 'folder', path: rel, children: null, ignored: false };
75
102
  });
76
103
  }
@@ -0,0 +1,183 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+
6
+ /**
7
+ * Real loopback listeners and real processes for the lifecycle suites.
8
+ *
9
+ * `probe`, `claimPort` and `findOccupant` all answer questions about sockets
10
+ * and PIDs, so a double would test the double: every case here drives actual
11
+ * listeners on OS-assigned ports and actual processes. The harness exists
12
+ * because those suites are split by subject (the address rules, the health
13
+ * probe, the lock, the claim) and each needs the same six fixtures — a copy per
14
+ * file is how one of them quietly stops covering both loopback families.
15
+ *
16
+ * Two properties are load-bearing:
17
+ *
18
+ * - `localhost` is TWO addresses. A fixture that holds one family and expects
19
+ * the other to read free must first find a port free on both, because the OS
20
+ * assigns per family.
21
+ * - A live PID that is not ours is what a test about ANOTHER instance needs:
22
+ * the guard reads a listener reporting `process.pid` as this very process
23
+ * re-binding (the `bun run --hot` case), which is the opposite of a refusal.
24
+ */
25
+
26
+ import { expect } from 'bun:test';
27
+ import type { Server } from 'bun';
28
+ import net from 'node:net';
29
+
30
+ import { getProcessState } from '@/server/lib/lifecycle/identity';
31
+ import { isPortAvailable, waitForPortFree } from '@/server/lib/lifecycle/probe';
32
+
33
+ /**
34
+ * The runner's own fetch, reached through `Bun` so a stub another file left on
35
+ * the global cannot be mistaken for it. Every case here talks to a real
36
+ * listener, and `findOccupant` asks one over `fetch`.
37
+ */
38
+ export const realFetch = Bun.fetch;
39
+
40
+ async function probeIpv6Loopback(): Promise<boolean> {
41
+ const { promise, resolve } = Promise.withResolvers<boolean>();
42
+ const probe = net.createServer();
43
+ probe.once('error', () => resolve(false));
44
+ probe.listen({ port: 0, host: '::1' }, () => {
45
+ probe.close(() => resolve(true));
46
+ });
47
+ return await promise;
48
+ }
49
+
50
+ /**
51
+ * Whether this host has a usable IPv6 loopback.
52
+ *
53
+ * A kernel booted without IPv6 answers `EADDRNOTAVAIL` for `::1`, where a
54
+ * case about the two addresses of `localhost` cannot observe anything at all.
55
+ * Skipped BY NAME rather than weakened: an assertion that silently holds on one
56
+ * family would pass while the bug was live.
57
+ */
58
+ export const ipv6Loopback = await probeIpv6Loopback();
59
+
60
+ export interface LoopbackHarness {
61
+ /** A live listener on an OS-assigned port, plus the number it got. */
62
+ occupy(
63
+ fetch: (request: Request) => Response | Promise<Response>,
64
+ hostname?: string,
65
+ ): { server: Server<undefined>; port: number };
66
+ /** A live listener on a specific port and address. */
67
+ occupyAt(port: number, hostname: string, fetch?: (request: Request) => Response): Server<undefined>;
68
+ /** An OS-assigned port, released and confirmed free. */
69
+ freePort(): Promise<number>;
70
+ /** An OS-assigned port free on BOTH loopback families. */
71
+ freePortBothFamilies(): Promise<number>;
72
+ /** A live process that is not this one; killed by `dispose`. */
73
+ livePid(): Promise<number>;
74
+ /** A real process whose argv says `kabmo`, i.e. `matched` to identity.ts. */
75
+ spawnChamberHolder(): Promise<Bun.Subprocess>;
76
+ /** A PID that has exited and been reaped, so it reads as `dead`. */
77
+ deadPid(): Promise<number>;
78
+ /** Stop every listener and kill every child this harness started. */
79
+ dispose(): Promise<void>;
80
+ }
81
+
82
+ export function createLoopbackHarness(): LoopbackHarness {
83
+ const servers: Server<undefined>[] = [];
84
+ const children: Bun.Subprocess[] = [];
85
+
86
+ function occupy(
87
+ fetch: (request: Request) => Response | Promise<Response>,
88
+ hostname = '127.0.0.1',
89
+ ): { server: Server<undefined>; port: number } {
90
+ const server = Bun.serve({ port: 0, hostname, fetch }) as Server<undefined>;
91
+ const port = server.port;
92
+ if (port === undefined) throw new Error('the OS did not assign an ephemeral port');
93
+ servers.push(server);
94
+ return { server, port };
95
+ }
96
+
97
+ function occupyAt(
98
+ port: number,
99
+ hostname: string,
100
+ fetch: (request: Request) => Response = () => new Response('held'),
101
+ ): Server<undefined> {
102
+ const server = Bun.serve({ port, hostname, fetch }) as Server<undefined>;
103
+ servers.push(server);
104
+ return server;
105
+ }
106
+
107
+ function forget(server: Server<undefined>): void {
108
+ const index = servers.indexOf(server);
109
+ if (index >= 0) servers.splice(index, 1);
110
+ }
111
+
112
+ async function freePort(): Promise<number> {
113
+ // Bun closes a stopped listener's socket on a later event-loop turn, so an
114
+ // immediate check would be a race, not a test.
115
+ const held = occupy(() => new Response('unused'));
116
+ held.server.stop(true);
117
+ forget(held.server);
118
+ if (!(await waitForPortFree(held.port, '127.0.0.1', 2_000, 25))) {
119
+ throw new Error(`ephemeral port ${held.port} never became free`);
120
+ }
121
+ return held.port;
122
+ }
123
+
124
+ async function freePortBothFamilies(): Promise<number> {
125
+ for (let attempt = 0; attempt < 10; attempt += 1) {
126
+ const candidate = await freePort();
127
+ if (await isPortAvailable(candidate, '::1')) return candidate;
128
+ }
129
+ throw new Error('the OS handed out no ephemeral port free on both loopback families');
130
+ }
131
+
132
+ async function livePid(): Promise<number> {
133
+ const child = Bun.spawn({
134
+ cmd: ['bun', '-e', 'await new Promise(() => {})'],
135
+ stdout: 'ignore',
136
+ stderr: 'ignore',
137
+ });
138
+ children.push(child);
139
+ return child.pid;
140
+ }
141
+
142
+ async function spawnChamberHolder(): Promise<Bun.Subprocess> {
143
+ // The child announces itself before it parks, and that line is what says the
144
+ // OS has finished `exec`: a freshly spawned process's command line is
145
+ // unreadable for the instant between fork and exec, so Linux's probe falls
146
+ // back to `comm` and identity answers `mismatched` for a process that IS
147
+ // ours. Production reads a PID out of a lock file written long before, so it
148
+ // never sees that window — no fixed delay to guess at here.
149
+ const child = Bun.spawn({
150
+ cmd: ['bun', '-e', 'console.log("ready"); await new Promise(() => {})', 'kabmo-holder'],
151
+ stdout: 'pipe',
152
+ stderr: 'ignore',
153
+ });
154
+ children.push(child);
155
+ const reader = (child.stdout as ReadableStream<Uint8Array>).getReader();
156
+ await reader.read();
157
+ reader.releaseLock();
158
+ expect(getProcessState(child.pid)).toBe('matched');
159
+ return child;
160
+ }
161
+
162
+ async function deadPid(): Promise<number> {
163
+ const child = Bun.spawn({ cmd: ['bun', '-e', 'process.exit(0)'], stdout: 'ignore', stderr: 'ignore' });
164
+ const pid = child.pid;
165
+ await child.exited;
166
+ expect(getProcessState(pid)).toBe('dead');
167
+ return pid;
168
+ }
169
+
170
+ async function dispose(): Promise<void> {
171
+ for (const child of children.splice(0)) {
172
+ try {
173
+ child.kill('SIGKILL');
174
+ await child.exited;
175
+ } catch {
176
+ // Already gone.
177
+ }
178
+ }
179
+ for (const server of servers.splice(0)) server.stop(true);
180
+ }
181
+
182
+ return { occupy, occupyAt, freePort, freePortBothFamilies, livePid, spawnChamberHolder, deadPid, dispose };
183
+ }
@@ -30,6 +30,13 @@ export const pristineWebSocket = globalThis.WebSocket;
30
30
  export const DOM_TEST_GLOBALS = [
31
31
  'window', 'document', 'navigator', 'Node', 'Element', 'HTMLElement',
32
32
  'Event', 'CustomEvent', 'WebSocket', 'EventSource',
33
+ // The three DOM data classes, because a suite that swaps `window` usually needs them and
34
+ // a LOCAL save-and-restore loop is how they leaked: `editor/save-as.test.ts` installed
35
+ // happy-dom's `File`/`Blob` and never put them back, so a later file's `carriesBytes` read
36
+ // a happy-dom `File` whose `slice().arrayBuffer()` answered empty and reported that a real
37
+ // file held no bytes — a failure in a suite that file does not name. Listed here, they are
38
+ // captured on the first install and restored with the rest.
39
+ 'FormData', 'File', 'Blob',
33
40
  ] as const;
34
41
 
35
42
  /**