Skip to content

v0.5.1 — partner-handoff polish

Choose a tag to compare

@bgorzelic bgorzelic released this 16 May 07:53
· 46 commits to main since this release

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.