umputun / agterm / 31151589951

98%

push

github

feat(control): hud corner placement and text color

two additions to `session hud`, both asked for in discussion 384.

**placement.** `--position` now takes the nine anchors of a 3x3 grid, spelled exactly as
`session background` spells them, so the shared `--position` field means one thing across both
commands. Every anchor off center holds a fixed edge margin on each axis it names, which is what lets
a panel sit in a corner instead of over the text being read. The bare `top` and `bottom` it shipped
with stay accepted as aliases for the middle column and normalize on read-back, so existing callers
keep working and `tree` reports one spelling.

`HudPosition.parse` is the single entry point for turning text into an anchor. The dispatcher, the
CLI's local validation and `Decodable` all go through it, so no path accepts a name another rejects.
Rejections and help list `acceptedNamesList` rather than the canonical set alone, the same split
`HudSpinner` already makes for `none`.

**text color.** `--text-color` colors the panel's text. It rides the body file's header as SGR
parameters rather than a per-surface config, which is why an update can change it while
`--background-color` still cannot: the surface reads the backing once at creation, the painter
re-reads the header every tick. `hud update` therefore takes `--text-color` and no
`--background-color`. `HudLayout.foregroundSGR` owns the encoding, host-free; `hud.sh` converts
nothing and wraps only digits and semicolons, so a malformed header cannot emit an arbitrary escape
into the pane.

the header gained one fixed field, before the variable-length spinner frames, and the helper's shift
count moved with it.

read-back carries `textColor` beside `backgroundColor`, with opposite update lifetimes: the
background is the color the panel was created with, the text color tracks the latest update.

verified against a live Debug instance across all nine anchors and an amber/green/red recolor
sequence on one pane... (continued)

64 of 66 new or added lines in 5 files covered. (96.97%)

7450 of 7612 relevant lines covered (97.87%)

4514130.0 hits per line