sake-ci-release

name	sake-ci-release
description	Use when working on CI workflows, GitHub Actions, release process, changelog generation (git-cliff), or dependabot configuration.

Sake CI & Release

CI Workflows

checks.yml — Tests & Lint

• Triggers: push to main, PRs to main
• Matrix: macOS-latest + ubuntu-latest, Swift 6.1 + 6.2.1
• Steps: sake build_tests → sake unit_tests --skip-build → sake integration_tests --skip-build
• Lint job: sake lint (macOS only, Swift 6.2.1)
• Setup: custom composite action .github/actions/setup-environment (mise + Swift + setup-sake)

semantic-pr-lint.yml — PR Title Validation

• Triggers: PR opened/edited/synchronize/reopened
• Action: amannn/action-semantic-pull-request@v5
• Allowed types: fix, feat, chore, test, perf, refactor, doc, project, revert

coverage.yml — Code Coverage

• Triggers: push to main
• Runs on: macOS-15 with Xcode 16.3
• Steps: swift test --enable-code-coverage → lcov export → Codecov upload

docs-deploy.yml — Documentation

• Triggers: push to main (docs/** or workflow file changes)
• VitePress build + deploy to GitHub Pages

Setup Environment Action

.github/actions/setup-environment/action.yml — composite action:

1. jdx/mise-action@v2 (install only, no auto-install of tools)
2. swift-actions/setup-swift@v2 with specified Swift version
3. kattouf/setup-sake@v1 — installs sake + caches prebuilt SakeApp binary

Dependabot

.github/dependabot.yml:

• Swift ecosystem, monthly
• Commit prefix: chore(deps):

Release Notes — git-cliff

Config: cliff.toml

Commit Parsing

chore(release): Bump version to X  → skipped
chore(deps): / fix(deps):          → Dependency Updates
feat:                               → Features
fix:                                → Bug Fixes
test:                               → Testing
perf:                               → Performance
refactor:                           → Refactoring
doc:                                → Documentation
project:                            → Project
revert:                             → Revert
anything else                       → Other Changes

Preprocessing

• Issue numbers stripped: \((\w+\s)?#([0-9]+)\) → removed
• Commits sorted newest first within groups
• Scoped commits sorted by scope

Version Tags

• v-prefixed: v1.0.0
• Full changelog links generated between versions

Landing Code in Main

Direct commit

For small changes. Commit message MUST have conventional commit prefix.

Pull Request (squash merge only)

For larger changes. PR title MUST have conventional commit prefix (enforced by semantic-pr-lint). Commits inside branch — free format. Only squash merge is allowed (merge commit and rebase disabled).

Branch Naming

kebab-case, optionally type-prefixed: feat-, fix-, doc-. Not enforced, not used for release notes.