cleanup

fialr cleanup <target> [options]

Cleanup operations. Runs dedup and validate in sequence. Dry-run by default. To apply changes, pass both --execute and --reviewed.

---

Arguments

Argument	Description
target	Directory to clean up (required)

Options

Option	Description
--execute	Apply changes (not just dry-run)
--reviewed	Confirm that execution is approved (required with --execute)
--no-dedup	Skip the deduplication phase
--no-validate	Skip the validation phase
--output-dir PATH	Output directory for cleanup artifacts

---

What it does

cleanup runs two phases in sequence:

1. Dedup — find exact and near-duplicate files, stage non-canonical copies
2. Validate — verify file integrity against the database

Dry-run (default)

Without --execute, cleanup reports what duplicates were found and what integrity issues exist. No files are modified.

Execution

With --execute --reviewed, dedup stages non-canonical duplicates to _dupes/ and validate reports integrity mismatches.

Skipping phases

Use --no-dedup to skip deduplication (validate only). Use --no-validate to skip validation (dedup only).

---

Output

Dry-run:

cleanup ~/Documents

  DEDUP     847 files (1.2s)
  VALIDATE  847 files (2.1s)
────────────────────────────────────────────────────────
     files  847
     dupes  14 (3 groups)
  verified  833
  mismatch  0
     total  3.3s

---

Examples

# Dry-run cleanup
fialr cleanup ~/Documents

# Execute cleanup
fialr cleanup ~/Documents --execute --reviewed

# Dedup only (skip validation)
fialr cleanup ~/Documents --no-validate

# Validate only (skip dedup)
fialr cleanup ~/Documents --no-dedup

---

See also

• dedup — standalone deduplication
• validate — standalone integrity verification
• process — full pipeline: scan, classify, enrich, rename