handing-off-private-releases

Handing Off Private Releases

Use when a template branch (often a private / embargoed model) has to reach a colleague without pushing it to GitHub yourself. You send one zip over chat, containing a git bundle and a handoff markdown (HANDOFF.md). The colleague's agent applies the bundle, opens the PR with the release label, publishes to PyPI, then bumps ComfyUI.

Related: /managing-releases (label, publish pipeline), /managing-templates (template content).

Sender workflow

Task Progress:
- [ ] 1. Inspect branch vs origin/main
- [ ] 2. Bump the root version and commit it
- [ ] 3. Run the local CI sync + sub-package auto-bump and commit it
- [ ] 4. Record the version bump summary (old to new)
- [ ] 5. Create and verify the bundle
- [ ] 6. Write the handoff file from HANDOFF_TEMPLATE.md
- [ ] 7. Zip the bundle and handoff into one file
- [ ] 8. Tell the user which zip to send

1. Inspect

git fetch origin main
git status -sb                      # must be clean
git log --oneline origin/main..HEAD
git merge-base --is-ancestor origin/main HEAD && echo "based on current main"
git show HEAD:pyproject.toml | awk '/^version/{print; exit}'

If the branch is not based on current origin/main, rebase first. Check ComfyUI's current pin so the handoff states the right "from" version:

gh api repos/Comfy-Org/ComfyUI/contents/requirements.txt --jq .content | base64 -d | rg comfyui-workflow-templates

2. Bump the root version

The handoff is only publishable if the bundle already carries the new version. The receiver must not bump anything.

git show origin/main:pyproject.toml | awk '/^version/{print; exit}'   # main
awk '/^version/{print; exit}' pyproject.toml                          # branch
curl -fsS https://pypi.org/pypi/comfyui-workflow-templates/json | python3 -c "import json,sys; print(json.load(sys.stdin)['info']['version'])"

• If the branch version is not above both origin/main and the latest PyPI version, bump the patch version in root pyproject.toml only (e.g. 0.11.75 to 0.11.76). The result must be above both baselines.
• Do not edit packages/*/pyproject.toml or the == pins by hand. Step 3 does that.
• Commit it: git commit -am "Bump version to <NEW_VERSION>".