SubMiner/docs/refactor-main-checklist.md

Main.ts Refactor Checklist

This checklist is the safety net for src/main.ts decomposition work.

Invariants (Do Not Break)

• Keep all existing CLI flags and aliases working.
• Keep IPC channel names and payload shapes backward-compatible.
• Preserve overlay behavior:
  • visible overlay toggles and follows expected state
  • invisible overlay toggles and mouse passthrough behavior
• Preserve MPV integration behavior:
  • connect/disconnect flows
  • subtitle updates and overlay updates
• Preserve texthooker mode (--texthooker) and subtitle websocket behavior.
• Preserve mining/runtime options actions and trigger paths.

Per-PR Required Automated Checks

• pnpm run build
• pnpm run test:config
• pnpm run test:core
• Current line gate script for milestone:
  • Example Gate 1: pnpm run check:main-lines:gate1

Per-PR Manual Smoke Checks

• CLI:
  • electron . --help output is valid
  • --start, --stop, --toggle still route correctly
• Overlay:
  • visible overlay show/hide/toggle works
  • invisible overlay show/hide/toggle works
• Subtitle behavior:
  • subtitle updates still render
  • copy/mine shortcuts still function
• Integration:
  • runtime options palette opens
  • texthooker mode serves UI and can be opened

Extraction Rules

• Move code verbatim first, refactor internals second.
• Keep temporary adapters/shims in main.ts until parity is verified.
• Limit each PR to one subsystem/risk area.
• If a regression appears, revert only that extraction slice and keep prior working structure.