# `once query test-plan`

Create an immutable test plan without assigning work to runners.

## Synopsis

```text
once query test-plan [OPTIONS]
```

## Options

| Flag | Value | Default | Description |
| --- | --- | --- | --- |
| `--changed-path` | `<PATH>` |  | Changed workspace-relative path. Repeat for multiple paths. |
| `--target` | `<TARGET>` |  | Create an explicit plan for this target instead of selecting by changed path. |
| `--test-unit` | `<TEST_UNIT>` |  | Select one current, filterable unit from `once query test-manifest`. Planning fails when the target does not support exact filtering or the unit is absent from the persisted whole-target manifest. |

`once query test-plan`

Create an immutable test plan without assigning work to runners.

Synopsis#

plaintext

once query test-plan [OPTIONS]

Options#

Flag	Value	Description
`--changed-path`	`<PATH>`	Changed workspace-relative path. Repeat for multiple paths.
`--target`	`<TARGET>`	Create an explicit plan for this target instead of selecting by changed path.
`--test-unit`	`<TEST_UNIT>`	Select one current, filterable unit from `once query test-manifest`. Planning fails when the target does not support exact filtering or the unit is absent from the persisted whole-target manifest.