umputun / agterm / 28919975493

98%

push

github

feat: expose an open overlay's size on the tree read side (#167)

* feat: expose an open overlay's size on the tree read side

session.overlay.resize could switch an overlay full<->floating but nothing
reported its current size, so a tmux-style zoom script couldn't restore the
exact original size after zooming to --full, it had to guess a fixed percent.

add overlaySizePercent to ControlSessionNode (omitted for a full-pane overlay or
no overlay, else the floating panel's percent), populated from
session.overlaySizePercent in AppStore.controlTree. So a script reads .overlay to
know an overlay is open and .overlaySizePercent for its size.

docs: agent-skill reference.md tree schema + control-api.md read-side note.
tests: round-trip (present + omitted-when-nil) + controlTree populate. No new
command, count stays 53.

* docs: list overlaySizePercent in the agent-skill tree summary

review-loop cleanup: codex and the documentation reviewer flagged that SKILL.md's
tree-field summary named the sibling read-side fields (background, unseen,
statusPane) but not the new overlaySizePercent.

reference.md and control-api.md were already in sync; this brings the SKILL.md
summary in line too.

* docs: note the read-back keep-in-sync obligation for control commands

a control command that writes or sets session state also owes a matching read
field on the tree node, so a script can query what it just changed. The
four-point audit only covers the write path. `session.overlay.resize` shipped
write-only, which is what this branch fixes with overlaySizePercent.

add the principle to the root CLAUDE.md HARD keep-in-sync section, and the
detail (with the round-trip + controlTree populate test expectation) to
control-api.md.

2 of 2 new or added lines in 2 files covered. (100.0%)

3712 of 3749 relevant lines covered (99.01%)

8019569.33 hits per line