Manual version management and release creation slows down the CI pipeline. This implements automated semantic versioning triggered on merge to main, with additional support for manual release triggering with maintainer-controlled versioning.

Changes

Automated Release Workflow

• Analyzes commits since last tag using conventional commit patterns
• Determines version bump: feat: → minor, fix: → patch, BREAKING CHANGE:/feat!: → major
• Non-conventional commits default to patch (ensures every merge releases)
• Updates jsf/BUILD version, commits with [skip ci], creates GitHub release with changelog
• Triggers existing PyPI publish and docs deployment workflows

Manual Release Trigger

• Added workflow_dispatch trigger for manual release creation
• Maintainers can specify exact version (e.g., 1.2.3) or select bump type (major, minor, patch, auto)
• Perfect for accepting PRs on mobile and then triggering releases with chosen versions
• Version format validation (X.Y.Z) with regression warnings
• Maintainer controls the version, not the PR author

Python Version Matrix

• Extended from 3.8-3.11 to 3.8-3.14
• Added [skip ci] condition to prevent redundant builds on version bumps

Documentation

• Release process guide with conventional commit examples and manual release instructions
• Updated contributing guidelines
• Workflow README for maintainers

Implementation Details

Version bump logic with validation:

# Extract and validate X.Y.Z format
CURRENT_VERSION=$(grep -o 'version="[^"]*"' jsf/BUILD | cut -d'"' -f2)

# Analyze commits with pattern matching
BREAKING_PATTERN="^(feat|fix|chore|docs|style|refactor|perf|test)(\(.+\))?!:"
FEAT_PATTERN="^feat(\(.+\))?:"

# Update with escaped sed
ESCAPED_CURRENT=$(echo "$CURRENT_VERSION" | sed 's/\./\\./g')
sed -i.bak "s/version=\"${ESCAPED_CURRENT}\"/version=\"${NEW_VERSION}\"/" jsf/BUILD

Manual version input with validation:

# If manual version specified, validate and use it
if [ -n "$MANUAL_VERSION" ]; then
  # Validate X.Y.Z format
  # Compare with current version and warn on regression
  # Allow intentional downgrades for hotfixes
fi

Portable grep patterns (no -P flag), version format validation, proper escaping in sed, comprehensive error handling throughout.

Mobile Workflow

1. Accept PR on GitHub mobile app
2. Navigate to Actions → "Automated Release" workflow
3. Tap "Run workflow"
4. Enter desired version or select bump type
5. Tap "Run workflow" to create release

The workflow handles version updates, commits, and triggers PyPI/docs deployment automatically.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.