[HexCodeYT]

What changed

• Documents the exact xattr command needed when macOS labels the ad-hoc-signed preview as damaged.
• Installs and starts the clipboard watcher automatically on first launch.
• Uses a new success-only activation key so users who opened the previous broken preview are repaired after updating.
• Preserves intentional pauses on later launches.
• Updates Preview 3 and menu-bar documentation.

Root cause

The README promised that launching PlainLink started cleaning, but the app only checked watcher status and showed an optional Enable Cleaning button. The ad-hoc-signed, unnotarized download can also receive a misleading damaged-app Gatekeeper alert that Control-click/Open does not reliably bypass.

Verification

• Verified the Rust cleaner removes tracking parameters from the advertised YouTube, Amazon Australia, and Spotify examples.
• cargo fmt --check
• cargo test
• cargo clippy --all-targets -- -D warnings
• scripts/test-macos-app.sh
• PLAINLINK_RELEASE_VERSION=v0.1.0-preview.3 scripts/package-macos-app.sh
• Preview 3 SHA-256 checksum verification

All checks passed on macOS arm64.