Support RN 0.82.1 with fmt 12.1.0 and complete native recovery repairs

.github/workflows/ci.yml

@@ -164,11 +164,6 @@ jobs:
       - name: Install cargo-mutants
         run: cargo install --locked --force cargo-mutants --version 27.1.0
 
-      - name: Start local PostgreSQL
-        run: |
-          make local-postgres-start
-          echo "ADAPTER_TEST_URL=$(cat .ignore/r2/tmp/local-postgres/postgres.url)" >> "$GITHUB_ENV"
-
       - name: Run candidate-server tests
         run: make ci-candidate-server SOAK_ARTIFACT_DIR="$RUNNER_TEMP/soak-evidence"
 
@@ -181,10 +176,6 @@ jobs:
           # A failure before the stress test leaves no journal. The test step keeps that failure.
           if-no-files-found: ignore
 
-      - name: Stop local PostgreSQL
-        if: always()
-        run: make local-postgres-stop
-
   candidate-swift:
     name: candidate Swift
     if: github.event_name == 'push'
@@ -318,7 +309,7 @@ jobs:
   candidate-rn-ios:
     name: candidate React Native iOS
     if: github.event_name == 'push'
-    runs-on: macos-15
+    runs-on: xcode-27
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
@@ -352,6 +343,18 @@ jobs:
             brew install wix/brew/applesimutils
           fi
 
+      - name: Select Xcode 27 and current iOS simulator
+        run: |
+          set -euo pipefail
+          sudo xcode-select -s /Applications/Xcode_27.0.app
+          test "$(xcodebuild -version | sed -n '1s/^Xcode //p')" = '27.0'
+          runtime="$(xcrun simctl list runtimes available -j | ruby -rjson -e 'r=JSON.parse(STDIN.read).fetch("runtimes").find { |x| x["version"] == "27.0" }; abort "iOS 27.0 runtime is required" unless r; puts r.fetch("identifier")')"
+          udid="$(xcrun simctl create Synchro_RN_Current com.apple.CoreSimulator.SimDeviceType.iPhone-18-Pro "$runtime")"
+          xcrun simctl boot "$udid"
+          xcrun simctl bootstatus "$udid" -b
+          echo "IOS_SIMULATOR_UDID=$udid" >> "$GITHUB_ENV"
+          echo "RN_IOS_TEST_DESTINATION=platform=iOS Simulator,id=$udid" >> "$GITHUB_ENV"
+
       - name: Start local PostgreSQL
         run: |
           set -euo pipefail
@@ -379,6 +382,12 @@ jobs:
           make synchrod-pg-test-stop
           make local-postgres-stop
 
+      - name: Delete React Native simulator
+        if: always() && env.IOS_SIMULATOR_UDID != ''
+        run: |
+          xcrun simctl shutdown "$IOS_SIMULATOR_UDID" >/dev/null 2>&1 || true
+          xcrun simctl delete "$IOS_SIMULATOR_UDID" >/dev/null 2>&1 || true
+
   candidate-rn-android:
     name: candidate React Native Android
     if: github.event_name == 'push'
@@ -450,9 +459,6 @@ jobs:
           make local-postgres-start
           echo "ADAPTER_TEST_URL=$(cat .ignore/r2/tmp/local-postgres/postgres.url)" >> "$GITHUB_ENV"
 
-      - name: Build React Native Android app
-        run: make test-rn-e2e-android-build
-
       - name: Enable KVM permissions
         run: |
           echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
@@ -466,7 +472,7 @@ jobs:
           python3 scripts/ci/run_android_emulator.py \
             --sdk-root "$ANDROID_SDK_ROOT" --sdkmanager "$SDKMANAGER" \
             --api 34 --image-api 34 --avd-name Pixel_7_API_34 --profile pixel_7 --memory 6144 \
-            --log-dir "$RUNNER_TEMP/synchro-rn-emulator" -- make ci-candidate-rn-android
+            --log-dir "$RUNNER_TEMP/synchro-rn-emulator" -- make test-rn-e2e-android-build ci-candidate-rn-android
 
   pull-request:
     name: pull-request

.github/workflows/release.yml

