mix rindle.verify_storage (Rindle v0.1.5)

Copy Markdown View Source

Walks variant records that have a storage_key and HEAD-checks the storage object via the profile's configured storage adapter.

Variants where the object is absent ({:error, :not_found}) are flipped to missing state. Other error types (network errors, auth failures) are counted separately without mutating the record.

Usage

mix rindle.verify_storage [--profile PROFILE] [--variant VARIANT_NAME]

Options

  • --profile — Restrict to variants whose asset has this profile module name. Example: --profile Elixir.MyApp.AvatarProfile

  • --variant — Restrict to variants with this name. Example: --variant thumb

Exit codes

  • 0 — Reconciliation completed cleanly (zero storage errors). Missing variants and FSM-blocked transitions do not affect the exit code — they are expected, recoverable outcomes (the next regenerate run will pick missing variants up; FSM-blocked transitions reflect intentional invariant enforcement on already-terminal states like failed).
  • 1 — Query failure, OR one or more non-:not_found storage errors occurred during HEAD checks (e.g. connection refused, auth failure). The summary is still printed before halting so operators can see the partial counts.

Output

The task emits a deterministic summary that is script-friendly:

Rindle: verifying storage for variants...
  checked:      10
  present:      8
  missing:      1
  fsm_blocked:  1
  errors:       0
Done.

The summary is stable and pipe-friendly (no progress bars or spinners). fsm_blocked counts variants whose object disappeared but whose current state (e.g. failed) is forbidden from transitioning to missing by the variant FSM. These are surfaced for visibility but do not trigger exit-1.

Reconciliation behavior

Variants are eligible for verification when they have a non-nil storage_key and are in one of the following states: ready, stale, missing, or failed. Variants without a storage_key (e.g., planned, queued) are skipped entirely.

On each HEAD call:

  • {:ok, _} — object is present; variant state is left unchanged.
  • {:error, :not_found} — object is absent; variant is flipped to missing.
  • {:error, other} — unexpected error (network, auth); counted as an error but the variant state is not mutated. Investigate manually if error count is non-zero.

Examples

# Verify all variants
mix rindle.verify_storage

# Verify only thumb variants
mix rindle.verify_storage --variant thumb

# Verify only variants for a specific profile
mix rindle.verify_storage --profile Elixir.MyApp.AvatarProfile