Add data / ATH documentation

ath correct

Replace a record's complete data and retain its prior revision.

Usage

$ath correct <record-id> --revision 2 --data '<complete-data-json>' --json

What it does

Keeps the stable record ID and complete earlier revisions. The expected revision prevents a stale preview from overwriting a newer change.

Review before writing

Read the current record and revision, preview a complete replacement, then repeat with --yes. Attachments can be added while correcting an athlete report or nutrition entry.

$ath records show <record-id> --history --json
$ath correct <record-id> --revision 2 --data '<complete-data-json>' --yes

Options

--revision <number>: required current revision from the preview
--data <json>: complete replacement data object
--agent <name>: agent making the correction
--attachment <path>: supported attachment; repeat for several
--file <path>: change another database
--dry-run: preview without writing
--json: structured preview; never confirms the write

Up nextath delete →