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/cli/settings.ts CHANGED
@@ -6,6 +6,7 @@ import { existsSync, writeFileSync, copyFileSync, mkdirSync } from "node:fs";
6
6
  import { join, dirname } from "node:path";
7
7
  import { homedir } from "node:os";
8
8
  import { readText, KNOWN_AGENTS, MODEL_FLAGS } from "./state.ts";
9
+ import { status as chatgptStatus } from "./chatgpt.ts";
9
10
 
10
11
  // `text` is a value typed rather than chosen: a path. It has no values to cycle.
11
12
  // `when`: the row only has an effect while that other key holds that value; both
@@ -110,29 +111,28 @@ const SETTINGS: Setting[] = [
110
111
  { key: "auto_accept", label: "Auto runs skip final approval", group: "Approvals", values: ["false", "true"], help: "true: an auto run that changed files finishes without waiting, marked auto-accepted", when: ["mode", "auto"] },
111
112
  { key: "approvals.each_file", label: "Confirm every file edit", group: "Approvals", values: ["true", "false"], help: "", when: ["mode", "approve"] },
112
113
  { key: "explore.enabled", label: "Explore before planning", group: "Agents", values: ["false", "true"], help: "Question the idea and research uncertainties before Plan. Clear fixes skip it; each run can skip Explore." },
113
- { key: "runner", label: "Stage isolation", group: "Agents", values: ["full", "lite"], help: "full: separate agent per stage. lite: one session" },
114
+ { key: "runner", label: "Agents per run", group: "Agents", values: ["full", "lite"], help: "full: a separate agent for each stage (plan, build, review). lite: one session does every stage, cheaper" },
114
115
  { key: "build.executor", label: "Who builds", group: "Agents", values: ["subagent", "inline", "ask"], help: "subagent: its own agent · inline: this session · ask: pick at plan approval", when: ["runner", "full"] },
115
116
  { key: "review.executor", label: "Reviewer", group: "Agents", values: ["inline", "subagent", "ask"], help: "subagent: its own cold agent · inline: this session · ask: pick before review", when: ["runner", "lite"] },
116
117
  { key: "agent.default", label: "Default agent", group: "Agents", values: ["auto", "claude", "codex", "agy", "opencode", "gemini"], help: "" },
117
- { key: "agent.launch", label: "Where agents run", group: "Agents", values: ["card", "terminal"], help: "" },
118
- { key: "agent.keep_alive", label: "Keep agents through a kaizen restart", group: "Agents", values: ["off", "tmux"], help: "tmux: Linux and macOS with tmux installed. The wheel scrolls tmux history; Shift+drag copies", when: ["agent.launch", "card"] },
118
+ { key: "agent.keep_alive", label: "Keep agents through a kaizen restart", group: "Agents", values: ["off", "tmux"], help: "tmux: Linux and macOS with tmux installed. The wheel scrolls tmux history; Shift+drag copies" },
119
119
  { key: "agent.keep_awake", label: "Keep computer awake", group: "Board", values: ["off", "auto", "on"], help: "auto: while kaizen runs agents · on: while kaizen is open. Linux and macOS" },
120
120
  { key: "agent.heartbeat_minutes", label: "Agent heartbeat", group: "Board", values: ["2", "5", "10", "30"], help: "Minutes. A card says stale after two quiet intervals" },
121
- { key: "subagents.model", label: "Claude Code", group: "Agents", values: ["inherit", "opus", "sonnet", "haiku"], help: "Its stage subagents: planner, builder, reviewer", when: ["runner", "full"] },
122
- { key: "subagents.effort", label: "Claude Code effort", group: "Agents", values: ["inherit", "low", "medium", "high"], help: "Planner, builder, reviewer", when: ["runner", "full"] },
123
- { key: "subagents.planner", label: "Claude Code planner", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "default: the model above", when: ["runner", "full"] },
124
- { key: "subagents.builder", label: "Claude Code builder", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "Also runs the fix rounds. default: the model above", when: ["runner", "full"] },
125
- { key: "subagents.reviewer", label: "Claude Code reviewer", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "Also runs the rechecks. default: the model above", when: ["runner", "full"] },
121
+ { key: "subagents.model", label: "Stage model", group: "Agents", values: ["inherit", "opus", "sonnet", "haiku"], help: "The model for Claude Code's stage subagents: planner, builder, reviewer", when: ["runner", "full"] },
122
+ { key: "subagents.effort", label: "Stage effort", group: "Agents", values: ["inherit", "low", "medium", "high"], help: "Planner, builder, reviewer", when: ["runner", "full"] },
123
+ { key: "subagents.planner", label: "Planner model", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "default: the model above", when: ["runner", "full"] },
124
+ { key: "subagents.builder", label: "Builder model", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "Also runs the fix rounds. default: the model above", when: ["runner", "full"] },
125
+ { key: "subagents.reviewer", label: "Reviewer model", group: "Agents", values: ["default", "opus", "sonnet", "haiku"], help: "Also runs the rechecks. default: the model above", when: ["runner", "full"] },
126
126
  { key: "auto_fix.enabled", label: "Fix findings automatically", group: "Auto-fix", values: ["true", "false"], help: "" },
127
127
  { key: "auto_fix.min_severity", label: "Lowest severity to fix", group: "Auto-fix", values: ["critical", "high", "medium", "low"], help: "", when: ["auto_fix.enabled", "true"] },
128
128
  { key: "auto_fix.max_iterations", label: "Max fix rounds", group: "Auto-fix", values: ["1", "2", "3", "4", "5"], help: "", when: ["auto_fix.enabled", "true"] },
129
- { key: "auto_guard.max_files", label: "Auto mode: stop above this many changed files", group: "Auto-fix", values: ["10", "25", "50", "0"], help: "0 turns the check off" },
130
- { key: "auto_guard.stop_on", label: "Auto mode: stop on an open finding at", group: "Auto-fix", values: ["critical", "high", "medium", "low", "off"], help: "" },
129
+ { key: "auto_guard.max_files", label: "Hold an auto run above this many files", group: "Auto-fix", values: ["10", "25", "50", "0"], help: "An auto run that changes more files waits for your approval. 0: never hold" },
130
+ { key: "auto_guard.stop_on", label: "Hold an auto run on a finding of", group: "Auto-fix", values: ["critical", "high", "medium", "low", "off"], help: "This severity or higher, still open after the fix rounds, makes an auto run wait for your approval. off: never hold" },
131
131
  { key: "git.auto_commit", label: "Commit when done", group: "Git", values: ["false", "true"], help: "Never pushes" },
132
- { key: "git.worktree_per_run", label: "Branch and folder per run", group: "Git", values: ["ask", "true", "false"], help: "" },
133
- { key: "git.generated", label: "Generated files", group: "Git", values: [], text: true, help: "Path patterns, space-separated. A land takes the base's side on conflict. Empty: none" },
134
- { key: "git.rebuild_on_land", label: "Rebuild after resolving", group: "Git", values: [], text: true, help: "Command that remakes the generated files. Empty: none" },
135
- { key: "git.land_check", label: "Check before landing", group: "Git", values: [], text: true, help: "After a rebase that pulled commits. auto: the test script in package.json · off · or a command" },
132
+ { key: "git.worktree_per_run", label: "Own branch and folder per run", group: "Git", values: ["ask", "true", "false"], help: "true: each run works in its own branch and folder. false: in the project folder. ask: choose each time" },
133
+ { key: "git.generated", label: "Generated files", group: "Git", values: [], text: true, help: "Files a build writes, as path patterns separated by spaces. If landing a run conflicts on one, the base branch's version wins. Empty: none" },
134
+ { key: "git.rebuild_on_land", label: "Regenerate after a conflict", group: "Git", values: [], text: true, help: "A command that rebuilds the generated files once a conflict is settled. Empty: none" },
135
+ { key: "git.land_check", label: "Check before landing", group: "Git", values: [], text: true, help: "Runs before a run lands, when the rebase pulled in new commits. auto: your package.json test script · off · or any command" },
136
136
  { key: "orchestration.enabled", label: "Build with workers", group: "Orchestration", values: ["false", "true"], help: "Off by default. A plan may split into workers, each in its own terminal and folder. Linux and macOS only" },
137
137
  { key: "orchestration.max_workers", label: "Max workers per run", group: "Orchestration", values: ["1", "2", "3", "4", "5", "6"], help: "Total per run", when: ["orchestration.enabled", "true"] },
138
138
  { key: "orchestration.permissions", label: "Worker permissions", group: "Orchestration", values: ["own", "bypass"], help: "own: each agent's own prompts. Bypass skips every prompt in every worker", when: ["orchestration.enabled", "true"] },
@@ -150,9 +150,7 @@ const SETTINGS: Setting[] = [
150
150
  { key: "sources.effort", label: "ChatGPT effort for the icebox", group: "Board", values: ["low", "medium", "high"], help: "Gathering, sorting and task drafts" },
151
151
  { key: "board.projects_dir", label: "Projects folder", group: "Board", values: [], text: true, folder: true, help: "Empty: known projects only" },
152
152
  { key: "board.video_dir", label: "Video library folder", group: "Board", values: [], text: true, folder: true, help: "Empty: ~/.kaizen" },
153
- { key: "board.open", label: "Open kaizen in", group: "Board", values: ["browser", "app"], help: "" },
154
153
  { key: "board.chat_hotkey", label: "Popup chat hotkey", group: "Board", values: [], text: true, help: "Hyprland, e.g. SUPER + ALT + SPACE. Empty: none" },
155
- { key: "ui.mouse", label: "Enable mouse", group: "Terminal", values: ["false", "true"], help: "" },
156
154
  ];
157
155
 
158
156
  // The same rows and the same write the TUI uses, for `kaizen web`'s settings panel:
@@ -177,7 +175,8 @@ export function listSettings(repoRoot: string, project?: string | null) {
177
175
  };
178
176
  });
