NAME
LibTmux::QueryPlan - Explainable explicit pane acquisition
METHODS
summary
Describe native lowering and local residual reasons. Explanation performs no I/O and uses the support floor until connected capabilities are available.
to_data
Return an inspectable plan with source commands, filter, policy, and reasons. The LibTmux::Schema catalog identifies required fields and relations.
filter
Return the compiled LibTmux::Filter. Its matching remains local.
policy
Return auto, never, or require. "query_panes" in LibTmux::Server executes the plan with complete captured local evaluation. Native candidates cannot hide errors or discard matches from that captured result. Only verified complete translation qualifies for require; runtime disagreement throws "QueryMismatch" in LibTmux::X without assigning a cause. The optional "query_panes" in LibTmux::Server observer exposes completed comparisons.