mulmoterminal 11.3.0 → 11.5.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 (173) hide show
  1. package/README.md +26 -4
  2. package/common/botJobs.ts +31 -0
  3. package/common/githubBoard.ts +119 -0
  4. package/common/httpsUrl.ts +11 -0
  5. package/common/psmuxWidthRuns.ts +528 -0
  6. package/common/terminalUnicode.ts +6 -7
  7. package/common/tmuxClusters.ts +246 -0
  8. package/common/tmuxUnicodeProvider.ts +90 -0
  9. package/common/tmuxWidthTable.ts +125 -0
  10. package/dist/assets/Notation-ntjjL2Db-CWj9gTcd.js +2 -0
  11. package/dist/assets/{abnfDiagram-WEYOIA3C-Cp_CVKVP.js → abnfDiagram-WEYOIA3C-Zss16q3K.js} +1 -1
  12. package/dist/assets/{architecture-WOLXFQ4H-DjkPqSb6.js → architecture-WOLXFQ4H-DTsHKn0G.js} +1 -1
  13. package/dist/assets/{architectureDiagram-ZHVYKT53-0qToe8DR.js → architectureDiagram-ZHVYKT53-BNbFIRvQ.js} +1 -1
  14. package/dist/assets/{blockDiagram-RJAE7QA3-DpNBhRyb.js → blockDiagram-RJAE7QA3-D6HPyPO_.js} +1 -1
  15. package/dist/assets/{c4Diagram-XDPPPE54-DuuyvDc1.js → c4Diagram-XDPPPE54-CD2luMRS.js} +1 -1
  16. package/dist/assets/channel-DqF2Qyzp.js +1 -0
  17. package/dist/assets/{chunk-2E7WHVMD-09NdOPmp.js → chunk-2E7WHVMD-BPmLRCSF.js} +1 -1
  18. package/dist/assets/{chunk-4EMNKR2T-TiPBF39q.js → chunk-4EMNKR2T-DEOOfxe8.js} +1 -1
  19. package/dist/assets/{chunk-55XCU76K-CKLcfm0y.js → chunk-55XCU76K-rymJ-3S9.js} +1 -1
  20. package/dist/assets/{chunk-7S6XSTFO-BZmcP52j.js → chunk-7S6XSTFO-ChlqVvq-.js} +1 -1
  21. package/dist/assets/{chunk-AQDTSKZB-BOza6VsT.js → chunk-AQDTSKZB-imLL2Lvo.js} +1 -1
  22. package/dist/assets/{chunk-DSNLSHJZ-Bv43aur5.js → chunk-DSNLSHJZ-B5SdfiDR.js} +1 -1
  23. package/dist/assets/{chunk-HAGFOTED-Br7EPqyd.js → chunk-HAGFOTED-8NfWMcDD.js} +1 -1
  24. package/dist/assets/{chunk-HNE4Q36P-BD4NAzEH.js → chunk-HNE4Q36P-BrnajitG.js} +1 -1
  25. package/dist/assets/{chunk-NQOKRVIF-Vm0uCJ3V.js → chunk-NQOKRVIF-DIb2o8lr.js} +1 -1
  26. package/dist/assets/{chunk-UHW7PFBP-pjP3twgI.js → chunk-UHW7PFBP-D8Ky3MG9.js} +1 -1
  27. package/dist/assets/{chunk-VQ5W62QI-DiVnexKy.js → chunk-VQ5W62QI-BVpVFla-.js} +1 -1
  28. package/dist/assets/{chunk-WQQL4CDK-CCBvphth.js → chunk-WQQL4CDK-C7JQ4A38.js} +1 -1
  29. package/dist/assets/{chunk-YZO67HFG-FCVXmL_e.js → chunk-YZO67HFG-CrRxld04.js} +1 -1
  30. package/dist/assets/{chunk-ZAUX2LTX-B4YrGhQn.js → chunk-ZAUX2LTX-BinEoQbm.js} +1 -1
  31. package/dist/assets/{chunk-ZCHMQSOR-B49fBUuL.js → chunk-ZCHMQSOR-CZSq1Lsx.js} +1 -1
  32. package/dist/assets/{classDiagram-v2-4MYWR3UA-Cphx3uY3.js → classDiagram-v2-4MYWR3UA-CNiE_Ji5.js} +1 -1
  33. package/dist/assets/{cynefin-EF2NZ3EQ-B3p24FBR.js → cynefin-EF2NZ3EQ-BbN_p-vu.js} +1 -1
  34. package/dist/assets/{cynefinDiagram-WF24UDRP-DPz477Qm.js → cynefinDiagram-WF24UDRP-CH42Y5v7.js} +1 -1
  35. package/dist/assets/{dagre-NK4GIZVX-WAFqkmtj.js → dagre-NK4GIZVX-_muelWrm.js} +1 -1
  36. package/dist/assets/{diagram-CBK3MWTC-DmmXqwTi.js → diagram-CBK3MWTC-DpzeZPYt.js} +1 -1
  37. package/dist/assets/{diagram-I5XIIV2D-BYBcg9gp.js → diagram-I5XIIV2D-C4Fdf-JM.js} +1 -1
  38. package/dist/assets/{diagram-ODIL2UCW-CYU_e9M0.js → diagram-ODIL2UCW-O5Cxitlb.js} +1 -1
  39. package/dist/assets/{diagram-PFBEJUXE-7wMB5XfM.js → diagram-PFBEJUXE-BUuigBun.js} +1 -1
  40. package/dist/assets/{diagram-RJA3I4VV-D6DewsR6.js → diagram-RJA3I4VV-CONsFXyj.js} +1 -1
  41. package/dist/assets/{diagram-TYUNFSNR-bJSVBB3K.js → diagram-TYUNFSNR-CpynoTAh.js} +1 -1
  42. package/dist/assets/{dist-DsrTb2r9.js → dist-BzByTvhm.js} +1 -1
  43. package/dist/assets/{dist-KvpSKcAS.js → dist-CHuoIB6Q.js} +4 -4
  44. package/dist/assets/dist-Cl9Cn33x.js +2 -0
  45. package/dist/assets/{dist-Dv-xuOQM.js → dist-CmQ40R5k.js} +1 -1
  46. package/dist/assets/{dist-BUJSBEak.js → dist-D8RIqh79.js} +1 -1
  47. package/dist/assets/{dist-ByvCx_i5.js → dist-DWXMgh4m.js} +5 -5
  48. package/dist/assets/{ebnfDiagram-V4P3TTPT-DJVw9hHg.js → ebnfDiagram-V4P3TTPT-Cc_ovyXz.js} +1 -1
  49. package/dist/assets/{echarts-gl-C4-n1BHz.js → echarts-gl-CI_7dr5Y.js} +4 -4
  50. package/dist/assets/{elk-QONTBCTQ-IZpnNv-8.js → elk-QONTBCTQ-CLzPyAjy.js} +1 -1
  51. package/dist/assets/{emscripten-module-Q67P5WYC-C-OqgOlF.js → emscripten-module-Q67P5WYC-DHAzrbpf.js} +1 -1
  52. package/dist/assets/{erDiagram-KYQIGQAA-DGnhRs9d.js → erDiagram-KYQIGQAA-WhXXqU4j.js} +1 -1
  53. package/dist/assets/{eventmodeling-K75KTNOO-ClDJvzBs.js → eventmodeling-K75KTNOO-cMxcC0PI.js} +1 -1
  54. package/dist/assets/flowDiagram-IUGLLWBU-D8mbkZ4E.js +1 -0
  55. package/dist/assets/{ganttDiagram-R7GPNTJY-RvhC4sS6.js → ganttDiagram-R7GPNTJY-C6kevpBh.js} +1 -1
  56. package/dist/assets/{gitGraph-VSP46ZUC-DPRZM9r2.js → gitGraph-VSP46ZUC-DjeGzW_y.js} +1 -1
  57. package/dist/assets/{gitGraphDiagram-PDYL7XHY-BSCJCqBA.js → gitGraphDiagram-PDYL7XHY-BQ1zSOMT.js} +1 -1
  58. package/dist/assets/index-CC-6hdYl.css +1 -0
  59. package/dist/assets/{index-DzgvX-JE.js → index-CusRx9qi.js} +614 -613
  60. package/dist/assets/{info-OHQRW6UA-BJUZ7JxX.js → info-OHQRW6UA-CmM4Q4IB.js} +1 -1
  61. package/dist/assets/{infoDiagram-MVDRKAX5-Bt-HtHOW.js → infoDiagram-MVDRKAX5-or8fsYr6.js} +1 -1
  62. package/dist/assets/{ishikawaDiagram-HPEHV2GE-DExundHg.js → ishikawaDiagram-HPEHV2GE-X64B1gsF.js} +1 -1
  63. package/dist/assets/{journeyDiagram-BOSHW7O7-ByNvSzXg.js → journeyDiagram-BOSHW7O7-JEMaR_hp.js} +1 -1
  64. package/dist/assets/{kanban-definition-FNSA4HC5-BFJUY0cK.js → kanban-definition-FNSA4HC5-CLsrRMy7.js} +1 -1
  65. package/dist/assets/{line-BoIv-CRn.js → line-D9yZQMYH.js} +1 -1
  66. package/dist/assets/{manifold-DoAt7vUN.js → manifold-BCGa0xSy.js} +1 -1
  67. package/dist/assets/{mermaid-parser.core-CuzMYAec.js → mermaid-parser.core-buF30qM2.js} +3 -3
  68. package/dist/assets/{mermaid.core-CGt3fAlm.js → mermaid.core-C4fn8974.js} +4 -4
  69. package/dist/assets/{mindmap-definition-6OY57UG3-BEXsfC5K.js → mindmap-definition-6OY57UG3-BIeat7cx.js} +1 -1
  70. package/dist/assets/opensheetmusicdisplay.min-CeBHhrOd.js +85 -0
  71. package/dist/assets/{packet-JDAUHWVQ-Bh3Jjnyu.js → packet-JDAUHWVQ-DS02QUvq.js} +1 -1
  72. package/dist/assets/{pegDiagram-ECIUJNBX-DJTqZy-O.js → pegDiagram-ECIUJNBX-NNs_91In.js} +1 -1
  73. package/dist/assets/{pie-XZMESJXO-q-b-oziT.js → pie-XZMESJXO-CgRSIBxi.js} +1 -1
  74. package/dist/assets/{pieDiagram-GNMPY74T-pZcdcWmj.js → pieDiagram-GNMPY74T-C0UoQ1-r.js} +1 -1
  75. package/dist/assets/{quadrantDiagram-D57K4MC3-CZCbSxYF.js → quadrantDiagram-D57K4MC3-D5Wbn8Cu.js} +1 -1
  76. package/dist/assets/{radar-ABXABTNO-Cmz1FLat.js → radar-ABXABTNO-BuU3LZP7.js} +1 -1
  77. package/dist/assets/{railroad-I3PHUGI6-Bm5NA0Rj.js → railroad-I3PHUGI6-CbZvnqVq.js} +1 -1
  78. package/dist/assets/{railroad-abnf-LNEFI6M7-BSVTY67X.js → railroad-abnf-LNEFI6M7-DMTQ5ilY.js} +1 -1
  79. package/dist/assets/{railroad-ebnf-DWYD2UWJ-CplgrKrG.js → railroad-ebnf-DWYD2UWJ-DPzo0tSy.js} +1 -1
  80. package/dist/assets/{railroad-peg-JR7BVNR7-BtrbqnrA.js → railroad-peg-JR7BVNR7-D9JUN3tH.js} +1 -1
  81. package/dist/assets/{railroadDiagram-Y72NRBL7-BCClvJ3M.js → railroadDiagram-Y72NRBL7-D2_RwvSv.js} +1 -1
  82. package/dist/assets/{requirementDiagram-EQYSW5RA-CrjB53T3.js → requirementDiagram-EQYSW5RA-DlvzxgDj.js} +1 -1
  83. package/dist/assets/{sankeyDiagram-SY24JHO5-CxI3popI.js → sankeyDiagram-SY24JHO5-BrOFtBRY.js} +1 -1
  84. package/dist/assets/{sequenceDiagram-BLEHNHQU-C5AzjjBB.js → sequenceDiagram-BLEHNHQU-CuQmun7K.js} +1 -1
  85. package/dist/assets/{stateDiagram-v2-A6IESKWZ-uvuO6onL.js → stateDiagram-v2-A6IESKWZ-DIYl6A4R.js} +1 -1
  86. package/dist/assets/{swimlanes-B3ENRKFQ-7CWtVbF7.js → swimlanes-B3ENRKFQ-zWPb3HUM.js} +1 -1
  87. package/dist/assets/swimlanesDiagram-AYQRV4AK-CbKp-bmm.js +8 -0
  88. package/dist/assets/{timeline-definition-JXYKGLGB-BVfIQMDg.js → timeline-definition-JXYKGLGB-By3IMB4u.js} +1 -1
  89. package/dist/assets/{treeView-D4JQ5SDB-5hWrCHzP.js → treeView-D4JQ5SDB-tTt-lUMH.js} +1 -1
  90. package/dist/assets/{treemap-SAJKECNS-DZ3to4l7.js → treemap-SAJKECNS-DEzgMQGq.js} +1 -1
  91. package/dist/assets/{usecaseDiagram-WPOLBNNX-BmKS40Rq.js → usecaseDiagram-WPOLBNNX-jZw5S7L2.js} +1 -1
  92. package/dist/assets/{vennDiagram-Q3Y3IDCW-BR1rmhha.js → vennDiagram-Q3Y3IDCW-DqJQFjkp.js} +1 -1
  93. package/dist/assets/{wardley-7MLQ67FV-pj2gt2sa.js → wardley-7MLQ67FV-DrD0u4NO.js} +1 -1
  94. package/dist/assets/{wardleyDiagram-IVAIDKWA-GsVcmL_C.js → wardleyDiagram-IVAIDKWA-KP8YD5qL.js} +1 -1
  95. package/dist/assets/{xychartDiagram-4URNHDU4-DilAytIW.js → xychartDiagram-4URNHDU4-kBzELbXd.js} +1 -1
  96. package/dist/index.html +2 -2
  97. package/docs/ChangeLog.md +60 -0
  98. package/docs/facts.json +1 -1
  99. package/docs/guide/en/accounts.md +12 -9
  100. package/docs/guide/en/config.md +12 -8
  101. package/docs/guide/en/feature-list.md +6 -1
  102. package/docs/guide/en/features.md +1 -1
  103. package/docs/guide/en/index.md +2 -2
  104. package/docs/guide/en/v11.4.0.md +135 -0
  105. package/docs/guide/en/v11.5.0.md +85 -0
  106. package/docs/guide/ja/accounts.md +3 -3
  107. package/docs/guide/ja/config.md +9 -6
  108. package/docs/guide/ja/feature-list.md +6 -1
  109. package/docs/guide/ja/features.md +1 -1
  110. package/docs/guide/ja/index.md +2 -2
  111. package/docs/guide/ja/v11.4.0.md +133 -0
  112. package/docs/guide/ja/v11.5.0.md +81 -0
  113. package/package.json +8 -8
  114. package/server/agents/codex/codex-sessions.ts +12 -18
  115. package/server/agents/codex/codex-thread-origin.ts +48 -0
  116. package/server/agents/probe/probe-cwd.spec.ts +18 -0
  117. package/server/agents/probe/probe-cwd.ts +13 -0
  118. package/server/agents/probe/probe-trust.spec.ts +188 -0
  119. package/server/agents/probe/probe-trust.ts +116 -0
  120. package/server/agents/rate-limit/rate-limit-routes.ts +6 -3
  121. package/server/agents/rate-limit/rate-limit-service.spec.ts +159 -6
  122. package/server/agents/rate-limit/rate-limit-service.ts +59 -19
  123. package/server/backends/botJobs/botJobHandler.ts +115 -0
  124. package/server/backends/botJobs/botTokens.ts +119 -0
  125. package/server/backends/botJobs/index.ts +92 -0
  126. package/server/backends/botJobs/jobScript.ts +149 -0
  127. package/server/backends/botJobs/routes.ts +61 -0
  128. package/server/backends/remoteHost/getFeed.spec.ts +1 -0
  129. package/server/backends/remoteHost/handlers/deps.ts +4 -0
  130. package/server/backends/remoteHost/handlers/index.ts +4 -0
  131. package/server/backends/remoteHost/handlers.spec.ts +1 -0
  132. package/server/backends/remoteHost/hostBindings.ts +5 -1
  133. package/server/backends/remoteHost/index.ts +1 -0
  134. package/server/backends/remoteHost/terminalInput.spec.ts +55 -1
  135. package/server/backends/remoteHost/terminalInput.ts +31 -2
  136. package/server/config/app-config.ts +7 -0
  137. package/server/config/config-routes.ts +30 -9
  138. package/server/git/board-detail.ts +90 -0
  139. package/server/git/board-fetch.ts +134 -0
  140. package/server/git/board.ts +158 -0
  141. package/server/git/codexVerdict.ts +68 -0
  142. package/server/index.ts +8 -3
  143. package/server/infra/fs/legacy-cleanup.ts +4 -2
  144. package/server/infra/http/allowed-origin.ts +26 -3
  145. package/server/infra/http/host-guard.ts +32 -0
  146. package/server/infra/http/on-listening.ts +4 -1
  147. package/server/infra/process/cmd-escape.ts +8 -2
  148. package/server/infra/process/psmux.ts +18 -0
  149. package/server/infra/process/psmuxWidthProbe.ts +71 -0
  150. package/server/infra/process/resolve-bin.ts +66 -15
  151. package/server/infra/process/throwawayTmux.ts +52 -0
  152. package/server/infra/process/tmux.ts +69 -11
  153. package/server/infra/process/tmuxLiveServer.ts +18 -0
  154. package/server/infra/process/tmuxWidthProbe.ts +161 -0
  155. package/server/routes/app-routes.ts +26 -9
  156. package/server/routes/issue-work-routes.ts +7 -4
  157. package/server/routes/repo-routes.ts +36 -0
  158. package/server/routes/request-gates.ts +21 -0
  159. package/server/routes/terminal-reply-routes.ts +62 -0
  160. package/server/routes/terminalReply.ts +24 -0
  161. package/server/session/lifecycle.ts +7 -0
  162. package/server/session/project-dir.ts +4 -3
  163. package/server/session/pty/pty-connection.ts +14 -0
  164. package/server/session/pty/pty-spawn.ts +9 -3
  165. package/server/session/registry.ts +23 -5
  166. package/server/session/spawn/spawn-shell.ts +22 -1
  167. package/server/session/types.ts +3 -0
  168. package/server/skills/mulmoterminal-config/SKILL.md +33 -1
  169. package/dist/assets/channel-73-ebGtK.js +0 -1
  170. package/dist/assets/dist-D9p6rX9l.js +0 -2
  171. package/dist/assets/flowDiagram-IUGLLWBU-DkHfmbMQ.js +0 -1
  172. package/dist/assets/index-SC3QBsgL.css +0 -1
  173. package/dist/assets/swimlanesDiagram-AYQRV4AK-T_WR9Zd-.js +0 -8
