umputun / agterm / 33707669523

97%

push

github

scope session.hud placement to a pane (#536)

* feat(control): scope session.hud placement to a pane

hud anchors resolved against the whole session rect, so in a split an agent asking for
bottom-right got the panel over the other pane, and `--size-percent` measured the same way
could push a long message across the divider.

`hud.open` and `hud.update` now take `--pane` and `--pane-id`, resolved the way
`session.restore` resolves them: a live stable token wins over the role, an unknown token with
no role fallback errors. The resolved identity is stored, so swap and promotion carry the panel
with its shell. Frame, anchor, `--size-percent`, the 80% cap and the edge margin all come from
the deck pane host's live bounds, published as a preference in the session detail coordinate
space. Never `splitRatio`, which is observation-ignored and would not re-lay-out on a divider
drag, and never the terminal surface, which zoom reparents.

open refuses a pane the deck does not render. Hiding the target keeps the HUD alive but
unmounted, showing it restores the panel, and destroying the pane closes the HUD. `tree` reports
the target's current role as `hud.pane`.

still one last-writer-wins HUD per session. Simultaneous per-agent panels are a separate ask.

Related to https://github.com/umputun/agterm/discussions/384

* fix(control): correct hud pane docs and pin the mount gate

review of the pane placement change turned up nine minors, all fixed here.

the ones that mattered were documentation an agent would act on and get wrong. `hud update` was described as
having open's rejections, which the change had deliberately made false: update resolves placement
with `requireVisible: false`, so it accepts a hidden target and answers `session has no split` where
open answers `pane not visible`. `reference.md` was also missing two reachable rejections, one of
them `hud pane must be left or right`, which appeared in no doc at all. Both files ship into the
installed Claude an... (continued)

40 of 58 new or added lines in 9 files covered. (68.97%)

9657 of 9927 relevant lines covered (97.28%)

4110552.46 hits per line