build: Add Python Semantic Release for automated versioning

[madeleine-c]

Summary

This PR sets up Python Semantic Release for automated version management, changelog generation, and PyPI releases.

Changes

• Added python-semantic-release to dev dependencies in pyproject.toml
• Configured semantic release with version management for both pyproject.toml and init.py
• Created GitHub Actions workflow for automated releases
• Added initial CHANGELOG.md documenting v0.1.0 release
• Updated CONTRIBUTING.md with comprehensive commit message guidelines

How It Works

Commit Types & Version Bumps

• feat: → MINOR bump (0.1.0 → 0.2.0)
• fix: → PATCH bump (0.1.0 → 0.1.1)
• perf: → PATCH bump (0.1.0 → 0.1.1)
• feat!: or BREAKING CHANGE: → MAJOR bump (0.1.0 → 1.0.0)
• docs:, test:, chore: → No version bump

Automated Release Process

When commits are pushed to main:

1. Python Semantic Release analyzes commit messages
2. Determines version bump based on commit types
3. Updates version in pyproject.toml and init.py
4. Generates/updates CHANGELOG.md
5. Creates a git tag (e.g., v0.2.0)
6. Publishes to PyPI
7. Creates a GitHub Release

Next Steps After Merge

1. Set up PyPI token in GitHub repository secrets:

   • Name: PYPI_API_TOKEN
   • Get token from PyPI Account Settings → API tokens

2. Test the workflow by merging a commit with conventional format to main

Test Plan

• Configuration validated in pyproject.toml
• GitHub Actions workflow created
• Documentation updated
• Ready for PyPI token configuration

🤖 Generated with Claude Code

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	python-semantic-release@​10.4.1
	pytest-cov@​7.0.0

View full report