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 the App Store What's New text from the repository

leepokai66c5a6a32c6f
diff --git a/AGENTS.md b/AGENTS.md
index 5aebeb66..e2b82f36 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,7 +29,7 @@ Always stop the old Mac app, host and iPhone process before running a new build
- **Every source change ships as a release.** A version bump on `main` is the only release trigger (Auto Tag → DMG, host, Linux app, Homebrew, in-app update), so any change to shipped code (`apps/`, `kit/`, `host/`, `packaging/`) bumps the version before it reaches `main`, without being asked. Docs, `web/`, `cloud/`, `relay/` and CI-only changes don't bump.
- Pick the bump yourself: patch for fixes and small tweaks, minor for new features or protocol additions. Never bump major (stay on 2.x). One bump per merge into `main`: if `MARKETING_VERSION` is already ahead of the latest `v*` tag, leave it.
-- How: set `MARKETING_VERSION` in `apps/project.yml` and `version` in `host/Cargo.toml` (+ its `Cargo.lock` entry) to the same value, run `xcodegen generate --spec apps/project.yml`, commit as `build: bump version to X.Y.Z`. Never touch `CURRENT_PROJECT_VERSION` (Xcode Cloud sets the iOS build number).
+- How: set `MARKETING_VERSION` in `apps/project.yml` and `version` in `host/Cargo.toml` (+ its `Cargo.lock` entry) to the same value, run `xcodegen generate --spec apps/project.yml`, commit as `build: bump version to X.Y.Z`. Never touch `CURRENT_PROJECT_VERSION` (Xcode Cloud sets the iOS build number). When the iOS app changes, also write that version's section in `apps/ios/WhatsNew.md` (zh-Hant + en-US, what iPhone users notice); it becomes the App Store "What's New".
## Coding Style & Naming Conventions
diff --git a/CLAUDE.md b/CLAUDE.md
index 53197dd4..33422bab 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -66,7 +66,7 @@ Always stop the old Mac app, host and iPhone process before running a new build
- Minor/patch bumps are always backward compatible within the same major; the iOS decoder is lenient (`Bot.init(from:)`) so small host additions don't break older apps
- **Every source change ships as a release.** A version bump on `main` is the only release trigger (Auto Tag → DMG, host, Linux app, Homebrew, in-app update), so any change to shipped code (`apps/`, `kit/`, `host/`, `packaging/`) bumps the version before it reaches `main`, without being asked. Docs, `web/`, `cloud/`, `relay/` and CI-only changes don't bump.
- Pick the bump yourself: patch for fixes and small tweaks, minor for new features or protocol additions. Never bump major (stay on 2.x). One bump per merge into `main`: if `MARKETING_VERSION` is already ahead of the latest `v*` tag, leave it.
-- How: set `MARKETING_VERSION` in `apps/project.yml` and `version` in `host/Cargo.toml` (+ its `Cargo.lock` entry) to the same value, run `xcodegen generate --spec apps/project.yml`, commit as `build: bump version to X.Y.Z`. Never touch `CURRENT_PROJECT_VERSION` (Xcode Cloud sets the iOS build number).
+- How: set `MARKETING_VERSION` in `apps/project.yml` and `version` in `host/Cargo.toml` (+ its `Cargo.lock` entry) to the same value, run `xcodegen generate --spec apps/project.yml`, commit as `build: bump version to X.Y.Z`. Never touch `CURRENT_PROJECT_VERSION` (Xcode Cloud sets the iOS build number). When the iOS app changes, also write that version's section in `apps/ios/WhatsNew.md` (zh-Hant + en-US, what iPhone users notice); it becomes the App Store "What's New".
## Targets
diff --git a/apps/ios/WhatsNew.md b/apps/ios/WhatsNew.md
new file mode 100644
index 00000000..7dacdde2
--- /dev/null
+++ b/apps/ios/WhatsNew.md
@@ -0,0 +1,6 @@
+<!--
+App Store "What's New" for the iPhone app. Write it in the change that bumps the version:
+a `## <version>` section with one `### <locale>` per App Store language (zh-Hant, en-US),
+listing what iPhone users notice. tools/asc-submit.py reads the released version's section;
+a version without one gets a generic "Bug fixes and improvements" line. Delete old sections.
+-->
diff --git a/docs/guides/development.md b/docs/guides/development.md
index 3f854acb..924d7598 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). Empty *What's New* fields get a generic "Bug fixes and improvements" text; write real notes in App Store Connect before the tag when a release deserves them. `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); 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.
diff --git a/tools/asc-submit.py b/tools/asc-submit.py
index b55bfd44..c6134ffc 100755
--- a/tools/asc-submit.py
+++ b/tools/asc-submit.py
@@ -5,6 +5,9 @@ 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.
+
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.
"""
@@ -14,8 +17,10 @@ import os
import sys
import time
import urllib.error
+import re
import urllib.request
from datetime import datetime
+from pathlib import Path
import jwt
@@ -26,6 +31,17 @@ EDITABLE = {"PREPARE_FOR_SUBMISSION", "READY_FOR_REVIEW", "DEVELOPER_REJECTED",
"METADATA_REJECTED", "INVALID_BINARY"}
DONE = {"READY_FOR_DISTRIBUTION", "REPLACED_WITH_NEW_VERSION", "REMOVED_FROM_SALE"}
DRY_RUN = os.environ.get("DRY_RUN") == "1"
+NOTES = Path(__file__).resolve().parent.parent / "apps/ios/WhatsNew.md"
+
+
+def release_notes(version):
+ """{locale: text} from the `## <version>` section, split by `### <locale>` headings."""
+ text = NOTES.read_text() if NOTES.exists() else ""
+ section = re.search(rf"^## {re.escape(version)}\s*$(.*?)(?=^## |\Z)", text, re.M | re.S)
+ if not section:
+ return {}
+ parts = re.split(r"^### +(\S+)\s*$", section.group(1), flags=re.M)[1:]
+ return {loc: body.strip() for loc, body in zip(parts[::2], parts[1::2]) if body.strip()}
def token():
@@ -100,10 +116,15 @@ 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'}")
if version_id != "dry-run":
for loc in call("GET", f"/appStoreVersions/{version_id}/appStoreVersionLocalizations")["data"]:
- if not loc["attributes"].get("whatsNew"):
- text = WHATS_NEW.get(loc["attributes"]["locale"], WHATS_NEW["en-US"])
+ locale = loc["attributes"]["locale"]
+ text = notes.get(locale) or notes.get("en-US")
+ if not text and not loc["attributes"].get("whatsNew"):
+ text = WHATS_NEW.get(locale, WHATS_NEW["en-US"])
+ if text:
call("PATCH", f"/appStoreVersionLocalizations/{loc['id']}", {"data": {
"type": "appStoreVersionLocalizations", "id": loc["id"], "attributes": {"whatsNew": text}}})