1. Walks every .java file (excluding generated/compiled output dirs). 2. Reads each file's `package` declaration and back-computes the candidate source root by stripping (package components + filename ...