Metadata backups: list them, put one back in place of the local database, or start over

Usage: barca state <COMMAND>

Commands:
  backups  List the metadata backups, local and in the store, newest first
  restore  Put a metadata backup in place of the local database (the current one is kept aside)
  reset    Start the metadata database over: move it aside and create an empty one (experimental)
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Show concise command help

      --examples
          Show all command examples without running anything

Examples:
  barca state backups                  # the metadata backups, local and in the store, newest first
  barca state backups --json           # {backups: [{index, name, where, size_bytes, run_id, rows, ...}], local_dir, store}
  barca state restore                  # put this machine's newest backup back in place of .barca/metadata.db
  barca state restore --from 1         # the newest, whichever machine took it
  barca state restore --from 3         # the third newest (the index in barca state backups)
  barca state restore --from 2026-10-14T18-02-11.482Z-3f9a1c2e.db  # one backup, by name
  barca state backups --env dev        # another environment's backups
  barca state reset --yes              # start over with an empty database (the old one is kept aside)

More: barca docs remote
