v0.5.1 — partner-handoff polish
Patch release. Closes the one real first-run gap from v0.5.0 and adds onboarding documentation.
What's new
- Setup wizard adds Step 3/7: OAuth consent screen. Previously the wizard jumped from "enable Gmail API" straight to "create OAuth client", but Google requires the consent screen to be configured first — and unverified apps need the user added as a Test User. Without this step, new users hit "Access blocked: This app's request is invalid" on first run.
- TROUBLESHOOTING.md covers the 6 issues new users hit most often: consent-screen errors, missing credentials, scope limits, scheduler on Linux/Windows, 7-day token expiry for unverified apps, PATH issues with pipx.
- ARCHITECTURE.md — 5-minute tour of the codebase for new contributors.
- CI workflow runs pytest matrix across Python 3.11/3.12/3.13 on every push and PR.
- Issue templates for bug reports and feature requests.
Changed
- README install section now leads with
pipx install git+https://github.com/bgorzelic/gmail-cleanup.git(the right choice for end users) instead of the clone-and-pip-install path (which stays, for contributors). - CONTRIBUTING.md adds a "First-time onboarding" section pointing new collaborators at ARCHITECTURE.md and the safety invariants.
Compatibility
No behavior changes for existing v0.5.0 users. 84 tests still passing.