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.