Releasing

Release checklist

1. Run make test
2. Run make build-ui
3. Run make package-check
4. Run make release-check
5. Validate installer smoke
6. Validate Linux GPU local-model smoke if the release touches that path
7. Update CHANGELOG.md
8. Verify release-manifest.json

Python package

Build:

python -m build

npm installer

Check:

npm pack --dry-run

Publishing configuration

PyPI

Supported modes:

• trusted publishing via GitHub OIDC
• token-based publishing via PYPI_API_TOKEN

Repository variable:

• PYPI_TRUSTED_PUBLISHING_ENABLED=true

Trusted publisher values for this repository:

• owner: ONEMULE
• repository: scibudy
• workflow: .github/workflows/publish-python.yml
• environment: pypi

If neither trusted publishing nor PYPI_API_TOKEN is configured, the publish workflow skips instead of failing.

npm

Required secret:

• NPM_TOKEN

If NPM_TOKEN is missing, the npm publish workflow skips instead of failing.

Release intent

Scibudy uses a stable v0.x policy. Any breaking change must be called out in the release notes.