package/README.md CHANGED
@@ -739,7 +739,16 @@ What MulmoTerminal does differently behind psmux, and only there:
739
739
  - counts emoji two cells wide in the browser (Unicode 11), as Claude Code and psmux do — otherwise
740
740
  each emoji shifts the rest of its row by one column;
741
741
  - keeps Volta's `_VOLTA_TOOL_RECURSION` out of psmux's environment, so `node` in a cell resolves through
742
- Volta's shim again.
742
+ Volta's shim again;
743
+ - turns psmux's warm pool off (`set -g warm off`, psmux 3.3.1+), in new servers and in the ones
744
+ already running. Every cell starts with `-e`, which never claims a spare shell, so the spares
745
+ only held memory and were restarted on every resize;
746
+ - starts an agent installed from npm (`codex.cmd`, `claude.cmd` — a batch shim, no `.exe`) through
747
+ `cmd.exe`, as a cell without psmux does. psmux 3.4.0 hands the pane's program to Windows as it is,
748
+ which cannot run a batch file, so the cell ended at once with `psmux: can't find session`;
749
+ - leaves the `terminal-features` declaration out of psmux's conf. psmux has no such option and
750
+ printed the rejection (`unknown option 'terminal-features'`) into every new cell; it forwards OSC 8
751
+ hyperlinks to its client without being told to.
743
752
 
