Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

ci: give every GitHub release a description

leepokai9a7245cf89f8
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 044a7375..13fab492 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,6 +1,6 @@
## Summary
-<!-- What changes for the user, and why. -->
+<!-- What changes for the user, and why. On a release PR into main, this section becomes the GitHub release description. -->
## Validation
diff --git a/.github/workflows/auto-tag.yml b/.github/workflows/auto-tag.yml
index daeacc52..01a9100f 100644
--- a/.github/workflows/auto-tag.yml
+++ b/.github/workflows/auto-tag.yml
@@ -8,6 +8,7 @@ on:
permissions:
contents: write
+ pull-requests: read
jobs:
tag:
@@ -25,7 +26,9 @@ jobs:
echo "version=$VERSION" >> $GITHUB_OUTPUT
echo "Detected version: $VERSION"
- - name: Create tag if not exists
+ - name: Create tag and release if not exists
+ env:
+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
TAG="v${{ steps.version.outputs.version }}"
if git rev-parse "$TAG" >/dev/null 2>&1; then
@@ -34,4 +37,7 @@ jobs:
echo "Creating tag $TAG"
git tag "$TAG"
git push origin "$TAG"
+ # Created here, before the build jobs upload to it, so it carries a description.
+ tools/release-notes.sh "$TAG" > notes.md
+ gh release create "$TAG" --verify-tag --title "$TAG" --notes-file notes.md --generate-notes
fi
diff --git a/docs/guides/development.md b/docs/guides/development.md
index 65d7e09d..c26077cb 100644
--- a/docs/guides/development.md
+++ b/docs/guides/development.md
@@ -101,6 +101,10 @@ Follow [UI conventions](../design/ui-conventions.md) for native toolbar behavior
Versions are defined in `apps/project.yml` (`MARKETING_VERSION`), `host/Cargo.toml` and `apps/desktop/package.json`; keep them equal (the desktop release workflow fails when the app and host differ), then regenerate the Xcode project.
+## GitHub releases
+
+Auto Tag (`.github/workflows/auto-tag.yml`) creates each `v*` release right after pushing the tag, before the host and desktop jobs upload to it. Its description comes from `tools/release-notes.sh`: the `## Summary` of the PR that merged the version bump into `main` (or the PR's opening text without that heading), else the `feat`/`fix` commits since the previous tag, followed by GitHub's generated PR list and compare link. Write the release PR's Summary for people reading the release page.
+
## iOS releases (Xcode Cloud)
The Xcode Cloud workflow "Release" on the product "iOS" has no automatic start condition (its own tag trigger never fired); it only runs when started through the API, and it archives the `iOS` scheme in Release with deployment preparation **TestFlight and App Store** (the "Internal Testing Only" option produces builds App Review can't take) and uploads it to App Store Connect. Xcode Cloud overrides the build number with its own counter (`CI_BUILD_NUMBER`, configured under Xcode Cloud settings → Build Number in App Store Connect), so `CURRENT_PROJECT_VERSION` in `project.yml` is only the local default. The checked-in `apps/Codync.xcodeproj` is what the cloud builds: regenerate it whenever `project.yml` changes, and commit `apps/Codync.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved` whenever a package version changes (Xcode Cloud never resolves packages itself; copy `apps/ios/Kit/Package.resolved` there if Xcode wrote it to `apps/ios/Kit/`). Xcode Cloud reads public package repositories without any connection. The `Submit iOS` GitHub workflow (`.github/workflows/ios-submit.yml` → `tools/asc-submit.py`, secrets `ASC_KEY_ID`, `ASC_ISSUER_ID`, `ASC_PRIVATE_KEY`) runs on every `v*` tag (the tags Auto Tag pushes after a version bump on `main`). It compares the tag with the last version sent to the App Store: when nothing the iPhone app is built from changed (`apps/ios/` including `apps/ios/Kit/`, `apps/shared/`, the package pins, or `apps/project.yml` beyond its version lines), iOS skips that release, so host- or desktop-only releases neither build nor touch a version in review. Otherwise it starts the Xcode Cloud archive on the tag, waits for that build to finish processing and submits it for App Review, released automatically after approval. The latest version wins: a version still *Waiting for Review* is pulled back, renamed and resubmitted with the new build; one already *In Review* or approved is left alone (rerun the workflow with the version once it is out). *What's New* comes from the version's `## <version>` section in `apps/ios/WhatsNew.md` (one `### <locale>` per App Store language, written in the version bump); without one, the `### zh-Hant` / `### en-US` bullets under `## What's New` in the PR template are collected from every PR merged since the last App Store version (changes pushed to `main` without a PR add nothing); with neither, empty fields get a generic "Bug fixes and improvements" line. Running `Submit iOS` by hand with a version ships it even without iPhone changes. `python3 tools/asc-submit-test.py` checks the PR parsing and the change detection. `DRY_RUN=1 tools/asc-submit.py <version>` prints the writes without making them.
diff --git a/tools/release-notes.sh b/tools/release-notes.sh
new file mode 100755
index 00000000..d947f942
--- /dev/null
+++ b/tools/release-notes.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Prints the GitHub release description for a tag: the Summary of the PR that merged it into
+# main (or the PR's opening text when it has no Summary heading), else the feat/fix commits
+# since the previous tag. Auto Tag passes it to `gh release create`. Usage: release-notes.sh v2.13.2
+set -euo pipefail
+tag=$1
+sha=$(git rev-list -n1 "$tag")
+pr=$(gh api "repos/{owner}/{repo}/commits/$sha/pulls" -q '.[0].number' || true)
+notes=""
+if [ -n "$pr" ]; then
+ notes=$(gh pr view "$pr" --json body -q .body | tr -d '\r' |
+ awk 'BEGIN{p=1} /^🤖/{exit} /^## /{p=($0=="## Summary"); next} p' |
+ grep -v -i -E '^- (build: )?(version|bump) ' | sed -e '/./,$!d' || true)
+fi
+if [ -z "${notes//[[:space:]]/}" ]; then
+ prev=$(git describe --tags --abbrev=0 "$tag^")
+ notes=$(git log --no-merges --format='- %s' "$prev..$tag" | grep -E '^- (feat|fix)(\(|:|!)' |
+ grep -v '(web)' | awk '!seen[$0]++' || true)
+fi
+printf '%s\n' "$notes"