@@ -346,12 +346,14 @@ jobs:
           from pathlib import Path
           cells = [
               {"id": "SUP-PG-LINUX-X64-001", "environment": {"architecture": "x86_64", "os": "ubuntu-24.04", "postgresql": "18.3"}},
-              {"id": "SUP-IOS-MIN-001", "environment": {"ios": "16.4", "xcode": "16.4"}},
+              {"id": "SUP-IOS-MIN-001", "environment": {"ios": "17.0", "xcode": "27.0"}},
               {"id": "SUP-IOS-CURRENT-001", "environment": {"ios": "27.0", "xcode": "27.0"}},
               {"id": "SUP-ANDROID-MIN-001", "environment": {"android_api": "24", "os": "ubuntu-24.04", "system_image": "system-images;android-24;google_apis;x86_64", "system_image_revision": "27", "emulator_version": "37.2.12", "emulator_build": "16428233"}},
               {"id": "SUP-ANDROID-CURRENT-001", "environment": {"android_api": "37", "os": "ubuntu-24.04", "system_image": "system-images;android-37.0;google_apis;x86_64", "system_image_revision": "6", "emulator_version": "37.2.12", "emulator_build": "16428233"}},
               {"id": "SUP-RN-IOS-CURRENT-001", "environment": {"ios": "27.0", "react_native": "0.83.10", "xcode": "27.0"}},
               {"id": "SUP-RN-ANDROID-CURRENT-001", "environment": {"android_api": "37", "os": "ubuntu-24.04", "react_native": "0.83.10", "system_image": "system-images;android-37.0;google_apis;x86_64", "system_image_revision": "6", "emulator_version": "37.2.12", "emulator_build": "16428233"}},
+              {"id": "SUP-RN-IOS-MIN-001", "environment": {"ios": "27.0", "react_native": "0.82.1", "xcode": "27.0"}},
+              {"id": "SUP-RN-ANDROID-MIN-001", "environment": {"android_api": "37", "os": "ubuntu-24.04", "react_native": "0.82.1", "system_image": "system-images;android-37.0;google_apis;x86_64", "system_image_revision": "6", "emulator_version": "37.2.12", "emulator_build": "16428233"}},
           ]
           Path("dist/release-inputs/support-environments.json").write_text(json.dumps(cells, indent=2, sort_keys=True) + "\n")
           PY
@@ -516,6 +518,9 @@ jobs:
           - cell: SUP-RN-ANDROID-CURRENT-001
             api: '37.0'
             support_api: '37'
+          - cell: SUP-RN-ANDROID-MIN-001
+            api: '37.0'
+            support_api: '37'
     env:
       ANDROID_HOME: /usr/local/lib/android/sdk
       ANDROID_SDK_ROOT: /usr/local/lib/android/sdk
@@ -707,10 +712,10 @@ jobs:
       matrix:
         include:
           - cell: SUP-IOS-MIN-001
-            ios: '16.4'
-            support: '16'
-            xcode: '16.4'
-            runner: macos-15
+            ios: '17.0'
+            support: '17'
+            xcode: '27.0'
+            runner: xcode-27
           - cell: SUP-IOS-CURRENT-001
             ios: '27.0'
             support: '27.0'
@@ -721,6 +726,11 @@ jobs:
             support: '27.0'
             xcode: '27.0'
             runner: xcode-27
+          - cell: SUP-RN-IOS-MIN-001
+            ios: '27.0'
+            support: '27.0'
+            xcode: '27.0'
+            runner: xcode-27
     steps:
       - name: Checkout candidate
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -763,7 +773,22 @@ jobs:
           test "$(xcodebuild -version | sed -n '1s/^Xcode //p')" = "$XCODE_VERSION"
           swift --version | grep -E 'Swift version 6[.]' >/dev/null
           if ! xcrun simctl list runtimes available -j | ruby -rjson -e 'wanted=ARGV.fetch(0); exit(JSON.parse(STDIN.read).fetch("runtimes").any? { |r| r["version"] == wanted } ? 0 : 1)' "$IOS_VERSION"; then
-            sudo xcodebuild -downloadPlatform iOS -buildVersion "$IOS_VERSION"
+            if [ "$IOS_VERSION" = '17.0' ]; then
+              umask 077
+              runtime_dir="$(mktemp -d)"
+              trap 'rm -rf "$runtime_dir"' EXIT
+              curl -q --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
+                --get --data-urlencode 'path=/Developer_Tools/iOS_17_Simulator_Runtime/iOS_17_Simulator_Runtime.dmg' \
+                --cookie-jar "$runtime_dir/cookies" --output /dev/null \
+                'https://developerservices2.apple.com/services/download'
+              test -s "$runtime_dir/cookies"
+              curl -q --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
+                --cookie "$runtime_dir/cookies" --output "$runtime_dir/iOS_17_Simulator_Runtime.dmg" \
+                'https://download.developer.apple.com/Developer_Tools/iOS_17_Simulator_Runtime/iOS_17_Simulator_Runtime.dmg'
+              sudo xcodebuild -importPlatform "$runtime_dir/iOS_17_Simulator_Runtime.dmg"
+            else
+              sudo xcodebuild -downloadPlatform iOS -buildVersion "$IOS_VERSION"
+            fi
           fi
           runtime="$(xcrun simctl list runtimes available -j | ruby -rjson -e 'wanted=ARGV.fetch(0); r=JSON.parse(STDIN.read).fetch("runtimes").find { |x| x["version"] == wanted }; abort "required iOS runtime is unavailable" unless r; puts r.fetch("identifier")' "$IOS_VERSION")"
           device="$(xcrun simctl list devicetypes -j | ruby -rjson -e 'd=JSON.parse(STDIN.read).fetch("devicetypes"); x=d.find { |i| i["name"] == "iPhone 14" } || d.find { |i| i["name"].start_with?("iPhone") }; abort "no iPhone simulator type" unless x; puts x.fetch("identifier")')"
