pb edit

Edit an existing validation plan with a natural-language instruction (AI Validation Editor).

pb edit [OPTIONS] [VALIDATION_FILE]

VALIDATION_FILE is a Python (.py) or YAML (.yaml/.yml) file containing a validation plan. The instruction is sent, along with the current plan, to the specified model; the proposed change is shown as a diff for review and can optionally be written to a file.

Full --help output

Usage: pb edit [OPTIONS] [VALIDATION_FILE]

  Edit an existing validation plan with a natural-language instruction (AI
  Validation Editor).

  VALIDATION_FILE is a Python (.py) or YAML (.yaml/.yml) file containing a
  validation plan. The instruction is sent, along with the current plan, to
  the specified model; the proposed change is shown as a diff for review and
  can optionally be written to a file.

  Examples:

  pb edit plan.py -i "add a not-null check on user_id" -m anthropic:claude-opus-4-8
  pb edit plan.yaml -i "tighten the price range to 0-1000" -m openai:gpt-4o --data sales.csv
  pb edit plan.py -i "drop the email regex check" -m anthropic:claude-opus-4-8 -o plan2.py -y

Options:
  -i, --instruction TEXT  Plain-English description of the change to make to
                          the plan.
  -m, --model TEXT        Model to use, as provider:model (e.g.,
                          anthropic:claude-opus-4-8).
  --data TEXT             Optional data source used for DataScan-informed
                          edits and validation.
  -o, --output PATH       Write the revised plan to this file.
  -y, --yes               Write the output file without asking for
                          confirmation.
  --help                  Show this message and exit.

Arguments

VALIDATION_FILE: PATH: Optional.

Options

-i, --instruction: TEXT: Plain-English description of the change to make to the plan.
-m, --model: TEXT: Model to use, as provider:model (e.g., anthropic:claude-opus-4-8).
--data: TEXT: Optional data source used for DataScan-informed edits and validation.
-o, --output: PATH: Write the revised plan to this file.
-y, --yes: Write the output file without asking for confirmation.

Examples


pb edit plan.py -i "add a not-null check on user_id" -m anthropic:claude-opus-4-8
pb edit plan.yaml -i "tighten the price range to 0-1000" -m openai:gpt-4o --data sales.csv
pb edit plan.py -i "drop the email regex check" -m anthropic:claude-opus-4-8 -o plan2.py -y