# LibTmux::QueryPlan

- **Module:** LibTmux
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** class
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/QueryPlan.pm#L1
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-queryplan/

```
package LibTmux::QueryPlan;
```

Explainable explicit pane acquisition

## Members

### Other members

- [`filter`](/en/perl/latest/reference/libtmux-queryplan-filter/) (method): Return the compiled [`LibTmux::Filter`](/en/perl/latest/reference/libtmux-filter/). Its matching remains local.
- [`policy`](/en/perl/latest/reference/libtmux-queryplan-policy/) (method): Return auto, never, or require. [`"query_panes" in LibTmux::Server`](/en/perl/latest/reference/libtmux-server-query_panes/) 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`](/en/perl/latest/reference/libtmux-x-querymismatch/) without assigning a cause. The optional [`"query_panes" in LibTmux::Server`](/en/perl/latest/reference/libtmux-server-query_panes/) observer exposes completed comparisons.
- [`summary`](/en/perl/latest/reference/libtmux-queryplan-summary/) (method): Describe native lowering and local residual reasons. Explanation performs no I/O and uses the support floor until connected capabilities are available.
- [`to_data`](/en/perl/latest/reference/libtmux-queryplan-to_data/) (method): Return an inspectable plan with source commands, filter, policy, and reasons. The [`LibTmux::Schema`](/en/perl/latest/reference/libtmux-schema/) catalog identifies required fields and relations.