W
Wrkr

wrkr verify

wrkr verify

Synopsis

wrkr verify --chain [--state <path>] [--path <chain-path>] [--json]

Flags

  • --json
  • --chain
  • --state
  • --path

Example

wrkr verify --chain --state ./.tmp/state.json --json

Expected JSON keys: status, chain.path, chain.intact, chain.count, chain.head_hash, chain.reason, chain.verification_mode, chain.authenticity_status.

Lookup precedence:

  • If --path is provided without --state, Wrkr reads verifier material beside the explicit chain path.
  • Ambient WRKR_STATE_PATH does not override an explicit --path.
  • If --state is provided, Wrkr resolves verifier material from that state directory even when --path points to a different chain file.

Failure taxonomy:

  • Chain parse/integrity/read verification failures emit verification_failure with exit 2.
  • Invalid or unreadable verifier-key material emits verification_failure with exit 2.
  • If no verifier key is available, a structurally intact chain still succeeds, but JSON explicitly reports chain.verification_mode = chain_only and chain.authenticity_status = unavailable.
  • CLI argument misuse (--chain missing, unsupported positional args) emits invalid_input with exit 6.
  • JSON verification failures include stable fields: code, message, reason, exit_code; break_index and break_point are included when available.