muxr 0.1.11 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0bd4e1e9036cc3f25aaa50e92b4183eb123230b3c33877d369d5350b1de8cc4
-  data.tar.gz: 55cd2910b19e1f546e6278c7d4532f34f4627be5e30866420e3ebe6b1997f3d1
+  metadata.gz: f207f0ebd4d74ae0660e3659cd9ad9703ff414266621d5a2624c5771d267cd0c
+  data.tar.gz: f8302e2987a759d5efe1c5971cd9845815f529c2dd901d0eaf229b6e4d107888
 SHA512:
-  metadata.gz: 4782c572a8e4ab2ba193bfd38edb0f11c37e8033decc79b5ebda1b2e2629c56adc8363e9ac000c7314eec508faf98f8b6c40fa9dfa03570ed42e9ccee0c2cfca
-  data.tar.gz: 9f39b068f63bfcae8f72dd7caba1a539723d98534d34cac0b15048f902df3440f3e4c51ac18fa6cf8154fc4eecfec8bc7eacc2c692cbe7ca03774db6cb2bc8bb
+  metadata.gz: f746020a1a69c8a90fb96cde030357eb9ac999b1b99e8f88a3b3d23b92d9047bcecc0830edddf4b897fc8627029ee3f539f82bc9216712a3ebff76248ab052aa
+  data.tar.gz: 633ff78595a4fc0f041decea8f4a574321908bc7d3a8624e087b000d55b84487baf870f5c9b3ad3f1db5fd517f2f712ff1bd79e33b1763df951801acd1c6c60b

data/CHANGELOG.md

