feat: add --show-errors flag to show detailed compiler errors

[frankieyan]

When React Compiler errors increase, the current output only shows counts like src/bad-hook.ts: +3. This makes it hard to know what actually broke. The new --show-errors flag displays the exact violation messages and line numbers:

❌ React Compiler errors have increased in:
  • src/bad-hook.ts: +3

Detailed errors:
    - src/bad-hook.ts: Line 6: Cannot access refs during render

Test plan

Test locally by running against the sample project fixtures:

npm run build
cd src/__fixtures__/sample-project

• Without --show-errors (baseline behavior) — shows only error counts

  node ../../../dist/index.mjs --check-files src/bad-hook.ts

  🔍 Checking 1 file for React Compiler errors…
  ❌ React Compiler errors have increased in:
    • src/bad-hook.ts: +3
  
  Please fix the errors and run the command again.
  

• With --show-errors — includes detailed error messages

  node ../../../dist/index.mjs --check-files --show-errors src/bad-hook.ts

  🔍 Checking 1 file for React Compiler errors…
  ❌ React Compiler errors have increased in:
    • src/bad-hook.ts: +3
  
  Detailed errors:
      - src/bad-hook.ts: Line 6: Cannot access refs during render
      - src/bad-hook.ts: Line 6: Cannot access refs during render
      - src/bad-hook.ts: Line 6: Cannot access refs during render
  
  Please fix the errors and run the command again.
  

• Multiple files — shows errors from all files

  node ../../../dist/index.mjs --check-files --show-errors src/bad-hook.ts src/bad-component.tsx

  🔍 Checking 2 files for React Compiler errors…
  ❌ React Compiler errors have increased in:
    • src/bad-hook.ts: +3
    • src/bad-component.tsx: +1
  
  Detailed errors:
      - src/bad-hook.ts: Line 6: Cannot access refs during render
      - src/bad-hook.ts: Line 6: Cannot access refs during render
      - src/bad-hook.ts: Line 6: Cannot access refs during render
      - src/bad-component.tsx: Line 6: Hooks must always be called in a consistent order...
  
  Please fix the errors and run the command again.
  

• Files with no errors — no detailed errors section shown

  node ../../../dist/index.mjs --check-files --show-errors src/good-component.tsx

  🔍 Checking 1 file for React Compiler errors…
  ✅ No new React Compiler errors in checked files
  

• Flag position flexibility — --show-errors works anywhere in the command

  node ../../../dist/index.mjs --show-errors --check-files src/bad-hook.ts
  node ../../../dist/index.mjs --check-files --show-errors src/bad-hook.ts
  node ../../../dist/index.mjs --check-files src/bad-hook.ts --show-errors

• Similarly, --show-errors can be used together with other flags like --overwrite, --stage-record-file, or when no mode flag is set

[doist-bot]

The PR successfully implements the --show-errors flag, including robust argument parsing and integration with the React Compiler logger. The changes are well-tested and preserve existing default behaviors.

[doist-bot]

[P3] String(event.data) may result in [object Object] if PipelineError carries an object payload. Consider checking if event.data is an Error instance to use its .message, or using JSON.stringify for generic objects, to ensure the detailed error message is actionable.