179
177
  const valueOf = (k: string) => rows.find((r) => r.key === k)?.value ?? null;
180
- return { file: tilde(file), rows: rows.map((r) => ({ ...r, idle: idle(r, valueOf) })) };
178
+ const gpt = /^sources\.(model|effort)$/;
179
+ return { file: tilde(file), rows: rows.map((r) => ({ ...r, idle: idle(r, valueOf) || (gpt.test(r.key) && !chatgptStatus().connected ? "No effect until ChatGPT is connected in the Icebox" : "") })) };
181
180
  }
182
181
 
183
182
  // Why a row has no effect right now, or "" while it has one: its `when` is not met.
package/cli/state.ts CHANGED
@@ -1097,21 +1097,9 @@ export function notice(c: Card): string | null {
1097
1097
  return what && `${c.text} — ${what}\n${c.where}`;
1098
1098
  }
1099
1099
 
1100
- // When a notice is worth sending, for both UIs: each keeps one of these, and the
1101
- // board page is served this very function, so it must stand on its own -- no
1102
- // imports, no outer names. A run never seen before says nothing, which covers first
1103
- // load and a run arriving already waiting. A `done` within a minute of the run
1104
- // leaving a wait was finished by the person's own decision, so that one stays quiet.
1105
- // ponytail: a fixed minute; an approval whose last writes take longer still pings.
1106
- export function notifier() {
1107
- const said = new Map<string, string | null>(), left = new Map<string, number>();
1108
- return (key: string, say: string | null, done: boolean, now: number) => {
1109
- const before = said.get(key);
1110
- said.set(key, say);
1111
- if (before && say !== before) left.set(key, now);
1112
- return before !== undefined && !!say && say !== before && !(done && now - (left.get(key) ?? -Infinity) < 60_000);
1113
- };
1114
- }
1100
+ // When a notice is worth sending, for both UIs: the terminal board and the web board each keep one of these. The rule is
1101
+ // web/lib/core/notifier.ts, so the board's bundle carries the very function this file exports.
1102
+ export { notifier } from "../web/lib/core/notifier.ts";
1115
1103
 
1116
1104
  export const LOGO = join(dirname(import.meta.dir), "assets", "kaizen-logo.png");
1117
1105
 
@@ -1596,7 +1584,6 @@ export function closeEnabled(projectDir: string) {
1596
1584
  return true;
1597
1585
  }
1598
1586
 
1599
- // agent.launch in the config chain: where the web board runs what it launches.
1600
1587
  // agent.keep_alive: tmux keeps a card's agent in a tmux session that outlives the board.
