| command | detectkit subcommand to run: "run", "autotune", or "clean". Any other value fails the step immediately (exit code 2) without invoking dtk. | no | run |
| select | Metric selector passed as `--select` (metric name, path pattern, or `tag:<name>`). `dtk run`/`dtk autotune` require a selector; `dtk clean` accepts either a selector (drift mode) or `--orphaned-metrics` (GC mode) via `extra-args` — set `select: ""` to use the latter, since a non-empty `select` and `--orphaned-metrics` conflict. | no | * |
| steps | Comma-separated pipeline steps passed as `--steps` (e.g. "load,detect" or "load,detect,alert"). Empty (default) omits the flag, so `dtk run` uses its own default (load,detect,alert). Only meaningful for `command: run`; ignored (with a warning) for autotune/clean. | no | "" |
| profile | Profile name passed as `--profile` (default: the project's `default_profile` in detectkit_project.yml / profiles.yml). | no | "" |
| project-dir | Directory containing detectkit_project.yml and profiles.yml, relative to the workflow's working directory (usually the checked-out repo). | no | . |
| version | detectkit PyPI version spec. A bare version ("0.61.0") is pinned exactly (`detectkit==0.61.0`); a string starting with a pip operator (">=0.60,<0.62", "~=0.61") is used as-is. Empty (default) installs the latest release. | no | "" |
| extras | Comma-separated pip extras to install alongside detectkit, e.g. "clickhouse" or "duckdb,mysql" (see the Databases guide for the full list). Empty (default) installs the bare package with no database driver — set this to whatever backend your profiles.yml points at. | no | "" |
| python-version | Python version for actions/setup-python (detectkit requires 3.10+). | no | 3.12 |
| json-summary | For `command: run` only: pass `--json` to capture the machine-readable run summary into the `summary`/`summary-path` outputs (human-readable logs still print to the job log via stderr either way). `autotune` and `clean` have no `--json` flag, so this has no effect on them. | no | true |
| extra-args | Extra raw arguments appended to the dtk command line, parsed with real shell quoting (e.g. "--full-refresh --force", or "--orphaned-metrics --execute --yes" for `dtk clean` with `select: ""`) — quote a value that contains spaces, e.g. extra-args: '--from "2026-01-01 00:00:00"'. | no | "" |