Show recent run history

Usage: barca history [OPTIONS]

Options:
      --reconcile <RUN_ID>  After verifying a run stopped, record it as interrupted; refuses a proven live owner
  -l, --limit <LIMIT>       Maximum recent runs (default: every run in JSON, 10 in a human table)
      --all                 Show every recorded run (no limit)
      --json                Emit JSON on stdout (the default when stdout is not a terminal)
      --pretty              Emit human-readable output (the default when stdout is a terminal)
      --fields <FIELDS>     Output JSON with only these keys (comma-separated) on each entry of `runs`. Implies --json. An unknown key is a usage error listing the valid ones [possible values: run_id, command, files, target, status, steps_total, steps_executed, steps_cached, attempts, started_at, finished_at, elapsed_seconds]
      --env <ENV>           Environment name (separates cache/state per environment)
  -h, --help                Print help

Examples:
  barca history                # last 10 in a terminal, every run as JSON when piped
  barca history -l 25          # last 25
  barca history --all          # every recorded run
  barca history --reconcile RUN_ID --json   # record a verified-stopped run as interrupted
  barca history --json         # {runs: [...], total, truncated, hint?}, even in a terminal
  barca history --pretty       # the table, even when piped
  barca history --fields run_id,status,elapsed_seconds,attempts   # JSON with only these keys per run
  barca history --env dev      # runs recorded in another environment

--reconcile is an explicit write: first verify the run stopped. It refuses a proven live
owner and terminal rows. It prints only that run, preserving progress and cached results;
no end time or duration is invented. Ordinary history inspection never reconciles an
unknown owner automatically.
Newest first. When more runs exist than are shown, JSON says `"truncated": true` with the
`total`, and the table prints a one-line note on stderr. In JSON, `files` is an array: the .py
files the run was given.
JSON returns every item unless --limit is given; human tables keep their default bound.
More: barca docs agents, barca docs cache
