flush - 2501.ai

Delete scenario run data from the database. Always shows a preview and asks for confirmation before proceeding.

2501-runner flush [filters] [options]

At least one filter is required.

Options

Option	Description
`--older-than <duration>`	Delete records older than the given duration. Accepts `7d`, `24h`, `2w`, `1m`, etc.
`--scenario <keys>`	Filter by scenario key(s), comma-separated (e.g. `nginx/001-broken-config,disk`).
`--status <status>`	Filter by status (see below).
`--deprecated`	Delete records for scenario keys that no longer exist on disk.
`--all`	Delete all scenario run data. Requires typing `yes` to confirm.
`--preview`	Show what would be deleted without deleting anything.
`-y, --yes`	Skip the confirmation prompt.
`-p, --scenarios-path <path>`	Path to scenarios directory (used with `--deprecated`, auto-detected if omitted).
`--env-file <path>`	Path to env file (auto-detected if omitted).

--status values:

Value	Namespace
`PASSED` / `FAILED`	ScenarioReport status
`success` / `agentic_failure` / `hard_failure` / `no_tasks_created`	Job resolution status

Examples

# Preview what would be deleted for scenarios older than 7 days
2501-runner flush --older-than 7d --preview

# Delete all runs for a specific scenario
2501-runner flush --scenario nginx/001-broken-config

# Delete all failed runs older than 30 days
2501-runner flush --older-than 30d --status FAILED

# Delete records for scenarios that no longer exist on disk
2501-runner flush --deprecated

# Delete everything (requires typing "yes")
2501-runner flush --all

# Non-interactive delete (CI usage)
2501-runner flush --older-than 14d --yes

Each flush removes matched ScenarioReport records along with their associated Job, Task, and Ticket records. The preview box shows exact counts before deletion. Run history is also visible in the Benchmark page in Command Center.