Expand description
Shared pure tmux model state for agent-doc.
This crate owns reusable tmux observations, realtime state, and layout
projection policy. It does not execute tmux commands, dispatch turns,
merge document text, or commit document changes.
Structs§
- Associated
Pane Candidate - Column
Memory Application - Column
Memory Restoration - Stash
TtlCandidate #stash-session-ttl-prune: one stash pane’s candidacy for opt-in TTL reaping.- Tmux
Focus Only Expansion - Tmux
Layout Column - Tmux
Model Machine - Tmux
Pane Geometry - Tmux
Realtime State
Enums§
- Associated
Pane Resolution - Associated
Pane Source - Focus
Pane Decision - Outcome of reconciling a candidate pane against the document’s provably-live owner pane.
- Pane
Position - Pane
Position Error - Prune
Cleanup Mode - Tmux
Focus Only Expansion Event - Tmux
Focus Only Expansion Mode - Tmux
Observation - Tmux
Pane Activity - Tmux
Pane Process Kind - Tmux
Supervisor Health
Constants§
- DESTRUCTIVE_
REPAIR_ MIN_ INTERVAL_ MS - Minimum interval between destructive doctor-repair passes for one tmux
session. Rapid
agent-doc syncinvocations within this window skip the destructiverepair_layoutwindow-op sequence while the non-destructive reconciler still runs. - TMUX_
PANE_ GEOMETRY_ FORMAT
Functions§
- apply_
column_ memory - apply_
focus_ only_ expansion_ policy - associated_
pane_ candidates_ detail - auto_
start_ candidate_ files - build_
layout_ state - classify_
sync_ layout_ columns - decide_
focus_ pane - Decide whether focus should keep its candidate pane or swap to a provable live owner pane.
- destructive_
repair_ throttled - Pure throttle decision:
truemeans skip the destructive repair this pass. - expand_
focus_ only_ columns_ for_ editor_ switch - focused_
column_ index - format_
associated_ pane_ fix_ error - format_
associated_ pane_ resolution_ error - format_
associated_ pane_ selected_ error - format_
missing_ pane_ closeout_ block_ reason - format_
missing_ pane_ manual_ repair_ reason - is_
first_ column - Determine if the file is in the first column of the editor layout.
- pane_
current_ command_ is_ agent_ process - pane_
current_ command_ is_ bare_ shell - Foreground program names tmux reports via
#{pane_current_command}when a pane has fallen back to a bare interactive shell. Login shells can show a leading-, for example-zsh. - pane_
process_ kind_ from_ current_ command - pane_
process_ kind_ from_ current_ command_ samples - parse_
pane_ inventory_ line - parse_
session_ window_ line - parse_
session_ windows - parse_
tmux_ pane_ geometry - projected_
sync_ pane_ count - repair_
layout_ skips_ rescue_ phase - resolve_
associated_ panes - same_
sync_ file - select_
pane_ by_ position - stash_
ttl_ prune_ candidate #stash-session-ttl-prune: pure, non-destructive decision for whether a stash-parked agent-doc pane is eligible for opt-in TTL reaping. Conservative by construction (seetasks/agent-doc/plan-stash-session-ttl-prune.md): the actualkill-panewiring, the idle-signal query, the config knob, and live verification are all gated — this is only the reusable decision core.- stash_
ttl_ prune_ targets - Filter a candidate list to the pane ids eligible for TTL reaping. With
ttl_secs == 0(disabled / unset) this always returns empty, so the feature is inert until explicitly configured. - transition_
tmux