Workspace Cleanup Audit

Overview

Run a read-only scan over repositories in ~/Workspace and report cleanup chores ranked by severity. Never delete, move, or modify files.

Workflow

1. Run scripts/scan_workspace_cleanup.py.
2. Review top-ranked findings first.
3. Report findings with severity, repo, directory, category, size, and reason.
4. Suggest cleanup actions as text only.

Commands

Use the default workspace scan:

python3 scripts/scan_workspace_cleanup.py

Scan a custom workspace root:

python3 scripts/scan_workspace_cleanup.py --workspace ~/Workspace

Return machine-readable output:

python3 scripts/scan_workspace_cleanup.py --json

Tune noise floor and stale threshold:

python3 scripts/scan_workspace_cleanup.py --min-mb 100 --stale-days 90

Output Contract

Each finding includes:

• severity
• repo
• directory
• category
• size_human
• score
• why_flagged
• suggested_cleanup

The report also includes:

• Top findings sorted by severity then size
• Repo summary ranked by total flagged size

Read-Only Rules

• Never run destructive commands.
• Never remove artifacts automatically.
• Never write into scanned repositories.
• Provide recommendations only.

References

• Pattern and threshold notes: references/patterns.md