mulmoterminal 2.0.1 → 2.1.0

package/README.md

@@ -70,7 +70,7 @@ output you haven't seen) — driven by Claude/Codex activity hooks the server in
 
 ![Single view — one agent in focus, terminal on the left and a GUI panel on the right](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/single-view.png)
 
-*Besides the grid there's a **single view** for focusing on one agent: the conversation/terminal on the left, and a **GUI panel** ("Canvas") on the right where the agent's tool calls render as documents, forms, charts, images, and HTML — not just printed text. Switch between the two with the chat / grid icons in the toolbar.*
+*Besides the grid there's a **single view** for focusing on one agent: the conversation/terminal on the left, and a **GUI panel** ("Canvas") on the right where the agent's tool calls render as documents, forms, charts, images, and HTML — not just printed text. Switch between the two with the chat / grid icons in the toolbar. **The app opens on the grid** (`/`); the single view has its own URL, `/chat`, so you can bookmark either.*
 
 **Inserting a file path** — like a native terminal, you can put a file's absolute path into
 the prompt: **drag a file** onto the terminal (works where the browser exposes the path via
@@ -434,7 +434,7 @@ The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/confi
 
 ![The Settings modal — theme, notification sound, PR repos, launch commands, and MCP servers](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/settings.png)
 
-*Open it from the ⚙ button in the toolbar. Pick a **theme**, set a custom **attention sound**, list the repos the cross-repo **PRs & Issues** view should aggregate, add **launch commands** for grid cells, and register your own **MCP servers** — no need to hand-edit the config file.*
+*Open it from the ⚙ button in the toolbar. Pick a **theme**, set the **terminal font size**, set a custom **attention sound**, list the repos the cross-repo **PRs & Issues** view should aggregate, add **launch commands** for grid cells, and register your own **MCP servers** — no need to hand-edit the config file. Note that **theme and font size are stored per browser** (they're display preferences, so a phone and a desktop keep their own); the rest live in `~/.mulmoterminal/config.json` and are shared by every client.*
 
 | Field        | Meaning |
 | ------------ | ------- |
@@ -451,6 +451,7 @@ The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/confi
 | `worklogEnabled` | `true` to run the built-in **dev worklog** batch (see below). Off by default (each run spawns an LLM session, so it costs tokens). |
 | `worklogIntervalHours` | Worklog cadence in hours (default `6`, clamped to `1`–`168`). |
 | `terminalSubmit` | Which bytes Claude reads as **submit** vs **newline**: `"cr"` (default — Enter submits, Shift+Enter makes a newline) or `"esc-cr"` (for a Claude Code rebound the other way). Applies to the keyboard **and** the phone remote-view submit, for **Claude sessions only** (shell/codex keep plain Enter). See the [Configuration guide](https://receptron.github.io/mulmoterminal/guide/en/config.html#terminal-submit). |
+| `prWorkdirFooter` | Ends the body of a PR **⧉ Open PR** creates with `work in <clone>` — the directory name of the clone the work happened in, so a PR says which of several side-by-side checkouts produced it. **On by default**; set `false` to opt out — read from the file per PR, so no restart is needed (there is no Settings control for it). Only applied to PRs this app creates (pressing the button again on an existing PR never re-appends). |
 
 #### Header buttons
 
@@ -527,6 +528,7 @@ malformed file is ignored.
   "buttonColor": "#c7cdf0",             // header icon buttons (hex #rrggbb)
   "theme": "nord",                      // terminal palette: midnight | nord | daylight | solarized
   "colors": { "background": "#190a23", "cursor": "#ff2e63" }, // per-key palette overrides
+  "fontSize": 16,                       // terminal font size in px (8–32); overrides Settings
   "sound": "./.mulmoterminal/alert.mp3" // attention sound, RELATIVE to this directory
 }
 ```
@@ -547,6 +549,7 @@ malformed file is ignored.
 | `buttonColor` | Header **icon button** color (`#rrggbb`) — expand / close / attach / folder / etc., across both header rows. |
 | `theme`      | xterm palette for terminals in this directory (one of the built-in theme ids). |
 | `colors`     | Per-key xterm palette overrides applied on top of `theme` (or the app theme when `theme` is unset). Keys are xterm `ITheme` names (`background`, `foreground`, `cursor`, `selectionBackground`, the 16 ANSI colors, …); values are hex (`#rgb` / `#rrggbb` / `#rrggbbaa`). Unknown keys / bad values are dropped. |
+| `fontSize`   | Terminal font size in px for this directory (8–32), overriding the Settings value. A size outside the range is clamped; a non-number is ignored. Changing it re-fits the terminal, so the PTY learns the new width — unlike browser zoom, which leaves the two disagreeing. |
 | `sound`      | Attention sound for this directory's sessions, a path **relative to the directory** (served at `GET /api/dir-sound`). |
 
 **Security.** `sound` is a directory-relative path only — absolute paths and any

package/common/cockpitLines.ts

@@ -0,0 +1,46 @@
+// How many lines each row of the cockpit roster (the list beside a zoomed terminal) shows before
+// it clamps. The roster trades two things against each other: how many sessions fit on screen,
+// and how much of each one you can read without opening it. 2/2/3 is the tight end — it fits a
+// long roster, but a summary written as a full sentence gets cut mid-thought, which is exactly
+// when you wanted to read it. That is a trade the user should get to make, not a bug to fix, so
+// the defaults stay put and the knob is opt-in.
+//
+// One knob per field: the three are worth different amounts. A summary says what a session is
+// doing NOW, while a prompt is usually done in two lines.
+//
+// Shared because both sides decide from it: the server sanitizes and serves it, the grid renders
+// from it. The CSS that applies the clamp is NOT here — the server has no use for it (#877).
+
+import { isRecord } from "./isRecord.js";
+
+export interface CockpitLines {
+  summary: number;
+  prompt: number;
+  response: number;
+}
+
+export const DEFAULT_COCKPIT_LINES: CockpitLines = { summary: 2, prompt: 2, response: 3 };
+
+// 1 is "one line, still clamped". Past ~20 a single row fills the column and the roster stops
+// being a roster.
+export const COCKPIT_LINES_MIN = 1;
+export const COCKPIT_LINES_MAX = 20;
+
+// Clamp an out-of-range number and round a fractional one — the contract normalizeFontSize
+// states for the font size, for the same reason: on a bounded number the user asked for a
+// DIRECTION, so honouring it reads as working where falling back to the default reads as
+// ignored. Non-numeric is a different thing — "nothing configured here" — and falls back.
+const oneField = (input: unknown, fallback: number): number => {
+  if (typeof input !== "number" || !Number.isFinite(input)) return fallback;
+  return Math.min(COCKPIT_LINES_MAX, Math.max(COCKPIT_LINES_MIN, Math.round(input)));
+};
+
+/** Per field, so one typo can't discard the two the user set correctly. */
+export function sanitizeCockpitLines(input: unknown): CockpitLines {
+  if (!isRecord(input)) return { ...DEFAULT_COCKPIT_LINES };
+  return {
+    summary: oneField(input.summary, DEFAULT_COCKPIT_LINES.summary),
+    prompt: oneField(input.prompt, DEFAULT_COCKPIT_LINES.prompt),
+    response: oneField(input.response, DEFAULT_COCKPIT_LINES.response),
+  };
+}

package/common/dirChrome.ts

@@ -1,4 +1,4 @@
-// The name + fixed-color fields a `.mulmoterminal.json` may set. Shared across the
+// The `.mulmoterminal.json` fields whose type is the SAME on both sides. Shared across the
 // build boundary: the server's DirConfig/PublicDirConfig and the client's DirConfig
 // all extend this, so a field added on one side can't go missing on the other.
 // `theme` and `colors` stay out of it — each side declares them with its own type
@@ -17,6 +17,10 @@ export interface DirChrome {
   cellBorderColor: string | null;
   dotColor: string | null;
   buttonColor: string | null;
+  // xterm font size in px for terminals opened here, or null to use the global setting.
+  // Unlike the colors above, this changes the cell metrics — every path that applies it has
+  // to re-fit and push the new cols/rows to the PTY, or the grid drifts from the canvas.
+  fontSize: number | null;
 }
 
 // "Nothing configured" — the base every DirConfig/PublicDirConfig empty spreads, so adding
@@ -32,4 +36,5 @@ export const EMPTY_DIR_CHROME: Readonly<DirChrome> = {
   cellBorderColor: null,
   dotColor: null,
   buttonColor: null,
+  fontSize: null,
 };

package/common/terminalFontSize.ts

@@ -0,0 +1,20 @@
+// The xterm font size, in px. Shared because all three sides decide from the same numbers:
+// the server validates `.mulmoterminal.json`, the Settings stepper bounds its own buttons, and
+// the client validates what it reads back out of localStorage.
+export const TERMINAL_FONT_SIZE_DEFAULT = 14;
+// Below ~8px the canvas renderer's glyphs stop being legible; above ~32px a grid cell holds so
+// few columns that Claude's output wraps into noise. Neither is a hard xterm limit — they bound
+// the stepper and reject a value that would leave the terminal unusable.
+export const TERMINAL_FONT_SIZE_MIN = 8;
+export const TERMINAL_FONT_SIZE_MAX = 32;
+export const TERMINAL_FONT_SIZE_STEP = 1;
+
+// Clamp rather than reject an out-of-range number: for a size, honouring the direction the user
+// asked for reads as working, where falling back to the default reads as ignored. Non-numeric
+// input is a different thing — "nothing configured here" — so it stays null and lets the caller
+// fall back. Fractional sizes round: xterm accepts them, but they make cell metrics drift from
+// the integer the UI shows.
+export function normalizeFontSize(input: unknown): number | null {
+  if (typeof input !== "number" || !Number.isFinite(input)) return null;
+  return Math.min(TERMINAL_FONT_SIZE_MAX, Math.max(TERMINAL_FONT_SIZE_MIN, Math.round(input)));
+}

package/dist/assets/{abnfDiagram-VRR7QNED-RjiYivmv-CMyzg2zY.js → abnfDiagram-VRR7QNED-RjiYivmv-BMVn5P4x.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-D1ef8DoR.js";import"./chunk-WYO6CB5R-BlzOfotS-qckQG4MR.js";import"./chunk-VAUOI2AC-CS9QJ4yz-DviHNtmN.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-CG59XkeN.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-iymJ5XTw.js";import"./chunk-WYO6CB5R-BlzOfotS-BRhqiyoJ.js";import"./chunk-VAUOI2AC-CS9QJ4yz-C6T0-Q0n.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-DsiY753w.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};

package/dist/assets/architecture-TIHT7OUA-0NsD2xW1-JfeahpZ_.js

@@ -0,0 +1 @@
+import{f as e}from"./mermaid-parser.core-DxEa8E3F-iymJ5XTw.js";export{e as createArchitectureServices};