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: take App Store release notes from the PR template

leepokai356bfcf8f6ee
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 00000000..d7200b8d
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,20 @@
+## Summary
+
+<!-- What changes for the user, and why. -->
+
+## What's New
+
+<!--
+Shown on the App Store when this PR ships in an iOS release. One bullet per user-visible
+iOS change, in both languages. Leave the bullets empty for changes iPhone users can't see
+(host, Linux, CI, docs); a section for the version in apps/ios/WhatsNew.md takes precedence; a release with
+neither gets a generic "Bug fixes and improvements".
+-->
+
+### zh-Hant
+
+-
+
+### en-US
+
+-
diff --git a/.github/workflows/ios-submit.yml b/.github/workflows/ios-submit.yml
index ded2eaa9..b9bb1df7 100644
--- a/.github/workflows/ios-submit.yml
+++ b/.github/workflows/ios-submit.yml
@@ -11,6 +11,10 @@ on:
description: "Version to submit, e.g. 2.3.0"
required: true
+permissions:
+ contents: read
+ pull-requests: read
+
concurrency:
group: ios-submit
cancel-in-progress: false
@@ -21,6 +25,8 @@ jobs:
timeout-minutes: 200
steps:
- uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
- run: pip install pyjwt cryptography
- name: Submit for review
env:
@@ -28,7 +34,14 @@ jobs:
ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
ASC_PRIVATE_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
VERSION: ${{ inputs.version || github.ref_name }}
+ GH_TOKEN: ${{ github.token }}
run: |
+ # PRs merged since the previous release tag supply What's New when apps/ios/WhatsNew.md has no section.
+ TAG="v${VERSION#v}"
+ PREV=$(git describe --tags --abbrev=0 --match 'v*' "$TAG^" 2>/dev/null || true)
+ git rev-list "${PREV:+$PREV..}$TAG" > "$RUNNER_TEMP/commits.txt"
+ gh pr list --state merged --limit 200 --json body,mergeCommit > "$RUNNER_TEMP/prs.json"
+ export PRS="$RUNNER_TEMP/prs.json" COMMITS="$RUNNER_TEMP/commits.txt"
# A tag run waits for the build Xcode Cloud starts now, not an older upload.
[[ "$GITHUB_EVENT_NAME" == push ]] && export SINCE=$(date -u +%Y-%m-%dT%H:%M:%SZ)
python3 tools/asc-submit.py "${VERSION#v}"
diff --git a/AGENTS.md b/AGENTS.md
index e2b82f36..3781c75b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -59,7 +59,7 @@ Use Swift Testing (`@Test`, `#expect`), Rust unit tests, and the relay’s Node
- Breaking changes: `!` after the type/scope, or a `BREAKING CHANGE:` footer.
- English only; no `Co-Authored-By` or other AI attribution trailers (the commit-msg hook rejects them).
-PRs should explain behavior changes, link relevant issues, list validation performed, and include screenshots for UI changes. Update affected documentation in the same change.
+PRs should explain behavior changes, link relevant issues, list validation performed, and include screenshots for UI changes. Fill the template's *What's New* bullets (zh-Hant + en-US) for iOS changes users can see; they become the App Store notes when `apps/ios/WhatsNew.md` has no section for the release. Update affected documentation in the same change.
## Keeping this file short
diff --git a/CLAUDE.md b/CLAUDE.md
index 33422bab..68a65dbb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -90,6 +90,7 @@ Folder layout, file naming and shared terms: [docs/architecture/file-structure.m
- One logical change per commit. Don't mix unrelated work, and stage only your own hunks when others have uncommitted changes in the tree.
- Breaking changes: `!` after the type/scope, or a `BREAKING CHANGE:` footer.
- English only; no `Co-Authored-By` or other AI attribution trailers (the commit-msg hook rejects them).
+- PRs: fill the template's *What's New* bullets (zh-Hant + en-US) for user-visible iOS changes; they become the App Store notes when `apps/ios/WhatsNew.md` has no section for the release.
## Keeping this file short
diff --git a/docs/guides/development.md b/docs/guides/development.md
index 924d7598..b2f73596 100644
--- a/docs/guides/development.md
+++ b/docs/guides/development.md
@@ -93,4 +93,4 @@ Versions are defined in `apps/project.yml`; keep the host package version aligne
## iOS releases (Xcode Cloud)
-The Xcode Cloud workflow on the Codync product starts on tag changes matching `v*` (the tags Auto Tag pushes after a version bump on `main`), 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 `kit/Package.resolved` there if Xcode wrote it to `kit/`). Xcode Cloud reads public package repositories without any connection; its setup wizard still blocked on Sparkle (asking for a GitHub app install only its owners can grant), so the product was created with Sparkle temporarily removed from `project.yml`. 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 the same tag: it waits for that version's build to finish processing, then 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); a version without one gets a generic "Bug fixes and improvements" line. `DRY_RUN=1 tools/asc-submit.py <version>` prints the writes without making them.
+The Xcode Cloud workflow on the Codync product starts on tag changes matching `v*` (the tags Auto Tag pushes after a version bump on `main`), 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 `kit/Package.resolved` there if Xcode wrote it to `kit/`). Xcode Cloud reads public package repositories without any connection; its setup wizard still blocked on Sparkle (asking for a GitHub app install only its owners can grant), so the product was created with Sparkle temporarily removed from `project.yml`. 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 the same tag: it waits for that version's build to finish processing, then 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 previous `v*` tag (changes pushed to `main` without a PR add nothing); with neither, empty fields get a generic "Bug fixes and improvements" line. `python3 tools/asc-submit-test.py` checks the PR parsing. `DRY_RUN=1 tools/asc-submit.py <version>` prints the writes without making them.
diff --git a/tools/asc-submit-test.py b/tools/asc-submit-test.py
new file mode 100644
index 00000000..f3032982
--- /dev/null
+++ b/tools/asc-submit-test.py
@@ -0,0 +1,26 @@
+"""Self-check for asc-submit.py's What's New parsing: python3 tools/asc-submit-test.py"""
+
+import importlib.util
+import pathlib
+import sys
+import types
+
+sys.modules.setdefault("jwt", types.ModuleType("jwt"))
+spec = importlib.util.spec_from_file_location("asc_submit", pathlib.Path(__file__).with_name("asc-submit.py"))
+asc = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(asc)
+
+template = pathlib.Path(__file__).parent.parent.joinpath(".github/pull_request_template.md").read_text()
+filled = template.replace("### zh-Hant\n\n-", "### zh-Hant\n\n- 例行任務改用同一個表單").replace(
+ "### en-US\n\n-", "### en-US\n\n- Routines use one form")
+prs = [
+ {"body": filled.replace("\n", "\r\n"), "mergeCommit": {"oid": "a"}},
+ {"body": filled, "mergeCommit": {"oid": "b"}}, # duplicate bullet is dropped
+ {"body": template, "mergeCommit": {"oid": "c"}}, # untouched template adds nothing
+ {"body": filled.replace("Routines", "Old"), "mergeCommit": {"oid": "z"}}, # not in this release
+ {"body": None, "mergeCommit": None},
+]
+assert asc.pr_notes(prs, {"a", "b", "c"}) == {
+ "zh-Hant": "- 例行任務改用同一個表單", "en-US": "- Routines use one form"}, asc.pr_notes(prs, {"a", "b", "c"})
+assert asc.pr_notes(prs, {"c"}) == {}
+print("ok")
diff --git a/tools/asc-submit.py b/tools/asc-submit.py
index c6134ffc..1a6c8f46 100755
--- a/tools/asc-submit.py
+++ b/tools/asc-submit.py
@@ -5,8 +5,10 @@ Usage: asc-submit.py 2.3.0
Env: ASC_KEY_ID, ASC_ISSUER_ID, ASC_PRIVATE_KEY (.p8 contents); DRY_RUN=1 prints writes instead;
SINCE (ISO 8601) ignores builds uploaded before it, so a tag run never submits an older build.
-What's New comes from the version's section in apps/ios/WhatsNew.md; without one, empty fields
-get a generic line.
+What's New comes from the version's section in apps/ios/WhatsNew.md, else from the
+"## What's New" bullets of the PRs merged into this release (PRS: `gh pr list --json
+body,mergeCommit` output, COMMITS: `git rev-list` of the release); without either, empty
+fields get a generic line.
Latest version wins: a version still waiting for review is pulled back, renamed and
resubmitted with the new build. A version already in review is left alone.
@@ -44,6 +46,22 @@ def release_notes(version):
return {loc: body.strip() for loc, body in zip(parts[::2], parts[1::2]) if body.strip()}
+def pr_notes(prs, commits):
+ """{locale: bullets} from "### <locale>" under "## What's New" in the PRs merged into this release."""
+ notes = {}
+ for pr in prs:
+ if (pr.get("mergeCommit") or {}).get("oid") not in commits:
+ continue
+ body = re.sub(r"<!--.*?-->", "", (pr.get("body") or "").replace("\r\n", "\n"), flags=re.S)
+ section = re.search(r"^## What.s New[ \t]*$(.*?)(?=^## |\Z)", body, flags=re.M | re.S)
+ for loc, text in re.findall(r"^### +(\S+)[ \t]*$(.*?)(?=^### |\Z)", section[1] if section else "",
+ flags=re.M | re.S):
+ for line in map(str.strip, text.splitlines()):
+ if line not in ("", "-") and line not in notes.setdefault(loc, []):
+ notes[loc].append(line)
+ return {loc: "\n".join(lines)[:4000] for loc, lines in notes.items() if lines}
+
+
def token():
now = int(time.time())
return jwt.encode(
@@ -116,8 +134,11 @@ def main(version):
"attributes": {"platform": "IOS", "versionString": version, "releaseType": "AFTER_APPROVAL"},
"relationships": {"app": {"data": {"type": "apps", "id": APP_ID}}}}})["data"]["id"]
- notes = release_notes(version)
- print(f"What's New from WhatsNew.md: {sorted(notes) or 'none, generic text'}")
+ notes, source = release_notes(version), "WhatsNew.md"
+ if not notes and os.environ.get("PRS"):
+ with open(os.environ["PRS"]) as prs, open(os.environ["COMMITS"]) as commits:
+ notes, source = pr_notes(json.load(prs), set(commits.read().split())), "PRs"
+ print(f"What's New from {source}: {sorted(notes) or 'none, generic text'}")
if version_id != "dry-run":
for loc in call("GET", f"/appStoreVersions/{version_id}/appStoreVersionLocalizations")["data"]:
locale = loc["attributes"]["locale"]