744
753
  psmux imitates tmux 3.4, so the few things that need tmux 3.7+ (such as restoring bracketed paste
745
754
  after a reload) are not available on it. A Windows restart still ends every session, as a reboot
@@ -881,7 +890,7 @@ The Settings modal (the gear button) persists per-user UI choices to `~/.mulmote
881
890
  | `appendSystemPrompt` | Whether a spawned Claude session is asked to end a reply with a **closing summary** — what was asked, what was achieved, what was not (see [Closing summary](#closing-summary)). **On by default**; set `false` to opt out, and a directory's `.mulmoterminal.json` outranks this. Settings → **Sessions and background tasks** has the switch. Read per spawn, so no restart is needed, though a session already running keeps what it was launched with. `true` / `false` only. |
882
891
  | `autoDirIcon` | Whether a project that sets no `icon` shows the favicon its repository already ships (`public/favicon.svg`, `apple-touch-icon.png`, a web manifest — first hit wins, ordered by how the image survives at 14px). **On by default**; Settings → **Directory appearance** has the switch. A single project opts out with `"icon": false` in its own `.mulmoterminal.json`, which this does not override. A key that was written and got it wrong shows nothing rather than falling back — a broken setting has to look broken. `true` / `false` only. |
883
892
  | `cockpitLines` | `{ summary, prompt, response }` — how many lines each **cockpit-roster** row shows before it clamps (default `2` / `2` / `3`, each clamped to `1`–`20`). Raising them trades how many sessions fit on screen for reading a long one in place. Three steppers in Settings → **Waiting rows**. |
884
- | `usageGauge` | Whether the grid header draws the 5h / 7d **usage gauge** for Claude and Codex. Claude is measured by a hidden `claude` making one API call, which counts against those windows. **On by default**; `false` hides the gauge and measures nothing. Settings → **Grid header read-outs** has the switch. |
893
+ | `usageGauge` | Whether the grid header draws the 5h / 7d **usage gauge** for Claude and Codex. Claude is measured by a hidden `claude` making one API call, which counts against those windows; it runs in a folder of MulmoTerminal's own, `~/.mulmoterminal/probe`, which MulmoTerminal marks as trusted in Claude Code's config before the first check (if that cannot be written, the gauge's hover text asks you to accept the prompt there once). **On by default**; `false` hides the gauge and measures nothing. Settings → **Grid header read-outs** has the switch. |
885
894
  | `usageProbeIntervalMinutes` | How many minutes Claude's reading may age before the gauge measures it again. **Default `10`**, whole minutes from 2 to 60. Settings → **Grid header read-outs** has the stepper. |
886
895
  | `showLoadAverage` | Whether the grid header draws this machine's **load average** beside the 5h / 7d usage windows, as a percentage of its cores (`load 334%` = a 20-core machine with 66.8 runnable processes). **On by default**; amber at 100%, red at 200%, hover for the raw 1 / 5 / 15-minute figures. Settings → **Grid header read-outs** has the switch. A host that keeps no load average (Windows) shows nothing rather than `0%`, whatever this says. `true` / `false` only. |
887
896
  | `remoteServer` | **Experimental.** The server runs on another machine than your browser (an SSH tunnel — [guide](https://receptron.github.io/mulmoterminal/guide/en/remote.html)): the actions that would act on the server's screen (the file dialog, the file manager, the OS app) are hidden or say why, and a dropped file is always uploaded. **Off unless `true`**; Settings → **Sessions and background tasks** has the box (or set it in the server's config). |
@@ -1599,6 +1608,16 @@ claude's input box to be ready — text pushed in before that lands in the scrol
1599
1608
  with several clones asks which one the first time and remembers the answer; a repo with no clone
1600
1609
  here disables the button and says why. Backed by `POST /api/issues/start`.
1601
1610
 
1611
+ **The board (experimental).** **Open the board** on `/github` goes to `/github/board`: per repo, one
1612
+ card per piece of work in five columns — To do, Implementing, In review (with the review round),
1613
+ Ready (QA) and Merged — joining each issue to the PR that closes it and to the live cells on its
1614
+ branch. An open PR's card also counts the codex cross-review verdicts posted as comments (a first line
1615
+ `CODEX VERDICT: LGTM (head <sha>)` or `CHANGES REQUESTED`, by the repo's owner, members or
1616
+ collaborators) and shows the newest, coloured only when the sha it names is the PR's head. Pressing a card opens a detail panel with the issue body, the PR's checks and reviews, and
1617
+ those cells (`GET /api/github/board/detail`); GitHub is a link inside it. A To do card's **▶** starts
1618
+ the issue as above but **sends the issue text at once** and stays on the board; the new cell joins
1619
+ the grid behind it, and the card moves to Implementing. The board keeps itself current while open: cells follow the same live `sessions` feed as the grid, a card whose cell is waiting for you gets an amber border, and the board reads itself again every minute while visible and a few seconds after one of its cells finishes a turn. Each cell in the detail panel can be answered there: its current screen (read by itself when the cell is waiting), a reply box that types one line and presses Enter — the phone's sanitized sender, which never clears what was already in the input box — and, when the question pane is switched on, Claude's question dialog as buttons. A permission prompt is answered with keys, so in the terminal. Backed by `GET /api/github/board`.
1620
+
1602
1621
  **Which clone a repo's work happens in.** `GET /api/repo-dirs` answers the reverse of the
1603
1622
  GitHub link a cell already shows: given `owner/repo`, which of your saved directories are
1604
1623
  clones of it. The candidates are derived from your directory presets by reading each one's
@@ -2113,7 +2132,8 @@ Any resulting state change is published on the `sessions` pub/sub channel.
2113
2132
 
2114
2133
  The endpoints above are the core; the server exposes many more (all under
2115
2134
  `http://localhost:$PORT`; query params shown where relevant). Mutating endpoints are