@@ -887,7 +912,7 @@ jobs:
     name: approve, publish, verify, and promote
     if: ${{ !cancelled() && needs.candidate.result == 'success' && needs.seal.result == 'success' && needs.package-gate.result == 'success' }}
     needs: [candidate, seal, package-gate]
-    runs-on: macos-26
+    runs-on: xcode-27
     environment: release
     permissions:
       actions: read
@@ -1388,21 +1413,23 @@ jobs:
           npm_config_cache: ${{ runner.temp }}/public-rn-npm-cache
           SYNCHRO_CONSUMER_RESOLUTION: public
           PACKAGED_SMOKE_TMP_ROOT: ${{ runner.temp }}/public-rn
-          SUPPORT_PLATFORM_VERSION: '26.5'
+          SUPPORT_PLATFORM_VERSION: '27.0'
         run: |
           set -euo pipefail
           mkdir -p "$GRADLE_USER_HOME" "$npm_config_cache"
           test -z "$(find "$GRADLE_USER_HOME" -mindepth 1 -print -quit)"
           test -z "$(find "$npm_config_cache" -mindepth 1 -print -quit)"
-          test -d /Applications/Xcode_26.6.app || { echo "Xcode 26.6 is required" >&2; exit 1; }
-          sudo xcode-select -s /Applications/Xcode_26.6.app
+          test -d /Applications/Xcode_27.0.app || { echo "Xcode 27.0 is required" >&2; exit 1; }
+          sudo xcode-select -s /Applications/Xcode_27.0.app
           sdkmanager="$(find "$ANDROID_SDK_ROOT/cmdline-tools" -type f -name sdkmanager | sort | tail -n 1)"
           test -x "$sdkmanager"
           yes | "$sdkmanager" --licenses >/dev/null || { statuses=("${PIPESTATUS[@]}"); test "${statuses[1]}" = 0; }
           "$sdkmanager" "platform-tools" "platforms;android-36" "build-tools;36.0.0"
           mkdir -p "$RUNNER_TEMP/public-rn" "$RUNNER_TEMP/empty-artifacts"
           sh verification/consumers/react-native/test-consumer.sh ios "$RUNNER_TEMP/empty-artifacts" "${{ needs.candidate.outputs.version }}" build-only
           sh verification/consumers/react-native/test-consumer.sh android "$RUNNER_TEMP/empty-artifacts" "${{ needs.candidate.outputs.version }}" build-only
+          SYNCHRO_RN_VERSION=0.82.1 sh verification/consumers/react-native/test-consumer.sh ios "$RUNNER_TEMP/empty-artifacts" "${{ needs.candidate.outputs.version }}" build-only
+          SYNCHRO_RN_VERSION=0.82.1 sh verification/consumers/react-native/test-consumer.sh android "$RUNNER_TEMP/empty-artifacts" "${{ needs.candidate.outputs.version }}" build-only
 
       - name: Promote npm latest only after public checks
         env:

CHANGELOG.md

@@ -9,7 +9,7 @@ Before `0.4.0`, use the [GitHub Releases](https://github.com/trainstar/synchro/r
 
 ## [Unreleased]
 
-## [0.4.0-rc.2] - 2026-10-05
+## [0.4.0-rc.2] - 2026-10-09
 
 This release candidate is for consumer validation of `0.4.0`.
 Use exact versions. See [Release Candidate](https://github.com/trainstar/synchro/blob/master/RELEASE.md#release-candidate) for registry behavior.
@@ -18,6 +18,18 @@ Use exact versions. See [Release Candidate](https://github.com/trainstar/synchro
 
 - Operators can register an assignment function with a SQL NULL bound to return all distinct assigned scopes. ([#300](https://github.com/trainstar/synchro/issues/300))
 
+### Changed
+
+- Swift Package Manager and CocoaPods integrations require GRDB 7.8 or later consistently for native inspection APIs. ([#303](https://github.com/trainstar/synchro/issues/303))
+- React Native applications can use RN 0.82.1 through 0.83.x. RN 0.82.1 iOS applications require the [fmt 12.1.0 backport](https://trainstar.github.io/synchro/reference/support-policy/#react-native-0821-fmt-backport) with Xcode 27. ([#303](https://github.com/trainstar/synchro/issues/303))
+- Breaking: Apple clients require iOS 17 or later. Increase the application deployment target before upgrading. See [client requirements](https://trainstar.github.io/synchro/clients/consumption/). ([#303](https://github.com/trainstar/synchro/issues/303))
+
+### Fixed
+
+- Native clients reject inconsistent migration journals and retain unfinished scope rebuild work during schema changes. Native clients preserve pending local edits and deletes when compatible schema changes replace cursors. Native clients rebuild only the affected scope after a local checksum mismatch. ([#331](https://github.com/trainstar/synchro/issues/331))
+- Swift clients apply remote changes after a later accepted or conflict outcome replaces a terminal rejection. ([#331](https://github.com/trainstar/synchro/issues/331))
+- Kotlin clients preserve rows when fields become nullable and support required-field additions without invented defaults. ([#331](https://github.com/trainstar/synchro/issues/331))
+
 ## [0.4.0-rc.1] - 2026-10-01
 
 This release candidate is for consumer validation of `0.4.0`.