Command-Line Help for `testaruda`

This document contains the help content for the testaruda command-line program.

Command Overview:

`testaruda`

Language-agnostic test selection engine — compute the affected test set from a code change via provenance-semiring dependency analysis

Usage: testaruda [OPTIONS] <COMMAND>

-v, --verbose — Increase output verbosity (-v, -vv, -vvv)
-q, --quiet — Suppress non-error output
-j, --json — Output machine-readable JSON (default when stdout is not a TTY)
--human — Output human-readable text (default when stdout is a TTY)

Initialize store and config in the current project

Usage: testaruda init

Select affected tests from a code change

Usage: testaruda select [OPTIONS]

--base <BASE> — Base revision (git ref)
--head <HEAD> — Head revision (git ref)
--files <FILES> — Explicit changed-file list (comma-separated)
--shadow — Shadow mode: compute but report all tests should run (TIA-CI-007)
--agent — Agent output format: structured JSON for LLM agent consumption (TIA-AGENT-001) Conflicts with –pre-edit
--pre-edit — Pre-edit blast radius: report affected tests for proposed changes (TIA-AGENT-005) Conflicts with –agent
--ci — CI mode: run selected tests and ingest results automatically (TIA-CI-008)
--safe — Safe mode: pre-flight checks then fall back to cargo test if anything is missing (config, store, git refs) or confidence is low. Implies –ci. Recommended: pass –base and –head to test the diff between two git refs; otherwise falls back to uncommitted changes
--ordering <ORDERING> — Selection ordering mode

Default value: default

Possible values:
- default: No specific ordering — results in Ascent’s internal iteration order
- deterministic: Byte-stable ordering: sort by test ID (TIA-SEL-005)
- duration: Order by descending recorded mean duration (TIA-SEL-006)
- predictive: Order by descending historical failure rate (TIA-SEL-007)

Full loop: select → run selected tests → ingest → calibrate (gh-26)

Usage: testaruda exec [OPTIONS]

--base <BASE> — Base revision (git ref)
--head <HEAD> — Head revision (git ref)
--files <FILES> — Explicit changed-file list (comma-separated)
--ordering <ORDERING> — Selection ordering mode

Default value: default

Possible values:
- default: No specific ordering — results in Ascent’s internal iteration order
- deterministic: Byte-stable ordering: sort by test ID (TIA-SEL-005)
- duration: Order by descending recorded mean duration (TIA-SEL-006)
- predictive: Order by descending historical failure rate (TIA-SEL-007)
--threshold <THRESHOLD> — Recall threshold (0.0–1.0) for the calibration gate (default: 0.8)

Default value: 0.8

Evaluate the predictive ranking calibration gate (TIA-VER-005)

Usage: testaruda calibrate [OPTIONS]

--threshold <THRESHOLD> — Recall threshold (0.0–1.0) for promotion (default: 0.8)

Default value: 0.8

Ingest test run results to update the model

Usage: testaruda ingest [OPTIONS] <PATH>

--raw — Raw test output — delegate to the project’s configured adapter for parsing and store runtime edges from the execution
--adapter <ADAPTER> — Adapter binary to use for raw output parsing (default: auto-detect)