1601
1588
  export function keepAlive(projectDir: string): "off" | "tmux" {
1602
1589
  for (const t of configTexts(projectDir)) {
@@ -1622,14 +1609,6 @@ export function keepAwake(text = existsSync(join(home, ".kaizen", "config.yml"))
1622
1609
  return (/^agent:\n(?:[ \t][^\n]*\n)*?[ \t]+keep_awake:[ \t]*["']?([^"'\s]+)/m.exec(text) || /^agent\.keep_awake:[ \t]*["']?([^"'\s]+)/m.exec(text))?.[1] ?? "off";
1623
1610
  }
1624
1611
 
1625
- export function launchMode(projectDir: string): "card" | "terminal" {
1626
- for (const t of configTexts(projectDir)) {
1627
- const m = /^agent:\n(?:[ \t][^\n]*\n)*?[ \t]+launch:[ \t]*["']?([^"'\s]+)/m.exec(t) || /^agent\.launch:[ \t]*["']?([^"'\s]+)/m.exec(t);
1628
- if (m) return m[1] === "terminal" ? "terminal" : "card";
1629
- }
1630
- return "card";
1631
- }
1632
-
1633
1612
  // Whether a live PID is still the agent a record launched, not a stranger that reused
1634
1613
  // the number: the tool's name (and conversation id) in its arguments, started no
1635
1614
  // earlier than the record. On Windows the PID is the PowerShell kaizen opened.
@@ -1864,7 +1843,7 @@ export function launchRun(it: Item, from: string, run?: string, pick: { agent?:
1864
1843
  const exploreChoice = !run && !pick.skill && typeof pick.explore === "boolean" ? `\n\n[Kaizen launch option: explore=${pick.explore ? "on" : "off"}. Freeze this per-run override at intake; it does not change the saved setting.]` : "";
1865
1844
  const prompt = !it.text ? "" : requestOf(it.where ? `${lead} ${it.text} (${it.where})` : `${lead} ${it.text}`, it.notes, from) + exploreChoice + (pick.task ? `
1866
1845
 
1867
- [Task context: task=${pick.task.id}; run=${run ?? "new"}; initial proposal confirmation=${pick.task.requirePlanConfirmation ? "required" : "already confirmed"}. Read task.json in .kaizen/tasks/${pick.task.id}/. Preserve task identity and frozen task_policy. Use kaizen task events for replies/questions/proposals/work receipts/results; questions do not authorize production. Do not produce until the current proposal is explicitly confirmed. Keep real tool permissions unchanged.]` : "");
1846
+ [Task context: task=${pick.task.id}; run=${run ?? "new"}; initial proposal confirmation=${pick.task.requirePlanConfirmation ? "required" : "already confirmed"}. Read task.json in .kaizen/tasks/${pick.task.id}/. Preserve task identity and frozen task_policy. Use kaizen task events for replies/questions/proposals/work receipts/results; questions do not authorize production. Do not produce until the current plan is approved. The user may approve or answer on the task page, the run panel, or in this terminal; record a decision typed here with task event {type:'approved'} or {type:'answered',text}. Keep real tool permissions unchanged.]` : "");
1868
1847
  const wanted = pick.model ?? (own?.cmd === agent.cmd ? own.model : null) ?? undefined;
1869
1848
  const model = wanted && plainModel(wanted) ? wanted : undefined;
1870
1849
  // Yolo was picked for one tool; a fallback to another opens in its normal mode.
@@ -2072,6 +2051,13 @@ export function acceptance(state: string, id: string): "user" | "auto" | null {
2072
2051
  return m ? (m[1].startsWith("auto") ? "auto" : "user") : null;
2073
2052
  } catch { return null; }
2074
2053
  }
2054
+ // When the user's acceptance was written, in ms; null when there is none.
2055
+ export function acceptedAt(state: string, id: string): number | null {
2056
+ try {
2057
+ const m = /^accepted: (\S+) by user via /m.exec(readText(join(state, "runs", id, "02-approval.md")));
2058
+ return m ? Date.parse(m[1]) || null : null;
2059
+ } catch { return null; }
2060
+ }
2075
2061
  export function recordAcceptance(state: string, id: string, via: "board" | "chat" | "auto"): string | null {
2076
2062
  if (acceptance(state, id)) return "That run is already approved.";
2077
2063
  const who = via === "auto" ? "auto (auto_accept)" : `by user via ${via}`;
@@ -2145,9 +2131,9 @@ export function setRunState(state: string, id: string, pairs: string[]): string
2145
2131
  let existing: any;
2146
2132
  try { existing = JSON.parse(readText(file)); } catch { return "invalid state.json"; }
2147
2133
  if (existing.task_policy) {
2148
- if (["task_policy", "task_id", "task_confirmed"].some((k) => k in set)) return "task policy is frozen; confirm the current proposal in Tasks";
2134
+ if (["task_policy", "task_id", "task_confirmed"].some((k) => k in set)) return "task policy is frozen; approve the current plan";
2149
2135
  if ((set.stage === "build" || set.stage === "review") && existing.task_policy.requirePlanConfirmation && !existing.task_confirmed)
2150
- return "task production needs explicit confirmation of the current proposal in Tasks";
2136
+ return `the build needs the current plan approved first. Approve it on the task or run page, or ask the user; on a clear yes run: kaizen task event --task ${existing.task_id} --run ${id} --json '{"type":"approved"}'`;
2151
2137
  }
2152
2138
  let now: any = null;
2153
2139
  if (!setStage(file, (s) => { Object.assign(s, set); now = s; return true; })) return `state.json for ${id} changed while writing or is not valid JSON; read it and retry`;
@@ -2189,7 +2175,7 @@ export function finishRun(state: string, id: string, userApproved = false): stri
2189
2175
  if (!existsSync(file)) return `No run ${id}.`;
2190
2176
  let taskRun: any = {};
2191
2177
  try { taskRun = JSON.parse(readText(file)); } catch {}
2192
- if (taskRun.task_policy?.requirePlanConfirmation && !taskRun.task_confirmed) return "task proposal has not been confirmed";
2178
+ if (taskRun.task_policy?.requirePlanConfirmation && !taskRun.task_confirmed) return "the task plan has not been approved";
2193
2179
  if (gateOf(state, id) === "needs") {
2194
2180
  if (!userApproved) return `Run ${id} changed files and the user has not approved it. Ask the user; on a clear yes run: kaizen done ${id} --user-approved`;
2195
2181
  const why = recordAcceptance(state, id, "chat");
@@ -2416,7 +2402,7 @@ export function readCommit(state: string, id: string): { sha: string; pushed: bo
2416
2402
  }
2417
2403
 
2418
2404
  // The card's git mark for each run asked about, by the rules of the panel's button
2419
- // (`gitBtn` in web/board/git.ts): one project status and one read of the reports for
2405
+ // (`gitShown` in web/lib/git/git-panel.ts): one project status and one read of the reports for
2420
2406
  // the lot. A run with nothing to say either way gets no entry.
2421
2407
  // `due`, when given, is filled with what a pending run still needs: "commit" (changed files) or "push" (committed, ahead).
2422
2408
  export function cardsGit(state: string, ids: string[], due: Record<string, "commit" | "push"> = {}): Record<string, "pending" | "pushed"> {
@@ -6,9 +6,11 @@ import { join, dirname } from 'node:path';
6
6
  import * as T from './tasks.ts';
7
7
  import * as R from './task-results.ts';
8
8
  import { read as scalar } from './config-values.ts';
9
- import { detectDefaultAgent, home, readInbox, writeInbox, replaceTask, abandonRun, setArchived, readRuns, readText, saveAttachment, acceptance, gateOf } from './state.ts';
9
+ import { detectDefaultAgent, home, readInbox, writeInbox, replaceTask, abandonRun, setArchived, readRuns, readText, requestTitle, saveAttachment, acceptance, acceptedAt, gateOf, recordAcceptance, finishRun } from './state.ts';
10
10
 
11
- type Hooks = { launch: (state:string, run:string, text:string, task:T.Task, pick?:any) => {ok:boolean; pty?:string; why?:string}; alive:(pty:string)=>boolean; stop:(pty:string)=>boolean };
11
+ type Hooks = { launch: (state:string, run:string, text:string, task:T.Task, pick?:any) => {ok:boolean; pty?:string; why?:string}; alive:(pty:string)=>boolean; stop:(pty:string)=>boolean; find?:(state:string,run:string)=>string|undefined;
12
+ // Sends the run's own Approve (review or open findings) to its agent, as the run panel does.
13
+ approve?:(state:string,run:string,awaiting:string)=>string|null };
12
14
  const runtimeLaunches = new Set<string>();
13
15
  const parse = (file:string) => { try { return JSON.parse(readFileSync(file,'utf8')); } catch { return null; } };
14
16
  const put = (file:string,value:unknown) => { const temp = file + `.${process.pid}.${randomUUID()}.tmp`; writeFileSync(temp,JSON.stringify(value,null,2)+'\n'); renameSync(temp,file); };
@@ -18,13 +20,30 @@ export const taskDefaults = (state:string) => ({ agent: detectDefaultAgent(dirna
18
20
  export function resultViews(state:string,id:string) {
19
21
  return R.listResults(state,id).map((r:any)=>({...r,createdAt:r.createdAt??r.created,summary:r.summary??'',checks:r.checks??r.validation??[],artifacts:r.artifacts.map((a:any)=>({...a,url:a.url??`/task-artifact?dir=${encodeURIComponent(state)}&task=${id}&result=${r.id}&artifact=${a.id}`,preview:a.preview??'download'}))}));
20
22
  }
21
- export function taskView(state:string,task:T.Task) {
23
+ // The one place that says which buttons a task may use; the page only draws this list and taskAction refuses the rest.
24
+ const agentKey=(state:string,t:T.Task,hooks?:Hooks)=>t.launch?.pty??(t.activeRun?hooks?.find?.(state,t.activeRun):undefined);
25
+ export function allowedActions(state:string,task:T.Task,hooks?:Hooks) {
26
+ const run=runState(state,task),finished=!!run&&(['done','abandoned'].includes(run.stage)||!!run.healed),live=!!task.activeRun&&!!run&&!finished;
27
+ const key=agentKey(state,task,hooks),alive=!!(key&&hooks?.alive(key));
28
+ let accept=false,acceptWhy:string|undefined;
29
+ try{T.acceptTask(structuredClone(task),task.currentResult??'');accept=true;}catch{/* not acceptable now */}
30
+ // Looks good on a run that waits for its review approval (or open findings) is that approval: it is sent to the run.
31
+ const approvable=!!run&&!run.healed&&['approvals.review','findings'].includes(run.awaiting)&&!!hooks?.approve;
32
+ if(accept&&run&&!finished&&!approvable){accept=false;acceptWhy=run.awaiting?'Resolve the blocking workflow decision first.':'The workflow is still reviewing this result';}
33
+ return {accept,...(acceptWhy?{acceptWhy}:{}),
34
+ stop:(live&&['draft','waiting','working','ready'].includes(task.status))||(['failed','interrupted','working'].includes(task.status)&&alive),
35
+ // A ready task whose run is still in review but whose agent is gone can only finish by relaunching it.
36
+ resume:(['interrupted','failed','stopping'].includes(task.status)||(task.status==='ready'&&live))&&!alive,
37
+ abandon:live||task.status==='stopping',archive:true,delete:!task.runIds.length&&!task.activeRun,
38
+ start:task.status==='draft'&&!task.activeRun&&!task.currentResult&&!!task.project};
39
+ }
40
+ export function taskView(state:string,task:T.Task,hooks?:Hooks) {
22
41
  const p=T.taskProjection(task);
23
42
  const run=runState(state,task), finished=run&&(['done','abandoned'].includes(run.stage)||run.healed);
24
- return {...task,activeRun:finished&&['ready','accepted'].includes(task.status)?null:task.activeRun,projectName:task.project?.split(/[\\/]/).pop()??'Choose a project',dir:state,updatedAt:task.updated,attention:{category:p.filter,reason:p.reason,action:p.action},statusLabel:p.label,decision:!task.project?{id:'project',kind:'project',text:'Choose a named project for your saved goal.'}:task.pendingDecision,messages:task.events,runs:task.runIds,currentResultId:task.currentResult,acceptedResultId:task.acceptedResult};
43
+ return {...task,actions:allowedActions(state,task,hooks),...(hooks?{agentAlive:!!(agentKey(state,task,hooks)&&hooks.alive(agentKey(state,task,hooks)!))}:{}),activeRun:finished&&['ready','accepted'].includes(task.status)?null:task.activeRun,projectName:task.project?.split(/[\\/]/).pop()??'Choose a project',dir:state,updatedAt:task.updated,attention:{category:p.filter,reason:p.reason,action:p.action},statusLabel:p.label,decision:!task.project?{id:'project',kind:'project',text:'Choose a named project for your saved goal.'}:task.pendingDecision,messages:task.events,runs:task.runIds,currentResultId:task.currentResult,acceptedResultId:task.acceptedResult};
25
44
  }
26
45
  export function taskList(states:string[],hooks?:Hooks) {
27
- const tasks=states.flatMap(state=>T.listTasks(state).filter(t=>!t.archived).map(t=>taskView(state,reconcile(state,t,hooks))));
46
+ const tasks=states.flatMap(state=>T.listTasks(state).filter(t=>!t.archived).map(t=>taskView(state,reconcile(state,t,hooks),hooks)));
28
47
  // Legacy rows become durable only when opened. Stable keys include stamps/index,
29
48
  // never a title-based merge; existing inbox and run files are left intact.
30
49
  for(const state of states) {
@@ -42,12 +61,34 @@ export function taskList(states:string[],hooks?:Hooks) {
42
61
  const readTextSafe=(f:string)=>{try{return readText(f);}catch{return null;}};
43
62
  export function reconcile(state:string,task:T.Task,hooks?:Hooks):T.Task {
44
63
  let reason='';
45
- if(task.status==='stopping'&&task.launch?.pty&&hooks&&!hooks.alive(task.launch.pty))return T.mutateTask(state,task.id,{revision:task.revision,opId:`stopped:${task.launch.id}`},T.confirmStopped);
64
+ if(T.normalizePause(structuredClone(task)))task=T.mutateTask(state,task.id,{revision:task.revision,opId:`heal:${task.revision}`},t=>{T.normalizePause(t);});
65
+ // The run finished with a saved result and nothing left to apply: the task is ready, whatever became of the agent.
66
+ // Not while its agent is still alive: clearing launch would stop tracking it; the heal runs once it ends.
67
+ if(['working','interrupted'].includes(task.status)&&task.currentResult&&!task.pendingDecision&&task.inputs.every(i=>['applied','failed'].includes(i.state))&&!(hooks&&task.launch?.pty&&hooks.alive(task.launch.pty))){
68
+ const run=runState(state,task);
69
+ if(run&&(run.stage==='done'||run.healed))return T.mutateTask(state,task.id,{revision:task.revision,opId:`finished:${task.revision}`},t=>{t.status='ready';t.safe=true;t.writePhase=false;t.queuePaused=false;t.error=undefined;t.launch=null;T.addEvent(t,'system','finished','The run finished and the saved result is ready to review.');});
70
+ }
71
+ // The run's acceptance (its Approve in the run panel, or kaizen done --user-approved after a yes in the terminal)
72
+ // is the task's Looks good, when it came after the current result.
73
+ if(task.status==='ready'&&task.currentResult&&task.activeRun&&acceptance(state,task.activeRun)==='user'){
74
+ const at=acceptedAt(state,task.activeRun)??0,made=Date.parse(String(resultViews(state,task.id).find((r:any)=>r.id===task.currentResult)?.createdAt??''))||0;
75
+ if(at>=made){try{const probe=structuredClone(task);T.acceptTask(probe,task.currentResult);return T.mutateTask(state,task.id,{revision:task.revision,opId:`run-accepted:${task.currentResult}`},t=>{T.acceptTask(t,t.currentResult!);});}catch{/* not acceptable yet */}}
76
+ }
77
+ if(task.status==='stopping'&&hooks){
78
+ // Stop is finished when the terminal is gone, or when there is none to wait for. A live one is asked again.
79
+ const key=agentKey(state,task,hooks);
80
+ if(key&&hooks.alive(key)){hooks.stop(key);return task;}
81
+ return T.mutateTask(state,task.id,{revision:task.revision,opId:`stopped:${task.revision}`},t=>stopped(t,key));
82
+ }
46
83
  if(task.launch && ['intent','started'].includes(task.launch.phase) && !runtimeLaunches.has(task.launch.id) && hooks && !(task.launch.pty&&hooks.alive(task.launch.pty))) reason='The launch was interrupted before the agent acknowledged it. Review the existing session before resuming.';
47
84
  else if(task.status==='working'&&task.launch?.pty&&hooks&&!hooks.alive(task.launch.pty)&&!task.safe)reason='The agent ended before reporting a safe handback. Your requests and previous results are saved.';
48
85
  if(reason) return T.mutateTask(state,task.id,{revision:task.revision,opId:`interrupted:${task.launch?.id}`},t=>{T.recoverLaunch(t);t.status='interrupted';t.error=reason;t.queuePaused=true;});
49
86
  return task;
50
87
  }
88
+ function stopped(t:T.Task,key?:string) {
89
+ T.confirmStopped(t);
90
+ if(!key)T.addEvent(t,'system','stop-unverified','No agent terminal was found on this board. If the agent runs somewhere else it may still be working. Resume starts a new session.');
91
+ }
51
92
  function runState(state:string,task:T.Task) { return task.activeRun?parse(join(state,'runs',task.activeRun,'state.json')):null; }
52
93
  export function dispatchReady(state:string,id:string,hooks:Hooks,initial=false,pick?:any):T.Task {
53
94
  let task=T.readTask(state,id)!;
@@ -71,7 +112,7 @@ export function dispatchReady(state:string,id:string,hooks:Hooks,initial=false,p
71
112
  const context=JSON.stringify({task:id,launch:task.launch.id,inputIds:ids,currentResult:task.currentResult,initialConfirmed:task.initialConfirmed});
72
113
  const command=`${JSON.stringify(process.execPath)} ${JSON.stringify(join(import.meta.dir,'install.ts'))}`;
73
114
  const protocol=join(dirname(import.meta.dir),'skills','kaizen','spec.md');
74
- const text=`Resume run ${run} for the persistent task. Read its state and request. Task context: ${context}. ${task.initialConfirmed?'Routine revision is authorized; preserve the accepted direction. Material scope changes require a new proposal.':'Perform intake/clarification and planning only. Publish a concise proposal and wait for explicit confirmation before any production, even in auto mode.'} Task protocol source: ${protocol}. Use the current implementation command ${command} task (the globally installed kaizen may be older). First acknowledge this launch with ${command} task event --task ${id} --run ${run} --json '${JSON.stringify({type:'ack',launchId:task.launch.id})}'. Structured event types: ack {launchId}, reply/question/proposal {text,details?,options?}, work {text}, receipt {inputIds,outcome:'applied'|'failed'}, boundary {text}, result {title,summary,artifacts:[{path|url,name?}],checks:[],limitations:[]}. Pass --operation a stable id for replay. A receipt acknowledges only dispatched ids; boundary means no active writes. Publish only settled completed files; never claim registration backend checks from a rendered form. Read the source workflow Task protocol. Inputs: ${task.inputs.filter(i=>ids.includes(i.id)).map(i=>`[${i.id}] ${i.text}`).join('\n')}`;
115
+ const text=`Resume run ${run} for the persistent task. Read its state and request. Task context: ${context}. ${task.initialConfirmed?'Routine revision is authorized; preserve the accepted direction. Material scope changes require a new proposal.':'Perform intake/clarification and planning only. Publish a concise proposal and wait for explicit confirmation before any production, even in auto mode.'} Task protocol source: ${protocol}. Use the current implementation command ${command} task (the globally installed kaizen may be older). First acknowledge this launch with ${command} task event --task ${id} --run ${run} --json '${JSON.stringify({type:'ack',launchId:task.launch.id})}'. Structured event types: ack {launchId}, reply/question/proposal {text,details?,options?}, approved {} and answered {text} when the user approves the plan or answers in this terminal, work {text}, receipt {inputIds,outcome:'applied'|'failed'}, boundary {text}, result {title,summary,artifacts:[{path|url,name?}],checks:[],limitations:[]}. Pass --operation a stable id for replay. A receipt acknowledges only dispatched ids; boundary means no active writes. Publish only settled completed files; never claim registration backend checks from a rendered form. Read the source workflow Task protocol. Inputs: ${task.inputs.filter(i=>ids.includes(i.id)).map(i=>`[${i.id}] ${i.text}`).join('\n')}`;
75
116
  runtimeLaunches.add(task.launch.id);
76
117
  let outcome;try{
77
118
  const selected=detectDefaultAgent(dirname(state)), requested=config(state,'agent.default','auto');
@@ -92,7 +133,7 @@ export function taskAction(state:string,body:any,hooks:Hooks):{state:string;task
92
133
  if(op==='adopt'){
93
134
  const l=body.legacy??{};let goal='',key='';
94
135
  if(l.kind==='run'){const run=readRuns(state).find(r=>r.id===l.id);if(!run)throw new T.TaskError('Existing run unavailable',404);key=`run:${run.id}`;goal=readTextSafe(join(state,'runs',run.id,'00-request.md'))??run.id;}else{const line=readInbox(state)[Number(l.index)];if(!line||line.added!==l.added)throw new T.TaskError('Task changed; refresh');key=`inbox:${line.added??'legacy'}:${l.index}`;goal=line.text;}
95
- let task=T.adoptTask(state,key,{goal,project:dirname(state)});
136
+ let task=T.adoptTask(state,key,{goal,project:dirname(state),title:l.kind==='run'?requestTitle(goal)||undefined:undefined});
96
137
  if(l.kind==='run'&&!task.activeRun)task=T.mutateTask(state,task.id,{revision:task.revision,opId:`link:${l.id}`},t=>{
97
138
  const file=join(state,'runs',l.id,'state.json'),run=parse(file);t.activeRun=l.id;t.runIds=[l.id];
98
139
  const finished=run&&['done','abandoned'].includes(run.stage);
@@ -115,23 +156,30 @@ export function taskAction(state:string,body:any,hooks:Hooks):{state:string;task
115
156
  return {state,task};
116
157
  }
117
158
  const found=T.resolveTask(state,String(body.id??''));if(!found)throw new T.TaskError('Unknown task',404);state=found.state;let task=reconcile(state,found.task,hooks);
118
- const mutation={revision:Number(body.revision),opId:operationId};
159
+ // Reconcile may bump the revision between the page's read and this call; a page that held the revision read just before it is not stale.
160
+ const mutation={revision:Number(body.revision)===found.task.revision&&['stop','abandon','archive'].includes(op)?task.revision:Number(body.revision),opId:operationId};
119
161
  if(task.operations.includes(operationId))return {state,task};
162
+ const allowed=allowedActions(state,task,hooks);
120
163
  if(op==='start'){task=T.mutateTask(state,task.id,mutation,t=>{if(t.status!=='draft')throw new T.TaskError('Task already started');});return {state,task:dispatchReady(state,task.id,hooks,true,body.pick&&typeof body.pick==='object'?body.pick:undefined)};}
121
164
  if(op==='delete'||op==='archive'||op==='abandon'){
122
165
  // Closing a task: Delete only before any run exists; Archive hides it; Abandon ends its run.
123
166
  if(op==='delete'){
124
- if(task.runIds.length||task.activeRun)throw new T.TaskError('A run already started. Archive or abandon it instead.');
167
+ if(!allowed.delete)throw new T.TaskError('A run already started. Archive or abandon it instead.');
125
168
  replaceTask(state,task.goal,null);T.deleteTask(state,task.id);return {state,task};
126
169
  }
127
- if(op==='abandon'){
128
- if(!task.activeRun)throw new T.TaskError('No run to abandon');
129
- const key=task.launch?.pty;if(key&&hooks.alive(key))hooks.stop(key);
130
- const bad=abandonRun(state,task.activeRun,String(body.why??'').trim()||'abandoned from the task page');if(bad)throw new T.TaskError(bad);
131
- }else if(task.activeRun)setArchived(state,task.activeRun,true);
132
- else{const lines=readInbox(state),at=lines.findIndex(l=>l.status==='open'&&l.text===task.goal);if(at>=0){lines[at]={...lines[at]!,status:'archived'};writeInbox(state,lines);}}
133
- return {state,task:T.mutateTask(state,task.id,mutation,t=>{t.archived=true;})};
170
+ if(op==='abandon'&&!task.activeRun)throw new T.TaskError('No run to abandon');
171
+ // Side effects run inside the mutation, after the revision check and under the task lock, so a stale page changes nothing.
172
+ // A run that is already done, already abandoned or gone counts as success: the task is archived either way.
173
+ return {state,task:T.mutateTask(state,task.id,mutation,t=>{
174
+ if(op==='abandon'){
175
+ const run=runState(state,t);
176
+ if(run&&!['done','abandoned'].includes(run.stage)){const key=agentKey(state,t,hooks);if(key&&hooks.alive(key))hooks.stop(key);const bad=abandonRun(state,t.activeRun!,String(body.why??'').trim()||'abandoned from the task page');if(bad)throw new T.TaskError(bad);}
177
+ }else if(t.activeRun)setArchived(state,t.activeRun,true);
178
+ else{const lines=readInbox(state),at=lines.findIndex(l=>l.status==='open'&&l.text===t.goal);if(at>=0){lines[at]={...lines[at]!,status:'archived'};writeInbox(state,lines);}}
179
+ t.archived=true;
180
+ })};
134
181
  }
182
+ if(op==='stop'&&!allowed.stop)return {state,task};
135
183
  task=T.mutateTask(state,task.id,mutation,t=>{
136
184
  if(op==='message'){
137
185
  const text=String(body.text??'').trim();const status=body.intent==='question'||/^\s*(status\??|what(?:'s| is) (?:the )?(?:status|progress)\??|how (?:is|are) (?:it|things|the task) (?:going|doing)\??)\s*$/i.test(text);
@@ -140,32 +188,44 @@ export function taskAction(state:string,body:any,hooks:Hooks):{state:string;task
140
188
  T.receiveInput(t,{id:operationId,text,intent:answer?'answer':'change',baseResult:body.baseResultId??null});
141
189
  if(answer||t.pendingDecision?.kind==='proposal'){t.pendingDecision=null;t.safe=true;t.status='draft';}
142
190
  }else if(op==='stop'){T.requestStop(t);}
143
- else if(op==='resume'){if(t.launch?.pty&&hooks.alive(t.launch.pty))throw new T.TaskError('The existing agent is still alive. Stop it or reconcile it in Technical details before resuming.');T.resumeTask(t);}
191
+ else if(op==='resume'){const key=agentKey(state,t,hooks);if(key&&hooks.alive(key))throw new T.TaskError('The existing agent is still alive. Stop it or reconcile it in Technical details before resuming.');if(!allowed.resume)throw new T.TaskError('This task does not need recovery');T.resumeTask(t);}
144
192
  else if(op==='accept'){
145
- const run=runState(state,t);if(run&&!['done','abandoned'].includes(run.stage)&&!run.healed)throw new T.TaskError('Workflow checks are still running. Wait for completed work before accepting.');
146
- if(run?.awaiting&&!run.healed)throw new T.TaskError('Resolve the blocking workflow decision first.');
193
+ if(!allowed.accept)throw new T.TaskError(allowed.acceptWhy??'Finish the active work and pending decisions before accepting this result');
194
+ T.acceptTask(structuredClone(t),String(body.resultId??''));
195
+ // Looks good is also the run's approval, so neither page is left waiting on the other.
196
+ const run=runState(state,t);
197
+ if(run&&t.activeRun){
198
+ if(run.healed||run.stage==='done'){if(gateOf(state,t.activeRun)==='needs'){const why=recordAcceptance(state,t.activeRun,'board');if(why)throw new T.TaskError(why,409);}if(run.healed){const why=finishRun(state,t.activeRun);if(why)throw new T.TaskError(why,409);}}
199
+ else if(['approvals.review','findings'].includes(run.awaiting)){const why=hooks.approve?hooks.approve(state,t.activeRun,run.awaiting):'This board cannot approve the run';if(why)throw new T.TaskError(why,409);}
200
+ }
147
201
  T.acceptTask(t,String(body.resultId??''));
148
202
  }else if(op==='confirm'){
149
- const d=t.pendingDecision;if(!d||d.kind!=='proposal'||d.id!==body.decisionId||d.run!==t.activeRun||d.result!==t.currentResult)throw new T.TaskError('This proposal changed. Refresh and review it again.');
150
- const file=join(state,'runs',t.activeRun!,'state.json'),run=parse(file);if(!run||Number(run.iteration??0)!==d.iteration||(run.awaiting!=='approvals.plan'&&run.task_confirmed?.proposal!==d.id))throw new T.TaskError('This run is no longer waiting for this proposal.');
151
- put(file,{...run,task_confirmed:{proposal:d.id,iteration:d.iteration,at:Date.now()},awaiting:null});
152
- const approval=join(state,'runs',t.activeRun!,'02-approval.md');writeFileSync(approval,(readTextSafe(approval)??'')+`\nTask proposal ${d.id} explicitly confirmed by user via board at ${new Date().toISOString()}.\n`);
153
- t.initialConfirmed=true;t.pendingDecision=null;t.safe=true;t.status='draft';T.addEvent(t,'user','confirm','Proposal confirmed.');
203
+ const d=t.pendingDecision;if(!d||d.kind!=='proposal'||d.id!==body.decisionId||d.run!==t.activeRun||d.result!==t.currentResult)throw new T.TaskError('This plan changed. Refresh and review it again.');
204
+ approvePlan(state,t,d,'board');t.status='draft';
154
205
  // The same run continues with a durable input receipt.
155
- T.receiveInput(t,{id:operationId+':continue',text:'The current proposal is confirmed. Continue production under the frozen task policy.',intent:'answer',baseResult:t.currentResult});
206
+ T.receiveInput(t,{id:operationId+':continue',text:'The current plan is approved. Continue production under the frozen task policy.',intent:'answer',baseResult:t.currentResult});
156
207
  }else throw new T.TaskError('Unknown task action',400);
157
208
  });
158
209
  if(op==='stop'){
159
- const key=task.launch?.pty;if(key&&hooks.alive(key))hooks.stop(key);
160
- else if(key)task=T.mutateTask(state,task.id,{revision:task.revision,opId:operationId+':stopped'},T.confirmStopped);
161
- else task=T.mutateTask(state,task.id,{revision:task.revision,opId:operationId+':unsupported'},t=>{t.error='This agent is outside the board. Stop it in Technical details and confirm its session has ended before resuming.';});
210
+ const key=agentKey(state,task,hooks);
211
+ if(key&&hooks.alive(key))hooks.stop(key);
212
+ else try{task=T.mutateTask(state,task.id,{revision:task.revision,opId:operationId+':stopped'},t=>stopped(t,key));}
213
+ catch{task=T.readTask(state,task.id)!;/* the pump confirmed the stop first: same outcome */}
162
214
  }else if(['message','confirm','resume'].includes(op))task=dispatchReady(state,task.id,hooks,op==='resume'&&!task.inputs.some(i=>['queued','received'].includes(i.state)));
163
215
  return {state,task};
164
216
  }
165
217
 
166
218
  // CLI-only structured events. Raw terminal text is never an acknowledgement.
219
+ // The plan's approval, wherever the user gave it: the task page, the run panel, or a yes typed to the agent.
220
+ function approvePlan(state:string,t:T.Task,d:T.TaskDecision,via:'board'|'terminal'){
221
+ const file=join(state,'runs',d.run!,'state.json'),run=parse(file);if(!run||Number(run.iteration??0)!==d.iteration||(run.awaiting!=='approvals.plan'&&run.task_confirmed?.proposal!==d.id))throw new T.TaskError('This run is no longer waiting for this plan.');
222
+ put(file,{...run,task_confirmed:{proposal:d.id,iteration:d.iteration,at:Date.now(),via},awaiting:null});
223
+ const approval=join(state,'runs',d.run!,'02-approval.md');writeFileSync(approval,(readTextSafe(approval)??'')+`\nTask proposal ${d.id} explicitly confirmed by user via ${via} at ${new Date().toISOString()}.\n`);
224
+ t.initialConfirmed=true;t.pendingDecision=null;t.safe=true;T.addEvent(t,'user','confirm',via==='terminal'?'Plan approved in the agent terminal.':'Plan approved.');
225
+ }
167
226
  export function taskEvent(state:string,id:string,runId:string,event:any,operationId:string):T.Task {
168
227
  const task=T.readTask(state,id);if(!task||task.activeRun!==runId)throw new T.TaskError('This run does not own the task');
228
+ let preserving=false;
169
229
  try { return T.mutateTask(state,id,{revision:task.revision,opId:operationId},t=>{
170
230
  const run=runState(state,t);if(!run||run.task_id!==id)throw new T.TaskError('Run task identity does not match');
171
231
  if(event.type==='ack'){T.acknowledgeLaunch(t,String(event.launchId),runId,t.launch?.pty);}
@@ -175,19 +235,39 @@ export function taskEvent(state:string,id:string,runId:string,event:any,operatio
175
235
  t.pendingDecision={id:randomUUID(),kind:event.type,text:String(event.text),run:runId,iteration:run.iteration??0,result:t.currentResult,...(event.details?{details:String(event.details)}:{}),...(Array.isArray(event.options)?{options:event.options.map(String)}:{})};t.status='waiting';t.safe=true;T.addEvent(t,'assistant',event.type,event.text);
176
236
  if(t.launch)t.launch.phase='acknowledged';
177
237
  if(event.type==='proposal')put(join(state,'runs',runId,'state.json'),{...run,awaiting:'approvals.plan',task_policy:{requirePlanConfirmation:true},task_confirmed:null});
238
+ }else if(event.type==='approved'){
239
+ // The user approved the plan by typing to the agent: the agent records it and goes on, nothing is queued.
240
+ const d=t.pendingDecision;
241
+ if(d?.kind==='proposal'&&d.run===runId){approvePlan(state,t,d,'terminal');t.status='working';}
242
+ else if(!run.task_confirmed)throw new T.TaskError('No plan is waiting for approval on this run',409);
243
+ }else if(event.type==='answered'){
244
+ // The user answered (or asked for plan changes) in the agent terminal: the decision is settled there.
245
+ const text=String(event.text??'').trim();if(!text)throw new T.TaskError('The answer text is required',400);
246
+ if(!t.pendingDecision||t.pendingDecision.run!==runId)throw new T.TaskError('Nothing is waiting for an answer on this run',409);
247
+ t.pendingDecision=null;t.safe=true;t.status='working';T.addEvent(t,'user','message',text+' (in the agent terminal)');
178
248
  }else if(event.type==='work'){
179
- if(run.task_policy?.requirePlanConfirmation&&!run.task_confirmed)throw new T.TaskError('Proposal confirmation is required before production');
249
+ if(run.task_policy?.requirePlanConfirmation&&!run.task_confirmed)throw new T.TaskError('Plan approval is required before the build');
180
250
  t.safe=false;t.status='working';T.addEvent(t,'assistant','work',String(event.text??'Working on the task'));
181
251
  }else if(event.type==='receipt'){T.acknowledgeInputs(t,event.inputIds??[],event.outcome==='failed'?'failed':'applied',event.error);}
182
252
  else if(event.type==='boundary'){T.safeBoundary(t,runId,String(event.text??'Work reached a safe boundary'));}
183
253
  else if(event.type==='result'){
184
- if(run.task_policy?.requirePlanConfirmation&&!run.task_confirmed)throw new T.TaskError('Proposal confirmation is required');
254
+ if(run.task_policy?.requirePlanConfirmation&&!run.task_confirmed)throw new T.TaskError('Plan approval is required');
185
255
  if(t.inputs.some(i=>i.state==='dispatched'))throw new T.TaskError('Acknowledge the dispatched requests before publishing a result');
186
- const result=R.publishResult(state,id,{...event,runId,iteration:run.iteration??0,roots:[dirname(state),...(typeof run.worktree==='string'?[run.worktree]:[])],id:stableUuid(`${id}:${runId}:${operationId}`)});
187
- t.currentResult=result.id;t.acceptedResult=null;t.status='ready';t.safe=true;t.pendingDecision=null;if(t.launch)t.launch.phase='acknowledged';T.addEvent(t,'assistant','result',String(event.summary??event.title??'Result ready'));
256
+ preserving=true;const result=R.publishResult(state,id,{...event,runId,iteration:run.iteration??0,roots:[dirname(state),...(typeof run.worktree==='string'?[run.worktree]:[])],id:stableUuid(`${id}:${runId}:${operationId}`)});
257
+ preserving=false;
258
+ // A result that lands while the task is stopping is saved, but the stop stands.
259
+ if(['stopping','interrupted'].includes(t.status)){t.currentResult=result.id;t.acceptedResult=null;T.addEvent(t,'assistant','result',String(event.summary??event.title??'Result ready'));return;}
260
+ t.currentResult=result.id;t.acceptedResult=null;t.status='ready';t.safe=true;t.pendingDecision=null;t.queuePaused=false;t.error=undefined;if(t.launch)t.launch.phase='acknowledged';T.addEvent(t,'assistant','result',String(event.summary??event.title??'Result ready'));
188
261
  }else throw new T.TaskError('Unknown task event',400);
189
262
  }); } catch (error) {
190
- if(event.type==='result'){const current=T.readTask(state,id)!;T.mutateTask(state,id,{revision:current.revision,opId:operationId+':preservation-failed'},t=>{t.error=(error as Error).message;t.status='failed';t.queuePaused=true;T.addEvent(t,'system','preservation-failed',`This result could not be preserved. ${t.error} Earlier saved results remain available.`);});}
263
+ if(event.type==='result'){
264
+ const current=T.readTask(state,id)!,disk=preserving&&((error as T.TaskError).status===507||!(error instanceof T.TaskError));
265
+ // Only a failed copy to disk pauses the task. A refused result (unreceipted input, unconfirmed proposal, bad output) is fixed and published again.
266
+ T.mutateTask(state,id,{revision:current.revision,opId:operationId+':preservation-failed'},t=>{
267
+ if(disk){t.error=(error as Error).message;t.status='failed';t.queuePaused=true;T.addEvent(t,'system','preservation-failed',`This result could not be preserved. ${t.error} Earlier saved results remain available.`);}
268
+ else T.addEvent(t,'system','result-refused',`The result was not accepted yet: ${(error as Error).message}. The agent can fix this and publish again.`);
269
+ });
270
+ }
191
271
  throw error;
192
272
  }
193
273
  }
package/cli/tasks.ts CHANGED
@@ -179,20 +179,26 @@ export function recoverLaunch(task: Task) {
179
179
  export function requestStop(task: Task) { task.queuePaused = true; task.status = "stopping"; task.safe = false; addEvent(task, "system", "stop", "Stop requested. Waiting for the agent to stop; existing edits are retained."); }
180
180
  export function confirmStopped(task: Task) { if (task.status !== "stopping") throw new TaskError("Stop was not requested"); task.status = "interrupted"; if (task.launch) task.launch.phase = "interrupted"; addEvent(task, "system", "stopped", "The agent stopped. Queued requests are saved. This does not undo edits."); }
181
181
  export function resumeTask(task: Task) {
182
- if (!["interrupted", "failed"].includes(task.status)) throw new TaskError("This task does not need recovery");
182
+ if (!["interrupted", "failed", "stopping", "ready"].includes(task.status)) throw new TaskError("This task does not need recovery");
183
183
  task.queuePaused = false; task.safe = true; task.launch = null; task.error = undefined;
184
184
  // Explicit recovery preserves ids and makes ambiguous work visible for reconciliation.
185
185
  for (const i of task.inputs) if (i.state === "dispatched" || i.state === "failed") i.state = "queued";
186
186
  task.status = task.currentResult ? "ready" : "draft";
187
187
  addEvent(task, "system", "resume", "Resume requested. Reconcile existing edits before applying the saved requests.");
188
188
  }
189
+ // A pause only means something while the task is stopping, interrupted or failed. Anywhere else it
190
+ // is a leftover that blocks Looks good, so it is cleared. Returns whether anything changed.
191
+ export function normalizePause(task: Task): boolean {
192
+ if (["stopping", "interrupted", "failed"].includes(task.status) || !(task.queuePaused || task.error)) return false;
193
+ task.queuePaused = false; task.error = undefined; return true;
194
+ }
189
195
  export function acceptTask(task: Task, result: string) {
190
196
  if (!result || result !== task.currentResult) throw new TaskError("This result is no longer current");
191
197
  if (task.status !== "ready" || !task.safe || task.writePhase || task.pendingDecision || task.queuePaused || task.inputs.some((i) => !["applied", "failed"].includes(i.state))) throw new TaskError("Finish the active work and pending decisions before accepting this result");
192
198
  task.acceptedResult = result; task.status = "accepted"; addEvent(task, "user", "accept", "Looks good. Result accepted; publishing is separate.");
193
199
  }
194
200
  export function taskProjection(task: Task): { filter: "needs-you" | "in-progress" | "completed"; label: string; reason: string; action: string; rank: number } {
195
- if (task.pendingDecision) return { filter: "needs-you", label: task.pendingDecision.kind === "proposal" ? "Confirm proposal" : "Your answer needed", reason: task.pendingDecision.text, action: task.pendingDecision.kind === "proposal" ? "Review proposal" : "Reply", rank: 0 };
201
+ if (task.pendingDecision) return { filter: "needs-you", label: task.pendingDecision.kind === "proposal" ? "Approve plan" : "Your answer needed", reason: task.pendingDecision.text, action: task.pendingDecision.kind === "proposal" ? "Review plan" : "Reply", rank: 0 };
196
202
  if (["failed", "interrupted"].includes(task.status)) return { filter: "needs-you", label: task.status === "failed" ? "Needs recovery" : "Work interrupted", reason: task.error || "The update stopped before finishing. Saved results and requests remain available.", action: "Review and resume", rank: 1 };
197
203
  if (task.status === "accepted" && task.acceptedResult === task.currentResult) return { filter: "completed", label: "Completed", reason: "You accepted this result. Publishing is separate.", action: "View result", rank: 4 };
198
204
  if (task.status === "ready" && !task.inputs.some((i) => ["queued", "received", "dispatched"].includes(i.state))) return { filter: "needs-you", label: "Your feedback needed", reason: "The latest result is ready to review.", action: "Review result", rank: 2 };
package/cli/term-image.ts CHANGED
@@ -24,3 +24,21 @@ export function saveImage(b: Uint8Array, dir = join(homedir(), ".kaizen", "term-
24
24
  try { chmodSync(file, 0o600); } catch { /* Windows */ }
25
25
  return file;
26
26
  }
27
+
28
+ // Any file attached to a board terminal (the phone's Attach key): saved under its own random folder with its own name, so an
29
+ // agent reads it by that name; the name is cleaned (no folders, no leading dot, no odd characters) and the folder is ours.
30
+ export const MAX_FILE = 25 * 1024 * 1024;
31
+ export const safeFileName = (name: string) => {
32
+ const base = name.split(/[\\/]/).pop() ?? "";
33
+ const clean = base.replace(/[^\w.\- ()]+/g, "_").replace(/^\.+/, "").slice(-120).trim();
34
+ return clean || "file";
35
+ };
36
+ export function saveFile(b: Uint8Array, name: string, dir = join(homedir(), ".kaizen", "term-files")) {
37
+ if (!b.length || b.length > MAX_FILE) return null;
38
+ const folder = join(dir, crypto.randomUUID());
39
+ mkdirSync(folder, { recursive: true, mode: 0o700 });
40
+ const file = join(folder, safeFileName(name));
41
+ writeFileSync(file, b, { mode: 0o600 });
42
+ try { chmodSync(file, 0o600); } catch { /* Windows */ }
43
+ return file;
44
+ }
@@ -1,5 +1,4 @@
1
1
  [
2
- {"screen": "*", "path": "div#phome>section.psec2", "rule": "column", "reason": "Phone Home's section headings are inset 4px from the cards under them (#phome h3 margin), as grouped lists on a phone are."},
3
2
  {"variant": ".ice-cap-row :is(.ib,.sel,.btn), .ice-cap-row .ice-combo>.sel", "reason": "The Icebox capture row is a compact row: attach, mic, the project and board pickers and save are all 30px, below the page's 32px controls."},
4
3
  {"screen": "*", "path": "button.ib.hgo", "rule": "size", "reason": "The composer's round send button is drawn 34px on purpose, a size step above the 32px icon buttons."},
5
4
  {"screen": "notes", "path": "li>details>ul>li", "rule": "column", "reason": "A folder row starts with its chevron's box, 2px left of its sibling note names; the chevron drawn inside that box starts level with them."}
package/cli/ui-audit.ts CHANGED
@@ -278,7 +278,7 @@ export async function settle(page: Page, ms = 6000) {
278
278
 
279
279
  // ---- screens and states. `open` runs in the page after load: click() waits for a shown element, then clicks it.
280
280
  type Screen = { name: string; url: string; widths?: number[]; open?: string };
281
- const BARS = [[".rail .top", ".hdr", "#rbar", "#panel>header", ".pstrip"], ["#sback", "#smain h2"]];
281
+ const BARS = [[".rail .top", ".hdr", "#rbar", "#panel>header", ".pstrip"], ["#sback", "[data-page] h2"]];
282
282
  const SETTINGS = ["general", "appearance", "notifications", "keyboard", "terminal", "agents", "models", "accounts", "skills", "runs", "approvals", "autofix", "orchestration", "automations", "git", "integrations", "mobile"];
283
283
 
284
284
  function screens(dir: string, run: string, emptyWs: { dir: string; ws: string }): Screen[] {
@@ -288,16 +288,16 @@ function screens(dir: string, run: string, emptyWs: { dir: string; ws: string })
288
288
  const D1 = [1400], P = [400];
289
289
  return [
290
290
  { name: "board", url: "/?view=board", widths: D1 }, // a phone shows Home for the board
291
- { name: "board-runs", url: "/?view=board", widths: D1, open: `await click("[data-m=runs]")` },
292
- { name: "card-menu", url: "/?view=board", widths: D1, open: `await click("[data-m=runs]"); await click("[data-a=menu]", true)` },
293
- { name: "card-drawer", url: "/?view=board", widths: D1, open: `await click("[data-m=runs]"); await click("main#board>section:last-of-type li .card")` },
294
- { name: "projects-filter", url: "/?view=board", widths: D1, open: `await click("#proj")` },
291
+ { name: "board-runs", url: "/?view=board", widths: D1, open: `await click("[aria-label='Board mode'] button", false, "Runs")` },
292
+ { name: "card-menu", url: "/?view=board", widths: D1, open: `await click("[aria-label='Board mode'] button", false, "Runs"); await click("button[aria-label=Actions]", true)` },
293
+ { name: "card-drawer", url: "/?view=board", widths: D1, open: `await click("[aria-label='Board mode'] button", false, "Runs"); await click("#board section:last-of-type li .card")` },
294
+ { name: "projects-filter", url: "/?view=board", widths: D1, open: `await click("#combo button")` },
295
295
  { name: "showing", url: "/?view=board", widths: D1, open: `await click("#show")` },
296
296
  { name: "new-task", url: "/?view=board", widths: D1, open: `await click("#newtop")` },
297
297
  { name: "add-project", url: "/?view=board", widths: D1, open: `await click("#padd")` },
298
298
  { name: "new-workspace", url: "/?view=board", widths: D1, open: `await click("#padd"); await click("[data-go=ws]")` },
299
299
  { name: "tasks", url: "/?view=tasks" },
300
- { name: "run-form", url: "/?view=tasks", widths: D1, open: `await click(".go[data-i]", false, "Start")` },
300
+ { name: "run-form", url: "/?view=board", widths: D1, open: `await click("[data-k^=idea] button[aria-label=Actions]", true); await click("[role=menuitem]", false, "Run")` },
301
301
  { name: "icebox", url: "/?view=icebox" },
302
302
  { name: "home", url: "/" },
303
303
  { name: "chat", url: "/?view=chat", widths: P },
@@ -307,12 +307,12 @@ function screens(dir: string, run: string, emptyWs: { dir: string; ws: string })
307
307
  ...SETTINGS.map((p) => ({ name: "settings-" + p, url: "/?view=settings&page=" + p })),
308
308
  { name: "run", url: RUN },
309
309
  { name: "run-none", url: EMPTY, widths: D1 },
310
- { name: "run-plus", url: RUN, widths: D1, open: `await click("#rtabs details.radd:not(.rsplit) > summary")` },
311
- { name: "run-split", url: RUN, widths: D1, open: `await click("#rtabs details.rsplit > summary")` },
312
- { name: "run-picker", url: RUN, widths: D1, open: `await click("#ppick")` },
313
- { name: "run-history", url: RUN, widths: D1, open: `await click("#rtabs details.radd:not(.rsplit) > summary"); await click("[data-n=history]")` },
310
+ { name: "run-plus", url: RUN, widths: D1, open: `await click("button[aria-label='New tab']")` },
311
+ { name: "run-split", url: RUN, widths: D1, open: `await click("button[aria-label='Split right']")` },
312
+ { name: "run-picker", url: RUN, widths: D1, open: `await click("button[title='Choose a run']")` },
313
+ { name: "run-history", url: RUN, widths: D1, open: `await click("button[aria-label='New tab']"); await click("[role=menuitem]", false, "History")` },
314
314
  { name: "phone-runs", url: "/?view=device", widths: P },
315
- { name: "phone-new", url: "/", widths: P, open: `await click("#phome .pag-new")` },
315
+ { name: "phone-new", url: "/", widths: P, open: `await click("button", false, "New")` },
316
316
  ];
317
317
  }
318
318
 
@@ -322,7 +322,7 @@ const until = async (s, ms = 6000) => { const end = Date.now() + ms; for (;;) {
322
322
  const click = async (s, force = false, text = "") => {
323
323
  const e = force ? document.querySelector(s) : text ? [...document.querySelectorAll(s)].find((x) => x.textContent.trim().startsWith(text)) : await until(s);
324
324
  if (!e) throw new Error("not found: " + s + (text ? " " + text : ""));
325
- e.scrollIntoView({ block: "nearest" }); e.click(); await sleep(400);
325
+ e.scrollIntoView({ block: "nearest" }); e.dispatchEvent(new PointerEvent("pointerdown", { bubbles: true, button: 0, pointerType: "mouse" })); e.click(); await sleep(400); // Radix menus open on pointerdown
326
326
  };`;
327
327
 
328
328
  type Hit = Flag & { screen: string; at: string };