kaizen-agent 1.85.2 → 1.87.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 (545) hide show
  1. package/README.md +1 -1
  2. package/cli/annotate-proxy.ts +6 -3
  3. package/cli/build-web.ts +46 -16
  4. package/cli/dev.ts +67 -0
  5. package/cli/docs.ts +1 -1
  6. package/cli/notes.ts +9 -3
  7. package/cli/ports.ts +121 -0
  8. package/cli/rea.ts +99 -11
  9. package/cli/settings.ts +16 -17
  10. package/cli/state.ts +15 -29
  11. package/cli/task-service.ts +114 -34
  12. package/cli/tasks.ts +8 -2
  13. package/cli/term-image.ts +18 -0
  14. package/cli/ui-audit.allow.json +0 -1
  15. package/cli/ui-audit.ts +12 -12
  16. package/cli/web.ts +197 -61
  17. package/package.json +21 -4
  18. package/skills/kaizen/spec.md +12 -4
  19. package/skills/optional/disk-cleanup/SKILL.md +60 -0
  20. package/skills/optional/disk-cleanup/skill.json +1 -0
  21. package/skills/optional/disk-cleanup/tui.py +90 -0
  22. package/tsconfig.json +16 -0
  23. package/web/README.md +105 -0
  24. package/web/{annotate.js → annotate/annotate.ts} +51 -50
  25. package/web/boot/boot.ts +7 -0
  26. package/web/components/annotate/annotate-bar.tsx +78 -0
  27. package/web/components/annotate/annotate-panel.tsx +20 -0
  28. package/web/components/annotate/annotate-settings.tsx +60 -0
  29. package/web/components/annotate/index.ts +1 -0
  30. package/web/components/annotate/notes-list.tsx +75 -0
  31. package/web/components/board/board-card.tsx +177 -0
  32. package/web/components/board/board-column.tsx +212 -0
  33. package/web/components/board/board-mode-switch.tsx +21 -0
  34. package/web/components/board/board-popups.tsx +45 -0
  35. package/web/components/board/card-footer.tsx +58 -0
  36. package/web/components/board/card-form.tsx +168 -0
  37. package/web/components/board/card-kids.tsx +53 -0
  38. package/web/components/board/clear-menu.tsx +36 -0
  39. package/web/components/board/filter-box.tsx +42 -0
  40. package/web/components/board/index.ts +6 -0
  41. package/web/components/board/run-form.tsx +129 -0
  42. package/web/components/board/severity-menu.tsx +44 -0
  43. package/web/components/board/status-strip.tsx +75 -0
  44. package/web/components/board/task-form.tsx +140 -0
  45. package/web/components/board/ws-card.tsx +38 -0
  46. package/web/components/context/context-panel.tsx +244 -0
  47. package/web/components/context/index.ts +1 -0
  48. package/web/components/decision/decision-bar.tsx +422 -0
  49. package/web/components/decision/index.ts +1 -0
  50. package/web/components/decision/inline-form.tsx +47 -0
  51. package/web/components/decision/plan-answers-form.tsx +78 -0
  52. package/web/components/decision/revise-form.tsx +65 -0
  53. package/web/components/decision/task-reply-form.tsx +48 -0
  54. package/web/components/footer/foot-bar.tsx +67 -0
  55. package/web/components/footer/index.ts +1 -0
  56. package/web/components/git/git-ask.tsx +88 -0
  57. package/web/components/git/git-commits.tsx +53 -0
  58. package/web/components/git/git-confirm.tsx +78 -0
  59. package/web/components/git/git-counts.tsx +10 -0
  60. package/web/components/git/git-files.tsx +113 -0
  61. package/web/components/git/git-head.tsx +70 -0
  62. package/web/components/git/git-icon.tsx +25 -0
  63. package/web/components/git/git-message.tsx +44 -0
  64. package/web/components/git/git-split.tsx +64 -0
  65. package/web/components/git/git-tab.tsx +55 -0
  66. package/web/components/git/index.ts +1 -0
  67. package/web/components/home/chat-list.tsx +57 -0
  68. package/web/components/home/home-composer.tsx +169 -0
  69. package/web/components/home/home-message.tsx +120 -0
  70. package/web/components/home/home-window.tsx +253 -0
  71. package/web/components/home/home-ws-add.tsx +47 -0
  72. package/web/components/home/index.ts +6 -0
  73. package/web/components/home/onboarding-dialog.tsx +371 -0
  74. package/web/components/icebox/board-chip.tsx +27 -0
  75. package/web/components/icebox/board-menu.tsx +41 -0
  76. package/web/components/icebox/bulk-bar.tsx +41 -0
  77. package/web/components/icebox/capture-box.tsx +155 -0
  78. package/web/components/icebox/choice-menu.tsx +39 -0
  79. package/web/components/icebox/collection-dialog.tsx +60 -0
  80. package/web/components/icebox/favicon.tsx +39 -0
  81. package/web/components/icebox/index.ts +10 -0
  82. package/web/components/icebox/kind-label.tsx +22 -0
  83. package/web/components/icebox/kind-menu.tsx +20 -0
  84. package/web/components/icebox/promote-form.tsx +93 -0
  85. package/web/components/icebox/reply-box.tsx +88 -0
  86. package/web/components/icebox/request-actions.tsx +141 -0
  87. package/web/components/icebox/request-badges.tsx +13 -0
  88. package/web/components/icebox/request-card.tsx +99 -0
  89. package/web/components/icebox/request-detail.tsx +43 -0
  90. package/web/components/icebox/request-images.tsx +33 -0
  91. package/web/components/icebox/request-phone-row.tsx +181 -0
  92. package/web/components/icebox/request-row.tsx +120 -0
  93. package/web/components/icebox/service-chip.tsx +58 -0
  94. package/web/components/icebox/snooze-menu.tsx +83 -0
  95. package/web/components/icebox/source-card.tsx +225 -0
  96. package/web/components/icebox/source-drawer.tsx +112 -0
  97. package/web/components/icebox/source-form.tsx +147 -0
  98. package/web/components/icebox/swipe-deck.tsx +242 -0
  99. package/web/components/layout/index.ts +1 -0
  100. package/web/components/layout/page-frame.tsx +44 -0
  101. package/web/components/markdown/index.ts +1 -0
  102. package/web/components/markdown/markdown.tsx +156 -0
  103. package/web/components/notebook/editor-pane.tsx +23 -0
  104. package/web/components/notebook/index.ts +5 -0
  105. package/web/components/notebook/note-body.tsx +172 -0
  106. package/web/components/notebook/note-tree.tsx +99 -0
  107. package/web/components/notebook/notes-head.tsx +37 -0
  108. package/web/components/notebook/notes-side.tsx +46 -0
  109. package/web/components/notes/index.ts +1 -0
  110. package/web/components/notes/note-composer.tsx +90 -0
  111. package/web/components/notes/notes-chat.tsx +58 -0
  112. package/web/components/panes/browser-pane.tsx +281 -0
  113. package/web/components/panes/index.ts +3 -0
  114. package/web/components/panes/preview-pane.tsx +91 -0
  115. package/web/components/panes/terminal-pane.tsx +52 -0
  116. package/web/components/phone/haptic.tsx +29 -0
  117. package/web/components/phone/index.ts +6 -0
  118. package/web/components/phone/phone-card.tsx +118 -0
  119. package/web/components/phone/phone-home.tsx +304 -0
  120. package/web/components/phone/phone-sheets.tsx +103 -0
  121. package/web/components/phone/qr-code.tsx +6 -0
  122. package/web/components/phone/usage-chips.tsx +85 -0
  123. package/web/components/phone/whatsapp-card.tsx +85 -0
  124. package/web/components/project/add-project-dialog.tsx +435 -0
  125. package/web/components/project/index.ts +3 -0
  126. package/web/components/project/project-bar.tsx +101 -0
  127. package/web/components/project/ws-menu.tsx +21 -0
  128. package/web/components/rail/agent-chips.tsx +110 -0
  129. package/web/components/rail/index.ts +4 -0
  130. package/web/components/rail/rail-filter.tsx +118 -0
  131. package/web/components/rail/rail-list.tsx +259 -0
  132. package/web/components/rail/source-marks.tsx +21 -0
  133. package/web/components/resources/index.ts +1 -0
  134. package/web/components/resources/resources-popup.tsx +490 -0
  135. package/web/components/run/doc-body.tsx +123 -0
  136. package/web/components/run/file-viewer.tsx +53 -0
  137. package/web/components/run/fix-form.tsx +88 -0
  138. package/web/components/run/index.ts +16 -0
  139. package/web/components/run/inline-md.tsx +30 -0
  140. package/web/components/run/key-hint.tsx +29 -0
  141. package/web/components/run/pane-gutter.tsx +52 -0
  142. package/web/components/run/pane-header.tsx +35 -0
  143. package/web/components/run/pane.tsx +140 -0
  144. package/web/components/run/panel-grip.tsx +49 -0
  145. package/web/components/run/panel-head.tsx +56 -0
  146. package/web/components/run/panel-tabs.tsx +35 -0
  147. package/web/components/run/phase-steps.tsx +37 -0
  148. package/web/components/run/project-notes.tsx +49 -0
  149. package/web/components/run/run-add-menu.tsx +80 -0
  150. package/web/components/run/run-bar.tsx +40 -0
  151. package/web/components/run/run-empty.tsx +10 -0
  152. package/web/components/run/run-footer.tsx +53 -0
  153. package/web/components/run/run-history.tsx +24 -0
  154. package/web/components/run/run-panes.tsx +78 -0
  155. package/web/components/run/run-picker.tsx +51 -0
  156. package/web/components/run/run-progress.tsx +30 -0
  157. package/web/components/run/run-tabs.tsx +147 -0
  158. package/web/components/run/run-wait.tsx +18 -0
  159. package/web/components/search/index.ts +1 -0
  160. package/web/components/search/search-palette.tsx +159 -0
  161. package/web/components/settings/account-rows.tsx +128 -0
  162. package/web/components/settings/agent-rows.tsx +249 -0
  163. package/web/components/settings/automation-rows.tsx +211 -0
  164. package/web/components/settings/browser-row.tsx +111 -0
  165. package/web/components/settings/cleanup-row.tsx +32 -0
  166. package/web/components/settings/commit-input.tsx +39 -0
  167. package/web/components/settings/index.ts +4 -0
  168. package/web/components/settings/integration-row.tsx +158 -0
  169. package/web/components/settings/mic-row.tsx +48 -0
  170. package/web/components/settings/orchestration-flow.tsx +87 -0
  171. package/web/components/settings/setting-row.tsx +131 -0
  172. package/web/components/settings/settings-item.tsx +78 -0
  173. package/web/components/settings/settings-loading.tsx +41 -0
  174. package/web/components/settings/settings-nav.tsx +119 -0
  175. package/web/components/settings/settings-scope.tsx +66 -0
  176. package/web/components/settings/settings-section.tsx +33 -0
  177. package/web/components/settings/skill-card.tsx +131 -0
  178. package/web/components/settings/stepper.tsx +74 -0
  179. package/web/components/settings/update-bar.tsx +167 -0
  180. package/web/components/shared/action-menu.tsx +76 -0
  181. package/web/components/shared/ask-host.tsx +18 -0
  182. package/web/components/shared/attach-button.tsx +23 -0
  183. package/web/components/shared/chip.tsx +19 -0
  184. package/web/components/shared/client-mark.tsx +15 -0
  185. package/web/components/shared/confirm-dialog.tsx +35 -0
  186. package/web/components/shared/empty-state.tsx +29 -0
  187. package/web/components/shared/field.tsx +77 -0
  188. package/web/components/shared/filter-popover.tsx +29 -0
  189. package/web/components/shared/form-frame.tsx +19 -0
  190. package/web/components/shared/icon-button.tsx +50 -0
  191. package/web/components/shared/index.ts +18 -0
  192. package/web/components/shared/mic-button.tsx +75 -0
  193. package/web/components/shared/pager.tsx +49 -0
  194. package/web/components/shared/picker.tsx +108 -0
  195. package/web/components/shared/project-mark.tsx +38 -0
  196. package/web/components/shared/segmented.tsx +43 -0
  197. package/web/components/shared/state-dot.tsx +4 -0
  198. package/web/components/shared/status-mark.tsx +26 -0
  199. package/web/components/shell/index.ts +3 -0
  200. package/web/components/shell/rail.tsx +259 -0
  201. package/web/components/shell/sprite.tsx +124 -0
  202. package/web/components/shell/wordmark.tsx +13 -0
  203. package/web/components/task/artifact-view.tsx +148 -0
  204. package/web/components/task/chat-bubble.tsx +43 -0
  205. package/web/components/task/filter-menu.tsx +38 -0
  206. package/web/components/task/index.ts +7 -0
  207. package/web/components/task/result-checks.tsx +34 -0
  208. package/web/components/task/result-view.tsx +103 -0
  209. package/web/components/task/status-badge.tsx +24 -0
  210. package/web/components/task/task-row.tsx +34 -0
  211. package/web/components/task/typing-dots.tsx +16 -0
  212. package/web/components/terminal/index.ts +3 -0
  213. package/web/components/terminal/terminal-bar.tsx +91 -0
  214. package/web/components/terminal/terminal-grid.tsx +149 -0
  215. package/web/components/terminal/terminal-modes.tsx +23 -0
  216. package/web/components/terminal/terminal-tile.tsx +139 -0
  217. package/web/dist/annotate.js +24 -0
  218. package/web/dist/board.css +718 -0
  219. package/web/dist/board.js +115 -0
  220. package/web/dist/boot.js +2 -0
  221. package/web/dist/notebook.css +319 -0
  222. package/web/dist/notebook.js +89 -0
  223. package/web/dist/popup.css +41 -0
  224. package/web/dist/popup.js +13 -0
  225. package/web/{term.js → dist/term.js} +48 -48
  226. package/web/dist/ui.css +3 -0
  227. package/web/dist/video.js +108 -0
  228. package/web/html/board.html +17 -0
  229. package/web/html/notes.html +14 -0
  230. package/web/html/popup.html +13 -0
  231. package/web/{video.html → html/video.html} +14 -15
  232. package/web/lib/annotate/index.ts +2 -0
  233. package/web/lib/annotate/notes.ts +105 -0
  234. package/web/lib/annotate/page.ts +121 -0
  235. package/web/lib/annotate/rules.ts +37 -0
  236. package/web/lib/annotate/session.ts +336 -0
  237. package/web/lib/board/board-actions.ts +119 -0
  238. package/web/lib/board/board-open.ts +12 -0
  239. package/web/lib/board/board-store.ts +159 -0
  240. package/web/lib/board/filter-box.ts +7 -0
  241. package/web/lib/board/index.ts +10 -0
  242. package/web/lib/board/nav.ts +29 -0
  243. package/web/lib/board/on-state.ts +90 -0
  244. package/web/lib/board/popups.ts +22 -0
  245. package/web/lib/board/snapshot.ts +105 -0
  246. package/web/lib/board/strip.ts +43 -0
  247. package/web/{board → lib/board}/ws-board.ts +1 -1
  248. package/web/lib/context/context-rules.ts +27 -0
  249. package/web/lib/context/context-store.ts +95 -0
  250. package/web/lib/context/feed.ts +28 -0
  251. package/web/lib/context/index.ts +3 -0
  252. package/web/lib/core/api.ts +86 -0
  253. package/web/lib/core/ask.ts +24 -0
  254. package/web/lib/core/board.ts +290 -0
  255. package/web/lib/core/brief.ts +31 -0
  256. package/web/lib/core/format.ts +8 -0
  257. package/web/lib/core/host.ts +107 -0
  258. package/web/lib/core/index.ts +16 -0
  259. package/web/{board → lib/core}/labels.ts +6 -5
  260. package/web/lib/core/layers.ts +7 -0
  261. package/web/lib/core/leave.ts +7 -0
  262. package/web/lib/core/motion.ts +10 -0
  263. package/web/{board/toast.ts → lib/core/notices.ts} +2 -20
  264. package/web/lib/core/notifier.ts +15 -0
  265. package/web/lib/core/store.ts +39 -0
  266. package/web/lib/core/term-handle.ts +8 -0
  267. package/web/lib/core/toast.ts +29 -0
  268. package/web/lib/core/utils.ts +15 -0
  269. package/web/lib/decision/index.ts +1 -0
  270. package/web/lib/decision/plan-questions.ts +39 -0
  271. package/web/lib/dictation/chunks.ts +93 -0
  272. package/web/lib/dictation/dictation-store.ts +22 -0
  273. package/web/lib/dictation/engine.ts +265 -0
  274. package/web/lib/dictation/index.ts +5 -0
  275. package/web/lib/dictation/mic.ts +42 -0
  276. package/web/lib/dictation/terminal-dictation.ts +50 -0
  277. package/web/lib/footer/footer-rules.ts +13 -0
  278. package/web/lib/footer/footer-store.ts +42 -0
  279. package/web/lib/footer/index.ts +2 -0
  280. package/web/lib/git/git-actions.ts +110 -0
  281. package/web/lib/git/git-panel.ts +43 -0
  282. package/web/lib/git/git-store.ts +47 -0
  283. package/web/lib/git/git.ts +170 -0
  284. package/web/lib/git/index.ts +4 -0
  285. package/web/lib/home/home-engine.ts +16 -0
  286. package/web/lib/home/home-events.ts +9 -0
  287. package/web/lib/home/home-store.ts +247 -0
  288. package/web/lib/home/home-window.ts +193 -0
  289. package/web/lib/home/home.ts +85 -0
  290. package/web/lib/home/index.ts +7 -0
  291. package/web/lib/home/onboarding.ts +199 -0
  292. package/web/lib/home/use-float-drag.ts +62 -0
  293. package/web/lib/icebox/icebox-actions.ts +518 -0
  294. package/web/lib/icebox/icebox-store.ts +112 -0
  295. package/web/lib/icebox/icebox-view.ts +48 -0
  296. package/web/lib/icebox/icebox.ts +273 -0
  297. package/web/lib/icebox/index.ts +8 -0
  298. package/web/lib/icebox/use-card-drag.ts +82 -0
  299. package/web/lib/icebox/use-ice-keys.ts +75 -0
  300. package/web/lib/icebox/use-icebox.ts +41 -0
  301. package/web/lib/icebox/use-row-swipe.ts +107 -0
  302. package/web/lib/markdown/index.ts +1 -0
  303. package/web/lib/markdown/markdown.ts +136 -0
  304. package/web/lib/notebook/autosave.ts +131 -0
  305. package/web/lib/notebook/deal.ts +58 -0
  306. package/web/lib/notebook/engine-complete.ts +128 -0
  307. package/web/lib/notebook/engine-preview.ts +287 -0
  308. package/web/lib/notebook/engine-types.ts +26 -0
  309. package/web/lib/notebook/engine-widgets.ts +218 -0
  310. package/web/lib/notebook/engine.ts +74 -0
  311. package/web/lib/notebook/index.ts +9 -0
  312. package/web/lib/notebook/kit-loader.ts +16 -0
  313. package/web/lib/notebook/kit.ts +12 -0
  314. package/web/{notes-lib.ts → lib/notebook/text.ts} +11 -10
  315. package/web/lib/notebook/vault-actions.ts +239 -0
  316. package/web/lib/notebook/vault-rules.ts +74 -0
  317. package/web/lib/notebook/vault-session.ts +73 -0
  318. package/web/lib/notebook/vault-store.ts +63 -0
  319. package/web/lib/notes/index.ts +4 -0
  320. package/web/lib/notes/md-html.ts +115 -0
  321. package/web/lib/notes/notes-actions.ts +32 -0
  322. package/web/lib/notes/notes-store.ts +22 -0
  323. package/web/lib/notes/notes.ts +58 -0
  324. package/web/{board → lib/notes}/rich.ts +1 -2
  325. package/web/lib/phone/index.ts +7 -0
  326. package/web/lib/phone/phone-actions.ts +77 -0
  327. package/web/lib/phone/phone-home.ts +102 -0
  328. package/web/lib/phone/phone-setup.ts +59 -0
  329. package/web/lib/phone/phone-sheet.ts +25 -0
  330. package/web/lib/phone/phone-store.ts +32 -0
  331. package/web/lib/phone/sheet-swipe.ts +55 -0
  332. package/web/lib/phone/use-phone-setup.ts +89 -0
  333. package/web/lib/project/add-project.ts +37 -0
  334. package/web/lib/project/branch.ts +14 -0
  335. package/web/lib/project/index.ts +5 -0
  336. package/web/lib/project/project-bar.ts +76 -0
  337. package/web/lib/project/project-pick.ts +36 -0
  338. package/web/lib/project/ws-menu.ts +8 -0
  339. package/web/lib/rail/agents.ts +63 -0
  340. package/web/lib/rail/card-links.ts +20 -0
  341. package/web/lib/rail/index.ts +7 -0
  342. package/web/lib/rail/rail-actions.ts +74 -0
  343. package/web/lib/rail/rail-boot.ts +99 -0
  344. package/web/lib/rail/rail-store.ts +85 -0
  345. package/web/lib/rail/rules.ts +241 -0
  346. package/web/lib/rail/source-marks.ts +17 -0
  347. package/web/lib/rail/use-rank-drag.ts +108 -0
  348. package/web/lib/resources/index.ts +3 -0
  349. package/web/lib/resources/resources-actions.ts +59 -0
  350. package/web/lib/resources/resources-store.ts +48 -0
  351. package/web/lib/resources/rules.ts +56 -0
  352. package/web/lib/router/index.ts +3 -0
  353. package/web/lib/router/route-rules.ts +96 -0
  354. package/web/lib/router/route-store.ts +115 -0
  355. package/web/lib/router/use-route-classes.ts +15 -0
  356. package/web/lib/run/browser.ts +53 -0
  357. package/web/lib/run/card-terminal.ts +32 -0
  358. package/web/lib/run/doc.ts +42 -0
  359. package/web/lib/run/grip.ts +8 -0
  360. package/web/lib/run/index.ts +19 -0
  361. package/web/lib/run/kept.ts +58 -0
  362. package/web/lib/run/layout-store.ts +156 -0
  363. package/web/lib/run/layout.ts +195 -0
  364. package/web/lib/run/panel-actions.ts +104 -0
  365. package/web/lib/run/panel-derive.ts +148 -0
  366. package/web/lib/run/panel-store.ts +125 -0
  367. package/web/lib/run/preview.ts +105 -0
  368. package/web/lib/run/run-actions.ts +118 -0
  369. package/web/lib/run/run-view-store.ts +134 -0
  370. package/web/lib/run/term-loader.ts +19 -0
  371. package/web/lib/run/use-panel-run.ts +125 -0
  372. package/web/lib/run/use-run-lifecycle.ts +70 -0
  373. package/web/lib/run/viewer.ts +12 -0
  374. package/web/lib/run/workspace.ts +281 -0
  375. package/web/lib/run/ws-actions.ts +293 -0
  376. package/web/lib/run/ws-derive.ts +50 -0
  377. package/web/lib/run/ws-draw.ts +102 -0
  378. package/web/lib/run/ws-store.ts +21 -0
  379. package/web/lib/run/ws-tabs.ts +125 -0
  380. package/web/lib/search/index.ts +3 -0
  381. package/web/lib/search/search-match.ts +48 -0
  382. package/web/lib/search/search-rows.ts +228 -0
  383. package/web/lib/search/search.ts +30 -0
  384. package/web/lib/search/use-search-rows.ts +22 -0
  385. package/web/lib/server/attention.ts +29 -0
  386. package/web/lib/server/index.ts +6 -0
  387. package/web/lib/server/poll-rules.ts +57 -0
  388. package/web/lib/server/poller.ts +210 -0
  389. package/web/lib/server/server-store.ts +39 -0
  390. package/web/lib/server/types.ts +31 -0
  391. package/web/lib/server/use-server.ts +19 -0
  392. package/web/lib/settings/agent-favicons.ts +14 -0
  393. package/web/lib/settings/index.ts +7 -0
  394. package/web/lib/settings/panel-settings.ts +29 -0
  395. package/web/lib/settings/settings-actions.ts +357 -0
  396. package/web/lib/settings/settings-store.ts +114 -0
  397. package/web/lib/settings/settings.ts +413 -0
  398. package/web/lib/settings/skill-icons.ts +24 -0
  399. package/web/lib/settings/update.ts +70 -0
  400. package/web/lib/shared/data-urls.ts +32 -0
  401. package/web/lib/shared/index.ts +4 -0
  402. package/web/lib/shared/use-draft.ts +38 -0
  403. package/web/lib/shared/use-narrow.ts +11 -0
  404. package/web/lib/shared/use-pager.ts +24 -0
  405. package/web/lib/shell/appearance.ts +97 -0
  406. package/web/lib/shell/help-store.ts +4 -0
  407. package/web/lib/shell/index.ts +4 -0
  408. package/web/lib/shell/shell-store.ts +23 -0
  409. package/web/lib/shell/stored-look.ts +47 -0
  410. package/web/lib/task/index.ts +7 -0
  411. package/web/lib/task/task-results.ts +92 -0
  412. package/web/lib/task/tasks.ts +132 -0
  413. package/web/lib/task/use-live-frame.ts +85 -0
  414. package/web/lib/task/use-saved-text.ts +25 -0
  415. package/web/lib/task/use-task.ts +161 -0
  416. package/web/lib/task/use-tasks.ts +50 -0
  417. package/web/{board → lib/task}/zoom.ts +25 -12
  418. package/web/lib/terminal/hidden-badge.ts +15 -0
  419. package/web/lib/terminal/index.ts +8 -0
  420. package/web/lib/terminal/layout.ts +138 -0
  421. package/web/{term-font.ts → lib/terminal/term-font.ts} +3 -2
  422. package/web/lib/terminal/terminal-store.ts +65 -0
  423. package/web/lib/terminal/terms-feed.ts +37 -0
  424. package/web/lib/terminal/use-arranged.ts +15 -0
  425. package/web/lib/terminal/use-terminal-keys.ts +37 -0
  426. package/web/lib/url/index.ts +1 -0
  427. package/web/lib/url/safe-url.ts +9 -0
  428. package/web/notebook/notebook.ts +27 -0
  429. package/web/notebook/notes-lib.ts +3 -0
  430. package/web/pages/board/App.tsx +76 -0
  431. package/web/pages/board/header.tsx +83 -0
  432. package/web/pages/board/help.tsx +59 -0
  433. package/web/pages/board/host-bridge.ts +94 -0
  434. package/web/pages/board/host.tsx +19 -0
  435. package/web/pages/board/keys.ts +112 -0
  436. package/web/pages/board/live.ts +39 -0
  437. package/web/pages/board/main.ts +32 -0
  438. package/web/pages/board/pages.tsx +86 -0
  439. package/web/pages/board/panel.tsx +157 -0
  440. package/web/pages/board/portal.tsx +39 -0
  441. package/web/pages/board/use-boot.ts +13 -0
  442. package/web/pages/board/views.ts +63 -0
  443. package/web/pages/board-page.tsx +62 -0
  444. package/web/pages/home-page.tsx +127 -0
  445. package/web/pages/icebox-page.tsx +440 -0
  446. package/web/pages/notebook/App.tsx +35 -0
  447. package/web/pages/notebook-page.tsx +50 -0
  448. package/web/pages/popup/App.tsx +207 -0
  449. package/web/pages/settings-page.tsx +111 -0
  450. package/web/pages/task-page.tsx +383 -0
  451. package/web/pages/tasks-page.tsx +151 -0
  452. package/web/pages/terminal-page.tsx +15 -0
  453. package/web/popup/popup.ts +7 -0
  454. package/web/term/term-paste.ts +10 -0
  455. package/web/{term.ts → term/term.ts} +101 -27
  456. package/web/ui/alert-dialog.tsx +39 -0
  457. package/web/ui/badge.tsx +20 -0
  458. package/web/ui/button.tsx +37 -0
  459. package/web/ui/checkbox.tsx +20 -0
  460. package/web/ui/command.tsx +41 -0
  461. package/web/ui/dialog.tsx +28 -0
  462. package/web/ui/dropdown-menu.tsx +54 -0
  463. package/web/ui/icon.tsx +17 -0
  464. package/web/ui/index.ts +21 -0
  465. package/web/ui/input.tsx +9 -0
  466. package/web/ui/label.tsx +7 -0
  467. package/web/ui/legacy/board.css +715 -0
  468. package/web/{notes.html → ui/legacy/notes.css} +23 -157
  469. package/web/ui/legacy/popup.css +40 -0
  470. package/web/ui/popover.tsx +28 -0
  471. package/web/ui/select.tsx +61 -0
  472. package/web/ui/sheet.tsx +43 -0
  473. package/web/ui/skeleton.tsx +6 -0
  474. package/web/ui/sonner.tsx +25 -0
  475. package/web/ui/spinner.tsx +12 -0
  476. package/web/ui/switch.tsx +18 -0
  477. package/web/ui/tabs.tsx +18 -0
  478. package/web/ui/textarea.tsx +14 -0
  479. package/web/ui/theme.css +125 -0
  480. package/web/ui/toggle.tsx +8 -0
  481. package/web/ui/tooltip.tsx +26 -0
  482. package/web/{video.ts → video/video.ts} +5 -5
  483. package/web/board/add-project.ts +0 -147
  484. package/web/board/agent-favicons.ts +0 -9
  485. package/web/board/agent-term.ts +0 -51
  486. package/web/board/annotate-lib.ts +0 -19
  487. package/web/board/annotate.ts +0 -221
  488. package/web/board/api.ts +0 -180
  489. package/web/board/approvals.ts +0 -109
  490. package/web/board/badge.ts +0 -115
  491. package/web/board/cards.ts +0 -1080
  492. package/web/board/chat.ts +0 -128
  493. package/web/board/context.ts +0 -248
  494. package/web/board/dictation.ts +0 -343
  495. package/web/board/dom.ts +0 -132
  496. package/web/board/drafts.ts +0 -21
  497. package/web/board/fixes.ts +0 -89
  498. package/web/board/git.ts +0 -416
  499. package/web/board/home-ws.ts +0 -266
  500. package/web/board/home.ts +0 -421
  501. package/web/board/icebox.ts +0 -1788
  502. package/web/board/keys.ts +0 -121
  503. package/web/board/live.ts +0 -87
  504. package/web/board/main.ts +0 -94
  505. package/web/board/markdown.ts +0 -210
  506. package/web/board/onboarding.ts +0 -227
  507. package/web/board/panel.ts +0 -437
  508. package/web/board/phone-setup.ts +0 -79
  509. package/web/board/phone.ts +0 -219
  510. package/web/board/projects.ts +0 -277
  511. package/web/board/resources.ts +0 -170
  512. package/web/board/run-pick.ts +0 -41
  513. package/web/board/run-view.ts +0 -1316
  514. package/web/board/search-match.ts +0 -20
  515. package/web/board/search.ts +0 -330
  516. package/web/board/settings-accounts.ts +0 -76
  517. package/web/board/settings-agents.ts +0 -102
  518. package/web/board/settings-automations.ts +0 -71
  519. package/web/board/settings-cleanup.ts +0 -42
  520. package/web/board/settings-orchestration.ts +0 -32
  521. package/web/board/settings-pages.ts +0 -62
  522. package/web/board/settings-skills.ts +0 -86
  523. package/web/board/settings-voice.ts +0 -28
  524. package/web/board/settings.ts +0 -490
  525. package/web/board/store.ts +0 -47
  526. package/web/board/task-page.ts +0 -615
  527. package/web/board/task-results.ts +0 -234
  528. package/web/board/tasks.ts +0 -242
  529. package/web/board/terms.ts +0 -390
  530. package/web/board/update.ts +0 -171
  531. package/web/board/viewer.ts +0 -47
  532. package/web/board/views.ts +0 -164
  533. package/web/board/whatsapp-setup.ts +0 -149
  534. package/web/board/workspace.ts +0 -650
  535. package/web/board/ws-board-ui.ts +0 -95
  536. package/web/board/ws-tabs.ts +0 -227
  537. package/web/board.html +0 -1563
  538. package/web/board.js +0 -500
  539. package/web/notebook.js +0 -514
  540. package/web/notebook.ts +0 -1254
  541. package/web/popup.html +0 -141
  542. package/web/video.js +0 -570
  543. /package/web/{term.css → dist/term.css} +0 -0
  544. /package/web/{board/term-sessions.ts → lib/terminal/sessions.ts} +0 -0
  545. /package/web/{board/terminal-viewport.ts → lib/terminal/viewport.ts} +0 -0
