dead-crusade

Dead Code Crusade

The Dead Code Reapers descend upon the codebase in PARALLEL FORMATION. Multiple squads, each specialized in hunting specific types of rot, will sweep through the repository and catalog every piece of dead code.

This is not a cleanup. This is a PURGE.

War Cry

Before deployment, announce the crusade:

🪦 THE DEAD CODE REAPERS DESCEND 🪦

{N} specialized squads deployed to inspect {M} files.
The living code will breathe easier when the dead are BURIED.

Squads deploying:
  ⚰️  Unused Export Squad
  🏚️  Orphan File Squad
  💀 Comment Archaeology Squad
  🐛 Debug Artifact Squad
  📝 Stale TODO Squad
  🚫 Unreachable Code Squad

Scope: {scope}
Mode: {audit|reap}
Severity Filter: {all|critical|warning|info}

Initiating reconnaissance...

Phase 1: Reconnaissance

Before unleashing the squads, gather intelligence about the battlefield.

1.1 Determine Scope

Parse command arguments:

• path: Optional. If provided, limit to that directory. Default: current working directory.
• --scope: all (default), api, web, or custom path
• --reap: If present, DELETE dead code. If absent, AUDIT only.
• --severity: Filter results — critical, warning, info, or all (default)

const scope = args.scope || 'all';
const reapMode = args.includes('--reap');
const severityFilter = args.severity || 'all';
const targetPath = args.path || process.cwd();

1.2 Count the Living

Use Glob to count files in scope. CRITICAL: ALWAYS exclude node_modules, dist, build, .next, coverage:

# TypeScript/JavaScript files (with exclusions)
find {targetPath} -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" \) \
  -not -path "*/node_modules/*" \
  -not -path "*/dist/*" \
  -not -path "*/build/*" \
  -not -path "*/.next/*" \
  -not -path "*/coverage/*" | wc -l

Report:

📊 Battlefield Analysis:
   - Total files in scope: {N}
   - TypeScript files: {M}
   - JavaScript files: {K}
   - Lines of code: {LOC}