2116
- same-origin-guarded.
2135
+ same-origin-guarded, and every request is refused (`403`) unless it is addressed to localhost or a
2136
+ name in `MULMOTERMINAL_HOST` / `MULMOTERMINAL_ALLOWED_ORIGINS`, against DNS rebinding (#3188).
2117
2137
 
2118
2138
  **Sessions & agents**
2119
2139
 
@@ -2141,8 +2161,10 @@ same-origin-guarded.
2141
2161
  | `GET /api/worktrees?cwd=` · `GET /api/worktrees/diff?cwd=` | List managed worktrees / diff one vs its base. |
2142
2162
  | `POST /api/worktrees/create` · `/remove` · `/push` · `/pr` | Create on `agent/<slug>` — or, with `issue: <N>`, on `issue/<N>-<slug>` forked from a freshly fetched `origin/<base>`; remove (managed root only), push, open a PR (`gh`, else compare URL). |
2143
2163
  | `GET /api/prs` · `GET /api/issues` | Open PRs / issues across the configured `prRepos` — `gh` for github.com entries, `glab` for gitlab.com and any host declared in `gitlabHosts`. |
2164
+ | `GET /api/github/board` · `GET /api/github/board/detail` | The experimental board: per configured GitHub repo, cards joining issues, the PRs that close them and the live cells on their branch, each in a progress column; and one card's issue body, checks and reviews (`?repo=owner/repo&issue=N&pr=M`, at least one number; a repo not in `prRepos` is a 404). GitHub only. |
2144
2165
  | `GET /api/repo-dirs` | Which saved directories clone which GitHub repo, ordered, with the recorded choice per repo. |
2145
- | `POST /api/issues/start` | Cut an issue's worktree in one of that repo's known clones and spawn a session there, seeded with the issue. An optional `agent` (any hosted agent; absent is `claude`, anything else is a 400) picks which. A Claude seed is a draft; every other agent runs it at once. The reply names the `agent` and whether the seed runs (`seedRuns`), so the cell attaches on the right endpoint. |
2166
+ | `GET /api/terminal/:sessionId/screen` · `POST /api/terminal/:sessionId/reply` | A session's current screen as plain text (the phone's capture), and one line typed into it with Enter (`{ text }`, the phone's sanitizer: control bytes stripped, bracketed paste, a separate Enter; the input box is not cleared). A malformed id or text with nothing printable is a 400, a session this host does not hold a 404 (screen), text over the limit a 413, a session with no live terminal here, or one with a question dialog open at that moment, a 409 (reply). |
2167
+ | `POST /api/issues/start` | Cut an issue's worktree in one of that repo's known clones and spawn a session there, seeded with the issue. An optional `agent` (any hosted agent; absent is `claude`, anything else is a 400) picks which. A Claude seed is a draft unless the request says `run: true` (the board's start does; the `/github` rows do not, and a non-boolean `run` is a 400); every other agent runs it at once. The reply names the `agent` and whether the seed runs (`seedRuns`), so the cell attaches on the right endpoint. |
2146
2168
  | `GET /api/agents/availability` | Which hosted agents this machine can start — `{ agents: [{ agent, available, reason?, installGuide? }] }`, `reason` being `missing`, `no-such-path` (an `<AGENT>_BIN` naming nothing) or `not-executable`, and `installGuide` the agent's official install page (from `bin/agent-install-guides.json`) or `null`. The same check a spawn makes before it starts, run once at server start, so an agent installed later shows after a restart. |
2147
2169
  | `GET /api/github/star` · `POST /api/github/star` | Whether you have starred MulmoTerminal, and star it (via `gh`). `starred: null` means `gh` could not answer, and hides the button. |
2148
2170
 
@@ -0,0 +1,31 @@
1
+ // The `botJobs` setting: whether this host runs Python a remote bot submits through mulmoserver's
2
+ // submitBotJob, and with which interpreter (plans/feat-bot-gpu-jobs.md). Both sides read it — the
3
+ // server sanitizes the file, the Settings section edits the same shape.
4
+ import { isRecord } from "./isRecord.js";
5
+
6
+ export interface BotJobs {
7
+ /** Off by default: a job is code from another machine, so nothing runs until the user says so. */
8
+ enabled: boolean;
9
+ /** The interpreter a job runs with. Usually a venv's python, since that is where the GPU packages
10
+ * (torch with MPS, …) live and the system python has none of them. A leading `~/` is the home. */
11
+ python: string;
12
+ }
13
+
14
+ export const BOT_JOBS_DEFAULT: BotJobs = { enabled: false, python: "python3" };
15
+
16
+ const MAX_PYTHON_LENGTH = 1024;
17
+ // eslint-disable-next-line no-control-regex -- intentional: a path with a control byte is not a path anyone typed
18
+ const CONTROL_BYTES = /[\u0000-\u001F\u007F]/u;
19
+
20
+ const pythonOf = (value: unknown): string => {
21
+ if (typeof value !== "string") return BOT_JOBS_DEFAULT.python;
22
+ const python = value.trim();
23
+ return python && python.length <= MAX_PYTHON_LENGTH && !CONTROL_BYTES.test(python) ? python : BOT_JOBS_DEFAULT.python;
24
+ };
25
+
26
+ /** Anything unrecognised is "unconfigured", and `enabled` is on only for a literal `true`: a typo
27
+ * must never be what lets another machine's code run here. */
28
+ export function sanitizeBotJobs(input: unknown): BotJobs {
29
+ if (!isRecord(input)) return BOT_JOBS_DEFAULT;
30
+ return { enabled: input.enabled === true, python: pythonOf(input.python) };
31
+ }
@@ -0,0 +1,119 @@
1
+ // What GET /api/github/board answers with (#3172): per repo, one card per piece of work — the issue,
2
+ // the PR that closes it, and the live cells on its branch — placed in a column. Shared because the
3
+ // server decides the column and the board renders it.
4
+ import type { CiState } from "./ghItems.js";
5
+
6
+ export const BOARD_COLUMNS = ["todo", "implementing", "review", "qa", "merged"] as const;
7
+
8
+ export type BoardColumn = (typeof BOARD_COLUMNS)[number];
9
+
10
+ export interface BoardIssue {
11
+ number: number;
12
+ title: string;
13
+ url: string;
14
+ }
15
+
16
+ export interface BoardPr {
17
+ number: number;
18
+ title: string;
19
+ url: string;
20
+ branch: string;
21
+ isDraft: boolean;
22
+ ci: CiState;
23
+ /** gh reviewDecision, or null when the repo requires none. */
24
+ review: string | null;
25
+ /** Distinct commits that received a review — one per push a reviewer looked at. */
26
+ reviewRounds: number;
27
+ /** Whether the newest commit has been reviewed yet. */
28
+ headReviewed: boolean;
29
+ /** Codex cross-review rounds, posted as comments; null when none was. */
30
+ codex: BoardCodexReview | null;
31
+ }
32
+
33
+ export type CodexVerdict = "lgtm" | "changes";
34
+
35
+ export interface BoardCodexReview {
36
+ /** Verdict comments posted by the repo's owner, members or collaborators. */
37
+ verdicts: number;
38
+ /** gh returned its cap of comments or of reviews, so there may be verdicts it did not return. */
39
+ more: boolean;
40
+ latest: CodexVerdict;
41
+ /** Which head the newest verdict names: this PR's head, another commit, or none. */
42
+ head: "current" | "stale" | "unknown";
43
+ }
44
+
45
+ export interface BoardCell {
46
+ session: string;
47
+ cwd: string;
48
+ working: boolean;
49
+ waiting: boolean;
50
+ }
51
+
52
+ export interface BoardCard {
53
+ /** Stable within a repo: `pr-N`, `issue-N` or `branch-<name>`. */
54
+ key: string;
55
+ column: BoardColumn;
56
+ issue: BoardIssue | null;
57
+ pr: BoardPr | null;
58
+ /** The branch the work is on, when there is one — the PR's head, or a cell's branch with no PR. */
59
+ branch: string | null;
60
+ cells: BoardCell[];
61
+ }
62
+
63
+ export interface RepoBoard {
64
+ repo: string;
65
+ cards?: BoardCard[];
66
+ error?: string;
67
+ }
68
+
69
+ export interface BoardResponse {
70
+ repos: RepoBoard[];
71
+ }
72
+
73
+ // What GET /api/github/board/detail answers with (#3177): the parts of one card that the board's
74
+ // list does not carry, read when its detail panel opens.
75
+ export interface BoardIssueDetail {
76
+ number: number;
77
+ title: string;
78
+ url: string;
79
+ author: string;
80
+ labels: string[];
81
+ /** Markdown, as written on GitHub. */
82
+ body: string;
83
+ }
84
+
85
+ export interface BoardCheck {
86
+ name: string;
87
+ ci: CiState;
88
+ /** The check's own page, or "" when it has none. */
89
+ url: string;
90
+ }
91
+
92
+ export interface BoardReview {
93
+ author: string;
94
+ /** gh's review state: APPROVED, CHANGES_REQUESTED, COMMENTED, … */
95
+ state: string;
96
+ /** The short oid of the commit the review was left on. */
97
+ commit: string;
98
+ submittedAt: string;
99
+ }
100
+
101
+ export interface BoardPrDetail {
102
+ number: number;
103
+ title: string;
104
+ url: string;
105
+ author: string;
106
+ body: string;
107
+ isDraft: boolean;
108
+ additions: number;
109
+ deletions: number;
110
+ checks: BoardCheck[];
111
+ reviews: BoardReview[];
112
+ }
113
+
114
+ export interface BoardDetailResponse {
115
+ issue: BoardIssueDetail | null;
116
+ pr: BoardPrDetail | null;
117
+ /** One line per part that could not be read; the other part is still shown. */
118
+ errors: string[];
119
+ }
@@ -0,0 +1,11 @@
1
+ // A URL that arrives as DATA and goes into an `<a href>`: `javascript:` in that attribute runs on
2
+ // click, so the scheme is not the data's decision. https only — github.com and GitHub Enterprise
3
+ // both serve it, and the cost of refusing anything else is a missing link beside text that still shows.
4
+ export const safeHttpsUrl = (value: unknown): string | null => {
5
+ if (typeof value !== "string" || value === "") return null;
6
+ try {
7
+ return new URL(value).protocol === "https:" ? value : null;
8
+ } catch {
9
+ return null;
10
+ }
11
+ };