Expand description
voom — fast, safe, parallel build-artifact pruning.
The library half of the voom binary. Everything testable lives here; main.rs is a
thin shell that parses arguments, dispatches, and maps errors to exit codes.
The pipeline is scan -> classify -> policy -> delete -> report; see
adrs/0001-mission-and-scope.md for scope and the ADRs it references for each stage.
Two invariants carry the whole design and are covered by regression tests:
- The directory walker runs with all ignore handling disabled — build artifacts are
precisely what
.gitignorelists (adrs/0005-traversal-and-parallelism.md). - Nothing is deleted without a marker file proving its ecosystem
(
adrs/0002-marker-anchored-classification.md).
Modules§
- bazel
- Bazel output-base housekeeping — orphaned and stale per-workspace scratch that nothing else reclaims.
- caches
- Machine-global tool caches and installed toolchains, which voom leaves alone.
- catalog
- The built-in ecosystem catalog: the table that says which directories are build output, and what proves it.
- classify
- Marker anchoring: candidate + markers -> verdict.
- claude
- Claude Code job scratch — age-gated, and never trusted on
state.json’sstatealone. - cli
- Argument parsing and command dispatch.
- config
- Hierarchical TOML configuration (ADR 0004).
- delete
- The safety rails, and the actual removal.
- docker
- Docker housekeeping — dangling and stale images, idle build cache, and optionally volumes — followed by handing the freed blocks back to the host when the daemon lives in a VM.
- error
- Typed library errors.
- git
- Git housekeeping — the maintenance git itself already considers safe.
- names
- Allocation-free file-name pattern matching.
- policy
- Keep policies: the rules that hold an artifact back after it has been proven.
- report
- The result set, and the two renderers over it.
- run
- The pipeline:
scan -> classify -> policy -> size -> delete -> report. - scan
- The ignore-blind parallel walker.
- size
- Recursive size accounting.
- suggest
voom suggest: what a tree keeps repeating that the catalog does not know about.- tagged
CACHEDIR.TAGdetection: a directory that declares itself regenerable (ADR 0013).- watch
- Watch mode: keep a tree pruned as work moves on.
- worktrees
- Merged-worktree cleanup — linked worktrees whose work is already in the default branch.
Constants§
- VERSION
- The version of the
voomcrate, as published.