gat system

Usage: gat system <COMMAND>

Commands:
  inspect  Read-only inspection of Gat-managed maintenance state. Never writes
           or repairs anything; reports actionable findings only
  repair   Restore invariants deliberately: recover authoritative `gat.lock`
           state only via an explicit recovery choice, and rebuild derived state
           (`SQLite` mirrors, cache metadata, managed Git excludes) when needed.
           Omit the scope to target every domain
  clean    Remove only state proven disposable: completed transaction scratch,
           abandoned temporary cache files, stale Gat-managed Git artifacts, and
           other cleanup that never makes an authoritative recovery choice. Omit
           the scope to target every domain
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

Usage: gat system clean [OPTIONS] [SCOPE]

Arguments:
  [SCOPE]
          Maintenance domain to clean (`all` by default)

          [possible values: lock, state, cache, git, all]

Options:
      --purge-temporary
          Also remove unverified `tmp-*` cache ingest scratch files, in addition
          to the ordinary proven-safe cleanup `gat system clean` does by
          default. Gat cannot tell an abandoned temp file apart from one an
          in-progress `add`/`fetch` on this or another process sharing the cache
          is still writing, so this is an explicit, destructive opt-in: it can
          disrupt another process's in-progress ingest. Never implied by `all`

      --purge-objects
          Also empty Gat's content-object fan-out namespace under the local
          cache, in addition to the ordinary disposable temporary cache state
          `gat system clean` removes by default. All locally cached objects are
          removed and may need to be fetched/rebuilt again. Never implied by
          `all`; must be opted into explicitly

  -h, --help
          Print help (see a summary with '-h')

Usage: gat system inspect [SCOPE]

Arguments:
  [SCOPE]
          Maintenance domain to inspect (`all` by default)

          [possible values: lock, state, cache, git, all]

Options:
  -h, --help
          Print help (see a summary with '-h')

Usage: gat system repair [OPTIONS] [SCOPE]

Arguments:
  [SCOPE]
          Maintenance domain to repair (`all` by default)

          [possible values: lock, state, cache, git, all]

Options:
      --restore-backup
          Explicitly restore the validated backup representation left by an
          interrupted `gat.lock` reshape (`.gat/lock-reshape/<txn>/backup`)
          instead of promoting the staged target. Only meaningful with `gat
          system repair lock`

      --promote-staged
          Explicitly promote the validated staged `gat.lock` target left by an
          interrupted reshape (`.gat/lock-reshape/<txn>/new`) instead of
          restoring the backup. Only meaningful with `gat system repair lock`

      --transaction <TRANSACTION>
          Which interrupted `gat.lock` reshape transaction id to recover when
          more than one exists under `.gat/lock-reshape/`. Only meaningful with
          `gat system repair lock`

  -h, --help
          Print help (see a summary with '-h')