feat!: new CLI structure

[cmorten]

Issue

Fixes #56, #57

Details

Breaking changes

The CLI has been restructured to separate environment configuration from screen reader asset installation.

The previous setup flow has been split into two commands:

• setup – configures the host environment, should be run once per machine.
• install – downloads and installs screen reader assets, should be run once per project and after every update to @guidepup/guidepup

Usage:

# Setup machine once for screen reader automation
npx @guidepup/setup setup

# In project directory install Guidepup
npm install @guidepup/guidepup

# In project directory install required screen reader assets
npx @guidepup/setup install

setup changes

Windows

• setup is now a no-op.
• It no longer disables the foreground lock timeout or installs NVDA.

macOS

• Existing setup behaviour is unchanged.
• The following flags have been renamed:
  • --record → --macos-record
  • --ignore-tcc-db → --macos-ignore-tcc-db

New install command

The new install command downloads and installs screen reader assets:

• Windows: installs NVDA assets from guidepup/nvda.
• macOS: installs VoiceOver assets from guidepup/voiceover.

Asset storage

Downloaded assets are now stored in the operating system’s cache directory.

Previously, on Windows, assets were downloaded to a temporary directory.

CheckList

• Has been tested (where required).