ferraus verify

Check that a sidecar's inputs and outputs still match their hashes

Synopsis

ferraus verify <input> [options] [-o <output>]

What it does

Check that a sidecar's inputs and outputs still match their hashes

Examples

Confirm nothing changed since the run

ferraus verify take.tuned.wav.ferraus.json --json

Check a master against its provenance; exit code 9 if a hash differs

ferraus verify master.wav.ferraus.json

Silent check for scripts: only the exit code matters

ferraus verify stems/vocals.wav.ferraus.json --quiet

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
4Unsupported format or codec
8Cancelled
9Output verification failed (checksum, clipping guard, duration mismatch)
70Internal error (bug)

Common mistakes

  • Forgetting that outputs are never overwritten: pass --overwrite or a new -o path when re-running.

For models

  • MCP tool: ferraus_verify
  • Schema: ferraus schema verify
  • Pipeline: { op: verify, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "verify", "defaults": {}}