Problem

--fail-on-error exits with code 1 if any URLs found, but can't distinguish error types.

Solution

Add more granular exit codes.

Exit Codes

• 0 - Success, no URLs found
• 1 - URLs found (when --fail-on-error)
• 2 - Configuration error
• 3 - File read error
• 4 - Parse error threshold exceeded

Files to Modify

• src/cli.ts - Set appropriate exit codes
• Update documentation

Priority

Phase 2 - Performance & UX (Medium Impact, Low Effort)

Related to TODO.md section 3.2