- Update
pyproject.tomlversion using semantic versioning. - Add release notes to CHANGELOG.md.
- Confirm
README.mdand INSTALL.md match the current package surface.
- Run
python -m pytest tests/ -q --tb=shorton Python 3.11+. - Export
HONUA_BASE_URLfor staging validation, and setHONUA_ENABLE_WRITE_SMOKE=truewhen the release candidate should exercise the add/query/update/delete smoke roundtrip. - Run
python -m pytest tests/integration -q --run-integration -m "integration and staging and smoke" --tb=shortagainst staging when validating a release candidate. - Build the package with
hatch build. - Create a clean virtual environment, install the built
honua-sdkartifact, and runpython scripts/release_smoke.py --results-path release-smoke-results.json. - Review
release-smoke-results.jsonforoverall_status,probe_counts, and any per-probeerrorpayloads before publish. - Dry-run the
Publish Python SDKworkflow when validating a release candidate.
Use docs/troubleshooting.md for the HONUA_* environment contract, seeded staging assumptions, and manual cleanup guidance.
- Merge release changes to
trunk. - Create a
python-sdk-v<version>tag that matchespyproject.toml. - Monitor the
Publish Python SDKworkflow for PyPI upload completion.