# mainskeeper CLI — PROPOSED product contract, not shipped software. Fictional demonstration data.
# screen: help-queue · host: duplex-pi-probe · 120 columns · NO_COLOR · exit 0
# clock: Wed 30 Sep 2026 15:22 PDT · Fixture · incident state, now 15:22
# stderr lines (counting the prompt line as 1): none
duplex-pi-probe $ mainskeeper help queue
mainskeeper queue — local history buffer

Shows records this collector has stored locally but not yet uploaded: how many, how old, how much space they use, upload
progress, retries, dropped records and gaps where no records exist.

Usage
  mainskeeper queue [--json]

Elevation
  None. Read-only.

Options
  --json          One JSON document on stdout (schema mainskeeper.queue/v1)

Exit codes
  0     Query succeeded — whatever the backlog state. A stalled or full buffer is reported in the output and in `state`
        (JSON), not via the exit code.
  1     General error — the buffer could not be read
  4     mainskeeperd is not running (buffer read from disk)
        Any command: 2 on a usage error.

History upload never holds an incident open: incidents are recovered on fresh evidence.