package/README.md CHANGED
@@ -146,7 +146,7 @@ bun run cli/install.ts # install from this checkout
146
146
  | `skills/` | The workflow as Agent Skills folders: `kaizen/` (`SKILL.md`, the `spec-*.md` stage contracts, `adapters.md`, `config.default.yml`), `kaizen-help/`, and `media/` with `kaizen-deck/`, `kaizen-video/`, `kaizen-book/`, `kaizen-game/`. |
147
147
  | `agents/` | The Claude Code subagents: `kaizen-planner`, `kaizen-builder`, `kaizen-reviewer`. |
148
148
  | `commands/` | The `/kaizen-*` slash commands, one file each. |
149
- | `web/` | The board and notebook front end: `board.html`, `notes.html`, `notebook.ts`. |
149
+ | `web/` | The board and notebook front end: page shells in `html/`, one folder per app, the React layers, and `dist/` (the generated bundles). See [`web/README.md`](web/README.md). |
150
150
  | `bot/` | Kaizen Bot — a separate private package with its own tests and build. See [its README](bot/README.md). |
151
151
  | `docs/` | The guide and internal notes, indexed in [`docs/README.md`](docs/README.md). |
152
152
  | `design.md` | Design notes for the repo. |
@@ -12,7 +12,7 @@ export type Proxy = { origin: string; port: number; target: string; token: strin
12
12
  const LOOP = ["localhost", "127.0.0.1", "[::1]"];
13
13
  export const isLoopbackHost = (h: string) => LOOP.includes(h.toLowerCase());
14
14
  const IDLE_MS = 6 * 3600_000; // a page left open overnight keeps working; the port is freed when the board stops
15
- const SCRIPT = join(import.meta.dir, "..", "web", "annotate.js");
15
+ const SCRIPT = join(import.meta.dir, "..", "web", "dist", "annotate.js");
16
16
 
17
17
  const proxies = new Map<string, Proxy>(); // by target origin
18
18
 
@@ -32,7 +32,7 @@ export function inject(html: string, token: string): string {
32
32
  // localhost can mean 127.0.0.1 or ::1 (Vite listens on one of them); try the others when the first refuses.
33
33
  const hostsFor = (t: URL) => (t.hostname === "localhost" ? ["localhost", "127.0.0.1", "[::1]"] : [t.hostname]);
34
34
 
35
- export function openProxy(target: URL): Proxy {
35
+ export function openProxy(target: URL, script: () => string | Buffer | null = () => readFileSync(SCRIPT)): Proxy {
36
36
  if (!/^https?:$/.test(target.protocol) || !isLoopbackHost(target.hostname)) throw new Error("only a localhost address");
37
37
  const old = proxies.get(target.origin);
38
38
  if (old) return (old.touched = Date.now()), old;
@@ -55,7 +55,10 @@ export function openProxy(target: URL): Proxy {
55
55
  px.touched = Date.now();
56
56
  const url = new URL(req.url);
57
57
  if (url.pathname === "/__kz/annotate.js") {
58
- return new Response(readFileSync(SCRIPT), { headers: { "content-type": "text/javascript; charset=utf-8", "cache-control": "no-store" } });
58
+ // The board hands in its own copy (the one it started with): an upgrade replacing the file under it is not a 500.
59
+ const js = script();
60
+ if (js === null) return new Response("not found", { status: 404 });
61
+ return new Response(js, { headers: { "content-type": "text/javascript; charset=utf-8", "cache-control": "no-store" } });
59
62
  }
60
63
  const path = url.pathname + url.search;
61
64
 
package/cli/build-web.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  // `bun run build:web`: bundles the notebook's script and CodeMirror into
2
- // web/notebook.js, the in-card terminal and xterm.js into web/term.js (+ its
3
- // stylesheet, web/term.css), the board's modules (web/board/) into web/board.js and
4
- // Kaizen Bot's page modules (bot/web/app/) into bot/web/app.js, the Video page's script into web/video.js, all committed, so an install or a checkout serves it with no
2
+ // web/dist/notebook.js, the in-card terminal and xterm.js into web/dist/term.js (+ its
3
+ // stylesheet, web/dist/term.css), the board's page (web/pages/board/main.ts) into web/dist/board.js and
4
+ // Kaizen Bot's page modules (bot/web/app/) into bot/web/app.js, the chat popup's page into web/dist/popup.js, the tiny blocking head script that applies the stored theme into web/dist/boot.js, the Video page's script into web/dist/video.js and the annotator's page script (web/annotate/) into web/dist/annotate.js, all committed, so an install or a checkout serves it with no
5
5
  // install step and no network. The first line is a hash of what it was built from;
6
6
  // cli/notes.test.ts fails when a committed file no longer matches.
7
7
  import { createHash } from "node:crypto";
@@ -10,12 +10,25 @@ import { join, dirname } from "node:path";
10
10
 
11
11
  const root = dirname(import.meta.dir);
12
12
  const modules = (dir: string) => readdirSync(join(root, dir)).filter((f) => f.endsWith(".ts")).sort().map((f) => `${dir}/${f}`);
13
- const SOURCES = ["web/notebook.ts", "web/notes-lib.ts", "web/term.ts", "web/video.ts", ...modules("web/board"), ...modules("bot/web/app")];
14
- export const OUT = join(root, "web", "notebook.js");
15
- export const TERM_OUT = join(root, "web", "term.js");
16
- export const BOARD_OUT = join(root, "web", "board.js");
13
+ // The React layers (web/ui, components, pages, lib) hold .ts and .tsx, in folders of their own; sorted so every OS hashes the same order.
14
+ const tree = (dir: string): string[] =>
15
+ readdirSync(join(root, dir), { withFileTypes: true })
16
+ .sort((a, b) => (a.name < b.name ? -1 : 1))
17
+ .flatMap((e) => (e.isDirectory() ? tree(`${dir}/${e.name}`) : /\.tsx?$/.test(e.name) && !/\.test\.tsx?$/.test(e.name) ? [`${dir}/${e.name}`] : []));
18
+ const SOURCES = ["web/notebook/notebook.ts", "web/notebook/notes-lib.ts", "web/term/term.ts", "web/video/video.ts", "web/annotate/annotate.ts", "web/popup/popup.ts", "web/boot/boot.ts", "web/ui/legacy/board.css", "web/ui/legacy/notes.css", "web/ui/legacy/popup.css", ...modules("bot/web/app"), ...["ui", "components", "pages", "lib"].flatMap((d) => tree(`web/${d}`)), "web/ui/theme.css"];
19
+ export const OUT = join(root, "web", "dist", "notebook.js");
20
+ export const TERM_OUT = join(root, "web", "dist", "term.js");
21
+ export const BOARD_OUT = join(root, "web", "dist", "board.js");
17
22
  export const BOT_OUT = join(root, "bot", "web", "app.js");
18
- export const VIDEO_OUT = join(root, "web", "video.js");
23
+ export const VIDEO_OUT = join(root, "web", "dist", "video.js");
24
+ export const ANNOTATE_OUT = join(root, "web", "dist", "annotate.js");
25
+ export const UI_CSS_OUT = join(root, "web", "dist", "ui.css");
26
+ // One stylesheet per page: the kit's Tailwind (ui.css) with the page's own styles after it (web/ui/legacy/). Video links ui.css as it was.
27
+ export const BOARD_CSS_OUT = join(root, "web", "dist", "board.css");
28
+ export const NOTEBOOK_CSS_OUT = join(root, "web", "dist", "notebook.css");
29
+ export const BOOT_OUT = join(root, "web", "dist", "boot.js");
30
+ export const POPUP_OUT = join(root, "web", "dist", "popup.js");
31
+ export const POPUP_CSS_OUT = join(root, "web", "dist", "popup.css");
19
32
 
20
33
  // The sources and the exact dependency versions: a CodeMirror bump is a rebuild too.
21
34
  export function sourceHash() {
@@ -24,23 +37,40 @@ export function sourceHash() {
24
37
  h.update(JSON.stringify(JSON.parse(readFileSync(join(root, "package.json"), "utf8")).devDependencies ?? {}));
25
38
  return h.digest("hex").slice(0, 16);
26
39
  }
27
- export const banner = (what = "notebook", from = "web/notebook.ts") => `/* kaizen ${what} ${sourceHash()} -- generated by bun run build:web from ${from}; do not edit */`;
40
+ export const banner = (what = "notebook", from = "web/notebook/notebook.ts") => `/* kaizen ${what} ${sourceHash()} -- generated by bun run build:web from ${from}; do not edit */`;
28
41
 
29
42
  if (import.meta.main) {
30
43
  const bundles = [
31
- ["web/notebook.ts", OUT, "notebook"],
32
- ["web/term.ts", TERM_OUT, "terminal"],
33
- ["web/board/main.ts", BOARD_OUT, "board"],
44
+ ["web/notebook/notebook.ts", OUT, "notebook"],
45
+ ["web/term/term.ts", TERM_OUT, "terminal"],
46
+ ["web/pages/board/main.ts", BOARD_OUT, "board"],
34
47
  ["bot/web/app/main.ts", BOT_OUT, "bot page"],
35
- ["web/video.ts", VIDEO_OUT, "video page"],
48
+ ["web/video/video.ts", VIDEO_OUT, "video page"],
49
+ ["web/annotate/annotate.ts", ANNOTATE_OUT, "annotator page script"],
50
+ ["web/popup/popup.ts", POPUP_OUT, "chat popup"],
51
+ ["web/boot/boot.ts", BOOT_OUT, "boot script"],
36
52
  ] as const;
37
53
  for (const [src, out, what] of bundles) {
38
- // The terminal, the board and the bot page are classic scripts: wrapped, or their
54
+ // The terminal, the board, the bot page and the annotator's page script are classic scripts: wrapped, or their
39
55
  // top-level names collide with each other's globals and the whole file is refused.
40
- const r = await Bun.build({ entrypoints: [join(root, src)], target: "browser", minify: true, format: what === "notebook" ? "esm" : "iife" });
56
+ // React reads process.env.NODE_ENV: without this the board carries React's development build (twice the size, slower).
57
+ const define = what === "board" || what === "notebook" || what === "chat popup" ? { "process.env.NODE_ENV": '"production"' } : undefined;
58
+ const r = await Bun.build({ entrypoints: [join(root, src)], target: "browser", minify: true, format: what === "notebook" ? "esm" : "iife", define });
41
59
  if (!r.success) { for (const l of r.logs) console.error(l); process.exit(1); }
42
60
  writeFileSync(out, banner(what, src) + "\n" + await r.outputs[0]!.text());
43
61
  console.log(` ${out.slice(root.length + 1)} ${(Bun.file(out).size / 1024).toFixed(0)} KB`);
44
62
  }
45
- copyFileSync(join(root, "node_modules", "@xterm", "xterm", "css", "xterm.css"), join(root, "web", "term.css"));
63
+ copyFileSync(join(root, "node_modules", "@xterm", "xterm", "css", "xterm.css"), join(root, "web", "dist", "term.css"));
64
+ // The board's Tailwind: web/ui/theme.css scans web/ui, components, pages and lib for the classes they use.
65
+ const tw = Bun.spawnSync([process.execPath, join(root, "node_modules", "@tailwindcss", "cli", "dist", "index.mjs"), "-i", join(root, "web", "ui", "theme.css"), "-o", UI_CSS_OUT, "--minify"], { cwd: root, stdout: "pipe", stderr: "pipe" });
66
+ if (tw.exitCode !== 0) { console.error(tw.stderr.toString()); process.exit(1); }
67
+ const css = readFileSync(UI_CSS_OUT, "utf8");
68
+ writeFileSync(UI_CSS_OUT, `/* kaizen ui ${sourceHash()} -- generated by bun run build:web from web/ui/theme.css; do not edit */\n` + css);
69
+ console.log(` web/dist/ui.css ${(Bun.file(UI_CSS_OUT).size / 1024).toFixed(0)} KB`);
70
+ // The raw page styles go after the kit's, as the page's own <style> once did after the link; copied byte for byte (the
71
+ // layer order line leads each file), because a stricter CSS parser would read the file differently from a browser.
72
+ for (const [out, own, what] of [[BOARD_CSS_OUT, "board", "board"], [NOTEBOOK_CSS_OUT, "notes", "notebook"]] as const)
73
+ writeFileSync(out, `/* kaizen ${what} css ${sourceHash()} -- generated by bun run build:web from web/ui/theme.css and web/ui/legacy/${own}.css; do not edit */\n` + css + "\n" + readFileSync(join(root, "web", "ui", "legacy", `${own}.css`), "utf8"));
74
+ writeFileSync(POPUP_CSS_OUT, `/* kaizen popup css ${sourceHash()} -- generated by bun run build:web from web/ui/legacy/popup.css; do not edit */\n` + readFileSync(join(root, "web", "ui", "legacy", "popup.css"), "utf8"));
75
+ for (const o of [BOARD_CSS_OUT, NOTEBOOK_CSS_OUT, POPUP_CSS_OUT]) console.log(` ${o.slice(root.length + 1)} ${(Bun.file(o).size / 1024).toFixed(0)} KB`);
46
76
  }
package/cli/dev.ts ADDED
@@ -0,0 +1,67 @@
1
+ #!/usr/bin/env bun
2
+ // `bun run dev`: the board with live reload for front-end work. It builds web/dist, starts the board (KAIZEN_DEV=1: pages
3
+ // are read from disk on every request and reload themselves), then rebuilds on every change under web/ and tells the open
4
+ // pages to reload. A full build takes well under a second.
5
+ // bun run dev [--port 7431] [--project <dir>] the project defaults to this checkout
6
+ import { watch } from "node:fs";
7
+ import { dirname, join, resolve } from "node:path";
8
+
9
+ const root = dirname(import.meta.dir);
10
+ const arg = (name: string, d: string) => { const i = process.argv.indexOf(name); return i > 0 && process.argv[i + 1] ? process.argv[i + 1]! : d; };
11
+ const port = arg("--port", "7431");
12
+ const project = resolve(arg("--project", process.cwd()));
13
+
14
+ const build = async () => {
15
+ const t = performance.now();
16
+ const p = Bun.spawn([process.execPath, join(root, "cli", "build-web.ts")], { cwd: root, stdout: "pipe", stderr: "pipe" });
17
+ const [out, err, code] = await Promise.all([new Response(p.stdout).text(), new Response(p.stderr).text(), p.exited]);
18
+ if (code !== 0) { console.error(`\n build failed\n${err || out}`); return false; }
19
+ console.log(` built in ${Math.round(performance.now() - t)} ms`);
20
+ return true;
21
+ };
22
+ const reload = async () => { try { await fetch(`http://127.0.0.1:${port}/__dev/reload`, { method: "POST" }); } catch {} };
23
+
24
+ if (!(await build())) process.exit(1);
25
+ // The board's own output is passed on and read: "already at <url>" means a board already serves this project, so this run
26
+ // only watches and rebuilds (the script stays up, a Run app terminal does not end) and says where that board is.
27
+ let existing = "";
28
+ const board = Bun.spawn([process.execPath, join(root, "cli", "install.ts"), "web", "--port", port, "--no-open"], {
29
+ cwd: project, env: { ...process.env, KAIZEN_DEV: "1" }, stdout: "pipe", stderr: "inherit", stdin: "inherit",
30
+ });
31
+ (async () => {
32
+ const dec = new TextDecoder();
33
+ for await (const chunk of board.stdout) {
34
+ const t = dec.decode(chunk);
35
+ process.stdout.write(t);
36
+ existing ||= /already at\s+(\S+)/.exec(t)?.[1] ?? "";
37
+ }
38
+ })();
39
+ console.log(` dev: watching web/ — pages reload after each rebuild`);
40
+
41
+ // One build at a time; a change during a build runs one more after it.
42
+ let busy = false, again = false, timer: ReturnType<typeof setTimeout> | undefined;
43
+ const run = async () => {
44
+ if (busy) { again = true; return; }
45
+ busy = true;
46
+ do { again = false; if (await build()) await reload(); } while (again);
47
+ busy = false;
48
+ };
49
+ const SRC = [join(root, "web"), join(root, "bot", "web", "app")];
50
+ const ignored = (f: string) => /(^|[\\/])(dist|checks)[\\/]|\.test\.tsx?$|\.(png|jpg|svg|map)$|~$|\.swp$/.test(f);
51
+ for (const dir of SRC)
52
+ watch(dir, { recursive: true }, (_e, f) => {
53
+ if (!f || ignored(String(f))) return;
54
+ clearTimeout(timer);
55
+ timer = setTimeout(run, 120);
56
+ });
57
+
58
+ const stop = () => { board.kill(); process.exit(0); };
59
+ process.on("SIGINT", stop);
60
+ process.on("SIGTERM", stop);
61
+ await board.exited;
62
+ await Bun.sleep(100); // the last output is read
63
+ if (!existing) process.exit(0);
64
+ console.log(`\n dev: a board already serves this project at ${existing}`);
65
+ console.log(` dev: still watching and rebuilding web/dist. That board reloads pages on its own only if it was started with KAIZEN_DEV=1;`);
66
+ console.log(` dev: otherwise reload the page yourself, or run this with --project <folder> and its own HOME for a second board.`);
67
+ await new Promise(() => {}); // stay up until Ctrl+C
package/cli/docs.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
2
2
  import { join, relative, resolve, sep } from "node:path";
3
- import { wikilinks, boardLink, resolve as resolveNote } from "../web/notes-lib.ts";
3
+ import { wikilinks, boardLink, resolve as resolveNote } from "../web/notebook/notes-lib.ts";
4
4
 
5
5
  const git = (root: string, args: string[]) => {
6
6
  const p = Bun.spawnSync(["git", ...args], { cwd: root, windowsHide: true });
package/cli/notes.ts CHANGED
@@ -1,10 +1,10 @@
1
1
  // The notebook's files: plain markdown under <state>/notes/, folders and all, so any
2
2
  // editor (Obsidian included) can open the same folder. Every name that arrives from
3
3
  // the page goes through safeName before it becomes a path.
4
- import { existsSync, mkdirSync, readdirSync, realpathSync, renameSync, rmdirSync, statSync, writeFileSync } from "node:fs";
4
+ import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmdirSync, statSync, writeFileSync } from "node:fs";
5
5
  import { join, dirname, resolve, sep } from "node:path";
6
6
  import { backlogLines, boardCards, reviewFindings, readText } from "./state.ts";
7
- import { wikilinks, boardLink, resolveRun } from "../web/notes-lib.ts";
7
+ import { wikilinks, boardLink, resolveRun } from "../web/notebook/notes-lib.ts";
8
8
 
9
9
  export type Note = { name: string; mtime: number; text: string };
10
10
 
@@ -77,7 +77,13 @@ export function saveNote(state: string, name: unknown, text: string, base: numbe
77
77
  if (now !== base) return { ok: false, why: "conflict", text: readText(t.file), mtime: now };
78
78
  } else if (base) return { ok: false, why: "conflict", text: "", mtime: 0 };
79
79
  mkdirSync(dirname(t.file), { recursive: true });
80
- writeFileSync(t.file, text);
80
+ // The editor holds LF (readText); a note that was CRLF on disk stays CRLF.
81
+ // Only when most lines are CRLF, so one stray CRLF in an LF note does not rewrite the whole file.
82
+ const crlf = existsSync(t.file) && (() => {
83
+ const old = readFileSync(t.file, "utf8"), all = (old.match(/\n/g) || []).length, cr = (old.match(/\r\n/g) || []).length;
84
+ return cr > 0 && cr * 2 >= all;
85
+ })();
86
+ writeFileSync(t.file, crlf ? text.replace(/\r?\n/g, "\r\n") : text);
81
87
  return { ok: true, name: t.name, mtime: statSync(t.file).mtimeMs };
82
88
  }
83
89
 
package/cli/ports.ts ADDED
@@ -0,0 +1,121 @@
1
+ // A dev server that cannot start because its port is taken: which port its terminal says is in use, who holds it, and
2
+ // stopping that process (the Run app button offers it). Linux reads `ss` and /proc; macOS reads `lsof`; Windows is not covered.
3
+ import { readlinkSync, readFileSync } from "node:fs";
4
+
5
+ // "EADDRINUSE ... :7431", "address already in use 0.0.0.0:3000", "Port 5173 is already in use", "port 8080 is already allocated".
6
+ export function conflictPort(text: string): number | null {
7
+ const t = text.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "");
8
+ const m =
9
+ /EADDRINUSE[^\n]*:(\d{2,5})(?!\d)/i.exec(t) ??
10
+ /address already in use[^\n]*:(\d{2,5})(?!\d)/i.exec(t) ??
11
+ /port\s+(\d{2,5})\s+(?:is\s+)?(?:already\s+)?(?:in use|allocated|taken)/i.exec(t) ??
12
+ /(?:listen|bind)[^\n]*?:(\d{2,5})[^\n]*in use/i.exec(t);
13
+ const n = m ? Number(m[1]) : NaN;
14
+ return n >= 1 && n <= 65535 ? n : null;
15
+ }
16
+
17
+ export type Holder = { pid: number; name: string; cmd: string; cwd: string };
18
+
19
+ // The processes listening on a loopback or wildcard port, from `ss -ltnpH`.
20
+ export function holdersFromSs(ss: string, port: number): { pid: number; name: string }[] {
21
+ const out: { pid: number; name: string }[] = [];
22
+ for (const line of ss.split("\n")) {
23
+ if (!new RegExp(`[:\\]]${port}\\s`).test(line)) continue;
24
+ const name = /users:\(\("([^"]+)"/.exec(line)?.[1] ?? "";
25
+ for (const [, pid] of line.matchAll(/pid=(\d+)/g)) out.push({ pid: Number(pid), name });
26
+ }
27
+ return out;
28
+ }
29
+
30
+ const run = async (cmd: string[]) => {
31
+ try {
32
+ const p = Bun.spawn(cmd, { stdout: "pipe", stderr: "ignore", timeout: 3000 });
33
+ return await new Response(p.stdout).text();
34
+ } catch {
35
+ return "";
36
+ }
37
+ };
38
+
39
+ export async function holders(port: number): Promise<Holder[]> {
40
+ if (process.platform === "linux") {
41
+ return holdersFromSs(await run(["ss", "-ltnpH"]), port).map(({ pid, name }) => {
42
+ let cmd = "", cwd = "";
43
+ try { cmd = readFileSync(`/proc/${pid}/cmdline`, "utf8").split("\0").join(" ").trim(); } catch {}
44
+ try { cwd = readlinkSync(`/proc/${pid}/cwd`); } catch {}
45
+ return { pid, name, cmd: cmd || name, cwd };
46
+ });
47
+ }
48
+ if (process.platform === "darwin") {
49
+ const out = await run(["lsof", "-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-Fpc"]);
50
+ const found: Holder[] = [];
51
+ let cur: Holder | null = null;
52
+ for (const l of out.split("\n")) {
53
+ if (l[0] === "p") found.push((cur = { pid: Number(l.slice(1)), name: "", cmd: "", cwd: "" }));
54
+ else if (l[0] === "c" && cur) cur.name = cur.cmd = l.slice(1);
55
+ }
56
+ return found;
57
+ }
58
+ return [];
59
+ }
60
+
61
+ // Stops what listens on `port`: only a process of this user, never the board's own. TERM first, KILL if it is still there.
62
+ export async function stopPort(port: number, spare: number[] = []): Promise<{ ok: boolean; error?: string; stopped?: Holder[] }> {
63
+ if (!Number.isInteger(port) || port < 1024 || port > 65535) return { ok: false, error: "that port is not one to stop" };
64
+ const mine = typeof process.getuid === "function" ? process.getuid() : null;
65
+ const found = await holders(port);
66
+ if (!found.length) return { ok: false, error: "nothing is listening on that port" };
67
+ const stopped: Holder[] = [];
68
+ for (const h of found) {
69
+ if (h.pid === process.pid || spare.includes(h.pid)) return { ok: false, error: "that is the board itself" };
70
+ if (mine !== null) {
71
+ try {
72
+ const uid = Number(/^Uid:\s+(\d+)/m.exec(readFileSync(`/proc/${h.pid}/status`, "utf8"))?.[1]);
73
+ if (Number.isFinite(uid) && uid !== mine) return { ok: false, error: "that process belongs to another user" };
74
+ } catch {}
75
+ }
76
+ try { process.kill(h.pid, "SIGTERM"); stopped.push(h); } catch (e) { return { ok: false, error: String((e as Error).message ?? e) }; }
77
+ }
78
+ for (let i = 0; i < 10 && (await holders(port)).length; i++) await new Promise((r) => setTimeout(r, 200));
79
+ for (const h of await holders(port)) { try { process.kill(h.pid, "SIGKILL"); } catch {} }
80
+ return { ok: true, stopped };
81
+ }
82
+
83
+ // The TCP ports this user's processes listen on, with where each runs (Linux: `ss` and /proc). `where` is the project folder
84
+ // the process works in, so the board lists the apps of its own projects and not every service on the computer.
85
+ export type Listener = { port: number; pid: number; name: string; cmd: string; cwd: string };
86
+ export function parseListeners(ss: string, info: (pid: number) => { cmd: string; cwd: string; mine: boolean }): Listener[] {
87
+ const seen = new Set<string>(), out: Listener[] = [];
88
+ for (const line of ss.split("\n")) {
89
+ const port = Number(/[:\]](\d+)\s+\S+:\*|[:\]](\d+)\s+\S+\s*$/.exec(line)?.[1] ?? /:(\d+)\s/.exec(line)?.[1]);
90
+ if (!port) continue;
91
+ const name = /users:\(\("([^"]+)"/.exec(line)?.[1] ?? "";
92
+ for (const [, p] of line.matchAll(/pid=(\d+)/g)) {
93
+ const pid = Number(p), k = `${port}:${pid}`;
94
+ if (seen.has(k)) continue;
95
+ seen.add(k);
96
+ const i = info(pid);
97
+ if (i.mine) out.push({ port, pid, name, cmd: i.cmd || name, cwd: i.cwd });
98
+ }
99
+ }
100
+ return out.sort((a, b) => a.port - b.port);
101
+ }
102
+ // The listeners whose working folder is inside one of `dirs`; each with the folder it matched.
103
+ export const inProjects = (list: Listener[], dirs: string[]) =>
104
+ list.flatMap((l) => {
105
+ const d = dirs.filter((x) => l.cwd === x || l.cwd.startsWith(x + "/")).sort((a, b) => b.length - a.length)[0];
106
+ return d ? [{ ...l, project: d }] : [];
107
+ });
108
+ export async function listeners(): Promise<Listener[]> {
109
+ if (process.platform !== "linux") return [];
110
+ const mine = typeof process.getuid === "function" ? process.getuid() : null;
111
+ return parseListeners(await run(["ss", "-ltnpH"]), (pid) => {
112
+ let cmd = "", cwd = "", uid = mine;
113
+ try { cmd = readFileSync(`/proc/${pid}/cmdline`, "utf8").split("\0").join(" ").trim(); } catch {}
114
+ try { cwd = readlinkSync(`/proc/${pid}/cwd`); } catch {}
115
+ try { uid = Number(/^Uid:\s+(\d+)/m.exec(readFileSync(`/proc/${pid}/status`, "utf8"))?.[1]); } catch {}
116
+ return { cmd, cwd, mine: mine === null || uid === mine };
117
+ });
118
+ }
119
+
120
+ // Kaizen's own processes (a board, the dev script, a test run) are not the user's apps: the Ports list leaves them out.
121
+ export const isKaizenProcess = (cmd: string) => /install\.ts\s+web\b|\bkaizen(?:-agent)?\s+web\b|cli\/(?:dev|web)\.ts|\bbun\s+test\b/.test(cmd);
package/cli/rea.ts CHANGED
@@ -3,10 +3,10 @@
3
3
  // `setup`, `uninstall` and `doctor` do, through `npx` pinned to an exact version. Kaizen keeps
4
4
  // only its switch in ~/.kaizen/rea.json and reads agent configs to see what is registered.
5
5
  import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
6
- import { join } from "node:path";
6
+ import { delimiter, join, posix, win32 } from "node:path";
7
7
  import { SKILL_HOMES } from "./skills.ts";
8
8
 
9
- export type Run = (argv: string[]) => Promise<{ ok: boolean; out: string }>;
9
+ export type Run = (argv: string[], ms?: number) => Promise<{ ok: boolean; out: string; err?: string }>;
10
10
  export type Reg = { client: string; version: string | null };
11
11
  export type Saved = { on: boolean; version: string; clients: string[] };
12
12
 
@@ -21,14 +21,16 @@ const npx = process.platform === "win32" ? "npx.cmd" : "npx";
21
21
  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
22
22
  const pkg = (version: string) => `rea-agents@${version}`;
23
23
 
24
- // Up to 5 minutes: a first npx run downloads REA (about 50 MB). A missing npx is a failure, not a throw.
25
- export const run: Run = async (argv) => {
24
+ // Up to 5 minutes by default: a first npx run downloads REA (about 50 MB). A missing npx is a failure, not a throw.
25
+ export const run: Run = async (argv, ms = 5 * 60_000) => {
26
26
  try {
27
27
  const p = Bun.spawn(argv, { stdout: "pipe", stderr: "pipe", stdin: "ignore", windowsHide: true });
28
- const timer = setTimeout(() => p.kill(), 5 * 60_000);
28
+ const timer = setTimeout(() => p.kill(), ms);
29
29
  const [out, err, code] = await Promise.all([new Response(p.stdout).text(), new Response(p.stderr).text(), p.exited]);
30
30
  clearTimeout(timer);
31
- return { ok: code === 0, out: out || err };
31
+ // `out` stays one stream, as REA's JSON parsing expects; `err` is there for callers that
32
+ // want the reason a package manager put on stderr after its progress on stdout.
33
+ return { ok: code === 0, out: out || err, err };
32
34
  } catch (e: any) { return { ok: false, out: `${argv[0]} not found: ${e?.message ?? e}` }; }
33
35
  };
34
36
 
@@ -57,7 +59,10 @@ export function doctorMissing(j: any): string[] {
57
59
  if (Array.isArray(v)) return v.forEach(walk);
58
60
  if (!v || typeof v !== "object") return;
59
61
  const bad = v.ok === false || v.passed === false || /^(fail|failed|error|missing)$/i.test(String(v.status ?? ""));
60
- if (bad && (v.name || v.id || v.message)) out.add(String(v.name ?? v.id ?? v.message).slice(0, 80));
62
+ // A failed `node` check is the PC's Node.js being too old: name what it needs, like oldNode.
63
+ const need = v.name === "node" && /^Install (Node\.js .+?)\.?$/.exec(String(v.remediation ?? ""))?.[1]?.replace(/, or /, ", ");
64
+ if (bad && need) out.add(`${need} (this PC has ${v.detail ?? "an older one"})`);
65
+ else if (bad && (v.name || v.id || v.message)) out.add(String(v.name ?? v.id ?? v.message).slice(0, 80));
61
66
  for (const x of Object.values(v)) if (x && typeof x === "object") walk(x);
62
67
  };
63
68
  if (j) for (const k of ["scope_checks", "informational_checks", "providerInspections", "checks"]) walk(j[k]);
@@ -107,8 +112,82 @@ const validClients = (home: string, clients: string[]) => {
107
112
  return clients.length > 0 && clients.every((c) => known.has(c));
108
113
  };
109
114
  const clientArgs = (clients: string[]) => clients.flatMap((c) => ["--client", c]);
115
+ // REA refuses a Node.js older than it supports with one plain line, no JSON. On Windows npx
116
+ // runs the PC's own Node.js, which kaizen cannot update, so say what is needed and how.
117
+ export function oldNode(out: string): { need: string; have: string } | null {
118
+ const m = /REA requires (Node\.js .+?); this process runs Node\.js v?(\d+(?:\.\d+)*)/.exec(out);
119
+ return m ? { need: m[1]!.replace(/, or /, ", "), have: m[2]! } : null;
120
+ }
121
+ const NODE_FIX = "Use Update Node.js on the REA row in Settings → Skills, or install the current Node.js LTS from nodejs.org, then try again.";
122
+
123
+ // ---- Node.js for REA: missing (no node on PATH) or old (REA said so). Installed only on the
124
+ // user's click and yes, through the platform's own package manager; otherwise a download link.
125
+ let nodeOld: { need: string; have: string } | null = null;
126
+ export const forgetNodeOld = () => { nodeOld = null; };
127
+ export const NODE_URL = "https://nodejs.org/en/download";
128
+ export type NodeFix = { how: "winget" | "brew"; argv: string[]; command: string; bin: string } | { how: "link"; url: string };
129
+
130
+ // Where a package manager lives when a desktop app's PATH does not list it (macOS GUI apps).
131
+ const BREWS = ["/opt/homebrew/bin/brew", "/usr/local/bin/brew"];
132
+ export function nodeFix(platform = process.platform, which: (b: string) => string | null = (b) => Bun.which(b, { PATH: process.env.PATH }), exists = existsSync, env = process.env): NodeFix {
133
+ if (platform === "win32") {
134
+ const winget = which("winget");
135
+ // `install` upgrades a package winget already knows, so one command covers both cases.
136
+ const argv = ["winget", "install", "--id", "OpenJS.NodeJS.LTS", "--exact", "--source", "winget", "--accept-package-agreements", "--accept-source-agreements", "--disable-interactivity"];
137
+ if (winget) return { how: "winget", argv: [winget, ...argv.slice(1)], command: argv.join(" "), bin: win32.join(env.ProgramFiles ?? "C:\\Program Files", "nodejs") };
138
+ }
139
+ if (platform === "darwin") {
140
+ const brew = which("brew") ?? BREWS.find((b) => exists(b)) ?? null;
141
+ // `brew install` of an outdated formula upgrades it.
142
+ if (brew) return { how: "brew", argv: [brew, "install", "node"], command: "brew install node", bin: posix.dirname(brew) }; // Homebrew paths are POSIX
143
+ }
144
+ return { how: "link", url: NODE_URL };
145
+ }
146
+
147
+ // What the row shows: null when Node.js is there and REA has not called it too old.
148
+ export function nodeState(which: (b: string) => string | null = (b) => Bun.which(b, { PATH: process.env.PATH })) {
149
+ const state = !which("node") ? "missing" as const : nodeOld ? "old" as const : null;
150
+ if (!state) return null;
151
+ const fix = nodeFix();
152
+ return { state, ...(state === "old" ? { need: nodeOld!.need, have: nodeOld!.have } : {}), ...(fix.how === "link" ? { how: fix.how, url: fix.url } : { how: fix.how, command: fix.command }) };
153
+ }
154
+
155
+ // Runs the fix nodeFix built here, never a command from the page. Up to 10 minutes: winget
156
+ // downloads and runs Node's installer, and Windows shows its own admin prompt. On success the
157
+ // new Node.js folder goes first on this process's PATH, so REA's npx finds it without a restart.
158
+ let nodeBusy = false;
159
+ export async function installNode(sh: Run = run, fix: NodeFix = nodeFix(), env: Record<string, string | undefined> = process.env) {
160
+ if (fix.how === "link") return { ok: false as const, why: `Download Node.js from ${fix.url}`, url: fix.url };
161
+ if (nodeBusy) return { ok: false as const, why: "Node.js is already being installed" };
162
+ nodeBusy = true;
163
+ try {
164
+ const r = await sh(fix.argv, 10 * 60_000);
165
+ // Already the newest: winget exits non-zero. The old Node.js REA sees then comes from
166
+ // somewhere else on PATH (nvm, Volta, another installer), which kaizen does not touch.
167
+ const said = [r.out, r.err ?? ""].join("\n");
168
+ if (!r.ok && /No (available upgrade|newer package versions) (found|are available)/i.test(said)) {
169
+ return { ok: false as const, why: `Node.js from ${fix.how} is already the newest, but an older Node.js comes first on PATH (nvm, Volta or another installer?). Update or remove that one, then restart kaizen.` };
170
+ }
171
+ // The last real line: winget redraws its spinner with \r, so split on both.
172
+ if (!r.ok) return { ok: false as const, why: (said.split(/[\r\n]+/).map((l) => l.trim()).filter((l) => l && !/^[-\\|/\s█▒░]+$/.test(l)).pop() ?? `${fix.command} failed`).slice(0, 300) };
173
+ // Windows keeps both PATH and Path here (adoptLoginEnv sets both): update every spelling.
174
+ const keys = Object.keys(env).filter((k) => k.toUpperCase() === "PATH");
175
+ for (const key of keys.length ? keys : ["PATH"]) {
176
+ const parts = (env[key] ?? "").split(delimiter).filter((d) => d && d.toLowerCase() !== fix.bin.toLowerCase());
177
+ env[key] = [fix.bin, ...parts].join(delimiter);
178
+ }
179
+ nodeOld = null;
180
+ forgetDoctor();
181
+ return { ok: true as const };
182
+ } finally { nodeBusy = false; }
183
+ }
110
184
  // REA's own words when a step did not go through: its message, else the first line it printed.
111
- const reason = (j: any, out: string) => String(j?.message ?? j?.error ?? j?.reason ?? (out.trim().split("\n")[0] || "REA did not answer")).slice(0, 300);
185
+ const reason = (j: any, out: string) => {
186
+ const n = oldNode(out);
187
+ if (n) nodeOld = n;
188
+ if (n) return `REA needs ${n.need}; this PC has Node.js ${n.have}. ${NODE_FIX}`;
189
+ return String(j?.message ?? j?.error ?? j?.reason ?? (out.trim().split("\n")[0] || "REA did not answer")).slice(0, 300);
190
+ };
112
191
 
113
192
  export async function reaLatest(sh: Run = run): Promise<string | null> {
114
193
  const r = await sh([npm, "view", "rea-agents", "version"]);
@@ -143,6 +222,7 @@ export async function reaRemove(home: string, sh: Run = run) {
143
222
  const r = await sh([npx, "-y", pkg(version), "uninstall", "--json"]);
144
223
  if (!r.ok) return { ok: false as const, why: reason(parse(r.out), r.out) };
145
224
  save(home, null);
225
+ nodeOld = null;
146
226
  const left = reaRegistered(home).map((x) => x.client);
147
227
  return { ok: true as const, left, ...(left.includes("claude_code") ? { hint: "claude mcp remove --scope user rea" } : {}) };
148
228
  }
@@ -155,7 +235,14 @@ export function reaDoctor(version: string, sh: Run = run, now = Date.now()) {
155
235
  const entry: { at: number; p: Promise<any>; v?: any } = { at: now, p: Promise.resolve(null) };
156
236
  entry.p = sh([npx, "-y", pkg(version), "doctor", "--json"]).then((r) => {
157
237
  const j = parse(r.out);
158
- entry.v = j ? { healthy: j.healthy === true, missing: doctorMissing(j) } : null;
238
+ const n = j ? null : oldNode(r.out);
239
+ if (n) nodeOld = n;
240
+ else if (j) {
241
+ // Doctor ran, so it settles the question either way: a failed node check is old, else fine.
242
+ const check = (Array.isArray(j.scope_checks) ? j.scope_checks : []).find((c: any) => c?.name === "node");
243
+ nodeOld = check?.ok === false ? { need: "a newer Node.js", have: String(check.detail ?? "") } : null;
244
+ }
245
+ entry.v = n ? { healthy: false, missing: [`${n.need} (this PC has ${n.have})`] } : j ? { healthy: j.healthy === true, missing: doctorMissing(j) } : null;
159
246
  return entry.v;
160
247
  });
161
248
  doctorCache.set(version, entry);
@@ -186,14 +273,15 @@ export function reaRow(home: string, sh: Run = run, now = Date.now()) {
186
273
  const latest = on ? cachedLatest(sh, now) : null;
187
274
  const doc = on && installed ? reaDoctor(installed, sh, now) : null;
188
275
  const regd = new Set(reg.map((r) => r.client));
276
+ const node = nodeState();
189
277
  const note = !on ? undefined
190
278
  : `REA ${installed ?? "(version unknown)"}${!saved ? " · set up outside kaizen" : ""}${latest && installed && newer(latest, installed) ? ` · ${latest} available` : ""}${doc === undefined ? " · checking what it needs…" : ""}`;
191
279
  return {
192
280
  id: "rea", title: "Reverse engineering (REA)", group: "optional", offByDefault: true, status: "beta",
193
281
  description: "Lets agents study apps, binaries, packages and file formats whose source isn't here, through REA's MCP tools.",
194
- off: !on, needs: (doc?.missing ?? []).map((name) => ({ name, found: false })),
282
+ off: !on, needs: [...(node?.state === "missing" ? ["Node.js"] : []), ...(doc?.missing ?? [])].map((name) => ({ name, found: false })),
195
283
  agents: reaClients(home).map((c) => ({ agent: c.agent, state: regd.has(c.client) ? "installed" : "missing" })),
196
284
  ...(note ? { note } : {}),
197
- rea: { installed, latest, update: !!(latest && installed && newer(latest, installed)), outside: on && !saved, clients: reaClients(home).map((c) => c.client) },
285
+ rea: { installed, latest, update: !!(latest && installed && newer(latest, installed)), outside: on && !saved, clients: reaClients(home).map((c) => c.client), node },
198
286
  };
199
287
  }