This document describes how to prepare and publish a StableSteering release.
A release should include:
- tagged source in Git
- release notes
- installation instructions
- published HTML documentation
- optional packaged zip artifact
- updated user/developer docs for async jobs, trace reports, and example bundles
Current release notes:
- Confirm the working tree is clean.
- Run backend tests:
python -m pytest - Run default browser tests:
npm run test:e2e:chrome - If releasing from a CUDA-capable machine, optionally run:
python scripts/smoke_real_diffusers.py - If releasing from a CUDA-capable machine, optionally refresh the real example bundle:
python scripts/create_real_e2e_example.py - Rebuild the documentation site:
python scripts/build_pages_site.py - Review:
- Build a source zip if needed:
powershell -ExecutionPolicy Bypass -File scripts/build_release_zip.ps1 -Version v0.1.0 - Create the Git tag.
- Push the tag and upload the zip if desired.
git tag v0.1.0
git push origin v0.1.0powershell -ExecutionPolicy Bypass -File scripts/build_release_zip.ps1 -Version v0.1.0The zip is written to output/releases/.
The current release line is a research-oriented MVP. It is suitable for local development, evaluation, teaching, and architectural review, but not intended as a production deployment package.