Echo/Docs

CLI command

reliability

Aggregate recent completed and failed account actions by platform and external service.

Invocation#

Shell
echo-cli reliability <days>

Inputs and output#

days is required and is any positive whole number; Echo chooses no default and no ceiling.

The command reads every completed or failed action log since the computed timestamp and writes one indented JSON object. The object contains window_days, since, log_count, platforms, services, and checked_at. Platform and service entries include completed and failed counts; costs are summed by service, and each entry keeps every error of the window.

State effect#

The command reads every matching row of account_action_logs and aggregates the rows in memory. It does not retry actions, change account status, update logs, charge a service, or trigger generation.

Refusals#

  • Without days it prints exactly "days is required: the number of days to read" to stderr and exits 2; a value that is not a positive whole number prints exactly "days must be a positive whole number" and exits 2, the usage-error status.
  • Without NEXT_PUBLIC_SUPABASE_URL it prints exactly "NEXT_PUBLIC_SUPABASE_URL is not configured" to stderr and exits 1.
  • After the URL is present, without SUPABASE_SERVICE_ROLE_KEY it prints exactly "SUPABASE_SERVICE_ROLE_KEY is not configured" to stderr and exits 1.
  • If Supabase refuses the SELECT, the CLI prints the returned database error message to stderr and exits 1.