dead-code-sweep

name	dead-code-sweep
description	Use when user wants to Find and remove genuine dead code using deadcode + vulture. Filters known false positives (dataclass fields, protocol methods, dunder hooks). Run before a cleanup commit.

Dead Code Sweep

Finds unreferenced code using two complementary tools and removes confirmed dead code.

Step 1 - Run scanners

uv run deadcode src/ 2>&1
uv run vulture src/ --min-confidence 80 2>&1

Step 2 - Filter false positives

Before removing anything, verify each reported symbol is actually unused:

Check all callers of a symbol

rg -rn 'symbol_name' src/ tests/ scripts/

Verification workflow for each candidate:

1. rg -rn 'ClassName\|method_name\|CONSTANT_NAME' src/ tests/ scripts/ .github/ - if any matches beyond definition, it's live
2. If a class: check if it's a dataclass (@dataclass), NamedTuple, or Protocol
3. If a function: check if it's registered as a Textual action or event handler

Step 3 - Remove confirmed dead code

Only remove when rg confirms zero callers and the symbol has no interface obligation.

After removal, run:

uv run ruff check src/ uv run pytest --tb=short -q

Both must pass before committing.

Step 4 - Commit

git add CHANGED_FILES git commit -m "chore: remove dead code (SYMBOLS_REMOVED)"