This repository uses Sampo for versioning and changelog generation, with GitHub Actions publishing packages to PyPI.
- When making changes, include a changeset:
sampo add - Create a PR with your changes and the changeset file
- Merge to
main(no release label required) - Approve the release in Slack when prompted — this triggers the version bump, publishes both
posthogand theposthoganalyticsmirror package to PyPI, creates a git tag, and creates a GitHub Release
You can also trigger a release manually via the workflow's workflow_dispatch trigger (still requires pending changesets).
Important
Changesets must live in .sampo/changesets/ (this is where sampo add puts them). Do not create them in the legacy .changeset/ directory — Sampo and the Release workflow only read .sampo/changesets/*.md, so a changeset placed anywhere else is silently ignored and no release is triggered.