ait gc — Complete Reference
Inspect, validate, and prune eligible native storage packs.
Audience: Repository owners and storage operators
Operating boundary#
Purpose: Inspect, validate, and prune eligible native storage packs.
Effect class: Stats and validate inspect; prune removes only data admitted by its exact eligibility rules.
Coverage: 4 public help surfaces under ait gc.
The blocks below preserve the RC.8 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.
Complete command tree#
ait gc
ait gc stats
ait gc validate
ait gc pruneExact emitted help#
ait gc#
Binary description: Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Usage: ait gc <COMMAND>
Commands:
stats Show a bounded local content-storage summary.
validate Run exact read-only local content validation.
prune Preview safe orphan object-pack cleanup; mutate only with --apply.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')ait gc stats#
Binary description: Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.
Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.
Usage: ait gc stats [OPTIONS]
Options:
--json
Emit the bounded summary as stable JSON.
-h, --help
Print help (see a summary with '-h')ait gc validate#
Binary description: Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.
Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.
Usage: ait gc validate [OPTIONS]
Options:
--json
Emit the exact validation result as stable JSON.
-h, --help
Print help (see a summary with '-h')ait gc prune#
Binary description: Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Usage: ait gc prune [OPTIONS]
Options:
--apply
Apply the recomputed and revalidated safe plan; without this option the command is read-only.
--json
Emit the preview or apply result as stable JSON.
-h, --help
Print help (see a summary with '-h')