uncommonroute-release

---

name: uncommonroute-release description: Use when publishing UncommonRoute. A release is only complete after all required steps are done: version sync, validation, GitHub push/tag/release, PyPI publish, and npm publish.

UncommonRoute Release

Use this skill when the user asks to release, publish, cut a version, or ship UncommonRoute.

Release contract

A release is not done until all of these succeed:

1. Version files are updated together
2. Validation passes
3. Release commit and tag are pushed to GitHub
4. GitHub Release exists for that tag
5. PyPI is published
6. npm is published

If any one of those is missing, the release is incomplete.

Keep the release clean

• Check git status --short first.
• Never sweep unrelated local dirt into the release.
• Stage only the files that belong to the release.
• If package registries already contain the intended version, do not try to overwrite it. Pick the next semver version instead.

Version workflow

Use the bundled script to update every tracked version string together:

python3 .codex/skills/uncommonroute-release/scripts/sync_version.py <version>

This script updates:

• pyproject.toml
• uncommon_route/cli.py
• uncommon_route/proxy.py
• uncommon_route/support.py
• openclaw-plugin/package.json
• openclaw-plugin/src/index.js

Validation workflow

Run the repo test suite and package checks before publishing:

PYTHONPATH=. python3 -m pytest tests -q
python3 -m build
python3 -m twine check dist/*
cd openclaw-plugin && npm pack --dry-run

Use a fresh build output. Do not upload stale artifacts from a previous version.

Publish workflow

After validation passes:

1. Commit only the intended release files
2. Create tag v<version>
3. Push main and the tag
4. Create the GitHub Release and attach the Python artifacts
5. Publish PyPI
6. Publish npm

Typical commands:

git tag v<version>
git push origin main --follow-tags
gh release create v<version> dist/*.whl dist/*.tar.gz --title "v<version>" --notes "<notes>"
TWINE_USERNAME=__token__ TWINE_PASSWORD="$TWINE_PASSWORD" python3 -m twine upload dist/*
cd openclaw-plugin && npm publish --access public

Verification

Check all three public destinations after publish:

• GitHub tag + Release page
• PyPI latest version
• npm latest version

Report the exact released version and any remaining caveats.