@@ -6,6 +6,229 @@ follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-09-23
+
+### Fixed
+- A flash is visible again in the modes that actually raise one. The status
+  bar's message branch was the last `elsif` in a chain starting with the
+  command prompt and running through scrollback, search and selection, so any
+  mode with a full-row overlay painted the row and the message never drew.
+  "not found: <query>" from a failed search and "yanked N bytes" from a
+  selection both land back in scrollback, where neither had ever been seen;
+  the scroll-source work added four more that only fire there, which is why
+  `Tab` on a pane with no scroll of its own read as a dead key rather than a
+  refusal with a reason. The message now draws after the chain, right-aligned
+  over the overlay — transient and specific beats a static key hint.
+
+### Added
+- `:capture [path]` saves the focused pane's full scrollback and screen to a
+  plain-text file: no escape codes, trailing spaces trimmed, wide glyphs
+  intact. With no path it writes to
+  `~/.muxr/captures/<session>-<pane>-<timestamp>.txt`. A relative path is
+  resolved against the directory the session was started in. While a
+  full-screen program is up, the capture holds the shell underneath rather
+  than the program's frame.
+- A config file at `~/.muxr/config.json` (or wherever `MUXR_CONFIG`
+  points) sets `layout`, `scrollback`, `master_ratio`, `master_count`,
+  `auto_spiral_min` (`{"cols": 180, "rows": 30}`), `prefix` (`"C-b"` to use
+  Ctrl-b instead of Ctrl-a), and `keys`, which remaps normal-mode and
+  prefix-mode keys onto existing actions (`{"normal": {"Z": "toggle_zoom",
+  "q": null}}`; `null` unbinds a key). Settings that don't make sense are
+  skipped and reported: the first one is flashed when you attach, and all of
+  them go to the session log. A saved session's layout still wins over the
+  configured default, and `MUXR_SCROLLBACK` still wins over `scrollback`.
+  `:reload` re-reads the file without restarting the server. A key can also
+  run any prompt command: `{"normal": {"Y": ":sync"}}`. A configured prefix
+  shows up everywhere muxr names the prefix: the help overlay, the `muxr ^b ?`
+  hint in the status bar, the `[^B]` chip while the prefix is pending, the
+  passthrough flash, and `muxr --help` (which also says which config file the
+  prefix came from).
+- `:rename <name>` gives the focused pane a label, shown in its title in
+  place of the hex id (`#1 api`). A bare `:rename` clears it. Names are saved
+  with the session, travel with a pane when it is moved to another session,
+  appear in the attach picker, and are listed by `muxr_panes_list` (except
+  for private panes). Any MCP tool that takes `pane` now also accepts a name.
+  An id always wins over a name that happens to look like one, and a name
+  shared by two panes is refused. The bridge's refusal to let a claude read
+  or type into its own pane also applies when that pane is referred to by
+  name.
+- `:sync` sends what you type to every pane in the window at once. It works
+  in passthrough mode, and `C-a ]` pastes go to every pane too. Use it to run
+  the same command on several hosts or checkouts. `:sync on` / `:sync off`
+  set it explicitly, and a bare `:sync` toggles it. While it is on, the
+  status bar shows a red `[SYNC]` and every unfocused pane gets a red border,
+  so you cannot forget it is on. Borrowed panes are included, and your
+  keystrokes reach their real shells. The drawer is left out in both
+  directions: typing in the drawer stays in the drawer. Sync is deliberately
+  not saved with the session.
+- `z` (or `C-a z`, or `:zoom`) zooms the focused pane to full screen, and
+  pressing it again restores the layout you were in. The status bar reads
+  `layout:zoom:tall` while zoomed, so you can see what `z` will return to.
+  Picking any layout explicitly forgets the zoom. A session saved while
+  zoomed saves the layout underneath.
+- The master area can be resized and can hold more than one pane, the way
+  it can in xmonad. `<` / `>` shrink or grow the master's share of the
+  screen in 5% steps, between 10% and 90%. `,` / `.` take a pane out of the
+  master area or add one to it, so two panes can share the master column.
+  Both keys work in normal mode and after `C-a`, and both apply to `tall`,
+  `wide` and `centered`. `:ratio 60` and `:masters 2` set them directly. The
+  current shape is flashed on every change and saved with the session.
+- `:silence <secs>` alerts you when the focused pane stops printing. Once
+  the pane has been quiet for that long, muxr flashes `pane #2 silent for
+  30s`, rings the outer terminal's bell, and marks the pane `~` in its title
+  and in `alerts:`. It fires once per quiet spell and re-arms on the next
+  output. It takes `30`, `30s` or `2m`. `:silence off` disarms it, and a bare
+  `:silence` reports the current setting. An armed pane shows
+  `[silence 30s]` in its title, and the threshold is saved with the session.
+- Panes that want your attention are marked. A pane that rings the bell or
+  sends an OSC 9 / OSC 777 notification while you are looking elsewhere gets
+  a `!` after its number in the title (`#2!`), and one that prints anything
+  gets a `•` (`#3•`). The status bar collects them as `alerts:2!,3•`. Both
+  clear the moment the pane is focused. The pane you are looking at is never
+  marked, unless no client is attached, in which case nobody is looking at
+  it either. Output within 1.5 s of a pane being resized or created is not
+  counted: every layout change sends SIGWINCH to every shell, and each one
+  answers by redrawing its prompt, which would otherwise light up every pane
+  on screen.
+- Scrollback can now drive the program instead of muxr's ring. A pane whose
+  program has turned on mouse tracking (DECSET 1000/1002/1003 — `lazygit`,
+  `k9s`, `htop`) gets `C-a [` routed to *it*: muxr synthesises
+  wheel reports at the centre of the pane and writes them into the pty, so
+  `j`/`k`, `C-d`/`C-u` and `C-f`/`C-b` scroll the program's own transcript
+  from the keyboard, no mouse involved. SGR encoding when the program asked
+  for 1006, legacy X10 otherwise. A full-screen program that wants no mouse
+  falls back to arrow keys, which is what `less` and `vim` respond to — so
+  `C-a [` no longer dead-ends with "no history while a full-screen app is
+  running" on an alternate-screen pane. `Tab` switches between the app's
+  scroll and muxr's ring at any time, and the mode chip reads `SCROLL:APP`
+  while the app has it. `Terminal` tracks the mouse modes and carries them in
+  `dump_ansi`, so a mirrored or moved pane knows its program speaks mouse.
+  Visual selection is clamped to the visible screen while the app is being
+  scrolled: a self-scrolling program repaints in place, so the ring's tail no
+  longer continues into row 0 and a selection spanning that seam would splice
+  two unrelated regions into the paste buffer.
+- The MCP bridge now reaches *any* claude started inside muxr, not just the
+  one in the Claude drawer. `MUXR_SESSION` and `MUXR_CONTROL_SOCKET` are
+  injected into every PTY muxr spawns, so with the bridge registered once at
+  user scope (`claude mcp add muxr muxr-mcp --scope user`) a claude launched
+  from an ordinary pane is already wired to the session around it. Each
+  pane's shell also carries `MUXR_PANE`, its own id: the bridge refuses
+  `pane.read`, `pane.send_input`, `pane.run` and `pane.kill` against that
+  pane, since driving your own pty feeds your output back to you — the pane
+  equivalent of the drawer's `MUXR_DRAWER_SELF` guard. Panes that predate the
+  upgrade need reopening to pick the vars up.
+- The bridge follows its pane across a move. Those env vars are a snapshot of
+  where the pane was when its shell started, and moving a pane to another
+  session leaves them naming the old one — a running process's environment
+  cannot be rewritten from outside. When the session the env names no longer
+  lists `MUXR_PANE` among its own panes, the bridge asks the other control
+  sockets in the same directory which of them owns it and connects there
+  instead, re-checking on a ten-second TTL so a pane moved out from under a
+  running claude is followed rather than left driving its old session. A
+  mirrored pane carries `origin` and is never mistaken for the owner.
+- Attach a pane from another muxr session: `A` (or `C-a A`, or `:attach`)
+  opens a picker listing every pane the other live servers on this machine
+  are willing to share, grouped by session. The chosen pane is *shared, not
+  moved* — it keeps running where it is, both sessions show the same live
+  shell, and either can type into it. The owner keeps the PTY and remains
+  its only reader; what crosses the control socket is the raw byte stream
+  and keystrokes, so colors, the alternate screen and full-screen TUIs all
+  mirror faithfully. The PTY runs at the smallest viewport looking at it so
+  it fits both layouts. If the owning session stops, the borrower drops the
+  pane; if the borrower stops, only the mirror goes away and the pane
+  carries on at home. Private panes are never offered, and borrowed panes
+  are left out of `:save`. New control methods: `pane.mirror`,
+  `pane.mirror_resize`, `pane.unmirror`, `pane.redraw`; `pane.send_input`
+  and `pane.run` now also accept `base64: true` payloads.
+- Move a pane between sessions for real, with `m` in the same picker. The
+  master pty file descriptor crosses the socket via `SCM_RIGHTS`, so the
+  same shell process keeps running — environment, background jobs, screen
+  and full scrollback intact — and simply belongs to the receiving session
+  afterwards, as an ordinary local pane. The handoff is two-phase: nothing
+  is torn down until the receiver confirms it has a working pane, a failure
+  anywhere leaves the pane where it was, and an abandoned move times out
+  after ten seconds instead of pausing the pane forever. muxr refuses to
+  move the last pane out of a session (it would shut that session down) or
+  to move on a pane that is itself borrowed. Sessions mirroring a pane that
+  moves away are told it is gone and detach. New control methods:
+  `pane.move`, `pane.move_commit`, `pane.move_abort`.
+- Kitty graphics protocol images are saved to `~/.muxr/images` and
+  announced in the pane as a clickable `file://` path (OSC 8) instead of
+  being drawn. muxr renders a cell grid and has nowhere to put pixels, so
+  `[image 640×480 → ~/.muxr/images/…png]` is the honest rendering —
+  Cmd-click opens it. Multi-chunk (`m=1`) transmissions are reassembled,
+  `t=f`/`t=t` file transmissions are read from disk, and raw `f=24`/`f=32`
+  pixel data is re-encoded into a PNG container so the saved file is
+  actually openable. A capability query (`a=q`) is answered `OK` so inner
+  programs pick the kitty path instead of falling back to sixel. The store
+  keeps the 200 most recent images.
+- A project page at https://roelbondoc.github.io/muxr/, served from `docs/`.
+  Its layout playground runs a port of `LayoutManager` in the browser, so
+  pressing muxr's own layout and `hjkl` keys tiles with the real algorithm.
+  A **Screen** control switches the simulated terminal between 132×38 and
+  220×54 so `auto` can be seen changing its mind.
+- An `auto` layout (`F`, or `:layout auto`) that picks its geometry from the
+  screen it is on: `spiral` once the content area is at least 180×30,
+  `stack` below that. It is a resolver rather than a tenth geometry —
+  `LayoutManager.resolve` maps it to a real layout and `compute` resolves
+  before dispatching, so nothing downstream sees `:auto`. No new size
+  plumbing: SIGWINCH already reaches the server as a `RESIZE` frame, so
+  detaching onto a laptop or plugging in a monitor re-resolves on the next
+  frame. The status bar names the verdict, e.g. `layout:auto:stack`.
+
+- The alternate screen buffer (DECSET 47/1047/1049, and 1048 for its cursor
+  slot). A full-screen program — a pager, an editor, `fzf` — now draws on a
+  grid of its own, and the screen it covered is set aside untouched until it
+  exits. Nothing drawn there reaches scrollback and the view offset is pinned
+  to the live screen, so there is nothing to page into; scrollback declines to
+  open on such a pane, and a pane that enters an alternate screen under a
+  reader drops them out of the mode. `Terminal#dump_ansi` leads with a repaint
+  of the covered screen, so a mirrored or moved pane carries both grids and
+  quitting the pager on the far side uncovers the same shell it uncovers at
+  home.
+- `MUXR_SCROLLBACK` sets the scrollback depth at server start, clamped to a
+  sane range.
+
+### Changed
+- `muxr-mcp` no longer exits when it can't find a muxr session. Registering
+  it at user scope loads it into every claude on the machine, most of which
+  are nowhere near a muxr, and exiting surfaced a failed MCP server in all of
+  them. It now completes the handshake, advertises no tools when there is no
+  session to talk to, and says so if called anyway. The socket is opened on
+  first use rather than at startup and reopened if it drops, so a claude
+  running in a pane survives a restart of the session around it.
+- `auto` is the default layout for new windows (was `spiral`). Saved
+  sessions are unaffected.
+- Scrollback holds 50,000 rows per pane by default, up from 5,000. Rows are
+  now stored packed — one string of characters plus run-length attributes,
+  trimmed to their content and materialized into cells only when read — which
+  cut a filled ring from ~330 MB of resident memory per pane to ~12 MB at
+  20,000 rows and made the deeper default affordable. Search and the transfer
+  serializer read the packed bytes directly, so `/` over a full 50,000-row
+  ring completes in tens of milliseconds.
+
+### Fixed
+- The help overlay claimed `C-a t w g m` set layouts and `muxr --help`
+  claimed `C-a k` closed a pane. Neither binding exists: layout keys are
+  normal-mode only, and close is `C-a x`.
+- `--list` and `:sessions` no longer report a phantom `<name>.ctrl`
+  session. Both enumerated `~/.muxr/sockets/*.sock`, which also matches
+  the sibling control socket `<name>.ctrl.sock`.
+- A pane whose grid is larger than the box drawn for it is now clipped to
+  the box instead of painting over its own border. Only reachable with a
+  borrowed pane, whose geometry belongs to another session.
+- Paging through a full-screen program no longer destroys scrollback. Without
+  an alternate screen buffer, a pager drew straight onto the primary grid and
+  every page-down pushed a screenful of its own frames into history, evicting
+  real output at the ring's cap — twenty page-downs of `less` cost 232 rows —
+  and quitting left the program's last frame on screen instead of uncovering
+  the shell.
+- APC (`ESC _ … ST`) and DCS/SOS/PM (`ESC P`/`ESC X`/`ESC ^`) string
+  sequences are now consumed by the parser. Previously neither had a
+  parser state: the introducer was swallowed and the entire body printed
+  into the grid as text, so any program emitting kitty graphics or sixel
+  sprayed kilobytes of base64 across the pane.
+
 ## [0.1.11] - 2026-06-11
 
 ### Added
@@ -332,7 +555,8 @@ Initial release.
   boundaries.
 - Renderer that composes one frame and diff-emits ANSI to STDOUT.
 
-[Unreleased]: https://github.com/roelbondoc/muxr/compare/v0.1.11...HEAD
+[Unreleased]: https://github.com/roelbondoc/muxr/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/roelbondoc/muxr/releases/tag/v0.2.0
 [0.1.11]: https://github.com/roelbondoc/muxr/releases/tag/v0.1.11
 [0.1.10]: https://github.com/roelbondoc/muxr/releases/tag/v0.1.10
 [0.1.9]: https://github.com/roelbondoc/muxr/releases/tag/v0.1.9