Release Skill

This skill automates the synchronized Sesori release process for both App and Bridge. When invoked with a release type (patch, minor, or major), it computes the next shared semantic version and bumps both app and bridge together.

Workflow

Step 1: Determine Release Type

Ask the user:

What type of release is this? Options:

1. patch (e.g., 1.0.6 → 1.0.7) — bug fixes, small improvements
2. minor (e.g., 1.0.6 → 1.1.0) — new features, backwards compatible
3. major (e.g., 1.0.6 → 2.0.0) — breaking changes

If the user does not specify a release type, ask before proceeding.

Alternatively, the user may provide an explicit version: make bump-version VERSION=<version>.

Step 2: Find the Latest Release Tag

Run the following to find the most recent release tag:

git tag -l "v*" --sort=-v:refname | head -n 1

Step 3: Bump Versions

Run the root version bump command:

make bump-version TYPE=<type>

Or for an explicit version:

make bump-version VERSION=<version>

This updates both bridge and mobile semantic versions while preserving the mobile build number.

Stage the version-bumped files.

Step 4: Analyze Changes Since Last Release

Find commits since the last release tag:

git log <previous-tag>..HEAD --oneline

To get diffs for each side:

git diff <previous-tag>..HEAD -- bridge/
git diff <previous-tag>..HEAD -- client/
git log --oneline --name-only <previous-tag>..HEAD

Categorize commits based on their prefixes (used to summarize the PR body):

• feat: or feat( → Added
• fix: or fix( → Fixed
• chore: → Changed (or skip unless significant)
• docs: → Changed
• refactor: → Changed

This repo does NOT use changelog files. Do not create or update any CHANGELOG.md. The categorized commits above are only used to write the PR body in the next step.

Step 5: Commit the version bump

Stage the version-bumped files and commit on the current release branch:

git commit -m "chore(release): v<version>"

Step 6: Create GitHub Pull Request

Use gh to create the PR:

gh pr create \
  --title "chore(release): v<version>" \
  --body "$(cat <<'EOF'
## Summary
- Bump shared version to v<version>

## Changes
<list the key changes since v<previous>, or "No changes">
EOF
)" \
  --base main

Important Notes

• Always confirm the release type or explicit version with the user before proceeding
• The root make bump-version command updates both bridge and mobile versions together
• The mobile build number is preserved during version bumps; do not increment it here
• If there are no changes on one side, use - No changes in that section of the changelog
• The user must be authenticated with gh CLI (gh auth status)
• The PR is created against main branch
• GitHub Actions workflows are not edited by this skill