Dead code detection crashes with TypeError: issues.files is not iterable

[Mergemat]

react-doctor crashes in the dead-code step on my project with:

TypeError: issues.files is not iterable

Output:

✖ Dead code detection failed (non-fatal, skipping).
TypeError: issues.files is not iterable

Repro:

bunx react-doctor@latest . --verbose

Repo details:

• Next.js
• React 19
• TypeScript
• Bun

I traced this locally to runKnip() iterating issues.files directly. In the installed Knip types, issues.files is not always an iterable list of file paths, so the dead-code pass blows up before results are returned.

Related:

• Fix/knip files runtime safe #128
• Diagnosis aborts during Detecting dead code step with no output and non-zero exit code #77
• oxlint crashes with SIGABRT (2.8GB RAM) on large TypeScript projects during dead code detection #84

There also seems to be a separate lint-side config drift issue around generated oxlint rules, but this report is specifically about the Knip/dead-code crash.

Expected:

• dead-code detection completes, or safely skips malformed/variant issues.files output without throwing

[Mergemat]

Minimal public repro:

https://github.com/Mergemat/react-doctor-knip-repro

Run:

bun install
bun run doctor

Observed output includes:

✖ Dead code detection failed (non-fatal, skipping).
TypeError: issues.files is not iterable