I replaced an implicit side effect with an explicit contract

I treated this as a reliability reset.

The issue was simple: hidden behavior and silent failure. I wanted predictability.

• made the contract explicit,
• added a visible retry budget,
• and standardized the logging shape for failures.

# smoke test a boundary path
npm run lint

Result

I can now reproduce the issue in seconds instead of guessing at 2am.