Populate hero names in tutorial game ClientTextStore

The tutorial game creation was not calling withPopulatedPregeneratedTexts(), causing hero names to show as "Hero" instead of their actual names because the name text IDs couldn't be resolved. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Remove default value from GameState.gameType parameter
2026-07-29 02:35:45 +00:00 · 2026-02-18 12:30:13 -08:00 · 2026-02-18 12:26:05 -08:00 · 2026-02-18 09:22:27 -08:00 · 2026-02-18 09:15:59 -08:00 · 2026-02-18 06:46:08 -08:00
855 changed files with 87297 additions and 47544 deletions
@@ -29,14 +29,20 @@ common --javacopt="-Xlint:-options"
 # Use host_linkopt for macOS-specific flags to avoid passing them to Linux cross-compilation
 common:macos --host_linkopt=-Wl,-no_warn_duplicate_libraries

+# Workaround for grpc cf_event_engine build error on macOS with Bazel 7.x
+# See: https://github.com/grpc/grpc/issues/37619
+common:macos --features=-module_maps
+
 # Fix Xcode version caching issue - avoids need for `bazel clean --expunge` after Xcode updates
 common:macos --repo_env=DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer

-common --java_language_version=17
-common --java_runtime_version=remotejdk_17
-common --tool_java_language_version=17
-common --tool_java_runtime_version=remotejdk_17
+common --java_language_version=25
+common --java_runtime_version=remotejdk_25
+common --tool_java_language_version=25
+common --tool_java_runtime_version=remotejdk_25

 # Workspace status for build stamping (git commit, timestamp)
+# Only targets with stamp=1 will use these values; we intentionally
+# do NOT set "common --stamp" so non-stamped targets can share the
+# remote cache across CI workflows.
 common --workspace_status_command=tools/workspace_status.sh
-common --stamp
@@ -1 +1 @@
-7.6.1
+8.5.1
@@ -11,3 +11,19 @@ src/main/csharp/**/GUI[[:space:]]Pro[[:space:]]Kit*/**/*.ttf !filter !diff !merg
 src/main/csharp/**/Modern[[:space:]]UI[[:space:]]Pack/**/*.ttf !filter !diff !merge
 *.herodata filter=lfs diff=lfs merge=lfs -text
 *.ogg filter=lfs diff=lfs merge=lfs -text
+
+# Unity Smart Merge - use UnityYAMLMerge for Unity files
+# Requires configuring unityyamlmerge in ~/.gitconfig:
+#   [merge]
+#   tool = unityyamlmerge
+#   [mergetool "unityyamlmerge"]
+#   trustExitCode = false
+#   cmd = '/Applications/Unity/Hub/Editor/*/Unity.app/Contents/Tools/UnityYAMLMerge' merge -p "$BASE" "$REMOTE" "$LOCAL" "$MERGED"
+*.unity merge=unityyamlmerge
+*.prefab merge=unityyamlmerge
+*.asset merge=unityyamlmerge
+*.mat merge=unityyamlmerge
+*.anim merge=unityyamlmerge
+*.controller merge=unityyamlmerge
+*.physicsMaterial2D merge=unityyamlmerge
+*.physicMaterial merge=unityyamlmerge
@@ -11,6 +11,7 @@ on:
      - 'src/main/protobuf/net/eagle0/eagle/internal/auth_internal.proto'
      - 'src/main/resources/net/eagle0/attributions.json'
      - 'ci/BUILD.bazel'
+      - '.bazelrc'
      - '.github/workflows/auth_build.yml'
  workflow_dispatch:
    inputs:
@@ -40,7 +41,8 @@ jobs:
          set -ex

          # Build auth server image (Go binary has explicit goos/goarch in BUILD.bazel)
-          bazel build //ci:auth_server_image
+          # --stamp is needed for authservice x_defs (git commit, build time)
+          bazel build --stamp //ci:auth_server_image

          # Save the resolved path before any other bazel command changes bazel-bin symlink
          IMAGE_PATH=$(readlink -f bazel-bin/ci/auth_server_image)
@@ -77,8 +79,14 @@ jobs:
          # Build the push target to get crane in runfiles
          bazel build //ci:auth_server_push

-          # Use crane directly for push
-          CRANE="bazel-bin/ci/push_auth_server_push.sh.runfiles/rules_oci~~oci~oci_crane_darwin_arm64/crane"
+          # Find crane binary in runfiles (path varies by Bazel version)
+          RUNFILES="bazel-bin/ci/push_auth_server_push.sh.runfiles"
+          CRANE=$(find "$RUNFILES" -path "*darwin*" -name crane 2>/dev/null | head -1)
+          if [ -z "$CRANE" ] || [ ! -x "$CRANE" ]; then
+            echo "ERROR: crane not found in runfiles"
+            find "$RUNFILES" -name crane 2>/dev/null || echo "No crane found at all"
+            exit 1
+          fi
          echo "Using crane: $CRANE"

          # Push with SHA tag
@@ -13,6 +13,8 @@ jobs:
    steps:
      - name: Checkout
        uses: actions/checkout@v4
+        with:
+          lfs: false

      - name: Show disk usage before cleanup
        run: |
@@ -8,6 +8,7 @@ on:
      - 'WORKSPACE'
      - 'MODULE.bazel'
      - 'BUILD.bazel'
+      - '.bazelrc'
      - '.github/workflows/bazel_test.yml'
      - '!src/main/csharp/**'
      - '!src/test/csharp/**'
@@ -17,17 +18,21 @@ on:
      - 'WORKSPACE'
      - 'MODULE.bazel'
      - 'BUILD.bazel'
+      - '.bazelrc'
      - '.github/workflows/bazel_test.yml'
      - '!src/main/csharp/**'
      - '!src/test/csharp/**'

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
 permissions:
  contents: read

 jobs:
-  test:
+  lint:
    runs-on: [self-hosted, bazel]
-
    steps:
    - name: Checkout repository
      uses: actions/checkout@v4
@@ -35,6 +40,14 @@ jobs:
        lfs: false
    - name: Check BUILD.bazel dependencies
      run: ./scripts/check_build_deps.sh --strict
+
+  test:
+    runs-on: [self-hosted, bazel]
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        lfs: false
    - name: Run tests
      run: bazel test --build_event_json_file=test.json //src/test/... //src/main/go/...
    - name: Collect failed test logs
@@ -19,6 +19,7 @@ on:
      - 'src/main/resources/**'
      - 'ci/BUILD.bazel'
      - 'MODULE.bazel'
+      - '.bazelrc'
      - 'docker-compose.prod.yml'
      - 'nginx/**'
      - '.github/workflows/docker_build.yml'
@@ -61,8 +62,10 @@ jobs:

          # Build ALL images in a single bazel command - Bazel parallelizes internally
          # Note: Shardok is built separately for ARM64 and deployed to Hetzner
+          # --stamp is needed for admin_server x_defs (git commit, build time)
          echo "=== Building Docker images ==="
          bazel build \
+            --stamp \
            --platforms=//:linux_x86_64 \
            --extra_toolchains=@llvm_toolchain_linux//:all \
            //ci:eagle_server_image \
@@ -88,6 +91,13 @@ jobs:
          echo "Admin: $ADMIN_PATH"
          echo "JFR Sidecar: $JFR_PATH"

+      - name: Upload warmup binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: warmup-binary
+          path: scripts/bin/warmup
+          retention-days: 1
+
      - name: Login to DigitalOcean Container Registry
        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && github.event.inputs.push_images == 'true')
        env:
@@ -109,44 +119,59 @@ jobs:

          GIT_SHA=$(git rev-parse --short=8 HEAD)

-          # Get crane from push target runfiles
-          bazel build //ci:eagle_server_push
-          CRANE="bazel-bin/ci/push_eagle_server_push.sh.runfiles/rules_oci~~oci~oci_crane_darwin_arm64/crane"
-
-          if [ ! -e "$CRANE" ]; then
-            # Fallback: find any Darwin crane
-            RUNFILES="bazel-bin/ci/push_eagle_server_push.sh.runfiles"
-            CRANE=$(find "$RUNFILES" -path "*darwin*" -name crane 2>/dev/null | head -1)
+          # Get crane (cached across runs to avoid rebuilding bazel target)
+          CRANE_VERSION="v0.20.2"
+          CRANE_DIR="${HOME}/.local/bin"
+          CRANE="${CRANE_DIR}/crane"
+          if [ ! -x "$CRANE" ] || ! "$CRANE" version 2>/dev/null | grep -q "0.20.2"; then
+            echo "Installing crane ${CRANE_VERSION}..."
+            mkdir -p "$CRANE_DIR"
+            curl -sL "https://github.com/google/go-containerregistry/releases/download/${CRANE_VERSION}/go-containerregistry_Darwin_arm64.tar.gz" | tar xzf - -C "$CRANE_DIR" crane
+            chmod +x "$CRANE"
+          else
+            echo "Using cached crane at $CRANE"
          fi

-          if [ -z "$CRANE" ] || [ ! -e "$CRANE" ]; then
-            echo "ERROR: crane not found"
-            exit 1
-          fi
-          echo "Using crane: $CRANE"
-
-          # Push Eagle image
+          # Set up image paths and tags
          EAGLE_IMAGE="${{ steps.build-all.outputs.eagle_path }}"
          EAGLE_TAG="registry.digitalocean.com/eagle0/eagle-server:${GIT_SHA}"
-          echo "Pushing Eagle: $EAGLE_TAG"
-          $CRANE push "$EAGLE_IMAGE" "$EAGLE_TAG"
-          $CRANE copy "$EAGLE_TAG" "registry.digitalocean.com/eagle0/eagle-server:latest"
-          echo "eagle_image_tag=$EAGLE_TAG" >> $GITHUB_OUTPUT
-
-          # Push Admin image
          ADMIN_IMAGE="${{ steps.build-all.outputs.admin_path }}"
          ADMIN_TAG="registry.digitalocean.com/eagle0/admin-server:${GIT_SHA}"
-          echo "Pushing Admin: $ADMIN_TAG"
-          $CRANE push "$ADMIN_IMAGE" "$ADMIN_TAG"
-          $CRANE copy "$ADMIN_TAG" "registry.digitalocean.com/eagle0/admin-server:latest"
-          echo "admin_image_tag=$ADMIN_TAG" >> $GITHUB_OUTPUT
-
-          # Push JFR Sidecar image
          JFR_IMAGE="${{ steps.build-all.outputs.jfr_path }}"
          JFR_TAG="registry.digitalocean.com/eagle0/jfr-sidecar:${GIT_SHA}"
+
+          # Push all three images in parallel
+          echo "Pushing Eagle: $EAGLE_TAG"
+          $CRANE push "$EAGLE_IMAGE" "$EAGLE_TAG" &
+          PID_EAGLE=$!
+
+          echo "Pushing Admin: $ADMIN_TAG"
+          $CRANE push "$ADMIN_IMAGE" "$ADMIN_TAG" &
+          PID_ADMIN=$!
+
          echo "Pushing JFR Sidecar: $JFR_TAG"
-          $CRANE push "$JFR_IMAGE" "$JFR_TAG"
-          $CRANE copy "$JFR_TAG" "registry.digitalocean.com/eagle0/jfr-sidecar:latest"
+          $CRANE push "$JFR_IMAGE" "$JFR_TAG" &
+          PID_JFR=$!
+
+          # Wait for all pushes to complete
+          PUSH_FAILED=0
+          wait $PID_EAGLE || PUSH_FAILED=1
+          wait $PID_ADMIN || PUSH_FAILED=1
+          wait $PID_JFR   || PUSH_FAILED=1
+          if [ $PUSH_FAILED -ne 0 ]; then
+            echo "ERROR: One or more image pushes failed"
+            exit 1
+          fi
+          echo "All images pushed, tagging :latest..."
+
+          # Tag :latest in parallel
+          $CRANE copy "$EAGLE_TAG" "registry.digitalocean.com/eagle0/eagle-server:latest" &
+          $CRANE copy "$ADMIN_TAG" "registry.digitalocean.com/eagle0/admin-server:latest" &
+          $CRANE copy "$JFR_TAG" "registry.digitalocean.com/eagle0/jfr-sidecar:latest" &
+          wait
+
+          echo "eagle_image_tag=$EAGLE_TAG" >> $GITHUB_OUTPUT
+          echo "admin_image_tag=$ADMIN_TAG" >> $GITHUB_OUTPUT
          echo "jfr_sidecar_image_tag=$JFR_TAG" >> $GITHUB_OUTPUT

          echo "=== All images pushed successfully ==="
@@ -167,6 +192,9 @@ jobs:
      EAGLE_ENABLE_S3: ${{ secrets.EAGLE_ENABLE_S3 }}
      DO_SPACES_ACCESS_KEY: ${{ secrets.DO_SPACES_ACCESS_KEY }}
      DO_SPACES_SECRET_KEY: ${{ secrets.DO_SPACES_SECRET_KEY }}
+      # Admin server uses different credentials (for eagle0-assets bucket)
+      ADMIN_S3_ACCESS_KEY: ${{ secrets.ACCESS_KEY_ID }}
+      ADMIN_S3_SECRET_KEY: ${{ secrets.SECRET_KEY }}
      JWT_PRIVATE_KEY: ${{ secrets.JWT_PRIVATE_KEY }}
      DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
      DISCORD_CLIENT_SECRET: ${{ secrets.DISCORD_CLIENT_SECRET }}
@@ -188,9 +216,17 @@ jobs:
      FASTMAIL_FROM_NAME: ${{ secrets.FASTMAIL_FROM_NAME }}
      DO_DROPLET_IP: ${{ secrets.DO_DROPLET_IP }}
      DO_REGISTRY_TOKEN: ${{ secrets.DO_REGISTRY_TOKEN }}
+      NOTIFY_SECRET: ${{ secrets.EAGLE_NOTIFY_SECRET }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
+        with:
+          lfs: false
+          sparse-checkout: |
+            docker-compose.prod.yml
+            nginx
+            scripts
+          sparse-checkout-cone-mode: false

      - name: Setup SSH key
        run: |
@@ -199,11 +235,11 @@ jobs:
          chmod 600 ~/.ssh/deploy_key
          ssh-keyscan -H "$DO_DROPLET_IP" >> ~/.ssh/known_hosts 2>/dev/null || true

-      - name: Build warmup tool
-        run: |
-          bazel build //ci:warmup_tar
-          mkdir -p scripts/bin
-          tar -xf bazel-bin/ci/warmup_tar.tar -C scripts/bin --strip-components=1
+      - name: Download warmup binary
+        uses: actions/download-artifact@v4
+        with:
+          name: warmup-binary
+          path: scripts/bin/

      - name: Copy config files to droplet
        run: |
@@ -287,6 +323,8 @@ jobs:
          export EAGLE_ENABLE_S3="${EAGLE_ENABLE_S3:-false}"
          export DO_SPACES_ACCESS_KEY="${DO_SPACES_ACCESS_KEY}"
          export DO_SPACES_SECRET_KEY="${DO_SPACES_SECRET_KEY}"
+          export ADMIN_S3_ACCESS_KEY="${ADMIN_S3_ACCESS_KEY}"
+          export ADMIN_S3_SECRET_KEY="${ADMIN_S3_SECRET_KEY}"
          export JWT_PRIVATE_KEY="${JWT_PRIVATE_KEY}"
          export DISCORD_CLIENT_ID="${DISCORD_CLIENT_ID}"
          export DISCORD_CLIENT_SECRET="${DISCORD_CLIENT_SECRET}"
@@ -307,6 +345,7 @@ jobs:
          export FASTMAIL_FROM_EMAIL="${FASTMAIL_FROM_EMAIL}"
          export FASTMAIL_FROM_NAME="${FASTMAIL_FROM_NAME}"
          export DO_REGISTRY_TOKEN="${DO_REGISTRY_TOKEN}"
+          export NOTIFY_SECRET="${NOTIFY_SECRET}"

          # Check Docker has IPv6 support
          if ! cat /etc/docker/daemon.json 2>/dev/null | grep -q '"ip6tables"'; then
@@ -318,29 +357,34 @@ jobs:

          echo "Using images: \$EAGLE_IMAGE, \$ADMIN_IMAGE, \$JFR_SIDECAR_IMAGE"

-          # Install crane for pulling OCI images
-          echo "Installing crane..."
-          rm -f crane
-          curl -sL https://github.com/google/go-containerregistry/releases/download/v0.20.2/go-containerregistry_Linux_x86_64.tar.gz | tar xzf - crane
-          chmod +x crane
+          # Install crane for pulling OCI images (cached across deploys)
+          CRANE_VERSION="v0.20.2"
+          if [ ! -x crane ] || ! ./crane version 2>/dev/null | grep -q "0.20.2"; then
+            echo "Installing crane \${CRANE_VERSION}..."
+            rm -f crane
+            curl -sL "https://github.com/google/go-containerregistry/releases/download/\${CRANE_VERSION}/go-containerregistry_Linux_x86_64.tar.gz" | tar xzf - crane
+            chmod +x crane
+          else
+            echo "Using cached crane"
+          fi

-          # Pull and load all images
-          echo "Pulling Eagle image..."
-          ./crane pull "\${EAGLE_IMAGE}" eagle.tar && docker load -i eagle.tar && rm eagle.tar
+          # Pull all images in parallel, then load sequentially
+          echo "Pulling all images in parallel..."
+          ./crane pull "\${EAGLE_IMAGE}" eagle.tar &
+          ./crane pull "\${ADMIN_IMAGE}" admin.tar &
+          ./crane pull "\${JFR_SIDECAR_IMAGE}" jfr-sidecar.tar &
+          docker pull nginx:alpine &
+          docker pull certbot/certbot &
+          wait

-          echo "Pulling Admin image..."
-          ./crane pull "\${ADMIN_IMAGE}" admin.tar && docker load -i admin.tar && rm admin.tar
+          echo "Loading images..."
+          docker load -i eagle.tar && rm eagle.tar
+          docker load -i admin.tar && rm admin.tar
          # Tag as :latest locally so docker-compose fallback uses correct image
          docker tag "\${ADMIN_IMAGE}" registry.digitalocean.com/eagle0/admin-server:latest
+          docker load -i jfr-sidecar.tar && rm jfr-sidecar.tar

-          echo "Pulling JFR Sidecar image..."
-          ./crane pull "\${JFR_SIDECAR_IMAGE}" jfr-sidecar.tar && docker load -i jfr-sidecar.tar && rm jfr-sidecar.tar
-
-          # Pull other compose images
-          docker pull nginx:alpine || true
-          docker pull certbot/certbot || true
-
-          echo "All images pulled successfully"
+          echo "All images pulled and loaded successfully"

          # =================================================================
          # Verify Shardok connectivity before proceeding with deployment
@@ -399,7 +443,9 @@ jobs:
          fi
          echo "Admin image verification passed"

-          # Cleanup
+          # Cleanup - remove old images to prevent disk full
          docker container prune -f
          docker image prune -f
+          # Remove images older than 24h (keeps recent images for rollback)
+          docker image prune -a -f --filter "until=24h" || true
          DEPLOY_SCRIPT
@@ -1,16 +1,7 @@
 name: Eagle Build

 on:
-  push:
-    branches: [ "main" ]
-    paths:
-      - 'src/main/scala/**'
-      - 'src/main/protobuf/net/eagle0/eagle/**'
-      - 'src/main/protobuf/net/eagle0/common/**'
-      - 'WORKSPACE'
-      - 'MODULE.bazel'
-      - 'BUILD.bazel'
-      - '.github/workflows/eagle_build.yml'
+  # Main pushes are covered by docker_build.yml which builds the same target
  pull_request:
    paths:
      - 'src/main/scala/**'
@@ -19,8 +10,13 @@ on:
      - 'WORKSPACE'
      - 'MODULE.bazel'
      - 'BUILD.bazel'
+      - '.bazelrc'
      - '.github/workflows/eagle_build.yml'

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
 permissions:
  contents: read

@@ -20,6 +20,10 @@ on:
      - "ci/github_actions/upload_addressables.sh"
  workflow_dispatch:

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
 permissions:
  contents: read

@@ -32,31 +36,38 @@ jobs:
    runs-on: [self-hosted, macOS, unity-mac]

    steps:
+      - name: Prune stale PR refs
+        run: |
+          # Self-hosted runners persist .git between runs. When a PR is updated,
+          # old local refs (refs/remotes/pull/*/merge) may point to commits whose
+          # objects were never fetched or have been pruned. Remove these stale refs
+          # before checkout to prevent "missing object" errors.
+          if [ -d ".git" ]; then
+            echo "Pruning stale PR refs..."
+            git for-each-ref --format='%(refname)' refs/remotes/pull/ 2>/dev/null | \
+              xargs -r git update-ref -d 2>/dev/null || true
+          fi
      - uses: actions/checkout@v4
        with:
-          lfs: true
-          clean: true
+          lfs: false  # Fetch LFS after checkout to avoid stale ref issues
+          clean: false  # Library/ persists between runs on self-hosted runners

-      - name: Pull LFS files
-        run: git lfs pull
+      - name: Clean stale files
+        run: |
+          git clean -ffd
+          rm -rf src/main/csharp/net/eagle0/clients/unity/eagle0/Library/Bee/
+
+      - name: Fetch LFS files
+        run: |
+          git lfs install
+          git lfs pull

      - name: Ensure Unity version installed
        run: ./ci/github_actions/ensure_unity_installed.sh ios

-      - name: Restore Library/
-        env:
-          UNITY_CACHE_PLATFORM: ios
-        run: ./ci/github_actions/restore_library.sh
-
      - name: Build iOS Addressables
        run: ./ci/github_actions/build_ios_addressables.sh "$EAGLE0_BUILD_DIR/editor_ios_addressables.log"

-      - name: Persist Library/
-        if: success()
-        env:
-          UNITY_CACHE_PLATFORM: ios
-        run: ./ci/github_actions/persist_library.sh
-
      - name: Upload Addressables to CDN
        if: success() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
        env:
@@ -64,6 +75,17 @@ jobs:
          SECRET_KEY: ${{ secrets.SECRET_KEY }}
        run: ./ci/github_actions/upload_addressables.sh iOS

+      - name: Purge CDN cache for iOS addressables
+        if: success() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+        env:
+          DO_CDN_PAT: ${{ secrets.DO_CDN_PAT }}
+        run: |
+          curl -s -X DELETE "https://api.digitalocean.com/v2/cdn/endpoints/8c98df29-6f0c-4704-8e82-ca40a2b81aa8/cache" \
+            -H "Authorization: Bearer $DO_CDN_PAT" \
+            -H "Content-Type: application/json" \
+            -d '{"files": ["addressables/iOS/*"]}' \
+            --fail || echo "Warning: CDN purge failed (non-fatal)"
+
      - name: Archive Build Log
        if: success() || failure()
        uses: actions/upload-artifact@v4
@@ -11,7 +11,6 @@ on:

 permissions:
  contents: read
-  actions: write

 env:
  # Runner-specific build directory to allow parallel builds on multiple runners
@@ -21,39 +20,43 @@ env:

 jobs:
  build-unity:
-    runs-on: [self-hosted, macOS, unity-mac]
-    outputs:
-      xcode_project_path: ${{ steps.build.outputs.xcode_project_path }}
+    runs-on: [self-hosted, macOS, testflight]

    steps:
+      - name: Prune stale PR refs
+        run: |
+          # Self-hosted runners persist .git between runs. When a PR is updated,
+          # old local refs (refs/remotes/pull/*/merge) may point to commits whose
+          # objects were never fetched or have been pruned. Remove these stale refs
+          # before checkout to prevent "missing object" errors.
+          if [ -d ".git" ]; then
+            echo "Pruning stale PR refs..."
+            git for-each-ref --format='%(refname)' refs/remotes/pull/ 2>/dev/null | \
+              xargs -r git update-ref -d 2>/dev/null || true
+          fi
      - uses: actions/checkout@v4
        with:
-          lfs: true
-          clean: true
+          lfs: false  # Fetch LFS after checkout to avoid stale ref issues
+          clean: false  # Library/ persists between runs on self-hosted runners
          fetch-depth: 0

-      - name: Pull LFS files
-        run: git lfs pull
+      - name: Clean stale files
+        run: |
+          git clean -ffd
+          rm -rf src/main/csharp/net/eagle0/clients/unity/eagle0/Library/Bee/
+
+      - name: Fetch LFS files
+        run: |
+          git lfs install
+          git lfs pull

      - name: Ensure Unity version installed
        run: ./ci/github_actions/ensure_unity_installed.sh ios

-      - name: Restore Library/
-        env:
-          UNITY_CACHE_PLATFORM: ios
-        run: ./ci/github_actions/restore_library.sh
-
      - name: Build iOS Unity Project
        id: build
        run: |
          ./ci/github_actions/build_unity_ios.sh "$EAGLE0_BUILD_DIR/eagle0iOS"
-          echo "xcode_project_path=$EAGLE0_BUILD_DIR/eagle0iOS" >> $GITHUB_OUTPUT
-
-      - name: Persist Library/
-        if: success()
-        env:
-          UNITY_CACHE_PLATFORM: ios
-        run: ./ci/github_actions/persist_library.sh

      - name: Upload Addressables to CDN
        if: success()
@@ -62,18 +65,16 @@ jobs:
          SECRET_KEY: ${{ secrets.SECRET_KEY }}
        run: ./ci/github_actions/upload_addressables.sh iOS

-      - name: Zip Xcode project for artifact
+      - name: Purge CDN cache for iOS addressables
+        if: success()
+        env:
+          DO_CDN_PAT: ${{ secrets.DO_CDN_PAT }}
        run: |
-          cd $EAGLE0_BUILD_DIR
-          # Use tar for speed - Xcode projects have many small files
-          tar -czf eagle0iOS.tar.gz eagle0iOS
-
-      - name: Upload Xcode project
-        uses: actions/upload-artifact@v4
-        with:
-          name: xcode-project-${{ github.run_id }}
-          path: ${{ env.EAGLE0_BUILD_DIR }}/eagle0iOS.tar.gz
-          retention-days: 1
+          curl -s -X DELETE "https://api.digitalocean.com/v2/cdn/endpoints/8c98df29-6f0c-4704-8e82-ca40a2b81aa8/cache" \
+            -H "Authorization: Bearer $DO_CDN_PAT" \
+            -H "Content-Type: application/json" \
+            -d '{"files": ["addressables/iOS/*"]}' \
+            --fail || echo "Warning: CDN purge failed (non-fatal)"

      - name: Archive Build Log
        if: success() || failure()
@@ -82,37 +83,12 @@ jobs:
          name: editor_ios.log
          path: ${{ env.EAGLE0_BUILD_DIR }}/editor_ios.log
          retention-days: 5
-      - name: Cleanup build directory
-        if: always()
-        run: rm -rf "${{ env.EAGLE0_BUILD_DIR }}"

  archive-and-upload:
    needs: build-unity
-    runs-on: [self-hosted, macOS, unity-mac]
+    runs-on: [self-hosted, macOS, testflight]

    steps:
-      - uses: actions/checkout@v4
-        with:
-          sparse-checkout: |
-            ci
-            scripts
-
-      - name: Clean download directory
-        run: rm -rf $EAGLE0_BUILD_DIR/eagle0iOS
-
-      - name: Download Xcode project
-        uses: actions/download-artifact@v4
-        with:
-          name: xcode-project-${{ github.run_id }}
-          path: ${{ env.EAGLE0_BUILD_DIR }}
-
-      - name: Extract Xcode project
-        run: |
-          cd $EAGLE0_BUILD_DIR
-          tar -xzf eagle0iOS.tar.gz
-          rm eagle0iOS.tar.gz
-          ls -la eagle0iOS/
-
      - name: Install Signing Certificate
        env:
          IOS_CERTIFICATE: ${{ secrets.IOS_CERTIFICATE }}
@@ -171,11 +147,23 @@ jobs:
      - name: Upload to TestFlight
        if: ${{ github.event.inputs.skip_upload != 'true' }}
        env:
-          APPLE_ID: ${{ secrets.APPLE_ID }}
-          APP_SPECIFIC_PASSWORD: ${{ secrets.APP_SPECIFIC_PASSWORD }}
+          # App Store Connect API Key (replaces deprecated altool with Apple ID)
+          # Create at: https://appstoreconnect.apple.com/access/api
+          APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}
+          APP_STORE_CONNECT_API_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_API_ISSUER_ID }}
+          APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
        run: |
+          # Write API key to file (xcodebuild needs a file path)
+          API_KEY_PATH=$(mktemp)
+          echo "$APP_STORE_CONNECT_API_KEY" > "$API_KEY_PATH"
+          export APP_STORE_CONNECT_API_KEY_PATH="$API_KEY_PATH"
+
          chmod +x ./ci/github_actions/upload_testflight.sh
-          ./ci/github_actions/upload_testflight.sh "$EAGLE0_BUILD_DIR/archive/eagle0.ipa"
+          ./ci/github_actions/upload_testflight.sh "$EAGLE0_BUILD_DIR/archive/eagle0.xcarchive" "$APPLE_TEAM_ID" "$PROFILE_UUID"
+
+          # Cleanup
+          rm -f "$API_KEY_PATH"

      - name: Upload IPA artifact
        # Only keep artifact if we skipped TestFlight upload (for debugging)
@@ -193,21 +181,3 @@ jobs:
      - name: Cleanup build directory
        if: always()
        run: rm -rf "${{ env.EAGLE0_BUILD_DIR }}"
-
-  cleanup:
-    needs: [build-unity, archive-and-upload]
-    if: always()
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Delete intermediate artifacts
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          artifact_name="xcode-project-${{ github.run_id }}"
-          echo "Deleting artifact: $artifact_name"
-          artifact_id=$(gh api "repos/${{ github.repository }}/actions/runs/${{ github.run_id }}/artifacts" \
-            -q ".artifacts[] | select(.name == \"$artifact_name\") | .id")
-          if [ -n "$artifact_id" ]; then
-            gh api -X DELETE "repos/${{ github.repository }}/actions/artifacts/$artifact_id" || true
-          fi
@@ -25,25 +25,19 @@ on:
      - "src/main/csharp/net/eagle0/clients/unity/eagle0/ProjectSettings/ProjectVersion.txt"
      - "ci/mac/**"
  pull_request:
+    # On PRs, only build Mac when Mac-specific files change. Shared C#/proto
+    # changes are covered by the Windows build — if it passes, Mac will too.
    paths:
      - ".github/workflows/mac_build.yml"
-      - "src/main/csharp/net/eagle0/clients/unity/**"
-      - "src/main/protobuf/net/eagle0/common/**"
-      - "src/main/protobuf/net/eagle0/shardok/**"
-      - "src/main/protobuf/net/eagle0/eagle/api/**"
-      - "src/main/protobuf/net/eagle0/eagle/common/**"
-      - "src/main/protobuf/net/eagle0/eagle/views/**"
      - "src/main/go/net/eagle0/build/mac_build_handler/**"
      - "scripts/build_mac_plugin.sh"
+      - "scripts/build_sparkle_plugin.sh"
      - "scripts/inject_sparkle.sh"
      - "scripts/codesign_mac_app.sh"
      - "scripts/notarize_submit.sh"
      - "scripts/notarize_wait.sh"
      - "ci/github_actions/build_mac.sh"
      - "ci/github_actions/build_unity_mac.sh"
-      - "ci/github_actions/upload_addressables.sh"
-      - "ci/github_actions/ensure_unity_installed.sh"
-      - "src/main/csharp/net/eagle0/clients/unity/eagle0/ProjectSettings/ProjectVersion.txt"
      - "ci/mac/**"
  workflow_dispatch:
    inputs:
@@ -53,6 +47,10 @@ on:
        default: 'false'
        type: boolean

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
 permissions:
  contents: read
  actions: write  # Required to delete artifacts after deploy
@@ -71,31 +69,58 @@ jobs:
      should_deploy: ${{ steps.check-deploy.outputs.should_deploy }}

    steps:
+      - name: Prune stale PR refs
+        run: |
+          # Self-hosted runners persist .git between runs. When a PR is updated,
+          # old local refs (refs/remotes/pull/*/merge) may point to commits whose
+          # objects were never fetched or have been pruned. Remove these stale refs
+          # before checkout to prevent "missing object" errors.
+          if [ -d ".git" ]; then
+            echo "Pruning stale PR refs..."
+            git for-each-ref --format='%(refname)' refs/remotes/pull/ 2>/dev/null | \
+              xargs -r git update-ref -d 2>/dev/null || true
+          fi
      - uses: actions/checkout@v4
        with:
-          lfs: true
-          clean: true  # Remove untracked files like old SparklePlugin.bundle
+          lfs: false  # Fetch LFS after checkout to avoid stale ref issues
+          clean: false  # Library/ persists between runs on self-hosted runners
          fetch-depth: 0  # For version numbering from git history

-      - name: Pull LFS files
-        run: git lfs pull
+      - name: Clean stale files
+        run: |
+          git clean -ffd
+          # Only clear Bee/ when C# files were added/deleted/renamed (structural
+          # changes that stale the DAG). Content-only modifications are handled by
+          # Bee's incremental compilation. See persist_library.sh for background.
+          BEE_DIR="src/main/csharp/net/eagle0/clients/unity/eagle0/Library/Bee"
+          SHA_FILE="src/main/csharp/net/eagle0/clients/unity/eagle0/Library/.last_built_sha"
+          if [ -f "$SHA_FILE" ] && [ -d "$BEE_DIR" ]; then
+            LAST_SHA=$(cat "$SHA_FILE")
+            if git diff --diff-filter=ADR --name-only "$LAST_SHA" HEAD -- '*.cs' '*.csproj' '*.asmdef' 2>/dev/null | grep -q .; then
+              echo "C# files added/deleted/renamed since $LAST_SHA — clearing Bee/"
+              rm -rf "$BEE_DIR"
+            else
+              echo "No structural C# changes since $LAST_SHA — keeping Bee/"
+            fi
+          else
+            echo "No previous build SHA or no Bee/ — clearing Bee/ as safe default"
+            rm -rf "$BEE_DIR"
+          fi
+
+      - name: Fetch LFS files
+        run: |
+          git lfs install
+          git lfs pull

      - name: Ensure Unity version installed
        run: ./ci/github_actions/ensure_unity_installed.sh mac

-      - name: Restore Library/
-        env:
-          UNITY_CACHE_PLATFORM: mac
-        run: ./ci/github_actions/restore_library.sh
-
      - name: Build Mac Unity
        run: ./ci/github_actions/build_unity_mac.sh "${{ env.EAGLE0_BUILD_DIR }}/eagle0MAC"

-      - name: Persist Library/
+      - name: Save build SHA for Bee/ cache invalidation
        if: success()
-        env:
-          UNITY_CACHE_PLATFORM: mac
-        run: ./ci/github_actions/persist_library.sh
+        run: git rev-parse HEAD > src/main/csharp/net/eagle0/clients/unity/eagle0/Library/.last_built_sha

      - name: Upload Addressables to CDN
        if: success() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
@@ -272,6 +297,8 @@ jobs:
    needs: [build-and-sign, wait-notarization]
    if: needs.build-and-sign.outputs.should_deploy == 'true'
    runs-on: [self-hosted, macOS, unity-mac]
+    outputs:
+      deployed_version: ${{ steps.deploy-mac.outputs.deployed_version }}

    steps:
      - uses: actions/checkout@v4
@@ -294,6 +321,7 @@ jobs:
          rm eagle0.app.zip

      - name: Deploy Mac Build
+        id: deploy-mac
        env:
          ACCESS_KEY_ID: ${{ secrets.ACCESS_KEY_ID }}
          SECRET_KEY: ${{ secrets.SECRET_KEY }}
@@ -324,28 +352,37 @@ jobs:

          rm "$SPARKLE_PRIVATE_KEY_PATH"

-      - name: Delete this run's Mac app artifacts
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          # Delete this run's artifacts (names include run ID to avoid conflicts)
-          for artifact_name in signed-mac-app-${{ github.run_id }} notarized-mac-app-${{ github.run_id }}; do
-            echo "Deleting artifact: $artifact_name"
-            artifact_id=$(gh api "repos/${{ github.repository }}/actions/runs/${{ github.run_id }}/artifacts" \
-              -q ".artifacts[] | select(.name == \"$artifact_name\") | .id")
-            if [ -n "$artifact_id" ]; then
-              echo "Deleting artifact ID: $artifact_id"
-              gh api -X DELETE "repos/${{ github.repository }}/actions/artifacts/$artifact_id" || true
-            fi
-          done
-          echo "Cleanup complete"
+          echo "deployed_version=$VERSION" >> $GITHUB_OUTPUT
+
+      # Artifact cleanup is handled by the cleanup job on ubuntu-latest
      - name: Cleanup build directory
        if: always()
        run: rm -rf "${{ env.EAGLE0_BUILD_DIR }}"

+  notify-mac:
+    needs: deploy
+    if: needs.deploy.outputs.deployed_version != ''
+    runs-on: ubuntu-latest
+    steps:
+      - name: Purge CDN cache and notify clients
+        env:
+          NOTIFY_SECRET: ${{ secrets.EAGLE_NOTIFY_SECRET }}
+          DO_CDN_PAT: ${{ secrets.DO_CDN_PAT }}
+        run: |
+          # Purge CDN cache so clients get the latest files immediately
+          curl -s -X DELETE "https://api.digitalocean.com/v2/cdn/endpoints/8c98df29-6f0c-4704-8e82-ca40a2b81aa8/cache" \
+            -H "Authorization: Bearer $DO_CDN_PAT" \
+            -H "Content-Type: application/json" \
+            -d '{"files": ["mac/*", "addressables/StandaloneOSX/*"]}' \
+            --fail || echo "Warning: CDN purge failed (non-fatal)"
+
+          curl -X POST "https://admin.eagle0.net/notify-update?platform=mac&version=${{ needs.deploy.outputs.deployed_version }}&required=false" \
+            -H "X-Notify-Secret: $NOTIFY_SECRET" \
+            --fail --silent --show-error || echo "Warning: Failed to notify clients (non-fatal)"
+
  # Cleanup job runs regardless of success/failure to prevent artifact accumulation
  cleanup:
-    needs: [build-and-sign, wait-notarization, deploy]
+    needs: [build-and-sign, wait-notarization, deploy, notify-mac]
    if: always()
    runs-on: ubuntu-latest

@@ -10,6 +10,7 @@ on:
      - 'src/main/resources/net/eagle0/shardok/**'
      - 'ci/BUILD.bazel'
      - 'MODULE.bazel'
+      - '.bazelrc'
      - '.github/workflows/shardok_arm64_build.yml'
  workflow_dispatch:
    inputs:
@@ -19,6 +20,10 @@ on:
        default: 'true'
        type: boolean

+concurrency:
+  group: shardok-arm64-deploy
+  cancel-in-progress: false
+
 permissions:
  contents: read

@@ -59,12 +64,14 @@ jobs:
          if [ "$MAGIC" = "7f454c46" ]; then
            echo "SUCCESS: Binary is ELF format (Linux)"
            # Check if it's ARM64 (e_machine = 0xB7 = 183 for aarch64)
+            # od -tx2 reads as a 16-bit value in host byte order (little-endian on macOS),
+            # so the little-endian ELF bytes b7 00 are displayed as 00b7.
            E_MACHINE=$(od -An -j18 -N2 -tx2 "$LINUX_BIN" | tr -d ' ')
            echo "ELF e_machine: $E_MACHINE"
-            if [ "$E_MACHINE" = "b700" ]; then
+            if [ "$E_MACHINE" = "00b7" ]; then
              echo "SUCCESS: Binary is ARM64 (aarch64)"
            else
-              echo "WARNING: Binary e_machine is $E_MACHINE (expected b700 for aarch64)"
+              echo "WARNING: Binary e_machine is $E_MACHINE (expected 00b7 for aarch64)"
            fi
          elif [ "$MAGIC" = "cfaeedfe" ] || [ "$MAGIC" = "cffaedfe" ]; then
            echo "ERROR: Binary is Mach-O format (macOS) - cross-compilation failed!"
@@ -127,20 +134,19 @@ jobs:
            exit 1
          fi

-          # Build a push target to get crane in runfiles
-          bazel build //ci:eagle_server_push
-
-          # Find the Darwin crane binary
-          RUNFILES="bazel-bin/ci/push_eagle_server_push.sh.runfiles"
-          CRANE=$(find "$RUNFILES" -path "*darwin*" -name crane 2>/dev/null | head -1)
-          if [ -z "$CRANE" ]; then
-            CRANE=$(find "$RUNFILES" -name crane 2>/dev/null | head -1)
+          # Get crane (cached across runs to avoid rebuilding bazel target,
+          # which would discard the ARM64 analysis cache due to platform change)
+          CRANE_VERSION="v0.20.2"
+          CRANE_DIR="${HOME}/.local/bin"
+          CRANE="${CRANE_DIR}/crane"
+          if [ ! -x "$CRANE" ] || ! "$CRANE" version 2>/dev/null | grep -q "0.20.2"; then
+            echo "Installing crane ${CRANE_VERSION}..."
+            mkdir -p "$CRANE_DIR"
+            curl -sL "https://github.com/google/go-containerregistry/releases/download/${CRANE_VERSION}/go-containerregistry_Darwin_arm64.tar.gz" | tar xzf - -C "$CRANE_DIR" crane
+            chmod +x "$CRANE"
+          else
+            echo "Using cached crane at $CRANE"
          fi
-          if [ -z "$CRANE" ] || [ ! -e "$CRANE" ]; then
-            echo "ERROR: crane not found"
-            exit 1
-          fi
-          echo "Using crane: $CRANE"

          # Push with arm64-prefixed SHA tag (same repo as x86, different tag)
          GIT_SHA=$(git rev-parse --short=8 HEAD)
@@ -1,17 +1,7 @@
 name: Shardok Build

 on:
-  push:
-    branches: [ "main" ]
-    paths:
-      - 'src/main/cpp/**'
-      - 'src/main/proto/net/eagle0/shardok/**'
-      - 'src/main/proto/net/eagle0/common/**'
-      - 'src/main/go/net/eagle0/build/**'
-      - 'WORKSPACE'
-      - 'MODULE.bazel'
-      - 'BUILD.bazel'
-      - '.github/workflows/shardok_build.yml'
+  # Main pushes are covered by shardok_arm64_build.yml which builds the same target
  pull_request:
    paths:
      - 'src/main/cpp/**'
@@ -21,8 +11,13 @@ on:
      - 'WORKSPACE'
      - 'MODULE.bazel'
      - 'BUILD.bazel'
+      - '.bazelrc'
      - '.github/workflows/shardok_build.yml'

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
 permissions:
  contents: read

@@ -15,8 +15,6 @@ on:
      - "scripts/build_plugins.sh"
      - "scripts/build_windows_plugin.sh"
      - "ci/github_actions/build_unity.sh"
-      - "ci/github_actions/restore_library.sh"
-      - "ci/github_actions/persist_library.sh"
      - "ci/github_actions/upload_addressables.sh"
      - "ci/github_actions/ensure_unity_installed.sh"
      - "src/main/csharp/net/eagle0/clients/unity/eagle0/ProjectSettings/ProjectVersion.txt"
@@ -36,14 +34,16 @@ on:
      - "scripts/build_plugins.sh"
      - "scripts/build_windows_plugin.sh"
      - "ci/github_actions/build_unity.sh"
-      - "ci/github_actions/restore_library.sh"
-      - "ci/github_actions/persist_library.sh"
      - "ci/github_actions/upload_addressables.sh"
      - "ci/github_actions/ensure_unity_installed.sh"
      - "src/main/csharp/net/eagle0/clients/unity/eagle0/ProjectSettings/ProjectVersion.txt"
      - "MODULE.bazel"
      - "WORKSPACE"

+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
 permissions:
  contents: read

@@ -54,27 +54,60 @@ env:
 jobs:
  windows-unity:
    runs-on: [self-hosted, macOS, unity-windows]
+    outputs:
+      deployed_version: ${{ steps.get-version.outputs.deployed_version }}

    steps:
+      - name: Prune stale PR refs
+        run: |
+          # Self-hosted runners persist .git between runs. When a PR is updated,
+          # old local refs (refs/remotes/pull/*/merge) may point to commits whose
+          # objects were never fetched or have been pruned. Remove these stale refs
+          # before checkout to prevent "missing object" errors.
+          if [ -d ".git" ]; then
+            echo "Pruning stale PR refs..."
+            git for-each-ref --format='%(refname)' refs/remotes/pull/ 2>/dev/null | \
+              xargs -r git update-ref -d 2>/dev/null || true
+          fi
      - uses: actions/checkout@v4
        with:
-          lfs: true
-          clean: true  # Remove untracked files from previous builds
-      - name: Pull lfs files
-        run: git lfs pull
+          lfs: false  # Fetch LFS after checkout to avoid stale ref issues
+          clean: false  # Library/ persists between runs on self-hosted runners
+
+      - name: Clean stale files
+        run: |
+          git clean -ffd
+          # Only clear Bee/ when C# files were added/deleted/renamed (structural
+          # changes that stale the DAG). Content-only modifications are handled by
+          # Bee's incremental compilation. See persist_library.sh for background.
+          BEE_DIR="src/main/csharp/net/eagle0/clients/unity/eagle0/Library/Bee"
+          SHA_FILE="src/main/csharp/net/eagle0/clients/unity/eagle0/Library/.last_built_sha"
+          if [ -f "$SHA_FILE" ] && [ -d "$BEE_DIR" ]; then
+            LAST_SHA=$(cat "$SHA_FILE")
+            if git diff --diff-filter=ADR --name-only "$LAST_SHA" HEAD -- '*.cs' '*.csproj' '*.asmdef' 2>/dev/null | grep -q .; then
+              echo "C# files added/deleted/renamed since $LAST_SHA — clearing Bee/"
+              rm -rf "$BEE_DIR"
+            else
+              echo "No structural C# changes since $LAST_SHA — keeping Bee/"
+            fi
+          else
+            echo "No previous build SHA or no Bee/ — clearing Bee/ as safe default"
+            rm -rf "$BEE_DIR"
+          fi
+
+      - name: Fetch LFS files
+        run: |
+          git lfs install
+          git lfs pull
      - name: Ensure Unity version installed
        run: ./ci/github_actions/ensure_unity_installed.sh windows
-      - name: Restore Library/
-        env:
-          UNITY_CACHE_PLATFORM: windows
-        run: ./ci/github_actions/restore_library.sh
      - name: Build Windows unity
        run: ./ci/github_actions/build_unity.sh "${{ env.EAGLE0_BUILD_DIR }}/eagle0WIN"
-      - name: Persist Library/
+
+      - name: Save build SHA for Bee/ cache invalidation
        if: success()
-        env:
-          UNITY_CACHE_PLATFORM: windows
-        run: ./ci/github_actions/persist_library.sh
+        run: git rev-parse HEAD > src/main/csharp/net/eagle0/clients/unity/eagle0/Library/.last_built_sha
+
      - name: Upload Addressables to CDN
        if: success() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
        env:
@@ -111,6 +144,14 @@ jobs:

          # Cleanup
          rm -f /tmp/manifest_signing_key
+
+      - name: Export deployed version
+        id: get-version
+        if: success() && github.ref == 'refs/heads/main' && github.event_name == 'push'
+        run: |
+          VERSION=$(grep "^version=" /tmp/unity_manifest.txt | cut -d= -f2 || date +%Y.%m.%d)
+          echo "deployed_version=$VERSION" >> $GITHUB_OUTPUT
+
      - name: Archive build log
        if: success() || failure()
        uses: actions/upload-artifact@v4
@@ -120,4 +161,25 @@ jobs:
          retention-days: 5
      - name: Cleanup build directory
        if: always()
-        run: rm -rf "${{ env.EAGLE0_BUILD_DIR }}"
+        run: rm -rf "${{ env.EAGLE0_BUILD_DIR }}"
+
+  notify-windows:
+    needs: windows-unity
+    if: needs.windows-unity.outputs.deployed_version != ''
+    runs-on: ubuntu-latest
+    steps:
+      - name: Purge CDN cache and notify clients
+        env:
+          NOTIFY_SECRET: ${{ secrets.EAGLE_NOTIFY_SECRET }}
+          DO_CDN_PAT: ${{ secrets.DO_CDN_PAT }}
+        run: |
+          # Purge CDN cache so clients get the latest files immediately
+          curl -s -X DELETE "https://api.digitalocean.com/v2/cdn/endpoints/8c98df29-6f0c-4704-8e82-ca40a2b81aa8/cache" \
+            -H "Authorization: Bearer $DO_CDN_PAT" \
+            -H "Content-Type: application/json" \
+            -d '{"files": ["windows/*", "addressables/StandaloneWindows64/*"]}' \
+            --fail || echo "Warning: CDN purge failed (non-fatal)"
+
+          curl -X POST "https://admin.eagle0.net/notify-update?platform=windows&version=${{ needs.windows-unity.outputs.deployed_version }}&required=false" \
+            -H "X-Notify-Secret: $NOTIFY_SECRET" \
+            --fail --silent --show-error || echo "Warning: Failed to notify clients (non-fatal)"
@@ -37,5 +37,8 @@ scripts/refresh_name_layers/refresh_name_layers.zip
 .metals
 api_keys.txt

+src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/GeneratedProtos/
+src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Plugins/Eagle0Protos/
 src/main/csharp/net/eagle0/clients/unity/eagle0/ProjectSettings/Packages/com.unity.dedicated-server/
 node_modules/
+tools/map_generator/output/
@@ -110,6 +110,10 @@ bazel run gazelle              # Update Go build files
 1. **If you modified any BUILD.bazel file:** Run `bazel run gazelle` and stage any changes it makes
 2. **If you modified C++ or C# files:** Run `clang-format -i` on the modified files
 3. **If you modified Scala files:** scalafmt will run automatically via pre-commit hook
+4. **ALWAYS run the full test suite for your language changes before pushing:**
+   - For Scala changes: `bazel test //src/test/scala/...`
+   - For C++ changes: `bazel test //src/test/cpp/...`
+   - This catches exhaustive pattern match errors and other compile-time failures that single-target builds miss

 The pre-commit hook runs gazelle but only checks if it succeeds - it does NOT verify the BUILD files are in canonical format. The `gazelle_test` will fail if deps are not alphabetically sorted. **Always run gazelle manually after BUILD file changes.**

@@ -221,6 +225,9 @@ to be used for different players or game situations within the same server proce
 - Real-time bidirectional streaming with server via `PersistentClientConnection.cs`
 - Strategic map UI in `Assets/Eagle/`, tactical battle UI in `Assets/Shardok/`
 - Seamless transition between strategic gameplay and hex-based tactical combat
+- **NEVER add defensive null checks on Unity Inspector fields** - these hide configuration bugs. If a field isn't
+  linked in the editor, it should throw a NullReferenceException so the problem is immediately obvious. Silently
+  skipping code when a required field is null makes bugs harder to find.

 **Go (Build Tools):**

@@ -329,6 +336,8 @@ dotty.tools.dotc.core.MissingType: Cannot resolve reference to type net.eagle0.e
 **Configuration:** Game parameters in `/src/main/resources/net/eagle0/eagle/game_parameters.json`
 **Data Files:** TSV format for battalions, heroes, and other game data

+**NEVER modify hero names.** Do not change names in `heroes.tsv`, `generated_heroes`, or any other hero data files. The names are carefully chosen and are not to be altered.
+
 ## Deployment

 - Bazel handles multi-language builds and dependencies
@@ -1,9 +1,9 @@
 module(name = "net_eagle0")

 # Version constants
-SCALA_VERSION = "3.7.2"
+SCALA_VERSION = "3.7.4"

-NETTY_VERSION = "4.1.110.Final"
+NETTY_VERSION = "4.1.127.Final"

 SCALAPB_VERSION = "1.0.0-alpha.1"

@@ -14,13 +14,14 @@ AWS_SDK_VERSION = "2.41.18"
 #

 bazel_dep(name = "bazel_skylib", version = "1.9.0")
+bazel_dep(name = "platforms", version = "1.0.0")
 bazel_dep(name = "rules_pkg", version = "1.2.0")

 #
 # Language Support - Scala
 #

-bazel_dep(name = "rules_scala", version = "7.1.1")
+bazel_dep(name = "rules_scala", version = "7.2.1")

 scala_config = use_extension(
    "@rules_scala//scala/extensions:config.bzl",
@@ -126,12 +127,44 @@ use_repo(
 )

 #
-# Platform Support - Apple/iOS
+# Language Support - Rust
 #

-bazel_dep(name = "apple_support", version = "1.21.1", repo_name = "build_bazel_apple_support")
-bazel_dep(name = "rules_apple", version = "4.3.3", repo_name = "build_bazel_rules_apple")
-bazel_dep(name = "rules_swift", version = "2.4.0", repo_name = "build_bazel_rules_swift")
+bazel_dep(name = "rules_rust", version = "0.68.1")
+
+rust = use_extension("@rules_rust//rust:extensions.bzl", "rust")
+rust.toolchain(edition = "2021")
+use_repo(rust, "rust_toolchains")
+
+register_toolchains("@rust_toolchains//:all")
+
+crate = use_extension("@rules_rust//crate_universe:extension.bzl", "crate")
+crate.from_cargo(
+    name = "map_generator_crates",
+    cargo_lockfile = "//src/main/rust/net/eagle0/eagle/map_generator:Cargo.lock",
+    manifests = ["//src/main/rust/net/eagle0/eagle/map_generator:Cargo.toml"],
+)
+use_repo(crate, "map_generator_crates")
+
+#
+# Platform Support - Apple/iOS
+#
+# Note: rules_apple is NOT included in the main workspace due to rules_swift
+# version conflicts with grpc. SparklePlugin (which needs rules_apple) is built
+# in a separate workspace at sparkle_workspace/ to isolate the conflict.
+#
+
+bazel_dep(name = "apple_support", version = "1.24.1", repo_name = "build_bazel_apple_support")
+
+# rules_swift is a transitive dep of grpc and flatbuffers with conflicting versions:
+# - grpc 1.76.0.bcr.1 requires rules_swift 3.x (compatibility level 3)
+# - flatbuffers requires rules_swift 2.x (compatibility level 2)
+# We don't use Swift directly, but we need to force a single version.
+# Force 3.x since grpc is more complex and harder to downgrade.
+single_version_override(
+    module_name = "rules_swift",
+    version = "3.1.2",
+)

 # Register Apple CC toolchain for Objective-C compilation
 apple_cc_configure = use_extension(
@@ -144,10 +177,13 @@ use_repo(apple_cc_configure, "local_config_apple_cc")
 # Protocol Buffers & RPC
 #

-bazel_dep(name = "protobuf", version = "29.2", repo_name = "com_google_protobuf")
-bazel_dep(name = "grpc", version = "1.71.0")
-bazel_dep(name = "grpc-java", version = "1.71.0")
-bazel_dep(name = "flatbuffers", version = "25.9.23")
+bazel_dep(name = "protobuf", version = "33.5", repo_name = "com_google_protobuf")
+bazel_dep(name = "rules_proto", version = "7.1.0")
+bazel_dep(name = "rules_cc", version = "0.2.14")
+bazel_dep(name = "grpc", version = "1.74.1")
+bazel_dep(name = "grpc-java", version = "1.78.0")
+bazel_dep(name = "rules_proto_grpc_csharp", version = "5.8.0")
+bazel_dep(name = "flatbuffers", version = "25.12.19")

 #
 # Testing
@@ -160,16 +196,29 @@ bazel_dep(name = "googletest", version = "1.17.0")
 #

 bazel_dep(name = "rules_oci", version = "2.2.7")
-bazel_dep(name = "aspect_bazel_lib", version = "2.22.4")
+bazel_dep(name = "aspect_bazel_lib", version = "2.22.5")

 oci = use_extension("@rules_oci//oci:extensions.bzl", "oci")

-# Base image for Eagle (Java 17 JDK - includes jcmd for JFR dumps)
+# Base image for Eagle (Java 25 JRE - smaller runtime, no dev tools needed)
+# Digest pinned for Bazel repository cache hit; update with:
+#   TOKEN=$(curl -s "https://auth.docker.io/token?service=registry.docker.io&scope=repository:library/eclipse-temurin:pull" | python3 -c "import json,sys; print(json.load(sys.stdin)['token'])")
+#   curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/vnd.oci.image.index.v1+json,application/vnd.docker.distribution.manifest.list.v2+json" "https://registry-1.docker.io/v2/library/eclipse-temurin/manifests/25-jre" | python3 -c "import json,sys; m=json.load(sys.stdin); [print(p['digest']) for p in m.get('manifests',[]) if p['platform']['architecture']=='amd64']"
 oci.pull(
-    name = "eclipse_temurin_17",
+    name = "eclipse_temurin_25_jre",
+    digest = "sha256:98236ffdfb61cff3fc4f8e40e5b80460a5a4c35a0f56a5b4182a926844a7db49",
    image = "docker.io/library/eclipse-temurin",
    platforms = ["linux/amd64"],
-    tag = "17-jdk",
+    tag = "25-jre",
+)
+
+# Base image for JFR sidecar (Java 25 JDK - includes jcmd for JFR dumps)
+oci.pull(
+    name = "eclipse_temurin_25_jdk",
+    digest = "sha256:bc2d562355813350f47bc472b9721b0b84761866671ad95d9a9f1151fa69da6e",
+    image = "docker.io/library/eclipse-temurin",
+    platforms = ["linux/amd64"],
+    tag = "25-jdk",
 )

 # Base image for Shardok (Ubuntu 24.04 for C++ runtime)
@@ -190,13 +239,14 @@ oci.pull(
    platforms = ["linux/amd64"],
    tag = "3.21",
 )
-use_repo(oci, "alpine_linux", "alpine_linux_linux_amd64", "eclipse_temurin_17", "eclipse_temurin_17_linux_amd64", "ubuntu_24_04", "ubuntu_24_04_linux_amd64", "ubuntu_24_04_linux_arm64_v8")
+use_repo(oci, "alpine_linux", "alpine_linux_linux_amd64", "eclipse_temurin_25_jdk", "eclipse_temurin_25_jdk_linux_amd64", "eclipse_temurin_25_jre", "eclipse_temurin_25_jre_linux_amd64", "ubuntu_24_04", "ubuntu_24_04_linux_amd64", "ubuntu_24_04_linux_arm64_v8")

 #
 # Java/Scala Dependencies
 #

-bazel_dep(name = "rules_jvm_external", version = "6.9")
+bazel_dep(name = "rules_java", version = "9.3.0")
+bazel_dep(name = "rules_jvm_external", version = "6.10")

 maven = use_extension("@rules_jvm_external//:extensions.bzl", "maven")
 maven.install(
@@ -259,6 +309,9 @@ maven.install(

        # Error tracking
        "io.sentry:sentry:8.31.0",
+
+        # SQLite for client text storage
+        "org.xerial:sqlite-jdbc:3.46.1.0",
    ],
    duplicate_version_warning = "error",
    fail_if_repin_required = True,
@@ -267,6 +320,27 @@ maven.install(
        "https://repo1.maven.org/maven2",
    ],
 )
+
+# Force specific versions for dependencies with conflicts between grpc-java and protobuf
+maven.artifact(
+    artifact = "gson",
+    force_version = True,
+    group = "com.google.code.gson",
+    version = "2.11.0",
+)
+maven.artifact(
+    artifact = "error_prone_annotations",
+    force_version = True,
+    group = "com.google.errorprone",
+    version = "2.30.0",
+)
+maven.artifact(
+    artifact = "guava",
+    force_version = True,
+    group = "com.google.guava",
+    version = "33.3.1-android",
+)
+
 use_repo(maven, "maven", "unpinned_maven")

 #
@@ -283,7 +357,14 @@ GTL_SHA = "1969c45dd76eac0dd87e9e2b65cffe358617f4fe1bcd203f72f427742537913a"

 http_archive(
    name = "gtl",
-    build_file = "@//external:BUILD.gtl",
+    build_file_content = """
+cc_library(
+    name = "gtl",
+    hdrs = glob(["include/gtl/*.hpp"]),
+    includes = ["include"],
+    visibility = ["//visibility:public"],
+)
+""",
    sha256 = GTL_SHA,
    strip_prefix = "gtl-%s" % GTL_VERSION,
    url = "https://github.com/greg7mdp/gtl/archive/refs/tags/v%s.zip" % GTL_VERSION,
@@ -303,16 +384,8 @@ http_archive(
    ],
 )

-# Sparkle framework for macOS auto-updates
-SPARKLE_VERSION = "2.6.4"
-
-http_archive(
-    name = "sparkle",
-    build_file = "@//external:BUILD.sparkle",
-    sha256 = "50612a06038abc931f16011d7903b8326a362c1074dabccb718404ce8e585f0b",
-    strip_prefix = "",
-    url = "https://github.com/sparkle-project/Sparkle/releases/download/%s/Sparkle-%s.tar.xz" % (SPARKLE_VERSION, SPARKLE_VERSION),
-)
+# Note: Sparkle framework is defined in sparkle_workspace/MODULE.bazel
+# (not in main workspace due to rules_swift version conflicts)

 # Busybox static binary for Docker health checks (provides nc, wget, etc.)
 # Primary: DigitalOcean Spaces (public, reliable)
@@ -346,7 +419,48 @@ LLVM_MINGW_VERSION = "20250305"

 http_archive(
    name = "llvm_mingw",
-    build_file = "@//external:BUILD.llvm_mingw",
+    build_file_content = """
+package(default_visibility = ["//visibility:public"])
+
+filegroup(
+    name = "all_files",
+    srcs = glob(["**/*"]),
+)
+
+filegroup(
+    name = "compiler_files",
+    srcs = glob([
+        "bin/x86_64-w64-mingw32-*",
+        "bin/clang*",
+        "bin/llvm-*",
+        "bin/lld*",
+    ]),
+)
+
+filegroup(
+    name = "windows_x86_64_sysroot",
+    srcs = glob([
+        "x86_64-w64-mingw32/**/*",
+        "generic-w64-mingw32/include/**/*",
+    ]),
+)
+
+filegroup(
+    name = "linker_files",
+    srcs = glob([
+        "bin/x86_64-w64-mingw32-*",
+        "bin/lld*",
+        "bin/ld.lld*",
+        "lib/**/*",
+        "x86_64-w64-mingw32/lib/**/*",
+    ]),
+)
+
+exports_files([
+    "bin/x86_64-w64-mingw32-clang",
+    "bin/x86_64-w64-mingw32-clang++",
+])
+""",
    sha256 = "32c24fc62fc8b9f8a900bf2c730b78b36767688f816f9d21e97a168289ff44e0",
    strip_prefix = "llvm-mingw-%s-ucrt-macos-14.4.1-universal" % LLVM_MINGW_VERSION,
    urls = ["https://github.com/fathonix/llvm-mingw-arm64ec-macos/releases/download/%s/llvm-mingw-%s-ucrt-macos-14.4.1-universal.tar.xz" % (LLVM_MINGW_VERSION, LLVM_MINGW_VERSION)],
@@ -73,7 +73,7 @@ pkg_tar(

 oci_image(
    name = "eagle_server_image",
-    base = "@eclipse_temurin_17_linux_amd64",
+    base = "@eclipse_temurin_25_jre_linux_amd64",
    entrypoint = [
        "java",
        "-Xmx2g",
@@ -288,7 +288,7 @@ pkg_tar(
 oci_image(
    name = "jfr_sidecar_image",
    # Use JDK base image - we need jcmd to dump JFR recordings
-    base = "@eclipse_temurin_17_linux_amd64",
+    base = "@eclipse_temurin_25_jdk_linux_amd64",
    entrypoint = ["/app/jfr_server_linux_amd64"],
    exposed_ports = ["8081/tcp"],
    tars = [
@@ -31,6 +31,17 @@ fi

 echo "Found Xcode project: $XCODEPROJ"

+# Ensure export compliance key is set in Info.plist
+# This bypasses the "Missing Compliance" prompt in App Store Connect.
+# Set here rather than relying solely on Unity's DeepLinkPostProcessor,
+# which depends on UNITY_IOS being defined at script compilation time.
+INFO_PLIST="$XCODE_PROJECT_PATH/Info.plist"
+if [ -f "$INFO_PLIST" ]; then
+    /usr/libexec/PlistBuddy -c "Set :ITSAppUsesNonExemptEncryption false" "$INFO_PLIST" 2>/dev/null \
+        || /usr/libexec/PlistBuddy -c "Add :ITSAppUsesNonExemptEncryption bool false" "$INFO_PLIST"
+    echo "Set ITSAppUsesNonExemptEncryption=false in Info.plist"
+fi
+
 # Unity always generates "Unity-iPhone" as the main app scheme
 SCHEME="Unity-iPhone"
 echo "Using scheme: $SCHEME"
@@ -1,33 +0,0 @@
-#!/bin/bash
-#
-# Persist Unity Library/ cache to persistent storage
-#
-# Environment variables:
-#   UNITY_CACHE_PLATFORM - Platform identifier (e.g., "mac", "windows")
-#                          Defaults to "mac" if not set
-#
-# Note: Library/Bee/ is excluded because it contains DAG files with hardcoded
-# file paths that become stale when project files change. This prevents
-# "Data at the root level is invalid" XML errors from stale references.
-
-set -uxo pipefail
-
-PLATFORM="${UNITY_CACHE_PLATFORM:-mac}"
-CACHE_DIR="/tmp/eagle0/Library-${PLATFORM}"
-
-/bin/echo "persist Library/ to $CACHE_DIR (excluding Bee/)"
-
-# rsync may exit with code 23 ("partial transfer due to error") if Unity's
-# temporary files vanish during the copy. This is acceptable for a cache.
-/usr/bin/rsync -rtlDvq --exclude='Bee/' src/main/csharp/net/eagle0/clients/unity/eagle0/Library/ "$CACHE_DIR/"
-rsync_exit=$?
-
-if [ $rsync_exit -eq 0 ]; then
-    exit 0
-elif [ $rsync_exit -eq 23 ]; then
-    echo "Warning: rsync exited with 23 (some files vanished during copy). This is expected for Unity temp files."
-    exit 0
-else
-    echo "Error: rsync failed with exit code $rsync_exit"
-    exit $rsync_exit
-fi
@@ -1,16 +0,0 @@
-#!/bin/bash
-#
-# Restore Unity Library/ cache from persistent storage
-#
-# Environment variables:
-#   UNITY_CACHE_PLATFORM - Platform identifier (e.g., "mac", "windows")
-#                          Defaults to "mac" if not set
-
-set -euxo pipefail
-
-PLATFORM="${UNITY_CACHE_PLATFORM:-mac}"
-CACHE_DIR="/tmp/eagle0/Library-${PLATFORM}"
-
-/bin/echo "restore Library/ from $CACHE_DIR"
-/bin/mkdir -p "$CACHE_DIR"
-/usr/bin/rsync -rtlDvq "$CACHE_DIR/" src/main/csharp/net/eagle0/clients/unity/eagle0/Library/
@@ -1,48 +1,102 @@
 #!/usr/bin/env bash

-# Upload IPA to TestFlight using Apple ID credentials (same as Mac notarization)
+# Upload xcarchive to TestFlight using App Store Connect API Key
+# This replaces the deprecated altool which was removed in Xcode 14+
+#
+# Uses xcodebuild -exportArchive with destination=upload, which is Apple's
+# recommended approach for CI/CD pipelines.

 set -euxo pipefail

-IPA_PATH=${1:?Usage: upload_testflight.sh <ipa_path>}
+# Ensure xcodebuild uses Xcode.app, not Command Line Tools
+export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer

-if [ ! -f "$IPA_PATH" ]; then
-    echo "Error: IPA file not found: $IPA_PATH"
+ARCHIVE_PATH=${1:?Usage: upload_testflight.sh <xcarchive_path> <team_id> <profile_uuid>}
+TEAM_ID=${2:?Missing team ID}
+PROFILE_UUID=${3:?Missing provisioning profile UUID}
+
+if [ ! -d "$ARCHIVE_PATH" ]; then
+    echo "Error: xcarchive not found: $ARCHIVE_PATH"
    exit 1
 fi

-echo "Uploading to TestFlight: $IPA_PATH"
+echo "Uploading to TestFlight: $ARCHIVE_PATH"

-# Uses same credentials as Mac notarization:
-# - APPLE_ID: Your Apple ID email
-# - APP_SPECIFIC_PASSWORD: App-specific password from appleid.apple.com
+# Requires App Store Connect API Key:
+# - APP_STORE_CONNECT_API_KEY_ID: Key ID from App Store Connect
+# - APP_STORE_CONNECT_API_ISSUER_ID: Issuer ID from App Store Connect
+# - APP_STORE_CONNECT_API_KEY_PATH: Path to .p8 private key file
+#
+# To create an API key:
+# 1. Go to https://appstoreconnect.apple.com/access/api
+# 2. Click the + button to create a new key
+# 3. Give it a name and Admin or App Manager access
+# 4. Download the .p8 file (you can only download it once!)
+# 5. Note the Key ID and Issuer ID shown on the page

-if [ -z "${APPLE_ID:-}" ]; then
-    echo "Error: APPLE_ID environment variable not set"
+if [ -z "${APP_STORE_CONNECT_API_KEY_ID:-}" ]; then
+    echo "Error: APP_STORE_CONNECT_API_KEY_ID environment variable not set"
+    echo "Create an API key at https://appstoreconnect.apple.com/access/api"
    exit 1
 fi

-if [ -z "${APP_SPECIFIC_PASSWORD:-}" ]; then
-    echo "Error: APP_SPECIFIC_PASSWORD environment variable not set"
+if [ -z "${APP_STORE_CONNECT_API_ISSUER_ID:-}" ]; then
+    echo "Error: APP_STORE_CONNECT_API_ISSUER_ID environment variable not set"
    exit 1
 fi

-echo "Uploading with xcrun altool..."
-
-# Capture output to check for errors (altool may return 0 even on failure)
-OUTPUT=$(xcrun altool --upload-app \
-    --type ios \
-    --file "$IPA_PATH" \
-    --username "$APPLE_ID" \
-    --password "$APP_SPECIFIC_PASSWORD" 2>&1) || true
-
-echo "$OUTPUT"
-
-# Check for error indicators in output
-if echo "$OUTPUT" | grep -q "ERROR:"; then
-    echo "ERROR: Upload failed. See error messages above."
+if [ -z "${APP_STORE_CONNECT_API_KEY_PATH:-}" ]; then
+    echo "Error: APP_STORE_CONNECT_API_KEY_PATH environment variable not set"
    exit 1
 fi

+if [ ! -f "$APP_STORE_CONNECT_API_KEY_PATH" ]; then
+    echo "Error: API key file not found: $APP_STORE_CONNECT_API_KEY_PATH"
+    exit 1
+fi
+
+# Create export options plist with upload destination
+EXPORT_OPTIONS_PLIST=$(mktemp)
+trap "rm -f $EXPORT_OPTIONS_PLIST" EXIT
+
+cat > "$EXPORT_OPTIONS_PLIST" << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>destination</key>
+    <string>upload</string>
+    <key>method</key>
+    <string>app-store-connect</string>
+    <key>teamID</key>
+    <string>$TEAM_ID</string>
+    <key>uploadSymbols</key>
+    <true/>
+    <key>signingStyle</key>
+    <string>manual</string>
+    <key>signingCertificate</key>
+    <string>Apple Distribution: Daniel Crosby (UWJ88DX8WQ)</string>
+    <key>provisioningProfiles</key>
+    <dict>
+        <key>net.eagle0.eagle</key>
+        <string>$PROFILE_UUID</string>
+    </dict>
+</dict>
+</plist>
+EOF
+
+echo "Export options:"
+cat "$EXPORT_OPTIONS_PLIST"
+
+echo "Uploading to App Store Connect..."
+
+# Use xcodebuild to upload with App Store Connect API authentication
+xcodebuild -exportArchive \
+    -archivePath "$ARCHIVE_PATH" \
+    -exportOptionsPlist "$EXPORT_OPTIONS_PLIST" \
+    -authenticationKeyPath "$APP_STORE_CONNECT_API_KEY_PATH" \
+    -authenticationKeyID "$APP_STORE_CONNECT_API_KEY_ID" \
+    -authenticationKeyIssuerID "$APP_STORE_CONNECT_API_ISSUER_ID"
+
 echo "Upload complete! Check App Store Connect for processing status."
 echo "The build should appear in TestFlight within 15-30 minutes after processing."
@@ -208,6 +208,13 @@ services:
      - "${JFR_SIDECAR_ADDR:-jfr-sidecar:8081}"  # Can be switched for blue-green
      - "--http-port"
      - "8080"
+    environment:
+      # Secret for CI to authenticate client update notifications
+      NOTIFY_SECRET: "${NOTIFY_SECRET:-}"
+      # S3/Spaces credentials for What's New storage (uses eagle0-assets bucket)
+      DO_SPACES_ENDPOINT: "${DO_SPACES_ENDPOINT:-https://sfo3.digitaloceanspaces.com}"
+      DO_SPACES_ACCESS_KEY: "${ADMIN_S3_ACCESS_KEY:-}"
+      DO_SPACES_SECRET_KEY: "${ADMIN_S3_SECRET_KEY:-}"
    # No external port - accessed via nginx at admin.eagle0.net
    depends_on:
      - auth
@@ -0,0 +1,242 @@
+# Adding New Quest Types
+
+This document describes how to add new quest types to Eagle. Quests are tasks that unaffiliated heroes want factions to complete before they'll join.
+
+## Deployment Strategy: Three-PR Approach
+
+When adding new quest types, use a three-PR strategy to ensure clients never see quests they don't understand:
+
+1. **PR 1 - Types Only (Server)**: Add proto definitions, Scala types, converters, and all handling logic (fulfillment, failure, LLM prompts). Do NOT generate the quests yet.
+
+2. **PR 2 - Client Handling**: Add client-side display code (C#/Unity) that can render the new quest type.
+
+3. **PR 3 - Quest Generation (Server)**: Add the actual quest creation logic to `QuestCreationUtils.scala`.
+
+**PR Dependencies:**
+```
+PR 1 (types)
+  ├── PR 2 (client)
+  └── PR 3 (generation)
+```
+
+PR 2 and PR 3 both depend on PR 1, but are independent of each other. They can be developed in parallel after PR 1 is merged, and merged in either order. The key constraint is that PR 3 should not be deployed before PR 2, so clients understand the quest type before the server starts generating it.
+
+## Files to Modify
+
+### Server-Side (Scala)
+
+#### 1. Proto Definition
+**File:** `src/main/protobuf/net/eagle0/eagle/common/unaffiliated_hero_quest.proto`
+
+Add a new message type for your quest and add it to the `QuestDetails` oneof:
+
+```protobuf
+message MyNewQuest {
+    int32 some_field = 1;
+    string another_field = 2;
+}
+
+// In the QuestDetails message, add to the oneof:
+oneof sealed_value {
+    // ... existing quests ...
+    MyNewQuest my_new_quest = XX;  // Use next available field number
+}
+```
+
+#### 2. Scala Case Class
+**File:** `src/main/scala/net/eagle0/eagle/model/state/quest/Quest.scala`
+
+Add a case class (or case object for quests with no parameters):
+
+```scala
+case class MyNewQuest(
+    someField: Int,
+    anotherField: String
+) extends Quest
+
+// For quests with multi-part completion, extend ComponentQuest:
+case class MyComponentQuest(
+    override val componentCount: Int,
+    override val componentsFulfilled: Int,
+    targetValue: Int
+) extends ComponentQuest {
+  override def withComponentsFulfilled(componentsFulfilled: Int): Quest =
+    this.copy(componentsFulfilled = componentsFulfilled)
+}
+```
+
+#### 3. Proto Converter
+**File:** `src/main/scala/net/eagle0/eagle/model/proto_converters/QuestConverter.scala`
+
+Add conversions in both `toProto` and `fromProto` methods:
+
+```scala
+// In toProto:
+case q: MyNewQuest =>
+  QuestProto(details = MyNewQuestProto(q.someField, q.anotherField))
+
+// In fromProto:
+case MyNewQuestProto(someField, anotherField, _) =>
+  MyNewQuest(someField, anotherField)
+```
+
+#### 4. Quest Fulfillment Check
+**File:** `src/main/scala/net/eagle0/eagle/library/actions/impl/action/CheckForFulfilledQuestsAction.scala`
+
+Add a case to `didFulfillQuest` that returns `true` when the quest conditions are met:
+
+```scala
+case MyNewQuest(someField, anotherField) =>
+  // Return true if quest is fulfilled
+  someConditionIsMet(province, someField)
+```
+
+For `ComponentQuest` subclasses, the base case `case q: ComponentQuest => q.componentsFulfilled >= q.componentCount` handles fulfillment automatically.
+
+#### 5. Quest Failure Check
+**File:** `src/main/scala/net/eagle0/eagle/library/actions/impl/action/CheckForFailedQuestsAction.scala`
+
+Add a case to `isQuestFailed` if your quest can fail (e.g., if a required faction is destroyed):
+
+```scala
+case MyNewQuest(someField, _) =>
+  // Return true if quest can no longer be completed
+  !factionWithId(someField).exists(_.isActive)
+```
+
+Many quests use the default case that returns `false` (quest never fails automatically).
+
+#### 6. LLM Prompt Generators
+**File:** `src/main/scala/net/eagle0/eagle/library/actions/llm_prompt_generators/DivineMessagePromptGenerator.scala`
+
+Add a case to `describeQuest` for when a soothsayer reveals the quest:
+
+```scala
+case MyNewQuest(someField, anotherField) =>
+  TextGenerationSuccess(
+    s"$divinedHeroName wants ${faction.name} to do something with $someField."
+  )
+```
+
+**File:** `src/main/scala/net/eagle0/eagle/library/actions/llm_prompt_generators/QuestEndedGeneratorUtilities.scala`
+
+Add a case to `pastTenseQuestDescription` for quest fulfilled/failed narratives:
+
+```scala
+case MyNewQuest(someField, anotherField) =>
+  for {
+    unaffiliatedHeroName <- unaffiliatedHeroNameResult
+  } yield s"$unaffiliatedHeroName wanted ${faction.name} to do something with $someField."
+```
+
+#### 7. Quest Creation (PR 3 only)
+**File:** `src/main/scala/net/eagle0/eagle/library/util/quest_creation/QuestCreationUtils.scala`
+
+Add a quest creator function and register it in `availableQuests`:
+
+```scala
+private def myNewQuests(
+    province: ProvinceT,
+    allProvinces: Vector[ProvinceT],
+    @unused factions: Vector[FactionT],
+    @unused battalions: Vector[BattalionT],
+    functionalRandom: FunctionalRandom
+): RandomState[Vector[Quest]] = {
+  // Return empty if quest shouldn't be available
+  if (!someCondition) RandomState(Vector(), functionalRandom)
+  else {
+    functionalRandom.nextIntInclusive(minValue, maxValue).map { value =>
+      Vector(MyNewQuest(value, "something"))
+    }
+  }
+}
+
+// Add to availableQuests list:
+def availableQuests(...) = functionalRandom.nextFlatMap(
+  Vector[QuestCreator](
+    // ... existing creators ...
+    myNewQuests
+  )
+) { ... }
+```
+
+#### 8. Optional: Quest Command Selectors (AI auto-completion)
+**Directory:** `src/main/scala/net/eagle0/eagle/library/util/command_choice_helpers/quest_command_selectors/`
+
+If you want AI players to automatically work toward completing your quest, create a command chooser.
+
+### Client-Side (C#/Unity)
+
+#### 1. Quest Type Display Name
+**File:** `src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Eagle/DisplayNames.cs`
+
+Add a case to `QuestTypeString`:
+
+```csharp
+case SealedValueOneofCase.MyNewQuest: return "My New Quest";
+```
+
+#### 2. Quest Description String
+**File:** `src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Eagle/Table Rows/UnaffiliatedHeroRowController.cs`
+
+Add a case to `ShortQuestString` for displaying the quest in the UI:
+
+```csharp
+case SealedValueOneofCase.MyNewQuest: {
+    var details = quest.Details.MyNewQuest;
+    return $"Do something with {details.SomeField}";
+}
+```
+
+For quests involving heroes (where you want dynamic name updates), add a case to `SetQuestText` instead.
+
+### Build Files
+
+After making changes, run:
+
+```bash
+bazel run gazelle
+```
+
+This updates BUILD.bazel files with any new dependencies.
+
+## Quest Type Categories
+
+### Simple Quests
+Quests with fixed completion conditions (e.g., `AllianceQuest`, `SuppressRiotByForceQuest`).
+
+### Component Quests
+Quests with multi-part completion that track progress via `componentsFulfilled` / `componentCount` (e.g., `AlmsToProvinceQuest`, `DevelopProvincesQuest`). Extend `ComponentQuest` and implement `withComponentsFulfilled`.
+
+### Action Quests
+Quests completed by specific player actions rather than state checks. Return `false` in `didFulfillQuest` and handle completion in the relevant command handler (e.g., `ExecutePrisonerQuest` is fulfilled in prisoner management command).
+
+## Testing
+
+1. Build all modified targets:
+   ```bash
+   bazel build //src/main/scala/net/eagle0/eagle/model/state/quest:quest
+   bazel build //src/main/scala/net/eagle0/eagle/model/proto_converters:quest_converter
+   ```
+
+2. Run tests:
+   ```bash
+   bazel test //src/test/scala/...
+   ```
+
+3. Verify proto/Scala parity:
+   ```bash
+   bazel test //src/test/scala/net/eagle0/eagle/model/action_result/types:action_result_type_parity_test
+   ```
+
+## Current Quest Types (30 total)
+
+- **Diplomacy**: AllianceQuest, TruceWithFactionQuest, TruceCountQuest, DefeatFactionQuest
+- **Development**: ImproveAgricultureQuest, ImproveEconomyQuest, ImproveInfrastructureQuest, TotalDevelopmentQuest
+- **Expansion**: SpecificExpansionQuest, ExpandToProvincesQuest
+- **Military**: GrandArmyQuest, UpgradeBattalionQuest, FightBeastsAloneQuest
+- **Resources**: WealthQuest, AlmsToProvinceQuest, AlmsAcrossRealmQuest, GiveToHeroesInProvinceQuest, GiveToHeroesAcrossRealmQuest
+- **Personnel**: DismissSpecificVassalQuest, RescueImprisonedLeaderQuest
+- **Prisoner**: ExecutePrisonerQuest, ExilePrisonerQuest, ReleasePrisonerQuest, ReturnPrisonerQuest
+- **Province Orders**: DevelopProvincesQuest, MobilizeProvincesQuest
+- **Events**: SuppressRiotByForceQuest
@@ -182,11 +182,14 @@ All 26 tracks have CC licenses with proper attribution:
 - `failure_horn.mp3` - licensing issue, no replacement found in purchased assets
 - ~~`runaway.mp3`~~ - **REPLACED** (2026-01-27) with `MedievalArmyRunningLoop.mp3` from Freesound (CC BY 4.0)

-**Presumed from Unity Asset Store purchases (31 files):**
+**Verified from [Medieval Combat Sounds](https://assetstore.unity.com/packages/audio/sound-fx/medieval-combat-sounds-100465) (Unity Asset Store):**
+- `duel_challenged.wav` - **REPLACED** (2026-02-03) with `Weapon Draw Metal 1.wav` from Medieval Combat Sounds
+
+**Presumed from Unity Asset Store purchases (30 files):**
 Owner believes these are from: Fantasy Interface Sounds, Medieval Combat Sounds, Magic Spells Sound Effects LITE, and/or Medieval Battle Sound Pack.
 - `archery.mp3`, `battle_shout.mp3`, `boo.mp3`, `braved_water.mp3`
 - `build_bridge.mp3`, `build_bridge_failure.mp3`, `charge.mp3`
- `dismiss_unit.mp3`, `duel_challenged.mp3`, `failure_horn.mp3`, `fear.mp3`, `fear_failed.mp3`
+- `dismiss_unit.mp3`, `failure_horn.mp3`, `fear.mp3`, `fear_failed.mp3`
 - `fire_extinguish.mp3`, `fire_spread.mp3`, `fire_start.mp3`, `fire_start_failure.mp3`
 - `freeze.mp3`, `holy_wave.mp3`, `holy_wave_damage.mp3`, `jail_door.mp3`, `lightning.mp3`
 - `melee.mp3`, `meteor.mp3`, `mind_control.mp3`, `move.mp3`, `move 1.mp3`
@@ -0,0 +1,218 @@
+# Programmatic Map Image Generation
+
+## Overview
+
+Create a tool to programmatically regenerate the Eagle strategic map images with more equalized province sizes while preserving neighbor relationships. Also implement dynamic text rendering for province names that scales with zoom.
+
+## Current Map Assets
+
+| File | Description | Dimensions |
+|------|-------------|------------|
+| `Assets/Eagle/rawGray.gz.bytes` | Province ID lookup map (gzip compressed) | 3786 x 1834 |
+| `Assets/Eagle/map_bw_labels.png` | B&W map with baked-in province labels | 3786 x 1834, RGBA |
+| `Assets/Eagle/Materials/1.png` - `43.png` | Individual province mask images | 3786 x 1834, grayscale |
+
+## Province Data
+
+- 43 provinces defined in `src/main/resources/net/eagle0/eagle/province_map.tsv`
+- Each has: id, name, neighbors, neighborPositions, hexMapName
+- Problem provinces (too small): **Shumal** (id=1), **Kojaria** (id=39), **Usvol** (id=33), **Tumala** (id=35), **Chia** (id=43)
+
+## Goals
+
+1. **Equalize province sizes** - Reduce disparity so small provinces are easier to click
+2. **Preserve topology** - Maintain all neighbor relationships
+3. **Preserve coastline** - Keep ocean/land boundaries
+4. **Dynamic text rendering** - Province names scale with zoom level
+
+---
+
+## Part 1: Province Size Equalization Tool
+
+### Algorithm: Constrained Voronoi Relaxation
+
+1. **Extract current state from rawGray:**
+   - Calculate centroid of each province
+   - Calculate area (pixel count) of each province
+   - Identify ocean pixels (value 0 or 255)
+
+2. **Iterative relaxation:**
+   ```
+   For each iteration:
+     For each province:
+       Calculate target area (average of all provinces)
+       If province is too small:
+         Move centroid away from larger neighbors
+       If province is too large:
+         Move centroid toward smaller neighbors
+       Constraint: Don't break neighbor relationships
+   ```
+
+3. **Generate new boundaries:**
+   - Use weighted Voronoi diagram from relaxed centroids
+   - Weight by target area
+   - Mask with original coastline
+
+4. **Output new images:**
+   - New rawGray (province ID map)
+   - New province masks (1.png - 43.png)
+   - New B&W base map (derived from boundaries)
+
+### Implementation Options
+
+**Option A: Python Script (Recommended)**
+- Use numpy, scipy, PIL/Pillow
+- Can run offline, generate assets once
+- Easier to iterate and debug
+- Output: New image files to replace existing
+
+**Option B: Unity Editor Script**
+- C# with Unity's Texture2D
+- Integrated into build process
+- Slower, harder to debug
+
+### Tool Location
+`tools/map_generator/` or `scripts/generate_map.py`
+
+---
+
+## Part 2: Dynamic Province Name Rendering
+
+### Current State
+- Province names are baked into `map_bw_labels.png`
+- Not visible when zoomed out, too small when zoomed in
+- `SetUpCenterText()` in MapController shows selected/hovered province name in a fixed UI panel
+
+### New Approach
+
+1. **Create province label GameObjects:**
+   - One TextMeshPro label per province
+   - Position at province centroid
+   - Child of map content (moves with zoom/pan)
+
+2. **Dynamic scaling:**
+   - Scale inversely with zoom level
+   - At zoom 1.0: Show major provinces only (or none)
+   - At zoom 2.0+: Show all province names
+   - Font size adjusts to fit province area
+
+3. **Implementation:**
+   ```csharp
+   public class ProvinceLabelsController : MonoBehaviour {
+       public MapPinchZoomHandler zoomHandler;
+       public TextMeshProUGUI labelPrefab;
+
+       private Dictionary<int, TextMeshProUGUI> _labels;
+
+       void Update() {
+           float zoom = zoomHandler.CurrentZoom;
+           foreach (var label in _labels.Values) {
+               label.transform.localScale = Vector3.one / zoom;
+               label.gameObject.SetActive(zoom >= 1.5f);
+           }
+       }
+   }
+   ```
+
+4. **Province centroid data:**
+   - Add `centroid_x`, `centroid_y` columns to `province_map.tsv`
+   - Or calculate at runtime from rawGray
+
+---
+
+## Files to Create/Modify
+
+### New Files
+| File | Purpose |
+|------|---------|
+| `tools/map_generator/generate_map.py` | Python script to generate new map images |
+| `tools/map_generator/requirements.txt` | Python dependencies |
+| `Assets/Eagle/ProvinceLabelsController.cs` | Dynamic province name rendering |
+
+### Modified Files
+| File | Changes |
+|------|---------|
+| `Assets/Eagle/rawGray.gz.bytes` | Replaced with equalized version |
+| `Assets/Eagle/Materials/*.png` | Replaced province masks |
+| `Assets/Eagle/map_bw_labels.png` | Either: regenerated, or removed if using dynamic labels |
+| `province_map.tsv` | Add centroid columns |
+| `Assets/Gameplay.unity` | Add ProvinceLabelsController, label prefab instances |
+
+---
+
+## Verification
+
+1. **Visual inspection:**
+   - Compare old vs new province sizes
+   - Verify small provinces (Shumal, Kojaria, Usvol) are larger
+   - Verify neighbor relationships preserved
+
+2. **Functional testing:**
+   - Click on each province at various zoom levels
+   - Verify correct province is selected
+   - Verify province colors/weather still work
+
+3. **Label testing:**
+   - Zoom in/out, verify labels scale appropriately
+   - Pan around, verify labels move with map
+   - Verify labels don't overlap excessively
+
+---
+
+## Design Decisions
+
+1. **Equalization approach:** Reduce disparity only
+   - Make small provinces (Shumal, Kojaria, Usvol, etc.) 2-3x larger
+   - Minimal changes to large provinces
+   - Not targeting perfectly equal areas
+
+2. **Coastline:** Allow simplification
+   - Coastline can be smoothed/simplified as part of generation
+   - Voronoi edges are acceptable
+
+3. **Map style:** Solid fills with borders
+   - Clean, simple look
+   - Easier to generate programmatically
+   - Province boundaries rendered as dark lines
+
+---
+
+## Implementation Steps
+
+### Step 1: Python Map Generator Tool
+
+```
+tools/map_generator/
+├── generate_map.py      # Main script
+├── requirements.txt     # numpy, scipy, Pillow
+└── README.md           # Usage instructions
+```
+
+**Algorithm:**
+1. Load current rawGray.gz.bytes, decompress
+2. Calculate each province's centroid and area
+3. Identify land mask (non-ocean pixels)
+4. Run constrained Voronoi relaxation:
+   - Small provinces push neighbors away
+   - Large provinces pull neighbors in
+   - Stop when min province is >= 50% of average
+5. Generate weighted Voronoi from relaxed centroids
+6. Output:
+   - `rawGray_new.bytes` (province ID map)
+   - `1.png` - `43.png` (province masks)
+   - `map_bw.png` (solid fill + borders)
+   - `centroids.json` (for label positioning)
+
+### Step 2: Dynamic Province Labels (Unity)
+
+1. Create `ProvinceLabelsController.cs`
+2. Load centroids from JSON or calculate from rawGray
+3. Spawn TextMeshPro labels at each centroid
+4. Update label scale/visibility based on zoom
+
+### Step 3: Integration
+
+1. Replace asset files with generated versions
+2. Update `MapController` to use new assets
+3. Add `ProvinceLabelsController` to scene
+4. Remove baked label image dependency
@@ -0,0 +1,150 @@
+# rules_apple Workspace Separation
+
+This document explains why `rules_apple` is built in a separate Bazel workspace (`sparkle_workspace/`) and what conditions need to be met before it can be reintegrated into the main workspace.
+
+## Background
+
+The main workspace cannot include `rules_apple` due to transitive dependency conflicts with `rules_swift`. Multiple dependencies require different major versions of `rules_swift`:
+
+| Dependency | rules_swift Version | Compatibility Level |
+|------------|---------------------|---------------------|
+| grpc | 3.x | 3 |
+| flatbuffers | 2.x | 2 |
+| rules_apple | 2.x | 2 |
+
+Bzlmod's `single_version_override` can force a single version, but compatibility levels 2 and 3 are incompatible. Forcing `rules_swift` 3.x (required for grpc) breaks `rules_apple` and `flatbuffers`.
+
+## Current Solution
+
+The `SparklePlugin` (the only component requiring `rules_apple`) is built in an isolated workspace:
+
+```
+sparkle_workspace/
+├── MODULE.bazel      # Minimal deps: apple_support, rules_apple, sparkle
+├── BUILD.bazel       # Builds SparklePlugin.bundle
+├── SparklePlugin.m   # Objective-C source
+├── Info.plist        # Bundle metadata
+└── external/
+    └── BUILD.sparkle # Build file for Sparkle framework
+```
+
+### How It Works
+
+1. **Build script**: `scripts/build_sparkle_plugin.sh` builds the plugin from the separate workspace
+2. **Output**: The built `SparklePlugin.bundle` is placed in `Assets/Plugins/macOS/`
+3. **CI integration**: `mac_build.yml` calls `inject_sparkle.sh` to embed Sparkle into the Mac app
+
+The main workspace uses `single_version_override` for `rules_swift` 3.x to satisfy grpc, and includes a comment noting that `rules_apple` is intentionally excluded.
+
+## What SparklePlugin Does
+
+SparklePlugin is a native macOS library that:
+- Initializes the [Sparkle](https://sparkle-project.org/) auto-update framework
+- Exposes C functions for Unity to call via P/Invoke:
+  - `SparklePlugin_Initialize`
+  - `SparklePlugin_CheckForUpdates`
+  - `SparklePlugin_CheckForUpdatesInBackground`
+  - `SparklePlugin_IsCheckingForUpdates`
+  - `SparklePlugin_GetAutomaticallyChecksForUpdates`
+  - `SparklePlugin_SetAutomaticallyChecksForUpdates`
+  - `SparklePlugin_IsRunningFromReadOnlyVolume`
+  - `SparklePlugin_ShowDMGWarning`
+
+## Conditions for Reintegration
+
+To move `rules_apple` back into the main workspace, **all** of the following must be true:
+
+### 1. rules_swift Version Alignment
+
+Check if grpc, flatbuffers, and rules_apple all support the same `rules_swift` major version:
+
+```bash
+# Check what rules_swift version each dependency requires
+bazel mod graph 2>&1 | grep -A2 "rules_swift"
+```
+
+Or check BCR directly:
+- https://registry.bazel.build/modules/grpc
+- https://registry.bazel.build/modules/flatbuffers
+- https://registry.bazel.build/modules/rules_apple
+
+**Test**: After updating versions, verify you can add this to MODULE.bazel without errors:
+```python
+bazel_dep(name = "rules_apple", version = "X.Y.Z")
+```
+
+### 2. Build Test
+
+If the dependency can be added, test that both the main build and SparklePlugin work:
+
+```bash
+# Main workspace builds
+bazel build //src/main/scala/net/eagle0/eagle:eagle_server
+bazel build //src/main/cpp/net/eagle0/shardok:shardok-server
+bazel build //ci:eagle_server_image
+
+# SparklePlugin builds (would move to main workspace)
+bazel build //sparkle:SparklePlugin  # After moving files
+```
+
+### 3. Files to Move
+
+When reintegrating, move these from `sparkle_workspace/` to the main workspace:
+
+| Source | Destination |
+|--------|-------------|
+| `sparkle_workspace/SparklePlugin.m` | `src/main/objc/net/eagle0/sparkle/SparklePlugin.m` |
+| `sparkle_workspace/Info.plist` | `src/main/objc/net/eagle0/sparkle/Info.plist` |
+| `sparkle_workspace/BUILD.bazel` | `src/main/objc/net/eagle0/sparkle/BUILD.bazel` |
+| `sparkle_workspace/external/BUILD.sparkle` | (inline into MODULE.bazel http_archive) |
+
+### 4. MODULE.bazel Changes
+
+Add to the main MODULE.bazel:
+
+```python
+bazel_dep(name = "rules_apple", version = "X.Y.Z", repo_name = "build_bazel_rules_apple")
+
+# Sparkle framework
+http_archive(
+    name = "sparkle",
+    build_file_content = """...""",  # Contents from external/BUILD.sparkle
+    sha256 = "...",
+    url = "https://github.com/sparkle-project/Sparkle/releases/download/...",
+)
+```
+
+Remove the `single_version_override` for `rules_swift` if no longer needed.
+
+### 5. Update Build Scripts
+
+- Update `scripts/build_sparkle_plugin.sh` to build from main workspace
+- Update `scripts/build_plugins.sh` if it references the separate workspace
+- Verify `mac_build.yml` still works
+
+### 6. Cleanup
+
+After successful integration:
+```bash
+rm -rf sparkle_workspace/
+```
+
+Update comments in MODULE.bazel that reference the separate workspace.
+
+## Version History
+
+| Date | Event |
+|------|-------|
+| 2026-02-04 | Separated sparkle_workspace (PR #5882) to enable Bazel 8 upgrade |
+| 2026-02-05 | Upgraded to Bazel 8.5.1 (PR #5883) |
+
+## Monitoring
+
+Periodically check if the upstream dependencies have aligned:
+
+1. **grpc releases**: https://github.com/grpc/grpc/releases
+2. **flatbuffers releases**: https://github.com/google/flatbuffers/releases
+3. **rules_apple releases**: https://github.com/bazelbuild/rules_apple/releases
+4. **BCR updates**: https://registry.bazel.build/
+
+When a new version of any of these is released, check if the `rules_swift` requirements have converged.
@@ -19,7 +19,7 @@ Larger set of goals in [The Big Eagle TODO](https://docs.google.com/document/d/1
 - [x] ~~Still not reconnecting after deployments~~
 - [ ] Notify about client updates, button to come directly back
 - [x] Generatedtext healing
- [ ] Kill outstanding shardok requests when game is deleted
+- [x] Kill outstanding shardok requests when game is deleted

 ### Other Productionization

@@ -76,4 +76,5 @@ Larger set of goals in [The Big Eagle TODO](https://docs.google.com/document/d/1

 ## Nice to have

- [ ] "What's new" changelog (fetch JSON, show entries since last launch)
+- [x] "What's new" changelog (fetch JSON, show entries since last launch)
+- [ ] Windows code signing ([Azure Artifact Signing](https://azure.microsoft.com/en-us/products/artifact-signing/), ~$10/mo) to eliminate SmartScreen "unknown publisher" warning
@@ -0,0 +1,240 @@
+# Tutorial Battle System
+
+This document describes the tutorial battle system for first-time players. The system provides a scripted introductory battle that teaches combat basics while telling a story.
+
+---
+
+## Overview
+
+When a new player starts their first game in tutorial mode, they experience:
+
+1. **Narrative Intro** - Story screens introducing the scenario
+2. **Immediate Battle** - Skip strategic map, start directly in combat
+3. **Scripted Flee** - Enemy flees when player is "on the ropes"
+4. **Reinforcements** - Allied heroes arrive mid-battle
+5. **Heroes Join** - Reinforcement heroes join player's faction after battle
+
+---
+
+## Battle Configuration
+
+### Defender (Player - John Ranil)
+- **Heroes**: John Ranil + 2 random vassals (3 total)
+- **Units**:
+  - 2x Light Infantry (300 troops each, 60 training/armament)
+  - 1x Longbowmen (200 troops, 60 training/armament)
+- **Province**: 14 (Onmaa) with 40 support, 500 gold, 3000 food
+- **Restriction**: Cannot flee (must defend)
+
+### Attacker (Ikhaan Tarn)
+- **Heroes**: Ikhaan Tarn + 2 sworn brothers (3 total)
+- **Units**:
+  - 1x Heavy Cavalry (600 troops, 80 training/armament)
+  - 1x Heavy Infantry (500 troops, 80 training/armament)
+  - 1x Longbowmen (300 troops, 80 training/armament)
+- **Origin Province**: 32
+
+### Flee Trigger
+Attacker flees when ANY of these conditions are met:
+- Player loses 1 unit
+- 5 rounds have passed
+
+### Reinforcements
+When Tarn flees, these heroes arrive as player reinforcements:
+- Elena Fyar
+- Hedrick
+- The Boulder
+
+---
+
+## Implementation Architecture
+
+### Phase 1: Narrative Intro System
+
+**Proto Changes:**
+- `game_state_view.proto`: Added `TutorialNarrativeScreen` message and `pending_narrative_screens` field
+- `game_parameters.proto`: Added `TutorialNarrativeScreen` and `tutorial_narrative_screens` field
+
+**Unity Client:**
+- `NarrativeScreenController.cs`: Modal screen with title, body text, optional image
+- `EagleGameController.cs`: Checks for pending narrative screens on game start
+
+**Narrative Content** (defined in `tutorial_game_parameters.json`):
+```
+Screen 1: "The Engineer of Onmaa" - Player backstory
+Screen 2: "The Traitor Arrives" - Tarn's attack
+Screen 3: "Defend Your Home" - Call to action
+```
+
+### Phase 2: Auto-Start Battle
+
+**Configuration:**
+- `tutorial_game_parameters.json`: Contains `tutorialBattle` config with attacker, target, flee conditions
+- `game_parameters.proto`: `TutorialBattleConfig` message
+
+**Game Creation:**
+- `NewGameCreation.scala`: `setupTutorialBattle()` method creates:
+  - `HostileArmyGroup` with `Attacking` status (bypasses decision phase)
+  - `Army` for defender
+  - Both added to target province
+
+**Battle Creation:**
+- When round advances to `BattleRequest` phase, `RequestBattlesAction` automatically creates the `ShardokBattle`
+
+### Phase 3: Scripted Flee Mechanism
+
+**C++ Component:**
+- `TutorialBattleController.hpp/cpp`: Controller for scripted battle logic
+
+**Key Methods:**
+```cpp
+// Check all events and execute triggered actions (called at end of each round)
+std::vector<ActionResult> CheckAndExecuteEvents(
+    const GameStateW& state,
+    const SettingsGetter& settings,
+    const std::shared_ptr<RandomGenerator>& randomGenerator);
+```
+
+**Integration:**
+- `ShardokEngine.cpp`: Calls `CheckAndExecuteEvents()` at end of each round in `HandlePlayerTurnEnd()`
+- Events fire in config order, each event fires at most once
+
+### Phase 4: Mid-Battle Reinforcements
+
+**Action Types** (in `action_type.proto`):
+- `TUTORIAL_ENEMY_FLED = 78`
+- `TUTORIAL_REINFORCEMENTS_ARRIVED = 79`
+
+**Implementation (TODO):**
+- When scripted flee triggers, create reinforcement units in defender's reserves
+- Units have `UnitStatus_RESERVE_UNIT` status
+- Reinforcements enter battle on subsequent turns
+
+### Phase 5: Tutorial Popups
+
+**Content Definitions** (in `TutorialContentDefinitions.cs`):
+- `tutorial_battle_started`: "Defend your province!"
+- `tutorial_enemy_fled`: "The enemy retreats!"
+- `tutorial_reinforcements_arrived`: "Allies have arrived!"
+- `tutorial_battle_victory`: Victory celebration
+
+**Trigger Integration:**
+- `TutorialTriggerRegistry.cs`: Handles tutorial action types from `ActionResultView`
+- `ShardokGameController.cs`: Detects tutorial events and triggers popups
+
+### Phase 6: Post-Battle Hero Joining
+
+**Implementation (TODO):**
+- `ResolveBattleAction.scala`: Check if battle was tutorial and defender won
+- Create `TutorialHeroJoined` action results adding reinforcement heroes to player faction
+- Set appropriate loyalty, vigor, location for joined heroes
+
+---
+
+## File Summary
+
+### New Files
+| File | Purpose |
+|------|---------|
+| `TutorialBattleController.hpp/cpp` | C++ scripted flee and reinforcement logic |
+| `NarrativeScreenController.cs` | Unity narrative screen display |
+
+### Modified Files
+| File | Changes |
+|------|---------|
+| `tutorial_game_parameters.json` | Battle configuration and narrative content |
+| `game_state_view.proto` | Narrative screens field |
+| `game_parameters.proto` | Tutorial battle config |
+| `player_info.proto` | Tutorial battle flags for Shardok |
+| `action_type.proto` | Tutorial action types |
+| `NewGameCreation.scala` | Auto-start battle setup |
+| `EagleGameController.cs` | Narrative display integration |
+| `TutorialContentDefinitions.cs` | Battle tutorial content |
+| `TutorialTriggerRegistry.cs` | Tutorial event triggers |
+
+---
+
+## Remaining Implementation
+
+### Disable Player Flee
+In `FleeCommandFactory.cpp`:
+- Check if tutorial mode is enabled
+- If defender, don't offer flee commands
+
+### Reinforcement Units
+In `TutorialBattleController::ExecuteScriptedFlee()`:
+- Create `Unit` objects for Elena Fyar, Hedrick, The Boulder
+- Add to defender's reserve units
+- Generate `TUTORIAL_REINFORCEMENTS_ARRIVED` action
+
+### Post-Battle Hero Joining
+In Eagle's battle resolution:
+- Detect tutorial battle completion
+- Create heroes in player's faction with proper stats
+- Generate notification action results
+
+---
+
+## Testing Checklist
+
+- [ ] New user sees narrative screens before battle
+- [ ] Battle starts immediately after narratives (no strategic map)
+- [ ] Player has correct units (3 heroes, 3 battalions)
+- [ ] Attacker has correct units (3 heroes, 3 battalions)
+- [ ] Player cannot flee
+- [ ] Tarn flees after player loses 1 unit
+- [ ] Tarn flees after 5 rounds (if no units lost)
+- [ ] Reinforcements appear when Tarn flees
+- [ ] Tutorial popups appear at correct moments
+- [ ] Reinforcement heroes join faction after battle victory
+
+---
+
+## Configuration Reference
+
+### tutorial_game_parameters.json
+```json
+{
+  "tutorialBattle": {
+    "attackerFactionHead": "Ikhaan Tarn",
+    "targetProvinceId": 14,
+    "fleeAfterDefenderUnitsLost": 1,
+    "fleeAfterRounds": 5,
+    "reinforcements": ["Elena Fyar", "Hedrick", "The Boulder"]
+  },
+  "tutorialNarrativeScreens": [
+    { "title": "...", "bodyText": "...", "imagePath": "" }
+  ]
+}
+```
+
+### TutorialBattleConfig Proto (Shardok)
+```protobuf
+message TutorialBattleConfig {
+    bool enabled = 1;
+    repeated TutorialEvent events = 2;
+    repeated UnitInitialSize initial_sizes = 3;  // For damage tracking
+}
+
+message TutorialEvent {
+    string event_id = 1;
+    TutorialTrigger trigger = 2;
+    TutorialAction action = 3;
+}
+
+message TutorialTrigger {
+    oneof trigger_type {
+        RoundTrigger after_round = 1;
+        UnitsLostTrigger units_lost = 2;
+        DamageTakenTrigger damage_taken = 3;
+        UnitKilledTrigger unit_killed = 4;
+    }
+}
+
+message TutorialAction {
+    oneof action_type {
+        FleeAction flee = 1;
+        ReinforcementsAction reinforcements = 2;  // Uses CommonUnit
+    }
+}
+```
@@ -0,0 +1,113 @@
+# AI Quest Completion Behavior
+
+This document describes which quests the AI attempts to complete proactively to recruit unaffiliated heroes.
+
+## Overview
+
+The AI attempts to complete quests via `FulfillQuestsCommandSelector`, which is invoked by `MidGameAIClient.chosenFulfillEasyQuestsCommand`. The AI only considers quests from unaffiliated heroes in provinces ruled by a faction leader.
+
+## Quests the AI Actively Completes
+
+### Diplomacy Quests
+
+| Quest | Handler | Conditions |
+|-------|---------|------------|
+| `AllianceQuest` | `AllianceQuestCommandChooser` | Target faction must meet trust conditions for alliance and not already be in an alliance |
+| `TruceWithFactionQuest` | `TruceWithFactionQuestCommandChooser` | Target faction must meet trust conditions for truce |
+| `TruceCountQuest` | `TruceCountQuestCommandChooser` | Picks a random faction that meets trust conditions and isn't already in a truce/alliance |
+
+### Resource Giving Quests
+
+| Quest | Handler | Notes |
+|-------|---------|-------|
+| `AlmsToProvinceQuest` | `AlmsToProvinceQuestCommandChooser` | Gives food to the specified province |
+| `AlmsAcrossRealmQuest` | `AlmsAcrossRealmQuestCommandChooser` | Gives food from the province with the largest surplus |
+| `GiveToHeroesInProvinceQuest` | `GiveToHeroesInProvinceQuestCommandChooser` | Gives gold to the hero with the lowest loyalty in the specified province |
+| `GiveToHeroesAcrossRealmQuest` | `GiveToHeroesAcrossRealmQuestCommandChooser` | Gives gold from the province with the most gold available |
+
+### Province Development Quests
+
+| Quest | Handler | Notes |
+|-------|---------|-------|
+| `ImproveAgricultureQuest` | `ImproveQuestCommandChooser` | Issues an Improve command with Agriculture type |
+| `ImproveEconomyQuest` | `ImproveQuestCommandChooser` | Issues an Improve command with Economy type |
+| `ImproveInfrastructureQuest` | `ImproveQuestCommandChooser` | Issues an Improve command with Infrastructure type |
+
+### Other Quests
+
+| Quest | Handler | Conditions |
+|-------|---------|------------|
+| `DismissSpecificVassalQuest` | `DismissSpecificVassalCommandChooser` | Only if province has more than 2 heroes AND the unaffiliated hero's power >= target hero's power * `RequiredPowerMultiplierForDismiss` |
+
+## Quests the AI Does Not Attempt to Complete
+
+The following quests have no handler in `FulfillQuestsCommandSelector` and must be completed naturally through gameplay:
+
+### Combat/Military Quests
+- `DefeatFactionQuest` - Defeat a specific faction
+- `GrandArmyQuest` - Accumulate a large number of troops
+- `UpgradeBattalionQuest` - Upgrade a battalion to minimum armament/training
+- `WinBattleOutnumberedQuest` - Win a battle while outnumbered
+- `WinBattlesQuest` - Win a number of battles
+- `RescueImprisonedLeaderQuest` - Rescue an imprisoned leader from another faction
+
+### Expansion Quests
+- `ExpandToProvincesQuest` - Expand to control a certain number of provinces
+- `SpecificExpansionQuest` - Conquer a specific province
+- `BorderSecurityQuest` - Have troops in a border province
+
+### Prisoner Quests
+- `ExecutePrisonerQuest` - Execute a specific prisoner
+- `ExilePrisonerQuest` - Exile a specific prisoner
+- `ReleasePrisonerQuest` - Release a specific prisoner
+- `ReturnPrisonerQuest` - Return a prisoner to their faction
+- `ReleaseAllPrisonersQuest` - Release all prisoners
+
+### Province Order Quests
+- `DevelopProvincesQuest` - Maintain provinces in Develop order for months
+- `MobilizeProvincesQuest` - Maintain provinces in Mobilize order for months
+- `RestProvinceQuest` - Use the Rest command in a specific province
+
+### Reconnaissance Quests
+- `ReconProvincesQuest` - Reconnoiter a number of provinces
+- `ReconSpecificProvincesQuest` - Reconnoiter specific provinces
+
+### Economic Quests
+- `TotalDevelopmentQuest` - Achieve total development level in a province
+- `WealthQuest` - Accumulate gold and food
+- `SpendOnFeastsQuest` - Spend gold on feasts
+- `SendSuppliesQuest` - Send food to a specific province
+- `RepairDevastationQuest` - Repair devastation
+
+### Special Event Quests
+- `SuppressRiotByForceQuest` - Suppress a riot by force
+- `FightBeastsAloneQuest` - Fight beasts alone
+- `StartBlizzardQuest` - Start a blizzard in a province
+- `StartEpidemicQuest` - Start an epidemic in a province
+- `ApprehendOutlawQuest` - Apprehend an outlaw hero
+
+### Miscellaneous
+- `BattalionDiversityQuest` - Have diverse battalion types
+- `SwearBrotherhoodWithHeroQuest` - Swear brotherhood with a specific hero
+- `BetrayAllyQuest` - Betray an allied faction
+
+## Implementation Details
+
+The quest completion logic is located in:
+- `FulfillQuestsCommandSelector.scala` - Main entry point, iterates through choosers
+- `quest_command_selectors/` - Individual quest handlers
+
+Each chooser extends either:
+- `QuestCommandChooser` - For quests requiring randomness
+- `DeterministicQuestCommandChooser` - For quests with deterministic command selection
+
+The AI prioritizes quests in the order they appear in `FulfillQuestsCommandSelector.choosers`:
+1. Alliance
+2. TruceWithFaction
+3. Improve (Agriculture/Economy/Infrastructure)
+4. AlmsToProvince
+5. GiveToHeroesInProvince
+6. AlmsAcrossRealm
+7. GiveToHeroesAcrossRealm
+8. TruceCount
+9. DismissSpecificVassal
@@ -0,0 +1,230 @@
+# Plan: Eliminate Battalion Backstory LLM Updates
+
+## Goal
+
+Dramatically reduce LLM request volume by eliminating battalion backstory updates. Battalions will retain:
+- An **initial backstory** (generated once when created)
+- A **history of events** (structured data, not LLM-generated prose)
+
+The history will be fed into other LLM updates (hero backstories, chronicle) but will no longer be regenerated into prose for each battalion.
+
+## Current System Overview
+
+### Data Flow
+```
+Battalion Created → Initial Backstory LLM Request → Text stored
+                                    ↓
+Battalion participates in events → Events accumulated → Update LLM Request → New text version
+                                    ↓
+BattalionView.backstoryTextId → Client displays on hover
+```
+
+### Event Types (8 total)
+Events are structured data already captured in `EventForBattalionBackstory`:
+- OrganizedTroops, SuppressedBeasts, ApprehendedOutlaws, FoughtInBattle
+- SuppressedRiot, Trained, Armed, SurvivedStarvation
+
+Each event has date, province, hero, and event-specific details.
+
+### Key Files
+
+| Component | File |
+|-----------|------|
+| Unity Display | `Assets/Eagle/HeroesAndBattalionsPanelController.cs` |
+| View Proto | `views/battalion_view.proto` |
+| View Filter | `BattalionViewFilter.scala` |
+| Update Action | `BattalionBackstoryUpdateAction.scala` |
+| Update Generator | `BattalionBackstoryUpdateActionGenerator.scala` |
+| Update Prompt | `BattalionBackstoryUpdatePromptGenerator.scala` |
+| Event-to-Text | `BattalionBackstoryUpdatePromptGenerator.textForEvent()` |
+| BattalionDescriptions | `BattalionDescriptions.scala` (used in other LLM prompts) |
+
+---
+
+## Stage 1: Stop Displaying Battalion Backstories in Client
+
+**Goal:** Remove the UI that shows battalion backstory text on hover.
+
+### Files to Modify
+
+**`Assets/Eagle/HeroesAndBattalionsPanelController.cs`**
+- In `BattalionLongHoverRowChanged()` (lines 143-169):
+  - Remove or comment out the backstory text population
+  - Keep the header/name display, remove `battalionPopupPanelBackstory.TextId = ...`
+
+**Unity Scene/Prefab**
+- Hide or remove the `battalionPopupPanelBackstory` UI element
+
+### Verification
+- [ ] Battalion hover popup no longer shows backstory text
+- [ ] No errors when hovering over battalions
+- [ ] Other battalion info (name, type, size) still displays
+
+---
+
+## Stage 2: Stop Populating Backstory in BattalionView
+
+**Goal:** Stop sending backstory text ID to the client.
+
+### Files to Modify
+
+**`BattalionViewFilter.scala`**
+- In `filteredBattalionViewBelongingToPlayer()`:
+  - Set `backstoryTextId = ""` instead of `battalion.backstoryTextId`
+- In `limitedBattalionView()`:
+  - Same change
+
+### Verification
+- [ ] BattalionView messages have empty backstoryTextId
+- [ ] Client handles empty backstoryTextId gracefully (Stage 1 should have removed the display)
+
+---
+
+## Stage 3: Remove backstory_text_id from BattalionView Proto
+
+**Goal:** Clean up the proto schema.
+
+### Files to Modify
+
+**`views/battalion_view.proto`**
+- Remove field: `string backstory_text_id = 7;`
+- Mark field 7 as reserved to prevent reuse
+
+**`Assets/Eagle/HeroesAndBattalionsPanelController.cs`**
+- Remove any remaining references to `BackstoryTextId`
+
+**`BattalionViewFilter.scala`**
+- Remove `backstoryTextId` from view construction
+
+### Verification
+- [ ] Proto compiles
+- [ ] C# client compiles without BackstoryTextId references
+- [ ] Full test suite passes
+
+---
+
+## Stage 4: Replace Backstory Usage in BattalionDescriptions
+
+**Goal:** When other LLM prompts need battalion context, use initial backstory + structured history instead of the latest LLM-generated prose.
+
+### Current Usage in `BattalionDescriptions.scala`
+
+```scala
+def backstoryText(): TextGenerationResult =
+  battalion.backstoryVersions.lastOption
+    .map(v => clientTextStore.getText(v.textId))
+    .getOrElse(TextGenerationSuccess(""))
+
+def fullDescription(): String =
+  s"${battalion.name} is $description. $backstoryText"
+```
+
+### New Approach
+
+Create `historyDescription()` that:
+1. Gets initial backstory (first version's text, if available)
+2. Appends structured event history using the same `textForEvent()` logic from `BattalionBackstoryUpdatePromptGenerator`
+
+```scala
+def historyDescription(): String = {
+  val initialBackstory = battalion.backstoryVersions.headOption
+    .map(v => clientTextStore.getText(v.textId))
+    .collect { case TextGenerationSuccess(text) => text }
+    .getOrElse("")
+
+  val eventHistory = battalion.backstoryEvents
+    .map(textForEvent)  // Reuse existing event-to-text conversion
+    .mkString(" ")
+
+  if eventHistory.isEmpty then initialBackstory
+  else s"$initialBackstory $eventHistory"
+}
+```
+
+### Files to Modify
+
+**`BattalionDescriptions.scala`**
+- Add `historyDescription()` method
+- Update `fullDescription()` to use `historyDescription()` instead of `backstoryText()`
+- Keep `textForEvent()` logic (move from `BattalionBackstoryUpdatePromptGenerator` if needed)
+
+**Move/refactor `textForEvent()`**
+- Currently in `BattalionBackstoryUpdatePromptGenerator.scala` (lines 78-262)
+- Move to `BattalionDescriptions.scala` or a shared utility
+- This converts events to human-readable text without LLM
+
+### Verification
+- [ ] Other LLM prompts that use `BattalionDescriptions` still get meaningful context
+- [ ] Chronicle updates include battalion history
+- [ ] Hero backstory updates include relevant battalion history
+
+---
+
+## Stage 5: Stop Generating Battalion Backstory Updates
+
+**Goal:** Remove the LLM request generation entirely.
+
+### Files to Modify
+
+**`BattalionBackstoryUpdateActionGenerator.scala`**
+- Return empty Vector instead of generating actions
+- Or delete the file entirely
+
+**`BattalionBackstoryUpdateAction.scala`**
+- Delete or mark as deprecated
+
+**`BattalionBackstoryUpdatePromptGenerator.scala`**
+- Delete or keep only `textForEvent()` if moved
+
+**`LlmResolver.scala`**
+- Remove case for `BattalionBackstoryUpdateRequest`
+- Optionally throw error if somehow called
+
+**`EndPlayerCommandsPhaseAction.scala`** (and other callers)
+- Find where `BattalionBackstoryUpdateActionGenerator` is called
+- Remove those calls
+
+### Files to Search for Callers
+```bash
+grep -r "BattalionBackstoryUpdateAction" src/
+```
+
+### Verification
+- [ ] No `BattalionBackstoryUpdateRequest` LLM requests generated
+- [ ] Battalions still accumulate events (for history description)
+- [ ] Full test suite passes
+- [ ] Game runs without errors
+
+---
+
+## Future Considerations
+
+### Keep or Remove Initial Backstory Generation?
+The initial backstory (`BattalionInitialBackstoryRequest`) is generated once per battalion. Options:
+1. **Keep it** - Low volume, provides flavor text for history
+2. **Remove it** - Use a template-based approach instead
+
+Recommendation: Keep for now, evaluate later based on volume.
+
+### Event History Cleanup
+Events currently accumulate forever on battalions. Consider:
+- Capping event history length
+- Summarizing old events
+- Only keeping "significant" events
+
+### Affected Tests
+Search for tests that verify backstory update behavior:
+```bash
+bazel query 'tests(//src/test/scala/...) intersect rdeps(//src/test/scala/..., //src/main/scala/net/eagle0/eagle/library/actions/impl/action:battalion_backstory_update_action)'
+```
+
+---
+
+## Summary of LLM Request Reduction
+
+| Request Type | Current Volume | After Change |
+|--------------|---------------|--------------|
+| BattalionInitialBackstoryRequest | 1 per battalion | 1 per battalion (unchanged) |
+| BattalionBackstoryUpdateRequest | ~N per battalion per game | **0** |
+
+For a typical game with ~50 battalions and ~20 rounds, this could eliminate **hundreds** of LLM requests.
@@ -0,0 +1,93 @@
+# Province Event 3D Effects
+
+Ideas for replacing 2D shader-based province event effects with 3D particle systems.
+
+## Current State
+
+| Event | Effect Type | Notes |
+|-------|-------------|-------|
+| Festival | 3D particles | Complete |
+| Epidemic | 3D particles | Complete (rising skulls + green haze) |
+| Blizzard | 2D shader | Not visible on unowned (white) provinces |
+| Drought | 2D shader | |
+| Flood | 2D shader | |
+| Beasts | None | Tricky - can be any animal or human |
+
+## Proposed 3D Effects
+
+### Blizzard
+
+- Falling snowflakes with slight blue tint (ensures visibility on white backgrounds)
+- Diagonal wind-blown particles to convey harsh weather
+- Swirling vortex effect near ground level
+- Frosty sparkle/glitter particles for magical winter feel
+
+### Drought
+
+- Rising dust/sand particles (tan/brown coloring)
+- Small dust devils (spinning particle columns)
+- Shimmering golden particles rising to suggest heat distortion
+- Dried leaves/debris blowing across the province
+
+### Flood
+
+- Rain falling (blue-tinted streaks or droplets)
+- Water splashes/ripples rising from ground
+- Mist/spray particles hovering low
+- Floating debris particles (leaves, sticks)
+
+### Beasts
+
+This is challenging since "beasts" can represent any dangerous creature. Universal approaches:
+
+- **Circling vultures/crows overhead** - Predators attract scavengers; works for any beast type and is visually distinctive
+- Dust clouds suggesting movement at province edges
+- Glowing eyes appearing/disappearing in shadows
+- Stylized claw/scratch mark effects
+- Paw prints materializing on the ground
+- Red "danger" aura pulsing from ground level
+
+The vultures/crows approach is recommended as the most universal solution.
+
+## Implementation Status
+
+Controllers have been created for all 4 event types:
+- `ProvinceBlizzardController.cs` - ready, needs prefab
+- `ProvinceDroughtController.cs` - ready, needs prefab
+- `ProvinceFloodController.cs` - ready, needs prefab
+- `ProvinceBeastsController.cs` - ready, needs prefab
+
+### Prefabs Needed
+
+Create these prefabs in `Assets/Eagle/Effects/`:
+
+1. **BlizzardEffect.prefab**
+   - Particle System with falling snowflakes
+   - Blue-tinted particles for visibility on white
+   - Diagonal velocity for wind effect
+   - RectTransform for UI positioning
+
+2. **DroughtEffect.prefab**
+   - Particle System with rising dust particles
+   - Tan/brown coloring
+   - Upward velocity
+   - Optional spinning sub-emitters for dust devils
+
+3. **FloodEffect.prefab**
+   - Particle System with falling rain streaks
+   - Blue tint
+   - Fast downward velocity
+   - Optional splash sub-emitter
+
+4. **BeastsEffect.prefab**
+   - Particle System with bird silhouettes
+   - Circular orbit motion around center
+   - Black/dark particles
+   - Could use a crow/vulture sprite texture
+
+### Scene Setup
+
+Wire up in `Gameplay.unity`:
+1. Add controller components to the Map GameObject
+2. Assign `mapContainer`, `centroidsJson` (shared with other controllers)
+3. Assign the effect prefab for each controller
@@ -0,0 +1,5 @@
+# Export BUILD files for use with http_archive build_file attribute
+exports_files([
+    "BUILD.gtl",
+    "BUILD.llvm_mingw",
+])
@@ -1,21 +1,228 @@
 {
  "__AUTOGENERATED_FILE_DO_NOT_MODIFY_THIS_FILE_MANUALLY": "THERE_IS_NO_DATA_ONLY_ZUUL",
-  "__INPUT_ARTIFACTS_HASH": 434250008,
-  "__RESOLVED_ARTIFACTS_HASH": -824975294,
+  "__INPUT_ARTIFACTS_HASH": {
+    "com.amazonaws:aws-lambda-java-core": -2008008480,
+    "com.amazonaws:aws-lambda-java-events": 904769795,
+    "com.google.android:annotations": 1910180409,
+    "com.google.api.grpc:proto-google-common-protos": -2106826238,
+    "com.google.auth:google-auth-library-credentials": 1149797254,
+    "com.google.auth:google-auth-library-oauth2-http": -2102758232,
+    "com.google.auto.value:auto-value": 1146221104,
+    "com.google.auto.value:auto-value-annotations": -1101276935,
+    "com.google.code.findbugs:jsr305": 495355163,
+    "com.google.code.gson:gson": 1675696798,
+    "com.google.errorprone:error_prone_annotations": 692295270,
+    "com.google.guava:failureaccess": 1582410452,
+    "com.google.guava:guava": 174556251,
+    "com.google.j2objc:j2objc-annotations": 2003271689,
+    "com.google.protobuf:protobuf-java": -1795397632,
+    "com.google.protobuf:protobuf-java-util": -1033086717,
+    "com.google.re2j:re2j": 1525409503,
+    "com.google.s2a.proto.v2:s2a-proto": 898932763,
+    "com.google.truth:truth": 1696781452,
+    "com.nimbusds:nimbus-jose-jwt": 200797458,
+    "com.squareup.okhttp3:okhttp": 916942239,
+    "com.squareup.okhttp3:okhttp-sse": 1714840279,
+    "com.squareup.okhttp:okhttp": -1467174407,
+    "com.squareup.okio:okio": 795722926,
+    "com.thesamet.scalapb:compilerplugin_3": -756207945,
+    "com.thesamet.scalapb:lenses_3": 1060875741,
+    "com.thesamet.scalapb:protoc-bridge_3": -1260006911,
+    "com.thesamet.scalapb:scalapb-json4s_3": -772830803,
+    "com.thesamet.scalapb:scalapb-runtime-grpc_3": 908736225,
+    "com.thesamet.scalapb:scalapb-runtime_3": 1652882204,
+    "io.netty:netty-buffer": -36891658,
+    "io.netty:netty-codec": -1968637428,
+    "io.netty:netty-codec-http": 2069139895,
+    "io.netty:netty-codec-http2": 980426895,
+    "io.netty:netty-codec-socks": -1802651606,
+    "io.netty:netty-common": -644663253,
+    "io.netty:netty-handler": 1555108312,
+    "io.netty:netty-handler-proxy": -964658153,
+    "io.netty:netty-resolver": -1317606544,
+    "io.netty:netty-tcnative-boringssl-static": 2033070843,
+    "io.netty:netty-tcnative-classes": 2023773715,
+    "io.netty:netty-transport": 1563151065,
+    "io.netty:netty-transport-native-epoll": -1215800119,
+    "io.netty:netty-transport-native-unix-common": -818773192,
+    "io.opencensus:opencensus-api": 2042364617,
+    "io.opencensus:opencensus-contrib-grpc-metrics": 317094357,
+    "io.perfmark:perfmark-api": 1019157794,
+    "io.sentry:sentry": -947045362,
+    "javax.xml.bind:jaxb-api": -1735500680,
+    "junit:junit": -744267592,
+    "org.checkerframework:checker-qual": -819031361,
+    "org.codehaus.mojo:animal-sniffer-annotations": -1634689353,
+    "org.json4s:json4s-ast_3": 687176866,
+    "org.json4s:json4s-core_3": 977579605,
+    "org.json4s:json4s-native_3": -123383795,
+    "org.reactivestreams:reactive-streams": 509083534,
+    "org.scalamock:scalamock_3": -610483078,
+    "org.slf4j:slf4j-api": 1609745898,
+    "org.slf4j:slf4j-simple": 1319506696,
+    "org.xerial:sqlite-jdbc": -1707012205,
+    "repositories": -1949687017,
+    "software.amazon.awssdk:aws-core": 1764800397,
+    "software.amazon.awssdk:http-client-spi": 1697477859,
+    "software.amazon.awssdk:regions": -663595789,
+    "software.amazon.awssdk:s3": -544649668,
+    "software.amazon.awssdk:s3-transfer-manager": -1414083014,
+    "software.amazon.awssdk:sdk-core": -1921023350,
+    "software.amazon.awssdk:utils": 1323800129
+  },
+  "__RESOLVED_ARTIFACTS_HASH": {
+    "com.amazonaws:aws-lambda-java-core": 930138565,
+    "com.amazonaws:aws-lambda-java-events": 582075020,
+    "com.fasterxml.jackson.core:jackson-annotations": 1276887193,
+    "com.fasterxml.jackson.core:jackson-core": 439118590,
+    "com.fasterxml.jackson.core:jackson-databind": 1897319963,
+    "com.github.stephenc.jcip:jcip-annotations": 2084352561,
+    "com.google.android:annotations": 2096496032,
+    "com.google.api.grpc:proto-google-common-protos": 2069379049,
+    "com.google.api:api-common": -597713164,
+    "com.google.auth:google-auth-library-credentials": -366937256,
+    "com.google.auth:google-auth-library-oauth2-http": -472658017,
+    "com.google.auto.value:auto-value": 1110951021,
+    "com.google.auto.value:auto-value-annotations": 641018093,
+    "com.google.code.findbugs:jsr305": 870839855,
+    "com.google.code.gson:gson": 614185888,
+    "com.google.errorprone:error_prone_annotations": -1097264484,
+    "com.google.guava:failureaccess": -718864417,
+    "com.google.guava:guava": 631608943,
+    "com.google.guava:listenablefuture": 1079558157,
+    "com.google.http-client:google-http-client": 418651909,
+    "com.google.http-client:google-http-client-gson": -48153131,
+    "com.google.j2objc:j2objc-annotations": -404209759,
+    "com.google.protobuf:protobuf-java": 1668417350,
+    "com.google.protobuf:protobuf-java-util": 1986864820,
+    "com.google.re2j:re2j": -1688126233,
+    "com.google.s2a.proto.v2:s2a-proto": 1518288545,
+    "com.google.truth:truth": -1338076935,
+    "com.nimbusds:nimbus-jose-jwt": -1437437976,
+    "com.squareup.okhttp3:okhttp": 1262276211,
+    "com.squareup.okhttp3:okhttp-sse": 505395183,
+    "com.squareup.okhttp:okhttp": -1958498367,
+    "com.squareup.okio:okio": -993505667,
+    "com.squareup.okio:okio-jvm": 2073967287,
+    "com.thesamet.scalapb:compilerplugin_3": -1711749067,
+    "com.thesamet.scalapb:lenses_3": 81185934,
+    "com.thesamet.scalapb:protoc-bridge_2.13": -1602581734,
+    "com.thesamet.scalapb:protoc-bridge_3": -350123056,
+    "com.thesamet.scalapb:protoc-gen_2.13": -1004483995,
+    "com.thesamet.scalapb:scalapb-json4s_3": -1395179337,
+    "com.thesamet.scalapb:scalapb-runtime-grpc_3": 1440887312,
+    "com.thesamet.scalapb:scalapb-runtime_3": -298320448,
+    "commons-codec:commons-codec": 1208138832,
+    "commons-logging:commons-logging": 1248790901,
+    "dev.dirs:directories": 513669062,
+    "io.grpc:grpc-api": 1519481799,
+    "io.grpc:grpc-context": 1273832094,
+    "io.grpc:grpc-protobuf": -1491986464,
+    "io.grpc:grpc-protobuf-lite": 1996390382,
+    "io.grpc:grpc-stub": 206724158,
+    "io.netty:netty-buffer": 1883825690,
+    "io.netty:netty-codec": 1759679007,
+    "io.netty:netty-codec-http": -965628835,
+    "io.netty:netty-codec-http2": -631439859,
+    "io.netty:netty-codec-socks": 1385966058,
+    "io.netty:netty-common": -1574327641,
+    "io.netty:netty-handler": 1812678974,
+    "io.netty:netty-handler-proxy": 452260541,
+    "io.netty:netty-resolver": -656912885,
+    "io.netty:netty-tcnative-boringssl-static": -1618728145,
+    "io.netty:netty-tcnative-boringssl-static:jar:linux-aarch_64": -46670590,
+    "io.netty:netty-tcnative-boringssl-static:jar:linux-x86_64": -323938727,
+    "io.netty:netty-tcnative-boringssl-static:jar:osx-aarch_64": 1027623299,
+    "io.netty:netty-tcnative-boringssl-static:jar:osx-x86_64": -322798677,
+    "io.netty:netty-tcnative-boringssl-static:jar:windows-x86_64": 1803328375,
+    "io.netty:netty-tcnative-classes": -498572591,
+    "io.netty:netty-transport": 764254626,
+    "io.netty:netty-transport-classes-epoll": 1006952729,
+    "io.netty:netty-transport-native-epoll:jar:linux-x86_64": -737288378,
+    "io.netty:netty-transport-native-unix-common": -1442019057,
+    "io.opencensus:opencensus-api": 516564413,
+    "io.opencensus:opencensus-contrib-grpc-metrics": -412818674,
+    "io.opencensus:opencensus-contrib-http-util": 1093902672,
+    "io.perfmark:perfmark-api": -1795841558,
+    "io.sentry:sentry": 1818358364,
+    "javax.activation:javax.activation-api": 1384047725,
+    "javax.annotation:javax.annotation-api": -1009230154,
+    "javax.xml.bind:jaxb-api": 238614541,
+    "joda-time:joda-time": -926621536,
+    "junit:junit": -1256429642,
+    "org.apache.httpcomponents:httpclient": 546847276,
+    "org.apache.httpcomponents:httpcore": 67453319,
+    "org.checkerframework:checker-qual": 1860567376,
+    "org.codehaus.mojo:animal-sniffer-annotations": -1201443841,
+    "org.hamcrest:hamcrest-core": 649657847,
+    "org.jetbrains.kotlin:kotlin-stdlib": -879725260,
+    "org.jetbrains.kotlin:kotlin-stdlib-common": 393704220,
+    "org.jetbrains.kotlin:kotlin-stdlib-jdk7": 1242909803,
+    "org.jetbrains.kotlin:kotlin-stdlib-jdk8": -597817274,
+    "org.jetbrains:annotations": 554168982,
+    "org.json4s:json4s-ast_3": -1000402007,
+    "org.json4s:json4s-core_3": -1662557228,
+    "org.json4s:json4s-jackson-core_3": -1868355082,
+    "org.json4s:json4s-native-core_3": 227547325,
+    "org.json4s:json4s-native_3": 1646180259,
+    "org.jspecify:jspecify": 117231129,
+    "org.ow2.asm:asm": 611381606,
+    "org.reactivestreams:reactive-streams": 1281941191,
+    "org.scala-lang.modules:scala-collection-compat_3": 1599811889,
+    "org.scala-lang:scala-library": -1079389784,
+    "org.scala-lang:scala3-library_3": -212752345,
+    "org.scalamock:scalamock_3": -1778657085,
+    "org.slf4j:slf4j-api": -771685699,
+    "org.slf4j:slf4j-simple": -776509812,
+    "org.xerial:sqlite-jdbc": 1311600081,
+    "software.amazon.awssdk:annotations": -324257201,
+    "software.amazon.awssdk:apache-client": 2066024214,
+    "software.amazon.awssdk:arns": -1240703529,
+    "software.amazon.awssdk:auth": 1612047768,
+    "software.amazon.awssdk:aws-core": -62367447,
+    "software.amazon.awssdk:aws-query-protocol": 570551548,
+    "software.amazon.awssdk:aws-xml-protocol": -1850136736,
+    "software.amazon.awssdk:checksums": -238416593,
+    "software.amazon.awssdk:checksums-spi": 807336878,
+    "software.amazon.awssdk:crt-core": 280528066,
+    "software.amazon.awssdk:endpoints-spi": -241689351,
+    "software.amazon.awssdk:http-auth": 236194098,
+    "software.amazon.awssdk:http-auth-aws": -385949349,
+    "software.amazon.awssdk:http-auth-aws-eventstream": -408169305,
+    "software.amazon.awssdk:http-auth-spi": 211732368,
+    "software.amazon.awssdk:http-client-spi": -1646055035,
+    "software.amazon.awssdk:identity-spi": 90960913,
+    "software.amazon.awssdk:json-utils": 740192539,
+    "software.amazon.awssdk:metrics-spi": 692846272,
+    "software.amazon.awssdk:netty-nio-client": 94159754,
+    "software.amazon.awssdk:profiles": 1441805445,
+    "software.amazon.awssdk:protocol-core": 204998161,
+    "software.amazon.awssdk:regions": 407633714,
+    "software.amazon.awssdk:retries": 1892797724,
+    "software.amazon.awssdk:retries-spi": -2126209698,
+    "software.amazon.awssdk:s3": -829433125,
+    "software.amazon.awssdk:s3-transfer-manager": 761695256,
+    "software.amazon.awssdk:sdk-core": 78965981,
+    "software.amazon.awssdk:third-party-jackson-core": 24776375,
+    "software.amazon.awssdk:utils": -1896886996,
+    "software.amazon.awssdk:utils-lite": -446744113,
+    "software.amazon.eventstream:eventstream": 666815114
+  },
  "conflict_resolution": {
    "com.google.guava:failureaccess:1.0.1": "com.google.guava:failureaccess:1.0.2",
+    "com.google.j2objc:j2objc-annotations:2.8": "com.google.j2objc:j2objc-annotations:3.0.0",
+    "com.google.protobuf:protobuf-java:4.27.2": "com.google.protobuf:protobuf-java:4.28.2",
    "com.squareup.okio:okio:2.10.0": "com.squareup.okio:okio:3.6.0",
-    "io.netty:netty-buffer:4.1.110.Final": "io.netty:netty-buffer:4.1.130.Final",
-    "io.netty:netty-codec-http2:4.1.110.Final": "io.netty:netty-codec-http2:4.1.130.Final",
-    "io.netty:netty-codec-http:4.1.110.Final": "io.netty:netty-codec-http:4.1.130.Final",
-    "io.netty:netty-codec:4.1.110.Final": "io.netty:netty-codec:4.1.130.Final",
-    "io.netty:netty-common:4.1.110.Final": "io.netty:netty-common:4.1.130.Final",
-    "io.netty:netty-handler:4.1.110.Final": "io.netty:netty-handler:4.1.130.Final",
-    "io.netty:netty-resolver:4.1.110.Final": "io.netty:netty-resolver:4.1.130.Final",
-    "io.netty:netty-transport-native-unix-common:4.1.110.Final": "io.netty:netty-transport-native-unix-common:4.1.130.Final",
-    "io.netty:netty-transport:4.1.110.Final": "io.netty:netty-transport:4.1.130.Final",
-    "io.opencensus:opencensus-api:0.31.0": "io.opencensus:opencensus-api:0.31.1",
-    "org.checkerframework:checker-qual:3.12.0": "org.checkerframework:checker-qual:3.43.0"
+    "io.netty:netty-buffer:4.1.127.Final": "io.netty:netty-buffer:4.1.130.Final",
+    "io.netty:netty-codec-http2:4.1.127.Final": "io.netty:netty-codec-http2:4.1.130.Final",
+    "io.netty:netty-codec-http:4.1.127.Final": "io.netty:netty-codec-http:4.1.130.Final",
+    "io.netty:netty-codec:4.1.127.Final": "io.netty:netty-codec:4.1.130.Final",
+    "io.netty:netty-common:4.1.127.Final": "io.netty:netty-common:4.1.130.Final",
+    "io.netty:netty-handler:4.1.127.Final": "io.netty:netty-handler:4.1.130.Final",
+    "io.netty:netty-resolver:4.1.127.Final": "io.netty:netty-resolver:4.1.130.Final",
+    "io.netty:netty-transport-native-unix-common:4.1.127.Final": "io.netty:netty-transport-native-unix-common:4.1.130.Final",
+    "io.netty:netty-transport:4.1.127.Final": "io.netty:netty-transport:4.1.130.Final",
+    "io.opencensus:opencensus-api:0.31.0": "io.opencensus:opencensus-api:0.31.1"
  },
  "artifacts": {
    "com.amazonaws:aws-lambda-java-core": {
@@ -62,21 +269,27 @@
    },
    "com.google.api.grpc:proto-google-common-protos": {
      "shasums": {
-        "jar": "0b27938f3d28ccd6884945d7e4f75f4e26a677bbf3cd39bbcb694f130f782aa9"
+        "jar": "352ffc769f4d17e2d6227b6893ec368f4f07fbb069dd7aaa644b16949369f8b7"
      },
-      "version": "2.51.0"
+      "version": "2.63.1"
+    },
+    "com.google.api:api-common": {
+      "shasums": {
+        "jar": "f7073fb389c2aa329981ee65241db7947e8744c988e6c4d975f18bf2748b935a"
+      },
+      "version": "2.53.0"
    },
    "com.google.auth:google-auth-library-credentials": {
      "shasums": {
-        "jar": "5dbf1207d14e093f67995f457cb69c3cf49bed1364150b23465e09acada65d96"
+        "jar": "dd7e39b8f5c366b09f8c2d400b7b63c925499df813b0f0d78044abd72098e159"
      },
-      "version": "1.24.1"
+      "version": "1.40.0"
    },
    "com.google.auth:google-auth-library-oauth2-http": {
      "shasums": {
-        "jar": "88a75cd4448ea2f3b46e48a89497a6cf0985a5fa4e21274af4940e07f59f6eaf"
+        "jar": "67fe2c9df9780d8725c1dff61d2ffbbcb93fdcf15e91c44a5e610a4a69afd151"
      },
-      "version": "1.24.1"
+      "version": "1.40.0"
    },
    "com.google.auto.value:auto-value": {
      "shasums": {
@@ -128,15 +341,15 @@
    },
    "com.google.http-client:google-http-client": {
      "shasums": {
-        "jar": "390618d7b51704240b8fd28e1230fa35d220f93f4b4ba80f63e38db00dacb09e"
+        "jar": "97a0666340956dbc96893bc8cf843a5b57367543f218feddad3ff433fbfdaa68"
      },
-      "version": "1.44.2"
+      "version": "2.0.2"
    },
    "com.google.http-client:google-http-client-gson": {
      "shasums": {
-        "jar": "1119b66685195310375b717de2215d6c5d14fa8ed9f57e07b4fecd461e7b9db7"
+        "jar": "37c8fd5c7869bc4abf3b3219c7e79cb566afa745559772e969c21595199600cd"
      },
-      "version": "1.44.2"
+      "version": "2.0.2"
    },
    "com.google.j2objc:j2objc-annotations": {
      "shasums": {
@@ -150,17 +363,29 @@
      },
      "version": "4.28.2"
    },
+    "com.google.protobuf:protobuf-java-util": {
+      "shasums": {
+        "jar": "a2665294d3e4675482bde593df8283f8c965f0207785e8e9b223f790644f5b08"
+      },
+      "version": "4.27.2"
+    },
    "com.google.re2j:re2j": {
      "shasums": {
        "jar": "7b52c72156dd7f98b3237a5b35c1d34fba381b21048c89208913ad80a45dfbd7"
      },
      "version": "1.8"
    },
+    "com.google.s2a.proto.v2:s2a-proto": {
+      "shasums": {
+        "jar": "3205a05a82003067fbbd28ec0381d4c75258c25eb772d37be62e8b12d0402936"
+      },
+      "version": "0.1.3"
+    },
    "com.google.truth:truth": {
      "shasums": {
-        "jar": "14c297bc64ca8bc15b6baf67f160627e4562ec91624797e312e907b431113508"
+        "jar": "a6409e90fdd6b31f239b0c02065c43b53e1b09c72f2e08c3a86d04fe5910cf4b"
      },
-      "version": "1.4.2"
+      "version": "1.4.5"
    },
    "com.nimbusds:nimbus-jose-jwt": {
      "shasums": {
@@ -266,33 +491,33 @@
    },
    "io.grpc:grpc-api": {
      "shasums": {
-        "jar": "b5120a11da5ce5ddfab019bbb69f5868529c9b5def1ba5b283251cc95fb3ba91"
+        "jar": "45faf2ac1bf2791e8fdabce53684a86b62c99b84cba26fb13a5ba3f4abf80d6c"
      },
-      "version": "1.68.0"
+      "version": "1.70.0"
    },
    "io.grpc:grpc-context": {
      "shasums": {
-        "jar": "4ab6efb9cbadc88f8dc723ada3a61785da367697373d4432aef5222312aa70f6"
+        "jar": "eb2824831c0ac03e741efda86b141aa863a481ebc4aaf5a5c1f13a481dbb40ff"
      },
-      "version": "1.60.1"
+      "version": "1.70.0"
    },
    "io.grpc:grpc-protobuf": {
      "shasums": {
-        "jar": "79704cf169ee27151fce4375a4d91fe828d276d921eef5a7f497d020b0a5d345"
+        "jar": "9b98039ed826604c46d6ac8f8a182d413d348ec6abe26467736b05aa92e7e1d3"
      },
-      "version": "1.68.0"
+      "version": "1.70.0"
    },
    "io.grpc:grpc-protobuf-lite": {
      "shasums": {
-        "jar": "60e92e148b4f86c06885afa79a86beb74bffcdcba47f8b65dc7010ba6701fa80"
+        "jar": "e7cc2ca8981672851cbebf83a24bfb93c1b2b058e75c1a817a757b914f33403d"
      },
-      "version": "1.68.0"
+      "version": "1.70.0"
    },
    "io.grpc:grpc-stub": {
      "shasums": {
-        "jar": "7c4090509cd6ea0432305f9397da21127b691905bdcf163a306bedb1c6f4ead7"
+        "jar": "5adaa1ec1f744b67ae14a8dbc39c9589c010fad0fd557b0a02966202e4d23a18"
      },
-      "version": "1.68.0"
+      "version": "1.70.0"
    },
    "io.netty:netty-buffer": {
      "shasums": {
@@ -320,9 +545,9 @@
    },
    "io.netty:netty-codec-socks": {
      "shasums": {
-        "jar": "976052a3c9bb280bc6d99f3a29e6404677cf958c3de05b205093d38c006b880c"
+        "jar": "d3d251f9239951a845f22e39191f95471fb2eb7951b9878ea4555ccac99529fb"
      },
-      "version": "4.1.110.Final"
+      "version": "4.1.127.Final"
    },
    "io.netty:netty-common": {
      "shasums": {
@@ -338,9 +563,9 @@
    },
    "io.netty:netty-handler-proxy": {
      "shasums": {
-        "jar": "ad54ab4fe9c47ef3e723d71251126db53e8db543871adb9eafc94446539eff52"
+        "jar": "2c0c8046e5d737e08f40a7c2907526648860d0434e125bd51de3c2cf390453fb"
      },
-      "version": "4.1.110.Final"
+      "version": "4.1.127.Final"
    },
    "io.netty:netty-resolver": {
      "shasums": {
@@ -350,20 +575,20 @@
    },
    "io.netty:netty-tcnative-boringssl-static": {
      "shasums": {
-        "jar": "3f7b4c3a51737965cd5b53777782c125784420458d96513cfac7412e4d1fa0c3",
-        "linux-aarch_64": "523c43f67ad9040d70f9494fc28eebf711d8c54e2aa30e3fd1a199c38740f53b",
-        "linux-x86_64": "3d773aac73fe40f5d04de37ce14a1f7abd27caf0b3bd8275884f5d2968b3e254",
-        "osx-aarch_64": "0454c53e65da6e253b2104d1ae26ecc79df4faf999e8924b659846b5bf41e996",
-        "osx-x86_64": "9c6a23335f296689fb3538bc49e4e280ff163675212c6fe01c9cf2a9273ee19a",
-        "windows-x86_64": "b3e3e0559df29a5624bcf529cb8e2bd9375c6d68164dda338e841677586a14c4"
+        "jar": "ec3b14ceff74c5d7e24a378e64074744cc5e7035c49cf6ca0a4e23dff9713d1f",
+        "linux-aarch_64": "11dfee82cfcb5c4f596271fe1d56a70fe77b4034e54162d0bd211623b540857f",
+        "linux-x86_64": "39ac6b1eb4ffc18d5fe9412cc6253a8954bafc8e3ca10109bc370490f73a3673",
+        "osx-aarch_64": "eef3fc7cdc5e2dc8c5cb50bae11443052bf1ee2f6e8b64378565746d1529f05e",
+        "osx-x86_64": "e3beaa3ebdb136569528c59aa826d771efadc0ac9db484c6c0e457fa5efd0f07",
+        "windows-x86_64": "5458b4b502763d49cd2e16c434312687178afac9c164cabf75c4a8bcecf7ac50"
      },
-      "version": "2.0.70.Final"
+      "version": "2.0.74.Final"
    },
    "io.netty:netty-tcnative-classes": {
      "shasums": {
-        "jar": "a79c1579313d4ad48a3ecc1d01a25da06d22d6449c3bcc369c2318749bcf55bc"
+        "jar": "194874cf723794dd409fd1e728cd91ffbcff0584d73b4d8a1ad0d69d04acf9b3"
      },
-      "version": "2.0.70.Final"
+      "version": "2.0.74.Final"
    },
    "io.netty:netty-transport": {
      "shasums": {
@@ -379,9 +604,9 @@
    },
    "io.netty:netty-transport-native-epoll": {
      "shasums": {
-        "linux-x86_64": "dcd60c6b3076af307ab877201a136e1f1066c9be809aaed827391a23909f9135"
+        "linux-x86_64": "3d03f27eea1cd23357a56a96e1eeedfeb3d74fa0ba4d5c36a862bd035056275b"
      },
-      "version": "4.1.110.Final"
+      "version": "4.1.127.Final"
    },
    "io.netty:netty-transport-native-unix-common": {
      "shasums": {
@@ -425,6 +650,12 @@
      },
      "version": "1.2.0"
    },
+    "javax.annotation:javax.annotation-api": {
+      "shasums": {
+        "jar": "e04ba5195bcd555dc95650f7cc614d151e4bcd52d29a10b8aa2197f3ab89ab9b"
+      },
+      "version": "1.3.2"
+    },
    "javax.xml.bind:jaxb-api": {
      "shasums": {
        "jar": "88b955a0df57880a26a74708bc34f74dcaf8ebf4e78843a28b50eae945732b06"
@@ -455,23 +686,17 @@
      },
      "version": "4.4.16"
    },
-    "org.apache.tomcat:annotations-api": {
-      "shasums": {
-        "jar": "253829d3c12b7381d1044fc22c6436cff025fe0d459e4a329413e560a7d0dd13"
-      },
-      "version": "6.0.53"
-    },
    "org.checkerframework:checker-qual": {
      "shasums": {
-        "jar": "3fbc2e98f05854c3df16df9abaa955b91b15b3ecac33623208ed6424640ef0f6"
+        "jar": "508c83c62c344f6f7ee28f47b88a8797d6116d043bfd1ca0576c828dd1df2880"
      },
-      "version": "3.43.0"
+      "version": "3.49.5"
    },
    "org.codehaus.mojo:animal-sniffer-annotations": {
      "shasums": {
-        "jar": "c720e6e5bcbe6b2f48ded75a47bccdb763eede79d14330102e0d352e3d89ed92"
+        "jar": "342f4d815eae69bb980620d0a622862709be37d38f47577675b42c739a962da9"
      },
-      "version": "1.24"
+      "version": "1.26"
    },
    "org.hamcrest:hamcrest-core": {
      "shasums": {
@@ -539,11 +764,17 @@
      },
      "version": "4.1.0-M8"
    },
+    "org.jspecify:jspecify": {
+      "shasums": {
+        "jar": "1fad6e6be7557781e4d33729d49ae1cdc8fdda6fe477bb0cc68ce351eafdfbab"
+      },
+      "version": "1.0.0"
+    },
    "org.ow2.asm:asm": {
      "shasums": {
-        "jar": "3c6fac2424db3d4a853b669f4e3d1d9c3c552235e19a319673f887083c2303a1"
+        "jar": "876eab6a83daecad5ca67eb9fcabb063c97b5aeb8cf1fca7a989ecde17522051"
      },
-      "version": "9.6"
+      "version": "9.8"
    },
    "org.reactivestreams:reactive-streams": {
      "shasums": {
@@ -587,6 +818,12 @@
      },
      "version": "2.0.16"
    },
+    "org.xerial:sqlite-jdbc": {
+      "shasums": {
+        "jar": "6dc7464e3803648d3ff18a7359bab6adf079fcd8495b18991f6f5edcb8ac6e3b"
+      },
+      "version": "3.46.1.0"
+    },
    "software.amazon.awssdk:annotations": {
      "shasums": {
        "jar": "ed03bb4ff78900307dc96bacdec70ddf80c17df3eb6761219573025649f08ff3"
@@ -791,10 +1028,19 @@
    "com.google.api.grpc:proto-google-common-protos": [
      "com.google.protobuf:protobuf-java"
    ],
+    "com.google.api:api-common": [
+      "com.google.auto.value:auto-value-annotations",
+      "com.google.code.findbugs:jsr305",
+      "com.google.errorprone:error_prone_annotations",
+      "com.google.j2objc:j2objc-annotations",
+      "javax.annotation:javax.annotation-api"
+    ],
    "com.google.auth:google-auth-library-oauth2-http": [
+      "com.google.api:api-common",
      "com.google.auth:google-auth-library-credentials",
      "com.google.auto.value:auto-value-annotations",
      "com.google.code.findbugs:jsr305",
+      "com.google.code.gson:gson",
      "com.google.errorprone:error_prone_annotations",
      "com.google.guava:guava",
      "com.google.http-client:google-http-client",
@@ -826,12 +1072,24 @@
      "com.google.code.gson:gson",
      "com.google.http-client:google-http-client"
    ],
+    "com.google.protobuf:protobuf-java-util": [
+      "com.google.code.findbugs:jsr305",
+      "com.google.code.gson:gson",
+      "com.google.errorprone:error_prone_annotations",
+      "com.google.guava:guava",
+      "com.google.j2objc:j2objc-annotations",
+      "com.google.protobuf:protobuf-java"
+    ],
+    "com.google.s2a.proto.v2:s2a-proto": [
+      "io.grpc:grpc-protobuf",
+      "io.grpc:grpc-stub"
+    ],
    "com.google.truth:truth": [
      "com.google.auto.value:auto-value-annotations",
      "com.google.errorprone:error_prone_annotations",
      "com.google.guava:guava",
      "junit:junit",
-      "org.checkerframework:checker-qual",
+      "org.jspecify:jspecify",
      "org.ow2.asm:asm"
    ],
    "com.nimbusds:nimbus-jose-jwt": [
@@ -919,7 +1177,8 @@
    "io.grpc:grpc-stub": [
      "com.google.errorprone:error_prone_annotations",
      "com.google.guava:guava",
-      "io.grpc:grpc-api"
+      "io.grpc:grpc-api",
+      "org.codehaus.mojo:animal-sniffer-annotations"
    ],
    "io.netty:netty-buffer": [
      "io.netty:netty-common"
@@ -1101,6 +1360,9 @@
    "org.slf4j:slf4j-simple": [
      "org.slf4j:slf4j-api"
    ],
+    "org.xerial:sqlite-jdbc": [
+      "org.slf4j:slf4j-api"
+    ],
    "software.amazon.awssdk:apache-client": [
      "commons-codec:commons-codec",
      "org.apache.httpcomponents:httpclient",
@@ -1409,11 +1671,17 @@
      "com.google.shopping.type",
      "com.google.type"
    ],
+    "com.google.api:api-common": [
+      "com.google.api.core",
+      "com.google.api.pathtemplate",
+      "com.google.api.resourcenames"
+    ],
    "com.google.auth:google-auth-library-credentials": [
      "com.google.auth"
    ],
    "com.google.auth:google-auth-library-oauth2-http": [
      "com.google.auth.http",
+      "com.google.auth.mtls",
      "com.google.auth.oauth2"
    ],
    "com.google.auto.value:auto-value": [
@@ -1531,9 +1799,15 @@
      "com.google.protobuf",
      "com.google.protobuf.compiler"
    ],
+    "com.google.protobuf:protobuf-java-util": [
+      "com.google.protobuf.util"
+    ],
    "com.google.re2j:re2j": [
      "com.google.re2j"
    ],
+    "com.google.s2a.proto.v2:s2a-proto": [
+      "com.google.s2a.proto.v2"
+    ],
    "com.google.truth:truth": [
      "com.google.common.truth"
    ],
@@ -1841,6 +2115,11 @@
    "javax.activation:javax.activation-api": [
      "javax.activation"
    ],
+    "javax.annotation:javax.annotation-api": [
+      "javax.annotation",
+      "javax.annotation.security",
+      "javax.annotation.sql"
+    ],
    "javax.xml.bind:jaxb-api": [
      "javax.xml.bind",
      "javax.xml.bind.annotation",
@@ -1937,13 +2216,6 @@
      "org.apache.http.ssl",
      "org.apache.http.util"
    ],
-    "org.apache.tomcat:annotations-api": [
-      "javax.annotation",
-      "javax.annotation.security",
-      "javax.ejb",
-      "javax.persistence",
-      "javax.xml.ws"
-    ],
    "org.checkerframework:checker-qual": [
      "org.checkerframework.checker.builder.qual",
      "org.checkerframework.checker.calledmethods.qual",
@@ -1958,12 +2230,14 @@
      "org.checkerframework.checker.interning.qual",
      "org.checkerframework.checker.lock.qual",
      "org.checkerframework.checker.mustcall.qual",
+      "org.checkerframework.checker.nonempty.qual",
      "org.checkerframework.checker.nullness.qual",
      "org.checkerframework.checker.optional.qual",
      "org.checkerframework.checker.propkey.qual",
      "org.checkerframework.checker.regex.qual",
      "org.checkerframework.checker.signature.qual",
      "org.checkerframework.checker.signedness.qual",
+      "org.checkerframework.checker.sqlquotes.qual",
      "org.checkerframework.checker.tainting.qual",
      "org.checkerframework.checker.units.qual",
      "org.checkerframework.common.aliasing.qual",
@@ -2051,6 +2325,9 @@
    "org.json4s:json4s-native_3": [
      "org.json4s.native"
    ],
+    "org.jspecify:jspecify": [
+      "org.jspecify.annotations"
+    ],
    "org.ow2.asm:asm": [
      "org.objectweb.asm",
      "org.objectweb.asm.signature"
@@ -2089,7 +2366,6 @@
      "scala.reflect",
      "scala.reflect.macros.internal",
      "scala.runtime",
-      "scala.runtime.java8",
      "scala.sys",
      "scala.sys.process",
      "scala.util",
@@ -2102,7 +2378,6 @@
      "scala.annotation",
      "scala.annotation.internal",
      "scala.annotation.unchecked",
-      "scala.compiletime",
      "scala.compiletime.ops",
      "scala.compiletime.testing",
      "scala.deriving",
@@ -2140,6 +2415,16 @@
    "org.slf4j:slf4j-simple": [
      "org.slf4j.simple"
    ],
+    "org.xerial:sqlite-jdbc": [
+      "org.sqlite",
+      "org.sqlite.core",
+      "org.sqlite.date",
+      "org.sqlite.javax",
+      "org.sqlite.jdbc3",
+      "org.sqlite.jdbc4",
+      "org.sqlite.nativeimage",
+      "org.sqlite.util"
+    ],
    "software.amazon.awssdk:annotations": [
      "software.amazon.awssdk.annotations"
    ],
@@ -2455,6 +2740,7 @@
      "com.github.stephenc.jcip:jcip-annotations",
      "com.google.android:annotations",
      "com.google.api.grpc:proto-google-common-protos",
+      "com.google.api:api-common",
      "com.google.auth:google-auth-library-credentials",
      "com.google.auth:google-auth-library-oauth2-http",
      "com.google.auto.value:auto-value",
@@ -2469,7 +2755,9 @@
      "com.google.http-client:google-http-client-gson",
      "com.google.j2objc:j2objc-annotations",
      "com.google.protobuf:protobuf-java",
+      "com.google.protobuf:protobuf-java-util",
      "com.google.re2j:re2j",
+      "com.google.s2a.proto.v2:s2a-proto",
      "com.google.truth:truth",
      "com.nimbusds:nimbus-jose-jwt",
      "com.squareup.okhttp3:okhttp",
@@ -2519,12 +2807,12 @@
      "io.perfmark:perfmark-api",
      "io.sentry:sentry",
      "javax.activation:javax.activation-api",
+      "javax.annotation:javax.annotation-api",
      "javax.xml.bind:jaxb-api",
      "joda-time:joda-time",
      "junit:junit",
      "org.apache.httpcomponents:httpclient",
      "org.apache.httpcomponents:httpcore",
-      "org.apache.tomcat:annotations-api",
      "org.checkerframework:checker-qual",
      "org.codehaus.mojo:animal-sniffer-annotations",
      "org.hamcrest:hamcrest-core",
@@ -2538,6 +2826,7 @@
      "org.json4s:json4s-jackson-core_3",
      "org.json4s:json4s-native-core_3",
      "org.json4s:json4s-native_3",
+      "org.jspecify:jspecify",
      "org.ow2.asm:asm",
      "org.reactivestreams:reactive-streams",
      "org.scala-lang.modules:scala-collection-compat_3",
@@ -2546,6 +2835,7 @@
      "org.scalamock:scalamock_3",
      "org.slf4j:slf4j-api",
      "org.slf4j:slf4j-simple",
+      "org.xerial:sqlite-jdbc",
      "software.amazon.awssdk:annotations",
      "software.amazon.awssdk:apache-client",
      "software.amazon.awssdk:arns",
@@ -2622,6 +2912,11 @@
        "org.slf4j.simple.SimpleServiceProvider"
      ]
    },
+    "org.xerial:sqlite-jdbc": {
+      "java.sql.Driver": [
+        "org.sqlite.JDBC"
+      ]
+    },
    "software.amazon.awssdk:apache-client": {
      "software.amazon.awssdk.http.SdkHttpService": [
        "software.amazon.awssdk.http.apache.ApacheSdkHttpService"
@@ -2638,5 +2933,5 @@
      ]
    }
  },
-  "version": "2"
+  "version": "3"
 }
@@ -2,7 +2,57 @@

 set -euxo pipefail

-/bin/echo "build protos"
-mkdir -p src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Plugins/Eagle0Protos/
-dotnet build src/main/csharp/net/eagle0/clients/unity/eagle0/protos/protos.csproj \
-    -o src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Plugins/Eagle0Protos/
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+UNITY_ROOT="$REPO_ROOT/src/main/csharp/net/eagle0/clients/unity/eagle0"
+OUTPUT_DIR="$UNITY_ROOT/Assets/GeneratedProtos"
+
+# All C# protobuf generation targets
+TARGETS=(
+    "//src/main/protobuf/net/eagle0/common:common_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/shardok/storage:storage_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/shardok/common:common_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/shardok/api:api_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/eagle/common:common_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/eagle/views:views_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/eagle/api:api_csharp_proto_srcs"
+    "//src/main/protobuf/net/eagle0/eagle/api:api_csharp_grpc_srcs"
+    "//src/main/protobuf/net/eagle0/eagle/api/command/util:util_csharp_proto_srcs"
+)
+
+# Subdirectory for each target (avoids filename collisions across packages)
+SUBDIRS=(
+    "net/eagle0/common"
+    "net/eagle0/shardok/storage"
+    "net/eagle0/shardok/common"
+    "net/eagle0/shardok/api"
+    "net/eagle0/eagle/common"
+    "net/eagle0/eagle/views"
+    "net/eagle0/eagle/api"
+    "net/eagle0/eagle/api"
+    "net/eagle0/eagle/api/command/util"
+)
+
+/bin/echo "Building C# protobuf sources..."
+bazel build "${TARGETS[@]}"
+
+/bin/echo "Copying generated .cs files to $OUTPUT_DIR..."
+rm -rf "$OUTPUT_DIR"
+
+for i in "${!TARGETS[@]}"; do
+    target="${TARGETS[$i]}"
+    subdir="${SUBDIRS[$i]}"
+
+    # Convert target label to bazel-bin path
+    # //src/main/protobuf/net/eagle0/common:common_csharp_proto_srcs
+    # -> bazel-bin/src/main/protobuf/net/eagle0/common/common_csharp_proto_srcs
+    target_path="${target#//}"
+    pkg="${target_path%%:*}"
+    name="${target_path##*:}"
+    bin_dir="$REPO_ROOT/bazel-bin/$pkg/$name"
+
+    dest_dir="$OUTPUT_DIR/$subdir"
+    mkdir -p "$dest_dir"
+    find "$bin_dir" -name "*.cs" -exec cp {} "$dest_dir/" \;
+done
+
+/bin/echo "Done. Generated C# proto sources in $OUTPUT_DIR"
@@ -2,6 +2,9 @@
 #
 # Build the SparklePlugin native library for Unity using Bazel
 #
+# The SparklePlugin is built in a separate Bazel workspace (sparkle_workspace/)
+# to avoid rules_swift version conflicts between grpc and rules_apple.
+#
 # Usage: build_sparkle_plugin.sh [output_dir]

 set -euo pipefail
@@ -11,12 +14,14 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"

 OUTPUT_DIR="${1:-$PROJECT_ROOT/src/main/csharp/net/eagle0/clients/unity/eagle0/Assets/Plugins/macOS}"

-echo "=== Building SparklePlugin with Bazel ==="
+echo "=== Building SparklePlugin with Bazel (from sparkle_workspace) ==="

-bazel build --config=mactools //src/main/objc/net/eagle0/sparkle:SparklePlugin
+# Build in the separate sparkle_workspace to avoid dependency conflicts
+cd "$PROJECT_ROOT/sparkle_workspace"
+bazel build //:SparklePlugin

 # Get the zip path from bazel
-ZIP_PATH=$(bazel cquery --config=mactools --output=files //src/main/objc/net/eagle0/sparkle:SparklePlugin 2>/dev/null)
+ZIP_PATH=$(bazel cquery --output=files //:SparklePlugin 2>/dev/null)

 echo "=== Extracting SparklePlugin.bundle ==="
 mkdir -p "$OUTPUT_DIR"
@@ -22,11 +22,31 @@ NC='\033[0m' # No Color
 MODE="${1:-check}"
 EXIT_CODE=0

+# Cache for expensive bazel query results
+LIBRARY_DEPS_CACHE=""
+MAIN_DEPS_CACHE=""
+
+# Get deps of library/ (cached)
+get_library_deps() {
+    if [ -z "$LIBRARY_DEPS_CACHE" ]; then
+        LIBRARY_DEPS_CACHE=$(bazel query 'deps(//src/main/scala/net/eagle0/eagle/library/...)' 2>/dev/null || true)
+    fi
+    echo "$LIBRARY_DEPS_CACHE"
+}
+
+# Get deps of src/main (cached)
+get_main_deps() {
+    if [ -z "$MAIN_DEPS_CACHE" ]; then
+        MAIN_DEPS_CACHE=$(bazel query 'deps(//src/main/...)' 2>/dev/null || true)
+    fi
+    echo "$MAIN_DEPS_CACHE"
+}
+
 # Rule 1: src/main should not depend on src/test
 check_main_depends_on_test() {
    echo -e "${YELLOW}Checking: src/main should not depend on src/test...${NC}"

-    violations=$(bazel query 'deps(//src/main/...) intersect //src/test/...' 2>/dev/null || true)
+    violations=$(get_main_deps | grep "^//src/test/" || true)

    if [ -n "$violations" ]; then
        echo -e "${RED}VIOLATION: src/main depends on src/test:${NC}"
@@ -43,7 +63,7 @@ check_main_depends_on_test() {
 check_library_depends_on_scala_proto() {
    echo -e "${YELLOW}Checking: library/ should not depend on Scala proto types...${NC}"

-    violations=$(bazel query 'deps(//src/main/scala/net/eagle0/eagle/library/...) intersect //src/main/protobuf/...' 2>/dev/null | grep "_scala_proto" || true)
+    violations=$(get_library_deps | grep "^//src/main/protobuf/.*_scala_proto$" || true)
    if [ -z "$violations" ]; then
        count=0
    else
@@ -65,7 +85,7 @@ check_library_depends_on_scala_proto() {
 check_library_depends_on_proto_converters() {
    echo -e "${YELLOW}Checking: library/ should not depend on proto_converters...${NC}"

-    violations=$(bazel query 'deps(//src/main/scala/net/eagle0/eagle/library/...) intersect //src/main/scala/net/eagle0/eagle/model/proto_converters/...' 2>/dev/null | grep "^//" || true)
+    violations=$(get_library_deps | grep "^//src/main/scala/net/eagle0/eagle/model/proto_converters/" || true)

    if [ -n "$violations" ]; then
        count=$(echo "$violations" | wc -l | tr -d ' ')
@@ -85,7 +105,8 @@ check_library_depends_on_proto_converters() {
 count_proto_deps() {
    echo -e "${YELLOW}=== Proto dependency counts ===${NC}"

-    scala_proto_results=$(bazel query 'deps(//src/main/scala/net/eagle0/eagle/library/...) intersect //src/main/protobuf/...' 2>/dev/null | grep "_scala_proto" || true)
+    library_deps=$(get_library_deps)
+    scala_proto_results=$(echo "$library_deps" | grep "^//src/main/protobuf/.*_scala_proto$" || true)
    if [ -z "$scala_proto_results" ]; then
        scala_proto_count=0
    else
@@ -94,7 +115,7 @@ count_proto_deps() {
    echo "library/ Scala proto deps: $scala_proto_count"

    # C++/Go proto deps are expected (map generation tools)
-    all_proto_count=$(bazel query 'deps(//src/main/scala/net/eagle0/eagle/library/...) intersect //src/main/protobuf/...' 2>/dev/null | wc -l | tr -d ' ')
+    all_proto_count=$(echo "$library_deps" | grep -c "^//src/main/protobuf/" || echo "0")
    echo "library/ all proto deps (includes C++/Go build tools): $all_proto_count"
 }

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash

 curl -L "https://docs.google.com/spreadsheets/d/1DHEsiv4cY4gE6AX3sVH82K__mpBD1aznIYCQwQxA_F0/export?gid=0&format=tsv" | tr -d '\r' > /tmp/names.tsv
-bazel run //src/main/scala/net/eagle0/util:name_list_checker -- /tmp/names.tsv > src/main/resources/net/eagle0/names.tsv
+bazel run //src/main/scala/net/eagle0/util:name_list_checker -- /tmp/names.tsv > /dev/null
 bazel run //src/main/scala/net/eagle0/util:name_list_json_maker -- /tmp/names.tsv > src/main/resources/net/eagle0/names.json
 curl -L "https://docs.google.com/spreadsheets/d/1NhvG73HKyVE36yGpkV2oJiSIXoNqQOYTr5ArLnucYL0/export?gid=0&format=tsv" | tr -d '\r' > src/main/resources/net/eagle0/shardok/battalionTypes.tsv
 curl -L "https://docs.google.com/spreadsheets/d/1pNWiyxIks2wJ1v7jRLFD24zrKHG2AfhC-nkWmQKQGN4/export?gid=0&format=tsv" | tr -d '\r' > src/main/resources/net/eagle0/eagle/heroes.tsv
@@ -373,6 +373,115 @@ send_email_fastmail() {
    echo "Email sent successfully"
 }

+# Generate player-friendly "What's New" summary
+# This creates a short summary suitable for in-game display
+generate_whats_new_summary() {
+    local pr_file="$1"
+    local output_file="/tmp/eagle0_whats_new_$$.txt"
+
+    echo "Generating player-friendly What's New summary..." >&2
+
+    # Create a prompt for player-facing summary
+    local prompt_file="/tmp/eagle0_whats_new_prompt_$$.txt"
+
+    cat > "$prompt_file" <<'WHATS_NEW_PROMPT'
+Based on these merged PRs, write a SHORT player-friendly summary.
+Focus only on changes players will notice. Ignore internal/technical changes.
+
+Output format (exactly this format, no markdown, no extra text):
+TITLE: (5-10 words describing the main change)
+DESCRIPTION: (1-2 sentences, what players can now do differently)
+CATEGORY: (one of: feature, improvement, fix, content)
+
+If there are multiple notable player-visible changes, pick the single most important one.
+If there are no player-visible changes at all, output exactly: NONE
+
+Examples of good output:
+TITLE: Bug Reporting
+DESCRIPTION: You can now report bugs directly from the Settings menu.
+CATEGORY: feature
+
+TITLE: Faster Reconnection
+DESCRIPTION: The game now reconnects more smoothly after network interruptions.
+CATEGORY: improvement
+
+Here are the merged PRs:
+
+WHATS_NEW_PROMPT
+
+    cat "$pr_file" >> "$prompt_file"
+
+    # Use Claude CLI to generate the summary
+    if ! command -v claude &> /dev/null; then
+        echo "NONE"
+        rm -f "$prompt_file"
+        return
+    fi
+
+    cat "$prompt_file" | claude --print > "$output_file" 2>/dev/null
+
+    rm -f "$prompt_file"
+
+    # Check if the output is NONE
+    if grep -q "^NONE$" "$output_file"; then
+        echo "NONE"
+        rm -f "$output_file"
+        return
+    fi
+
+    # Return the output
+    cat "$output_file"
+    rm -f "$output_file"
+}
+
+# URL encode a string for use in query parameters
+urlencode() {
+    local string="$1"
+    local strlen=${#string}
+    local encoded=""
+    local pos c o
+
+    for (( pos=0 ; pos<strlen ; pos++ )); do
+        c=${string:$pos:1}
+        case "$c" in
+            [-_.~a-zA-Z0-9] ) o="${c}" ;;
+            * )               printf -v o '%%%02x' "'$c"
+        esac
+        encoded+="${o}"
+    done
+    echo "${encoded}"
+}
+
+# Open the admin console with pre-populated what's new content
+open_whats_new_preview() {
+    local title="$1"
+    local description="$2"
+    local category="$3"
+
+    local encoded_title=$(urlencode "$title")
+    local encoded_desc=$(urlencode "$description")
+    local encoded_cat=$(urlencode "$category")
+
+    local preview_url="https://admin.eagle0.net/whats-new?preview=true&title=${encoded_title}&description=${encoded_desc}&category=${encoded_cat}"
+
+    echo ""
+    echo "=== What's New Preview ==="
+    echo "Title: $title"
+    echo "Description: $description"
+    echo "Category: $category"
+    echo ""
+    echo "Opening admin console preview..."
+
+    # Open the URL in the default browser
+    if [[ "$(uname)" == "Darwin" ]]; then
+        open "$preview_url"
+    elif command -v xdg-open &> /dev/null; then
+        xdg-open "$preview_url"
+    else
+        echo "Preview URL: $preview_url"
+    fi
+}
+
 # Update the tag to mark this run
 update_tag() {
    echo "Updating $TAG_NAME tag..."
@@ -462,6 +571,26 @@ main() {

        # Update tag for next run
        update_tag
+
+        # Generate player-friendly What's New summary and open admin preview
+        echo ""
+        echo "Generating What's New summary for in-game display..."
+        whats_new_output=$(generate_whats_new_summary "$pr_file")
+
+        if [[ "$whats_new_output" != "NONE" ]]; then
+            # Parse the output
+            title=$(echo "$whats_new_output" | grep "^TITLE:" | sed 's/^TITLE:[[:space:]]*//')
+            description=$(echo "$whats_new_output" | grep "^DESCRIPTION:" | sed 's/^DESCRIPTION:[[:space:]]*//')
+            category=$(echo "$whats_new_output" | grep "^CATEGORY:" | sed 's/^CATEGORY:[[:space:]]*//')
+
+            if [[ -n "$title" && -n "$description" ]]; then
+                open_whats_new_preview "$title" "$description" "$category"
+            else
+                echo "Could not parse What's New output, skipping preview"
+            fi
+        else
+            echo "No player-visible changes detected, skipping What's New preview"
+        fi
    fi

    echo ""
@@ -0,0 +1 @@
+7.7.1
@@ -0,0 +1,2 @@
+# Bazel symlinks
+bazel-*
@@ -0,0 +1,28 @@
+module(name = "sparkle_workspace")
+
+# Minimal dependencies for building SparklePlugin
+# This workspace is isolated from the main workspace to avoid
+# rules_swift version conflicts between grpc and rules_apple
+
+bazel_dep(name = "apple_support", version = "1.21.1", repo_name = "build_bazel_apple_support")
+bazel_dep(name = "rules_apple", version = "4.3.3", repo_name = "build_bazel_rules_apple")
+
+# Register Apple CC toolchain for Objective-C compilation
+apple_cc_configure = use_extension(
+    "@build_bazel_apple_support//crosstool:setup.bzl",
+    "apple_cc_configure_extension",
+)
+use_repo(apple_cc_configure, "local_config_apple_cc")
+
+# Sparkle framework for macOS auto-updates
+http_archive = use_repo_rule("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+
+SPARKLE_VERSION = "2.6.4"
+
+http_archive(
+    name = "sparkle",
+    build_file = "//:external/BUILD.sparkle",
+    sha256 = "50612a06038abc931f16011d7903b8326a362c1074dabccb718404ce8e585f0b",
+    strip_prefix = "",
+    url = "https://github.com/sparkle-project/Sparkle/releases/download/%s/Sparkle-%s.tar.xz" % (SPARKLE_VERSION, SPARKLE_VERSION),
+)
@@ -0,0 +1,451 @@
+{
+  "lockFileVersion": 13,
+  "registryFileHashes": {
+    "https://bcr.bazel.build/bazel_registry.json": "8a28e4aff06ee60aed2a8c281907fb8bcbf3b753c91fb5a5c57da3215d5b3497",
+    "https://bcr.bazel.build/modules/abseil-cpp/20210324.2/MODULE.bazel": "7cd0312e064fde87c8d1cd79ba06c876bd23630c83466e9500321be55c96ace2",
+    "https://bcr.bazel.build/modules/abseil-cpp/20211102.0/MODULE.bazel": "70390338f7a5106231d20620712f7cccb659cd0e9d073d1991c038eb9fc57589",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230125.1/MODULE.bazel": "89047429cb0207707b2dface14ba7f8df85273d484c2572755be4bab7ce9c3a0",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.0.bcr.1/MODULE.bazel": "1c8cec495288dccd14fdae6e3f95f772c1c91857047a098fad772034264cc8cb",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.0/MODULE.bazel": "d253ae36a8bd9ee3c5955384096ccb6baf16a1b1e93e858370da0a3b94f77c16",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.1/MODULE.bazel": "fa92e2eb41a04df73cdabeec37107316f7e5272650f81d6cc096418fe647b915",
+    "https://bcr.bazel.build/modules/abseil-cpp/20240116.1/MODULE.bazel": "37bcdb4440fbb61df6a1c296ae01b327f19e9bb521f9b8e26ec854b6f97309ed",
+    "https://bcr.bazel.build/modules/abseil-cpp/20240116.1/source.json": "9be551b8d4e3ef76875c0d744b5d6a504a27e3ae67bc6b28f46415fd2d2957da",
+    "https://bcr.bazel.build/modules/apple_support/1.11.1/MODULE.bazel": "1843d7cd8a58369a444fc6000e7304425fba600ff641592161d9f15b179fb896",
+    "https://bcr.bazel.build/modules/apple_support/1.15.1/MODULE.bazel": "a0556fefca0b1bb2de8567b8827518f94db6a6e7e7d632b4c48dc5f865bc7c85",
+    "https://bcr.bazel.build/modules/apple_support/1.21.1/MODULE.bazel": "5809fa3efab15d1f3c3c635af6974044bac8a4919c62238cce06acee8a8c11f1",
+    "https://bcr.bazel.build/modules/apple_support/1.23.1/MODULE.bazel": "53763fed456a968cf919b3240427cf3a9d5481ec5466abc9d5dc51bc70087442",
+    "https://bcr.bazel.build/modules/apple_support/1.23.1/source.json": "d888b44312eb0ad2c21a91d026753f330caa48a25c9b2102fae75eb2b0dcfdd2",
+    "https://bcr.bazel.build/modules/bazel_features/1.1.1/MODULE.bazel": "27b8c79ef57efe08efccbd9dd6ef70d61b4798320b8d3c134fd571f78963dbcd",
+    "https://bcr.bazel.build/modules/bazel_features/1.11.0/MODULE.bazel": "f9382337dd5a474c3b7d334c2f83e50b6eaedc284253334cf823044a26de03e8",
+    "https://bcr.bazel.build/modules/bazel_features/1.15.0/MODULE.bazel": "d38ff6e517149dc509406aca0db3ad1efdd890a85e049585b7234d04238e2a4d",
+    "https://bcr.bazel.build/modules/bazel_features/1.17.0/MODULE.bazel": "039de32d21b816b47bd42c778e0454217e9c9caac4a3cf8e15c7231ee3ddee4d",
+    "https://bcr.bazel.build/modules/bazel_features/1.18.0/MODULE.bazel": "1be0ae2557ab3a72a57aeb31b29be347bcdc5d2b1eb1e70f39e3851a7e97041a",
+    "https://bcr.bazel.build/modules/bazel_features/1.19.0/MODULE.bazel": "59adcdf28230d220f0067b1f435b8537dd033bfff8db21335ef9217919c7fb58",
+    "https://bcr.bazel.build/modules/bazel_features/1.21.0/MODULE.bazel": "675642261665d8eea09989aa3b8afb5c37627f1be178382c320d1b46afba5e3b",
+    "https://bcr.bazel.build/modules/bazel_features/1.27.0/MODULE.bazel": "621eeee06c4458a9121d1f104efb80f39d34deff4984e778359c60eaf1a8cb65",
+    "https://bcr.bazel.build/modules/bazel_features/1.28.0/MODULE.bazel": "4b4200e6cbf8fa335b2c3f43e1d6ef3e240319c33d43d60cc0fbd4b87ece299d",
+    "https://bcr.bazel.build/modules/bazel_features/1.3.0/MODULE.bazel": "cdcafe83ec318cda34e02948e81d790aab8df7a929cec6f6969f13a489ccecd9",
+    "https://bcr.bazel.build/modules/bazel_features/1.30.0/MODULE.bazel": "a14b62d05969a293b80257e72e597c2da7f717e1e69fa8b339703ed6731bec87",
+    "https://bcr.bazel.build/modules/bazel_features/1.30.0/source.json": "b07e17f067fe4f69f90b03b36ef1e08fe0d1f3cac254c1241a1818773e3423bc",
+    "https://bcr.bazel.build/modules/bazel_features/1.4.1/MODULE.bazel": "e45b6bb2350aff3e442ae1111c555e27eac1d915e77775f6fdc4b351b758b5d7",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.0.3/MODULE.bazel": "bcb0fd896384802d1ad283b4e4eb4d718eebd8cb820b0a2c3a347fb971afd9d8",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.1.1/MODULE.bazel": "1add3e7d93ff2e6998f9e118022c84d163917d912f5afafb3058e3d2f1545b5e",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.2.0/MODULE.bazel": "44fe84260e454ed94ad326352a698422dbe372b21a1ac9f3eab76eb531223686",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.2.1/MODULE.bazel": "f35baf9da0efe45fa3da1696ae906eea3d615ad41e2e3def4aeb4e8bc0ef9a7a",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.3.0/MODULE.bazel": "20228b92868bf5cfc41bda7afc8a8ba2a543201851de39d990ec957b513579c5",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.4.1/MODULE.bazel": "a0dcb779424be33100dcae821e9e27e4f2901d9dfd5333efe5ac6a8d7ab75e1d",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.4.2/MODULE.bazel": "3bd40978e7a1fac911d5989e6b09d8f64921865a45822d8b09e815eaa726a651",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.5.0/MODULE.bazel": "32880f5e2945ce6a03d1fbd588e9198c0a959bb42297b2cfaf1685b7bc32e138",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.6.1/MODULE.bazel": "8fdee2dbaace6c252131c00e1de4b165dc65af02ea278476187765e1a617b917",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.0/MODULE.bazel": "0db596f4563de7938de764cc8deeabec291f55e8ec15299718b93c4423e9796d",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.1/MODULE.bazel": "3120d80c5861aa616222ec015332e5f8d3171e062e3e804a2a0253e1be26e59b",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.1/source.json": "f121b43eeefc7c29efbd51b83d08631e2347297c95aac9764a701f2a6a2bb953",
+    "https://bcr.bazel.build/modules/buildozer/7.1.2/MODULE.bazel": "2e8dd40ede9c454042645fd8d8d0cd1527966aa5c919de86661e62953cd73d84",
+    "https://bcr.bazel.build/modules/buildozer/7.1.2/source.json": "c9028a501d2db85793a6996205c8de120944f50a0d570438fcae0457a5f9d1f8",
+    "https://bcr.bazel.build/modules/google_benchmark/1.8.2/MODULE.bazel": "a70cf1bba851000ba93b58ae2f6d76490a9feb74192e57ab8e8ff13c34ec50cb",
+    "https://bcr.bazel.build/modules/googletest/1.11.0/MODULE.bazel": "3a83f095183f66345ca86aa13c58b59f9f94a2f81999c093d4eeaa2d262d12f4",
+    "https://bcr.bazel.build/modules/googletest/1.14.0.bcr.1/MODULE.bazel": "22c31a561553727960057361aa33bf20fb2e98584bc4fec007906e27053f80c6",
+    "https://bcr.bazel.build/modules/googletest/1.14.0.bcr.1/source.json": "41e9e129f80d8c8bf103a7acc337b76e54fad1214ac0a7084bf24f4cd924b8b4",
+    "https://bcr.bazel.build/modules/googletest/1.14.0/MODULE.bazel": "cfbcbf3e6eac06ef9d85900f64424708cc08687d1b527f0ef65aa7517af8118f",
+    "https://bcr.bazel.build/modules/jsoncpp/1.9.5/MODULE.bazel": "31271aedc59e815656f5736f282bb7509a97c7ecb43e927ac1a37966e0578075",
+    "https://bcr.bazel.build/modules/jsoncpp/1.9.5/source.json": "4108ee5085dd2885a341c7fab149429db457b3169b86eb081fa245eadf69169d",
+    "https://bcr.bazel.build/modules/libpfm/4.11.0/MODULE.bazel": "45061ff025b301940f1e30d2c16bea596c25b176c8b6b3087e92615adbd52902",
+    "https://bcr.bazel.build/modules/nlohmann_json/3.6.1/MODULE.bazel": "6f7b417dcc794d9add9e556673ad25cb3ba835224290f4f848f8e2db1e1fca74",
+    "https://bcr.bazel.build/modules/nlohmann_json/3.6.1/source.json": "f448c6e8963fdfa7eb831457df83ad63d3d6355018f6574fb017e8169deb43a9",
+    "https://bcr.bazel.build/modules/platforms/0.0.10/MODULE.bazel": "8cb8efaf200bdeb2150d93e162c40f388529a25852b332cec879373771e48ed5",
+    "https://bcr.bazel.build/modules/platforms/0.0.11/MODULE.bazel": "0daefc49732e227caa8bfa834d65dc52e8cc18a2faf80df25e8caea151a9413f",
+    "https://bcr.bazel.build/modules/platforms/0.0.11/source.json": "f7e188b79ebedebfe75e9e1d098b8845226c7992b307e28e1496f23112e8fc29",
+    "https://bcr.bazel.build/modules/platforms/0.0.4/MODULE.bazel": "9b328e31ee156f53f3c416a64f8491f7eb731742655a47c9eec4703a71644aee",
+    "https://bcr.bazel.build/modules/platforms/0.0.5/MODULE.bazel": "5733b54ea419d5eaf7997054bb55f6a1d0b5ff8aedf0176fef9eea44f3acda37",
+    "https://bcr.bazel.build/modules/platforms/0.0.6/MODULE.bazel": "ad6eeef431dc52aefd2d77ed20a4b353f8ebf0f4ecdd26a807d2da5aa8cd0615",
+    "https://bcr.bazel.build/modules/platforms/0.0.7/MODULE.bazel": "72fd4a0ede9ee5c021f6a8dd92b503e089f46c227ba2813ff183b71616034814",
+    "https://bcr.bazel.build/modules/platforms/0.0.8/MODULE.bazel": "9f142c03e348f6d263719f5074b21ef3adf0b139ee4c5133e2aa35664da9eb2d",
+    "https://bcr.bazel.build/modules/platforms/0.0.9/MODULE.bazel": "4a87a60c927b56ddd67db50c89acaa62f4ce2a1d2149ccb63ffd871d5ce29ebc",
+    "https://bcr.bazel.build/modules/protobuf/21.7/MODULE.bazel": "a5a29bb89544f9b97edce05642fac225a808b5b7be74038ea3640fae2f8e66a7",
+    "https://bcr.bazel.build/modules/protobuf/27.0/MODULE.bazel": "7873b60be88844a0a1d8f80b9d5d20cfbd8495a689b8763e76c6372998d3f64c",
+    "https://bcr.bazel.build/modules/protobuf/29.0-rc2/MODULE.bazel": "6241d35983510143049943fc0d57937937122baf1b287862f9dc8590fc4c37df",
+    "https://bcr.bazel.build/modules/protobuf/29.0-rc3/MODULE.bazel": "33c2dfa286578573afc55a7acaea3cada4122b9631007c594bf0729f41c8de92",
+    "https://bcr.bazel.build/modules/protobuf/29.0-rc3/source.json": "c16a6488fb279ef578da7098e605082d72ed85fc8d843eaae81e7d27d0f4625d",
+    "https://bcr.bazel.build/modules/protobuf/3.19.0/MODULE.bazel": "6b5fbb433f760a99a22b18b6850ed5784ef0e9928a72668b66e4d7ccd47db9b0",
+    "https://bcr.bazel.build/modules/protobuf/3.19.6/MODULE.bazel": "9233edc5e1f2ee276a60de3eaa47ac4132302ef9643238f23128fea53ea12858",
+    "https://bcr.bazel.build/modules/pybind11_bazel/2.11.1/MODULE.bazel": "88af1c246226d87e65be78ed49ecd1e6f5e98648558c14ce99176da041dc378e",
+    "https://bcr.bazel.build/modules/pybind11_bazel/2.11.1/source.json": "be4789e951dd5301282729fe3d4938995dc4c1a81c2ff150afc9f1b0504c6022",
+    "https://bcr.bazel.build/modules/re2/2023-09-01/MODULE.bazel": "cb3d511531b16cfc78a225a9e2136007a48cf8a677e4264baeab57fe78a80206",
+    "https://bcr.bazel.build/modules/re2/2023-09-01/source.json": "e044ce89c2883cd957a2969a43e79f7752f9656f6b20050b62f90ede21ec6eb4",
+    "https://bcr.bazel.build/modules/rules_android/0.1.1/MODULE.bazel": "48809ab0091b07ad0182defb787c4c5328bd3a278938415c00a7b69b50c4d3a8",
+    "https://bcr.bazel.build/modules/rules_android/0.1.1/source.json": "e6986b41626ee10bdc864937ffb6d6bf275bb5b9c65120e6137d56e6331f089e",
+    "https://bcr.bazel.build/modules/rules_apple/4.3.3/MODULE.bazel": "c5c2c4adeeac5f3f2f9b7f16abfa8be7ffefa596171d0d92bed4cae9ade0a498",
+    "https://bcr.bazel.build/modules/rules_apple/4.3.3/source.json": "3cb1d69c8243ffcc42ecbf84ae8b9cccd7b1e2f091b0aee5a3e9c9a45267f312",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.1/MODULE.bazel": "cb2aa0747f84c6c3a78dad4e2049c154f08ab9d166b1273835a8174940365647",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.10/MODULE.bazel": "ec1705118f7eaedd6e118508d3d26deba2a4e76476ada7e0e3965211be012002",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.11/MODULE.bazel": "9f249c5624a4788067b96b8b896be10c7e8b4375dc46f6d8e1e51100113e0992",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.13/MODULE.bazel": "0e8529ed7b323dad0775ff924d2ae5af7640b23553dfcd4d34344c7e7a867191",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.15/MODULE.bazel": "6704c35f7b4a72502ee81f61bf88706b54f06b3cbe5558ac17e2e14666cd5dcc",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.16/MODULE.bazel": "7661303b8fc1b4d7f532e54e9d6565771fea666fbdf839e0a86affcd02defe87",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.2/MODULE.bazel": "6915987c90970493ab97393024c156ea8fb9f3bea953b2f3ec05c34f19b5695c",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.6/MODULE.bazel": "abf360251023dfe3efcef65ab9d56beefa8394d4176dd29529750e1c57eaa33f",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.8/MODULE.bazel": "964c85c82cfeb6f3855e6a07054fdb159aced38e99a5eecf7bce9d53990afa3e",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.9/MODULE.bazel": "836e76439f354b89afe6a911a7adf59a6b2518fafb174483ad78a2a2fde7b1c5",
+    "https://bcr.bazel.build/modules/rules_cc/0.1.2/MODULE.bazel": "557ddc3a96858ec0d465a87c0a931054d7dcfd6583af2c7ed3baf494407fd8d0",
+    "https://bcr.bazel.build/modules/rules_cc/0.1.2/source.json": "53fcb09b5816c83ca60d9d7493faf3bfaf410dfc2f15deb52d6ddd146b8d43f0",
+    "https://bcr.bazel.build/modules/rules_foreign_cc/0.9.0/MODULE.bazel": "c9e8c682bf75b0e7c704166d79b599f93b72cfca5ad7477df596947891feeef6",
+    "https://bcr.bazel.build/modules/rules_fuzzing/0.5.2/MODULE.bazel": "40c97d1144356f52905566c55811f13b299453a14ac7769dfba2ac38192337a8",
+    "https://bcr.bazel.build/modules/rules_fuzzing/0.5.2/source.json": "c8b1e2c717646f1702290959a3302a178fb639d987ab61d548105019f11e527e",
+    "https://bcr.bazel.build/modules/rules_java/4.0.0/MODULE.bazel": "5a78a7ae82cd1a33cef56dc578c7d2a46ed0dca12643ee45edbb8417899e6f74",
+    "https://bcr.bazel.build/modules/rules_java/5.3.5/MODULE.bazel": "a4ec4f2db570171e3e5eb753276ee4b389bae16b96207e9d3230895c99644b86",
+    "https://bcr.bazel.build/modules/rules_java/6.5.2/MODULE.bazel": "1d440d262d0e08453fa0c4d8f699ba81609ed0e9a9a0f02cd10b3e7942e61e31",
+    "https://bcr.bazel.build/modules/rules_java/7.10.0/MODULE.bazel": "530c3beb3067e870561739f1144329a21c851ff771cd752a49e06e3dc9c2e71a",
+    "https://bcr.bazel.build/modules/rules_java/7.12.2/MODULE.bazel": "579c505165ee757a4280ef83cda0150eea193eed3bef50b1004ba88b99da6de6",
+    "https://bcr.bazel.build/modules/rules_java/7.2.0/MODULE.bazel": "06c0334c9be61e6cef2c8c84a7800cef502063269a5af25ceb100b192453d4ab",
+    "https://bcr.bazel.build/modules/rules_java/7.6.1/MODULE.bazel": "2f14b7e8a1aa2f67ae92bc69d1ec0fa8d9f827c4e17ff5e5f02e91caa3b2d0fe",
+    "https://bcr.bazel.build/modules/rules_java/7.6.5/MODULE.bazel": "481164be5e02e4cab6e77a36927683263be56b7e36fef918b458d7a8a1ebadb1",
+    "https://bcr.bazel.build/modules/rules_java/8.3.2/MODULE.bazel": "7336d5511ad5af0b8615fdc7477535a2e4e723a357b6713af439fe8cf0195017",
+    "https://bcr.bazel.build/modules/rules_java/8.5.1/MODULE.bazel": "d8a9e38cc5228881f7055a6079f6f7821a073df3744d441978e7a43e20226939",
+    "https://bcr.bazel.build/modules/rules_java/8.5.1/source.json": "db1a77d81b059e0f84985db67a22f3f579a529a86b7997605be3d214a0abe38e",
+    "https://bcr.bazel.build/modules/rules_jvm_external/4.4.2/MODULE.bazel": "a56b85e418c83eb1839819f0b515c431010160383306d13ec21959ac412d2fe7",
+    "https://bcr.bazel.build/modules/rules_jvm_external/5.1/MODULE.bazel": "33f6f999e03183f7d088c9be518a63467dfd0be94a11d0055fe2d210f89aa909",
+    "https://bcr.bazel.build/modules/rules_jvm_external/5.2/MODULE.bazel": "d9351ba35217ad0de03816ef3ed63f89d411349353077348a45348b096615036",
+    "https://bcr.bazel.build/modules/rules_jvm_external/6.3/MODULE.bazel": "c998e060b85f71e00de5ec552019347c8bca255062c990ac02d051bb80a38df0",
+    "https://bcr.bazel.build/modules/rules_jvm_external/6.3/source.json": "6f5f5a5a4419ae4e37c35a5bb0a6ae657ed40b7abc5a5189111b47fcebe43197",
+    "https://bcr.bazel.build/modules/rules_kotlin/1.9.6/MODULE.bazel": "d269a01a18ee74d0335450b10f62c9ed81f2321d7958a2934e44272fe82dcef3",
+    "https://bcr.bazel.build/modules/rules_kotlin/1.9.6/source.json": "2faa4794364282db7c06600b7e5e34867a564ae91bda7cae7c29c64e9466b7d5",
+    "https://bcr.bazel.build/modules/rules_license/0.0.3/MODULE.bazel": "627e9ab0247f7d1e05736b59dbb1b6871373de5ad31c3011880b4133cafd4bd0",
+    "https://bcr.bazel.build/modules/rules_license/0.0.7/MODULE.bazel": "088fbeb0b6a419005b89cf93fe62d9517c0a2b8bb56af3244af65ecfe37e7d5d",
+    "https://bcr.bazel.build/modules/rules_license/1.0.0/MODULE.bazel": "a7fda60eefdf3d8c827262ba499957e4df06f659330bbe6cdbdb975b768bb65c",
+    "https://bcr.bazel.build/modules/rules_license/1.0.0/source.json": "a52c89e54cc311196e478f8382df91c15f7a2bfdf4c6cd0e2675cc2ff0b56efb",
+    "https://bcr.bazel.build/modules/rules_pkg/0.7.0/MODULE.bazel": "df99f03fc7934a4737122518bb87e667e62d780b610910f0447665a7e2be62dc",
+    "https://bcr.bazel.build/modules/rules_pkg/1.0.1/MODULE.bazel": "5b1df97dbc29623bccdf2b0dcd0f5cb08e2f2c9050aab1092fd39a41e82686ff",
+    "https://bcr.bazel.build/modules/rules_pkg/1.0.1/source.json": "bd82e5d7b9ce2d31e380dd9f50c111d678c3bdaca190cb76b0e1c71b05e1ba8a",
+    "https://bcr.bazel.build/modules/rules_proto/4.0.0/MODULE.bazel": "a7a7b6ce9bee418c1a760b3d84f83a299ad6952f9903c67f19e4edd964894e06",
+    "https://bcr.bazel.build/modules/rules_proto/5.3.0-21.7/MODULE.bazel": "e8dff86b0971688790ae75528fe1813f71809b5afd57facb44dad9e8eca631b7",
+    "https://bcr.bazel.build/modules/rules_proto/6.0.2/MODULE.bazel": "ce916b775a62b90b61888052a416ccdda405212b6aaeb39522f7dc53431a5e73",
+    "https://bcr.bazel.build/modules/rules_proto/6.0.2/source.json": "17a2e195f56cb28d6bbf763e49973d13890487c6945311ed141e196fb660426d",
+    "https://bcr.bazel.build/modules/rules_python/0.10.2/MODULE.bazel": "cc82bc96f2997baa545ab3ce73f196d040ffb8756fd2d66125a530031cd90e5f",
+    "https://bcr.bazel.build/modules/rules_python/0.22.1/MODULE.bazel": "26114f0c0b5e93018c0c066d6673f1a2c3737c7e90af95eff30cfee38d0bbac7",
+    "https://bcr.bazel.build/modules/rules_python/0.23.1/MODULE.bazel": "49ffccf0511cb8414de28321f5fcf2a31312b47c40cc21577144b7447f2bf300",
+    "https://bcr.bazel.build/modules/rules_python/0.25.0/MODULE.bazel": "72f1506841c920a1afec76975b35312410eea3aa7b63267436bfb1dd91d2d382",
+    "https://bcr.bazel.build/modules/rules_python/0.28.0/MODULE.bazel": "cba2573d870babc976664a912539b320cbaa7114cd3e8f053c720171cde331ed",
+    "https://bcr.bazel.build/modules/rules_python/0.31.0/MODULE.bazel": "93a43dc47ee570e6ec9f5779b2e64c1476a6ce921c48cc9a1678a91dd5f8fd58",
+    "https://bcr.bazel.build/modules/rules_python/0.4.0/MODULE.bazel": "9208ee05fd48bf09ac60ed269791cf17fb343db56c8226a720fbb1cdf467166c",
+    "https://bcr.bazel.build/modules/rules_python/1.3.0/MODULE.bazel": "8361d57eafb67c09b75bf4bbe6be360e1b8f4f18118ab48037f2bd50aa2ccb13",
+    "https://bcr.bazel.build/modules/rules_python/1.3.0/source.json": "25932f917cd279c7baefa6cb1d3fa8750a7a29de522024449b19af6eab51f4a0",
+    "https://bcr.bazel.build/modules/rules_shell/0.2.0/MODULE.bazel": "fda8a652ab3c7d8fee214de05e7a9916d8b28082234e8d2c0094505c5268ed3c",
+    "https://bcr.bazel.build/modules/rules_shell/0.3.0/MODULE.bazel": "de4402cd12f4cc8fda2354fce179fdb068c0b9ca1ec2d2b17b3e21b24c1a937b",
+    "https://bcr.bazel.build/modules/rules_shell/0.3.0/source.json": "c55ed591aa5009401ddf80ded9762ac32c358d2517ee7820be981e2de9756cf3",
+    "https://bcr.bazel.build/modules/rules_swift/1.16.0/MODULE.bazel": "4a09f199545a60d09895e8281362b1ff3bb08bbde69c6fc87aff5b92fcc916ca",
+    "https://bcr.bazel.build/modules/rules_swift/2.4.0/MODULE.bazel": "1639617eb1ede28d774d967a738b4a68b0accb40650beadb57c21846beab5efd",
+    "https://bcr.bazel.build/modules/rules_swift/2.4.0/source.json": "a6577f57f9febbdc015a01f2a8f3487422032f134d6c61d18ed8e8ca3b9acc7c",
+    "https://bcr.bazel.build/modules/stardoc/0.5.1/MODULE.bazel": "1a05d92974d0c122f5ccf09291442580317cdd859f07a8655f1db9a60374f9f8",
+    "https://bcr.bazel.build/modules/stardoc/0.5.3/MODULE.bazel": "c7f6948dae6999bf0db32c1858ae345f112cacf98f174c7a8bb707e41b974f1c",
+    "https://bcr.bazel.build/modules/stardoc/0.7.0/MODULE.bazel": "05e3d6d30c099b6770e97da986c53bd31844d7f13d41412480ea265ac9e8079c",
+    "https://bcr.bazel.build/modules/stardoc/0.7.2/MODULE.bazel": "fc152419aa2ea0f51c29583fab1e8c99ddefd5b3778421845606ee628629e0e5",
+    "https://bcr.bazel.build/modules/stardoc/0.7.2/source.json": "58b029e5e901d6802967754adf0a9056747e8176f017cfe3607c0851f4d42216",
+    "https://bcr.bazel.build/modules/swift_argument_parser/1.3.1.1/MODULE.bazel": "5e463fbfba7b1701d957555ed45097d7f984211330106ccd1352c6e0af0dcf91",
+    "https://bcr.bazel.build/modules/swift_argument_parser/1.3.1.1/source.json": "32bd87e5f4d7acc57c5b2ff7c325ae3061d5e242c0c4c214ae87e0f1c13e54cb",
+    "https://bcr.bazel.build/modules/upb/0.0.0-20220923-a547704/MODULE.bazel": "7298990c00040a0e2f121f6c32544bab27d4452f80d9ce51349b1a28f3005c43",
+    "https://bcr.bazel.build/modules/zlib/1.2.11/MODULE.bazel": "07b389abc85fdbca459b69e2ec656ae5622873af3f845e1c9d80fe179f3effa0",
+    "https://bcr.bazel.build/modules/zlib/1.2.12/MODULE.bazel": "3b1a8834ada2a883674be8cbd36ede1b6ec481477ada359cd2d3ddc562340b27",
+    "https://bcr.bazel.build/modules/zlib/1.3.1.bcr.3/MODULE.bazel": "af322bc08976524477c79d1e45e241b6efbeb918c497e8840b8ab116802dda79",
+    "https://bcr.bazel.build/modules/zlib/1.3.1.bcr.3/source.json": "2be409ac3c7601245958cd4fcdff4288be79ed23bd690b4b951f500d54ee6e7d",
+    "https://bcr.bazel.build/modules/zlib/1.3.1/MODULE.bazel": "751c9940dcfe869f5f7274e1295422a34623555916eb98c174c1e945594bf198"
+  },
+  "selectedYankedVersions": {},
+  "moduleExtensions": {
+    "@@rules_java~//java:rules_java_deps.bzl%compatibility_proxy": {
+      "general": {
+        "bzlTransitiveDigest": "C4xqrMy1wN4iuTN6Z2eCm94S5XingHhD6uwrIXvCxVI=",
+        "usagesDigest": "pwHZ+26iLgQdwvdZeA5wnAjKnNI3y6XO2VbhOTeo5h8=",
+        "recordedFileInputs": {},
+        "recordedDirentsInputs": {},
+        "envVariables": {},
+        "generatedRepoSpecs": {
+          "compatibility_proxy": {
+            "bzlFile": "@@rules_java~//java:rules_java_deps.bzl",
+            "ruleClassName": "_compatibility_proxy_repo_rule",
+            "attributes": {}
+          }
+        },
+        "recordedRepoMappingEntries": [
+          [
+            "rules_java~",
+            "bazel_tools",
+            "bazel_tools"
+          ]
+        ]
+      }
+    },
+    "@@rules_kotlin~//src/main/starlark/core/repositories:bzlmod_setup.bzl%rules_kotlin_extensions": {
+      "general": {
+        "bzlTransitiveDigest": "eecmTsmdIQveoA97hPtH3/Ej/kugbdCI24bhXIXaly8=",
+        "usagesDigest": "aJF6fLy82rR95Ff5CZPAqxNoFgOMLMN5ImfBS0nhnkg=",
+        "recordedFileInputs": {},
+        "recordedDirentsInputs": {},
+        "envVariables": {},
+        "generatedRepoSpecs": {
+          "com_github_jetbrains_kotlin_git": {
+            "bzlFile": "@@rules_kotlin~//src/main/starlark/core/repositories:compiler.bzl",
+            "ruleClassName": "kotlin_compiler_git_repository",
+            "attributes": {
+              "urls": [
+                "https://github.com/JetBrains/kotlin/releases/download/v1.9.23/kotlin-compiler-1.9.23.zip"
+              ],
+              "sha256": "93137d3aab9afa9b27cb06a824c2324195c6b6f6179d8a8653f440f5bd58be88"
+            }
+          },
+          "com_github_jetbrains_kotlin": {
+            "bzlFile": "@@rules_kotlin~//src/main/starlark/core/repositories:compiler.bzl",
+            "ruleClassName": "kotlin_capabilities_repository",
+            "attributes": {
+              "git_repository_name": "com_github_jetbrains_kotlin_git",
+              "compiler_version": "1.9.23"
+            }
+          },
+          "com_github_google_ksp": {
+            "bzlFile": "@@rules_kotlin~//src/main/starlark/core/repositories:ksp.bzl",
+            "ruleClassName": "ksp_compiler_plugin_repository",
+            "attributes": {
+              "urls": [
+                "https://github.com/google/ksp/releases/download/1.9.23-1.0.20/artifacts.zip"
+              ],
+              "sha256": "ee0618755913ef7fd6511288a232e8fad24838b9af6ea73972a76e81053c8c2d",
+              "strip_version": "1.9.23-1.0.20"
+            }
+          },
+          "com_github_pinterest_ktlint": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_file",
+            "attributes": {
+              "sha256": "01b2e0ef893383a50dbeb13970fe7fa3be36ca3e83259e01649945b09d736985",
+              "urls": [
+                "https://github.com/pinterest/ktlint/releases/download/1.3.0/ktlint"
+              ],
+              "executable": true
+            }
+          },
+          "rules_android": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "sha256": "cd06d15dd8bb59926e4d65f9003bfc20f9da4b2519985c27e190cddc8b7a7806",
+              "strip_prefix": "rules_android-0.1.1",
+              "urls": [
+                "https://github.com/bazelbuild/rules_android/archive/v0.1.1.zip"
+              ]
+            }
+          }
+        },
+        "recordedRepoMappingEntries": [
+          [
+            "rules_kotlin~",
+            "bazel_tools",
+            "bazel_tools"
+          ]
+        ]
+      }
+    },
+    "@@rules_python~//python/uv:uv.bzl%uv": {
+      "general": {
+        "bzlTransitiveDigest": "Xpqjnjzy6zZ90Es9Wa888ZLHhn7IsNGbph/e6qoxzw8=",
+        "usagesDigest": "qI5PVlIum/YAnGJg5oXGHzDkMFWt2aNSUZY4G8PBbic=",
+        "recordedFileInputs": {},
+        "recordedDirentsInputs": {},
+        "envVariables": {},
+        "generatedRepoSpecs": {
+          "uv": {
+            "bzlFile": "@@rules_python~//python/uv/private:uv_toolchains_repo.bzl",
+            "ruleClassName": "uv_toolchains_repo",
+            "attributes": {
+              "toolchain_type": "'@@rules_python~//python/uv:uv_toolchain_type'",
+              "toolchain_names": [
+                "none"
+              ],
+              "toolchain_implementations": {
+                "none": "'@@rules_python~//python:none'"
+              },
+              "toolchain_compatible_with": {
+                "none": [
+                  "@platforms//:incompatible"
+                ]
+              },
+              "toolchain_target_settings": {}
+            }
+          }
+        },
+        "recordedRepoMappingEntries": [
+          [
+            "rules_python~",
+            "platforms",
+            "platforms"
+          ]
+        ]
+      }
+    },
+    "@@rules_swift~//swift:extensions.bzl%non_module_deps": {
+      "general": {
+        "bzlTransitiveDigest": "l+Zu+SMObRQy3DG2LEw0eGVPkYRnyVj+M1QyR5AAFmM=",
+        "usagesDigest": "l2vIL7SL4tJqHIVLWd78Y/ym+r0II64lmvoX8o+0Bb0=",
+        "recordedFileInputs": {},
+        "recordedDirentsInputs": {},
+        "envVariables": {},
+        "generatedRepoSpecs": {
+          "com_github_apple_swift_protobuf": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-protobuf/archive/1.20.2.tar.gz"
+              ],
+              "sha256": "3fb50bd4d293337f202d917b6ada22f9548a0a0aed9d9a4d791e6fbd8a246ebb",
+              "strip_prefix": "swift-protobuf-1.20.2/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_protobuf/BUILD.overlay"
+            }
+          },
+          "com_github_grpc_grpc_swift": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/grpc/grpc-swift/archive/1.16.0.tar.gz"
+              ],
+              "sha256": "58b60431d0064969f9679411264b82e40a217ae6bd34e17096d92cc4e47556a5",
+              "strip_prefix": "grpc-swift-1.16.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_grpc_grpc_swift/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_docc_symbolkit": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-docc-symbolkit/archive/refs/tags/swift-5.10-RELEASE.tar.gz"
+              ],
+              "sha256": "de1d4b6940468ddb53b89df7aa1a81323b9712775b0e33e8254fa0f6f7469a97",
+              "strip_prefix": "swift-docc-symbolkit-swift-5.10-RELEASE",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_docc_symbolkit/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_nio": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-nio/archive/2.42.0.tar.gz"
+              ],
+              "sha256": "e3304bc3fb53aea74a3e54bd005ede11f6dc357117d9b1db642d03aea87194a0",
+              "strip_prefix": "swift-nio-2.42.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_nio/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_nio_http2": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-nio-http2/archive/1.26.0.tar.gz"
+              ],
+              "sha256": "f0edfc9d6a7be1d587e5b403f2d04264bdfae59aac1d74f7d974a9022c6d2b25",
+              "strip_prefix": "swift-nio-http2-1.26.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_nio_http2/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_nio_transport_services": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-nio-transport-services/archive/1.15.0.tar.gz"
+              ],
+              "sha256": "f3498dafa633751a52b9b7f741f7ac30c42bcbeb3b9edca6d447e0da8e693262",
+              "strip_prefix": "swift-nio-transport-services-1.15.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_nio_transport_services/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_nio_extras": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-nio-extras/archive/1.4.0.tar.gz"
+              ],
+              "sha256": "4684b52951d9d9937bb3e8ccd6b5daedd777021ef2519ea2f18c4c922843b52b",
+              "strip_prefix": "swift-nio-extras-1.4.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_nio_extras/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_log": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-log/archive/1.4.4.tar.gz"
+              ],
+              "sha256": "48fe66426c784c0c20031f15dc17faf9f4c9037c192bfac2f643f65cb2321ba0",
+              "strip_prefix": "swift-log-1.4.4/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_log/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_nio_ssl": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-nio-ssl/archive/2.23.0.tar.gz"
+              ],
+              "sha256": "4787c63f61dd04d99e498adc3d1a628193387e41efddf8de19b8db04544d016d",
+              "strip_prefix": "swift-nio-ssl-2.23.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_nio_ssl/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_collections": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-collections/archive/1.0.4.tar.gz"
+              ],
+              "sha256": "d9e4c8a91c60fb9c92a04caccbb10ded42f4cb47b26a212bc6b39cc390a4b096",
+              "strip_prefix": "swift-collections-1.0.4/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_collections/BUILD.overlay"
+            }
+          },
+          "com_github_apple_swift_atomics": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/apple/swift-atomics/archive/1.1.0.tar.gz"
+              ],
+              "sha256": "1bee7f469f7e8dc49f11cfa4da07182fbc79eab000ec2c17bfdce468c5d276fb",
+              "strip_prefix": "swift-atomics-1.1.0/",
+              "build_file": "@@rules_swift~//third_party:com_github_apple_swift_atomics/BUILD.overlay"
+            }
+          },
+          "build_bazel_rules_swift_index_import": {
+            "bzlFile": "@@bazel_tools//tools/build_defs/repo:http.bzl",
+            "ruleClassName": "http_archive",
+            "attributes": {
+              "build_file": "@@rules_swift~//third_party:build_bazel_rules_swift_index_import/BUILD.overlay",
+              "canonical_id": "index-import-5.8",
+              "urls": [
+                "https://github.com/MobileNativeFoundation/index-import/releases/download/5.8.0.1/index-import.tar.gz"
+              ],
+              "sha256": "28c1ffa39d99e74ed70623899b207b41f79214c498c603915aef55972a851a15"
+            }
+          },
+          "build_bazel_rules_swift_local_config": {
+            "bzlFile": "@@rules_swift~//swift/internal:swift_autoconfiguration.bzl",
+            "ruleClassName": "swift_autoconfiguration",
+            "attributes": {}
+          }
+        },
+        "recordedRepoMappingEntries": [
+          [
+            "rules_swift~",
+            "bazel_tools",
+            "bazel_tools"
+          ]
+        ]
+      }
+    }
+  }
+}
@@ -0,0 +1,3 @@
+# This file marks sparkle_workspace as a separate Bazel workspace.
+# It prevents Bazel from looking up to the parent directory's workspace.
+# The actual dependencies are defined in MODULE.bazel (bzlmod).
@@ -27,6 +27,7 @@ cc_library(
        "//src/main/cpp/net/eagle0/shardok/library/actions:update_game_status_action",
        "//src/main/cpp/net/eagle0/shardok/library/actions:update_opponent_knowledge_action",
        "//src/main/cpp/net/eagle0/shardok/library/fb_helpers:game_state_helpers",
+        "//src/main/cpp/net/eagle0/shardok/library/tutorial:tutorial_battle_controller",
        "//src/main/cpp/net/eagle0/shardok/library/util:game_state_validator",
        "//src/main/cpp/net/eagle0/shardok/library/view_filters:action_result_filter",
        "//src/main/cpp/net/eagle0/shardok/library/view_filters:game_state_filter",
@@ -286,6 +286,29 @@ void ShardokEngine::HandlePlayerTurnEnd(const std::shared_ptr<RandomGenerator> &
                                         true /* atEndOfRound */)
                                         .Execute(gameState, randomGenerator));

+        // Check for tutorial events at end of round
+        if (!GameIsOver() && tutorialController_.IsEnabled()) {
+            auto tutorialResults = tutorialController_.CheckAndExecuteEvents(
+                    gameState,
+                    settingsGetter,
+                    randomGenerator);
+
+            if (!tutorialResults.empty()) {
+                ApplyAndAddActionResults(tutorialResults);
+
+                // Update game status after tutorial events (e.g., attackers fled, defender wins)
+                ApplyAndAddActionResults(UpdateGameStatusAction(
+                                                 GetCurrentGameState(),
+                                                 criticalTileCoords,
+                                                 settingsGetter,
+                                                 true /* atEndOfRound */)
+                                                 .Execute(gameState, randomGenerator));
+
+                // If tutorial events ended the game, don't start new round
+                if (GameIsOver()) { return; }
+            }
+        }
+
        ApplyAndAddActionResults(
                UpdateOpponentKnowledgeAction(settingsGetter).Execute(gameState, randomGenerator));

@@ -20,6 +20,7 @@
 #include "src/main/cpp/net/eagle0/shardok/library/fb_helpers/GameStateHelpers.hpp"
 #include "src/main/cpp/net/eagle0/shardok/library/map/CoordsSet.hpp"
 #include "src/main/cpp/net/eagle0/shardok/library/settings/GameSettings.hpp"
+#include "src/main/cpp/net/eagle0/shardok/library/tutorial/TutorialBattleController.hpp"
 #include "src/main/protobuf/net/eagle0/shardok/api/action_result_view.pb.h"
 #include "src/main/protobuf/net/eagle0/shardok/api/game_state_view.pb.h"
 #include "src/main/protobuf/net/eagle0/shardok/api/unit_view.pb.h"
@@ -36,6 +37,7 @@ using net::eagle0::shardok::api::UnitView;
 using PlayerInfoProto = net::eagle0::shardok::common::PlayerInfo;
 using net::eagle0::shardok::storage::ShardokActionWithResultingState;
 using HexMapProto = net::eagle0::shardok::common::HexMap;
+using TutorialBattleConfigProto = net::eagle0::common::TutorialBattleConfig;

 class ShardokEngine {
 private:
@@ -52,6 +54,8 @@ private:

    const CoordsSet criticalTileCoords;

+    TutorialBattleController tutorialController_;
+
    mutable CommandListSPtr cachedAvailableCommands{};

    void ApplyAndAddActionResult(const ActionResult &result);
@@ -197,6 +201,11 @@ public:

    [[nodiscard]] auto GetGameSettings() const -> GameSettingsSPtr { return gameSettings; }

+    /// Configure the tutorial battle controller (call after construction if needed)
+    void SetTutorialBattleConfig(const TutorialBattleConfigProto &config) {
+        tutorialController_ = TutorialBattleController(config);
+    }
+
    static inline auto GameIsOver(const fb::GameStatus *status) -> bool {
        return (status->state() == net::eagle0::shardok::storage::fb::GameStatus_::State_VICTORY);
    }
@@ -1,4 +1,3 @@
-load("@build_bazel_rules_apple//apple:macos.bzl", "macos_command_line_application")
 load("//tools:copts.bzl", "COPTS")

 cc_library(
@@ -82,11 +81,3 @@ cc_binary(
        ":fixed_action_point_distances_timer",
    ],
 )
-
-macos_command_line_application(
-    name = "fixed_action_point_distances_timer_macos_app",
-    minimum_os_version = "10.15",
-    deps = [
-        ":fixed_action_point_distances_timer",
-    ],
-)
@@ -0,0 +1,18 @@
+load("//tools:copts.bzl", "COPTS")
+
+cc_library(
+    name = "tutorial_battle_controller",
+    srcs = ["TutorialBattleController.cpp"],
+    hdrs = ["TutorialBattleController.hpp"],
+    copts = COPTS,
+    visibility = ["//visibility:public"],
+    deps = [
+        "//src/main/cpp/net/eagle0/common:random_generator",
+        "//src/main/cpp/net/eagle0/shardok/library:game_state_w",
+        "//src/main/cpp/net/eagle0/shardok/library/settings:game_settings",
+        "//src/main/cpp/net/eagle0/shardok/library/util:action_result_flatbuffer_helpers",
+        "//src/main/protobuf/net/eagle0/common:tutorial_battle_config_cc_proto",
+        "//src/main/protobuf/net/eagle0/shardok/common:action_type_cc_proto",
+        "//src/main/protobuf/net/eagle0/shardok/storage:action_result_cc_proto",
+    ],
+)
@@ -0,0 +1,236 @@
+//
+//  TutorialBattleController.cpp
+//  eagle0
+//
+//  Created for tutorial battle system.
+//  Copyright 2025 none. All rights reserved.
+//
+
+#include "TutorialBattleController.hpp"
+
+#include <ranges>
+#include <vector>
+
+#include "src/main/cpp/net/eagle0/shardok/library/util/ActionResultFlatbufferHelpers.hpp"
+
+namespace shardok {
+
+using UnitStatusFB = net::eagle0::shardok::storage::fb::UnitStatus;
+using ActionType = net::eagle0::shardok::common::ActionType;
+using FleeActionProto = net::eagle0::common::FleeAction;
+using ReinforcementsActionProto = net::eagle0::common::ReinforcementsAction;
+using UnitKilledTriggerProto = net::eagle0::common::UnitKilledTrigger;
+
+TutorialBattleController::TutorialBattleController()
+    : enabled_(false),
+      config_(),
+      firedEventIds_() {}
+
+TutorialBattleController::TutorialBattleController(const TutorialBattleConfigProto& protoConfig)
+    : enabled_(protoConfig.enabled()),
+      config_(protoConfig),
+      firedEventIds_() {}
+
+auto TutorialBattleController::CheckAndExecuteEvents(
+        const GameStateW& state,
+        const SettingsGetter& settings,
+        const std::shared_ptr<RandomGenerator>& randomGenerator) -> std::vector<ActionResult> {
+    if (!enabled_) { return {}; }
+
+    std::vector<ActionResult> allResults;
+
+    // Check events in config order
+    for (const auto& event : config_.events()) {
+        // Skip already-fired events
+        if (firedEventIds_.contains(event.event_id())) { continue; }
+
+        // Check if trigger condition is met
+        if (EvaluateTrigger(event.trigger(), state)) {
+            // Mark as fired before executing (to prevent re-triggering)
+            firedEventIds_.insert(event.event_id());
+
+            // Execute the action
+            auto results = ExecuteAction(event.action(), state, settings, randomGenerator);
+            allResults.insert(allResults.end(), results.begin(), results.end());
+        }
+    }
+
+    return allResults;
+}
+
+auto TutorialBattleController::EvaluateTrigger(
+        const TutorialTriggerProto& trigger,
+        const GameStateW& state) const -> bool {
+    switch (trigger.trigger_type_case()) {
+        case TutorialTriggerProto::kAfterRound: {
+            const int currentRound = state->current_round();
+            return currentRound >= trigger.after_round().round_number();
+        }
+
+        case TutorialTriggerProto::kUnitsLost: {
+            const auto& unitsLost = trigger.units_lost();
+            const int lostCount = CountLostUnits(state, unitsLost.player_id());
+            return lostCount >= unitsLost.threshold();
+        }
+
+        case TutorialTriggerProto::kDamageTaken: {
+            const auto& damageTaken = trigger.damage_taken();
+            const int totalDamage = GetTotalDamageTaken(state, damageTaken.player_id());
+            return totalDamage >= damageTaken.threshold();
+        }
+
+        case TutorialTriggerProto::kUnitKilled: {
+            return IsUnitKilled(state, trigger.unit_killed());
+        }
+
+        case TutorialTriggerProto::TRIGGER_TYPE_NOT_SET:
+        default: return false;
+    }
+}
+
+auto TutorialBattleController::ExecuteAction(
+        const TutorialActionProto& action,
+        [[maybe_unused]] const GameStateW& state,
+        [[maybe_unused]] const SettingsGetter& settings,
+        [[maybe_unused]] const std::shared_ptr<RandomGenerator>& randomGenerator) const
+        -> std::vector<ActionResult> {
+    switch (action.action_type_case()) {
+        case TutorialActionProto::kFlee: return ExecuteFleeAction(action.flee(), state);
+
+        case TutorialActionProto::kReinforcements:
+            return ExecuteReinforcementsAction(action.reinforcements());
+
+        case TutorialActionProto::ACTION_TYPE_NOT_SET:
+        default: return {};
+    }
+}
+
+auto TutorialBattleController::CountLostUnits(const GameStateW& state, const PlayerId playerId)
+        const -> int {
+    int count = 0;
+    for (const auto* unit : *state->units()) {
+        if (unit->player_id() != playerId) { continue; }
+
+        // Count units that are no longer in battle (destroyed, captured, fled, retreated)
+        const auto status = unit->status();
+        if (status != UnitStatusFB::UnitStatus_NORMAL_UNIT &&
+            status != UnitStatusFB::UnitStatus_RESERVE_UNIT &&
+            status != UnitStatusFB::UnitStatus_NEVER_ENTERED_UNIT &&
+            status != UnitStatusFB::UnitStatus_RESERVED_SLOT) {
+            count++;
+        }
+    }
+    return count;
+}
+
+auto TutorialBattleController::GetTotalDamageTaken(const GameStateW& state, const PlayerId playerId)
+        const -> int {
+    int totalDamage = 0;
+    for (const auto* unit : *state->units()) {
+        if (unit->player_id() != playerId) { continue; }
+
+        // Calculate damage as difference between initial and current size
+        // Initial sizes are stored in config since flatbuffers don't track starting sizes
+        int initialSize = 0;
+        for (const auto& initial : config_.initial_sizes()) {
+            if (initial.unit_id() == unit->unit_id()) {
+                initialSize = initial.size();
+                break;
+            }
+        }
+        if (initialSize == 0) { continue; }
+
+        const int currentSize = unit->battalion().size();
+        if (initialSize > currentSize) { totalDamage += (initialSize - currentSize); }
+    }
+    return totalDamage;
+}
+
+auto TutorialBattleController::IsUnitKilled(
+        const GameStateW& state,
+        const UnitKilledTriggerProto& trigger) const -> bool {
+    for (const auto* unit : *state->units()) {
+        // Check if this unit matches the identifier
+        bool matches = false;
+
+        switch (trigger.unit_identifier_case()) {
+            case UnitKilledTriggerProto::kUnitId:
+                matches = (unit->unit_id() == trigger.unit_id());
+                break;
+
+            case UnitKilledTriggerProto::kEagleHeroId:
+                if (unit->has_attached_hero()) {
+                    matches = (unit->attached_hero().eagle_hero_id() == trigger.eagle_hero_id());
+                }
+                break;
+
+            case UnitKilledTriggerProto::UNIT_IDENTIFIER_NOT_SET:
+            default: continue;
+        }
+
+        if (!matches) { continue; }
+
+        // Check if the unit is "killed" (destroyed/captured status)
+        const auto status = unit->status();
+        if (status == UnitStatusFB::UnitStatus_DESTROYED_SUMMONED_UNIT ||
+            status == UnitStatusFB::UnitStatus_CAPTURED_UNIT) {
+            return true;
+        }
+    }
+    return false;
+}
+
+auto TutorialBattleController::ExecuteFleeAction(
+        const FleeActionProto& fleeAction,
+        const GameStateW& state) const -> std::vector<ActionResult> {
+    std::vector<ActionResult> results;
+    const PlayerId fleeingPlayerId = fleeAction.player_id();
+
+    // First, create a "tutorial enemy fled" notification
+    ActionResult fleeNotification{};
+    fleeNotification.set_type(ActionType::TUTORIAL_ENEMY_FLED);
+    results.push_back(fleeNotification);
+
+    // Determine which units should flee
+    std::set<int32_t> specificUnits(fleeAction.unit_ids().begin(), fleeAction.unit_ids().end());
+    const bool fleeAllUnits = specificUnits.empty();
+
+    // Find all matching units that are still active and make them flee
+    for (const auto* unit : *state->units()) {
+        if (unit->player_id() != fleeingPlayerId) { continue; }
+        if (unit->status() != UnitStatusFB::UnitStatus_NORMAL_UNIT) { continue; }
+
+        // Check if this is a specific unit to flee, or if we're fleeing all
+        if (!fleeAllUnits && !specificUnits.contains(unit->unit_id())) { continue; }
+
+        // Create flee result for this unit (100% success - guaranteed flee)
+        ActionResult fleeResult{};
+        fleeResult.set_type(ActionType::FLED);
+        fleeResult.mutable_player()->set_value(fleeingPlayerId);
+        fleeResult.mutable_actor()->set_value(unit->unit_id());
+
+        auto* resolvedUnit = fleeResult.add_resolved_units();
+        AddUnitToResolved(*resolvedUnit, *unit);
+        resolvedUnit->set_status(net::eagle0::shardok::storage::ResolvedUnit_UnitStatus_FLED_UNIT);
+
+        results.push_back(fleeResult);
+    }
+
+    return results;
+}
+
+auto TutorialBattleController::ExecuteReinforcementsAction(
+        const ReinforcementsActionProto& reinforcementsAction) const -> std::vector<ActionResult> {
+    std::vector<ActionResult> results;
+
+    // Add reinforcements arrival notification if there are units
+    if (!reinforcementsAction.units().empty()) {
+        ActionResult reinforcementsResult{};
+        reinforcementsResult.set_type(ActionType::TUTORIAL_REINFORCEMENTS_ARRIVED);
+        results.push_back(reinforcementsResult);
+    }
+
+    return results;
+}
+
+}  // namespace shardok
@@ -0,0 +1,102 @@
+//
+//  TutorialBattleController.hpp
+//  eagle0
+//
+//  Created for tutorial battle system.
+//  Copyright 2025 none. All rights reserved.
+//
+
+#ifndef TutorialBattleController_hpp
+#define TutorialBattleController_hpp
+
+#include <set>
+#include <string>
+#include <vector>
+
+#include "src/main/cpp/net/eagle0/common/RandomGenerator.hpp"
+#include "src/main/cpp/net/eagle0/shardok/library/GameStateW.hpp"
+#include "src/main/cpp/net/eagle0/shardok/library/settings/GameSettings.hpp"
+#include "src/main/protobuf/net/eagle0/common/tutorial_battle_config.pb.h"
+#include "src/main/protobuf/net/eagle0/shardok/storage/action_result.pb.h"
+
+namespace shardok {
+
+using ActionResult = net::eagle0::shardok::storage::ActionResult;
+using TutorialBattleConfigProto = net::eagle0::common::TutorialBattleConfig;
+using TutorialEventProto = net::eagle0::common::TutorialEvent;
+using TutorialTriggerProto = net::eagle0::common::TutorialTrigger;
+using TutorialActionProto = net::eagle0::common::TutorialAction;
+
+/// Controller for scripted tutorial battles with event-driven triggers and actions.
+/// Events are checked at the end of each round and fire in config order.
+/// Each event fires at most once (tracked by event_id).
+class TutorialBattleController {
+public:
+    /// Creates a disabled controller.
+    TutorialBattleController();
+
+    /// Creates a controller from proto configuration.
+    explicit TutorialBattleController(const TutorialBattleConfigProto& protoConfig);
+
+    /// Returns true if the controller is enabled for this battle.
+    [[nodiscard]] auto IsEnabled() const -> bool { return enabled_; }
+
+    /// Check all events at end of round, return actions for triggered events.
+    /// Events fire in config order - first triggered event executes, then next.
+    /// Each event fires at most once.
+    [[nodiscard]] auto CheckAndExecuteEvents(
+            const GameStateW& state,
+            const SettingsGetter& settings,
+            const std::shared_ptr<RandomGenerator>& randomGenerator) -> std::vector<ActionResult>;
+
+    /// Gets the set of fired event IDs (for testing/debugging).
+    [[nodiscard]] auto GetFiredEventIds() const -> const std::set<std::string>& {
+        return firedEventIds_;
+    }
+
+private:
+    bool enabled_ = false;
+    TutorialBattleConfigProto config_;
+    std::set<std::string> firedEventIds_;  // Track which events have fired
+
+    /// Evaluates whether a trigger condition is met.
+    [[nodiscard]] auto EvaluateTrigger(const TutorialTriggerProto& trigger, const GameStateW& state)
+            const -> bool;
+
+    /// Executes an action and returns the resulting action results.
+    [[nodiscard]] auto ExecuteAction(
+            const TutorialActionProto& action,
+            const GameStateW& state,
+            const SettingsGetter& settings,
+            const std::shared_ptr<RandomGenerator>& randomGenerator) const
+            -> std::vector<ActionResult>;
+
+    // Helper methods for trigger evaluation
+
+    /// Counts units lost (destroyed, captured, fled, retreated) for a player.
+    [[nodiscard]] auto CountLostUnits(const GameStateW& state, PlayerId playerId) const -> int;
+
+    /// Gets total damage taken (cumulative size reduction) for a player.
+    [[nodiscard]] auto GetTotalDamageTaken(const GameStateW& state, PlayerId playerId) const -> int;
+
+    /// Checks if a specific unit has been killed.
+    [[nodiscard]] auto IsUnitKilled(
+            const GameStateW& state,
+            const net::eagle0::common::UnitKilledTrigger& trigger) const -> bool;
+
+    // Helper methods for action execution
+
+    /// Executes a flee action for specified units.
+    [[nodiscard]] auto ExecuteFleeAction(
+            const net::eagle0::common::FleeAction& fleeAction,
+            const GameStateW& state) const -> std::vector<ActionResult>;
+
+    /// Executes a reinforcements action.
+    [[nodiscard]] auto ExecuteReinforcementsAction(
+            const net::eagle0::common::ReinforcementsAction& reinforcementsAction) const
+            -> std::vector<ActionResult>;
+};
+
+}  // namespace shardok
+
+#endif /* TutorialBattleController_hpp */
@@ -19,6 +19,7 @@ cc_library(
        "//src/main/cpp/net/eagle0/shardok/library/settings_loader",
        "//src/main/cpp/net/eagle0/shardok/util:battalion_type_registrar",
        "//src/main/cpp/net/eagle0/shardok/util:map_loader",
+        "//src/main/protobuf/net/eagle0/common:tutorial_battle_config_cc_proto",
        "//src/main/protobuf/net/eagle0/common:victory_condition_cc_proto",
    ],
 )
@@ -193,6 +193,7 @@ void EagleInterfaceImpl::StartGame(const NewGameRequest &request) {
            mapName,
            customMapBytes,
            month,
+            request.tutorial_battle_config(),
            request.SerializeAsString());
 }

@@ -30,6 +30,7 @@ auto SetUpController(
        int month,
        const vector<Unit> &units,
        const vector<PlayerInfoProto> &playerSetupInfos,
+        const TutorialBattleConfigProto &tutorialConfig,
        const string &serializedRequest) -> shared_ptr<ShardokGameController>;

 ShardokGamesManager::ShardokGamesManager(const std::vector<std::string> &extraSettings) {
@@ -77,6 +78,7 @@ auto ShardokGamesManager::UnlockedCreateSpecifiedGame(
        const string &mapName,
        const string &customMapBytes,
        const int month,
+        const TutorialBattleConfigProto &tutorialConfig,
        const string &serializedRequest) -> GameId {
    // Check for existing game with this ID and early-exit
    std::shared_lock<std::shared_mutex> lk(runningControllersLock);
@@ -111,6 +113,7 @@ auto ShardokGamesManager::UnlockedCreateSpecifiedGame(
            month,
            units,
            playerInfos,
+            tutorialConfig,
            serializedRequest);

    return LockedCreateGame(controller, playerSetupInfos, serializedRequest);
@@ -137,6 +140,7 @@ auto SetUpController(
        const int month,
        const vector<Unit> &units,
        const vector<PlayerInfoProto> &playerInfos,
+        const TutorialBattleConfigProto &tutorialConfig,
        const string &serializedRequest) -> shared_ptr<ShardokGameController> {
    auto unplacedUnits = std::vector<Unit>();

@@ -155,6 +159,8 @@ auto SetUpController(
            gameId,
            playerInfos);

+    engine->SetTutorialBattleConfig(tutorialConfig);
+
    return std::make_shared<ShardokGameController>(std::move(engine), mapName, serializedRequest);
 }

@@ -17,6 +17,7 @@

 #include "src/main/cpp/net/eagle0/shardok/ai/ShardokAIClient.hpp"
 #include "src/main/cpp/net/eagle0/shardok/library/settings/GameSettings.hpp"
+#include "src/main/protobuf/net/eagle0/common/tutorial_battle_config.pb.h"
 #include "src/main/protobuf/net/eagle0/shardok/common/game_status.pb.h"
 #include "src/main/protobuf/net/eagle0/shardok/common/player_info.pb.h"
 #include "src/main/protobuf/net/eagle0/shardok/common/victory_condition.pb.h"
@@ -25,6 +26,7 @@ class GameStatePersister;

 using net::eagle0::shardok::common::GameStatus;
 using PlayerInfoProto = net::eagle0::shardok::common::PlayerInfo;
+using TutorialBattleConfigProto = net::eagle0::common::TutorialBattleConfig;
 using std::string;
 using std::vector;
 using VictoryConditionProto = net::eagle0::shardok::common::VictoryCondition;
@@ -101,6 +103,7 @@ public:
            const string &mapName,
            const string &customMapBytes,
            int month,
+            const TutorialBattleConfigProto &tutorialConfig,
            const string &serializedRequest) -> GameId;

    auto UnlockedCreateFromGameStateBytes(
@@ -15,7 +15,7 @@ MonoBehaviour:
  m_DefaultGroup: 4458439bbfafa478b905417eff3c5741
  m_currentHash:
    serializedVersion: 2
-    Hash: 0e8900f37a8b7b1c88049de57e371339
+    Hash: 00000000000000000000000000000000
  m_OptimizeCatalogSize: 0
  m_BuildRemoteCatalog: 1
  m_CatalogRequestsTimeout: 0
@@ -272,9 +272,8 @@ namespace Auth {

        /// <summary>
        /// Start OAuth login with specified provider.
-        /// Opens system browser for user consent, then quits the app.
-        /// The browser's "Return to Eagle" deep link will relaunch the app
-        /// with the auth session, which HandleSessionTransferAsync will process.
+        /// In editor: Opens browser and polls for completion.
+        /// In standalone: Opens browser, quits app, deep link relaunches with token.
        /// </summary>
        public async Task<CheckOAuthStatusResponse> LoginAsync(OAuthProvider provider) {
            EnsureConfigured();
@@ -288,6 +287,13 @@ namespace Auth {
                Debug.Log($"[OAuthManager] Opening browser for OAuth: {authUrl}");
                Application.OpenURL(authUrl);

+#if UNITY_EDITOR
+                // In editor: poll for OAuth completion since deep links don't work
+                Debug.Log("[OAuthManager] Editor mode - polling for OAuth completion");
+                var response = await _authClient.PollForOAuthCompletionAsync(state);
+                HandleOAuthResponse(response);
+                return response;
+#else
                // Quit the app - the browser's "Return to Eagle" deep link will
                // relaunch a fresh instance with the auth session code.
                // This avoids the dual-instance problem where both the original
@@ -299,6 +305,7 @@ namespace Auth {
                // to satisfy the compiler. The new instance will handle auth
                // via OnDeepLinkActivated -> HandleSessionTransferAsync.
                return null;
+#endif
            } catch (Exception ex) {
                Debug.LogWarning($"[OAuthManager] Login failed: {ex.Message}");
                OnLoginFailed?.Invoke(ex.Message);
@@ -306,6 +313,28 @@ namespace Auth {
            }
        }

+        /// <summary>
+        /// Handle OAuth response from polling (editor mode).
+        /// </summary>
+        private void HandleOAuthResponse(CheckOAuthStatusResponse response) {
+            var providerName = response.User.Provider.ToString().ToLowerInvariant();
+            TokenStorage.StoreTokens(
+                    response.AccessToken,
+                    response.RefreshToken,
+                    response.ExpiresAt,
+                    response.User.UserId,
+                    response.User.DisplayName,
+                    providerName);
+
+            if (response.IsNewUser || string.IsNullOrEmpty(response.User.DisplayName)) {
+                Debug.Log("[OAuthManager] New user needs to set display name");
+                OnNewUserNeedsDisplayName?.Invoke(true);
+            } else {
+                Debug.Log($"[OAuthManager] OAuth successful for {response.User.DisplayName}");
+                OnLoginSuccess?.Invoke(response.User);
+            }
+        }
+
        /// <summary>
        /// Set display name for new user after OAuth.
        /// </summary>
@@ -10,6 +10,7 @@ using System.Threading.Tasks;
 using Auth;
 using common;
 using common.GUIUtils;
+using common.WhatsNew;
 using eagle;
 using Eagle0.Tutorial;
 using Grpc.Core;
@@ -130,7 +131,8 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
    public GameObject availableGamesListArea;
    public GameObject availableGamesListItemPrefab;
    public GameObject waitingGamesListItemPrefab;
-    public GameObject createGameListItemPrefab;
+    public CreateGameItem createGameItem;
+    public Button tutorialButton;

    public DropGameConfirmationPanel dropGameConfirmationPanel;

@@ -141,7 +143,6 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {

    List<GameInfo> fetchedRunningGames;
    List<AvailableLeader> fetchedNewGameLeaders;
-    int fetchedMaxPlayerCount;
    private EagleConnection eagleConnection;
    private PersistentClientConnection _persistentClientConnection;
    private HttpClient _httpClient;
@@ -410,27 +411,25 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
    }

    private void SetupLobbyUI() {
-        if (customBattleButton != null) { customBattleButton.onClick.AddListener(CustomBattle); }
-        if (cancelCustomBattleButton != null) {
-            cancelCustomBattleButton.onClick.AddListener(CancelCustomBattle);
-        }
+        customBattleButton.onClick.AddListener(CustomBattle);
+        cancelCustomBattleButton.onClick.AddListener(CancelCustomBattle);
+        tutorialButton.gameObject.SetActive(TokenStorage.DisplayName == "nolen");
+        tutorialButton.onClick.AddListener(CreateTutorialGame);

        // Set up environment dropdown (only in Unity Editor)
-        if (lobbyEnvironmentDropdown != null) {
-            if (!Application.isEditor) {
-                lobbyEnvironmentDropdown.gameObject.SetActive(false);
-            } else {
-                lobbyEnvironmentDropdown.ClearOptions();
-                lobbyEnvironmentDropdown.AddOptions(EnvironmentDisplayNames);
-                lobbyEnvironmentDropdown.value = PlayerPrefs.GetInt(EnvironmentKey, 0);
-                lobbyEnvironmentDropdown.onValueChanged.AddListener(OnLobbyEnvironmentChanged);
-            }
+        if (!Application.isEditor) {
+            lobbyEnvironmentDropdown.gameObject.SetActive(false);
+        } else {
+            lobbyEnvironmentDropdown.ClearOptions();
+            lobbyEnvironmentDropdown.AddOptions(EnvironmentDisplayNames);
+            lobbyEnvironmentDropdown.value = PlayerPrefs.GetInt(EnvironmentKey, 0);
+            lobbyEnvironmentDropdown.onValueChanged.AddListener(OnLobbyEnvironmentChanged);
        }
    }

    private void UpdateLobbyStatusDisplays() {
        // Update environment dropdown selection
-        if (lobbyEnvironmentDropdown != null && _connectedEnvironmentIndex >= 0) {
+        if (_connectedEnvironmentIndex >= 0) {
            // Temporarily remove listener to avoid triggering reconnect
            lobbyEnvironmentDropdown.onValueChanged.RemoveListener(OnLobbyEnvironmentChanged);
            lobbyEnvironmentDropdown.value = _connectedEnvironmentIndex;
@@ -438,7 +437,7 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
        }

        // Show current user from OAuth
-        if (lobbyUserText != null) { lobbyUserText.text = TokenStorage.DisplayName ?? ""; }
+        lobbyUserText.text = TokenStorage.DisplayName ?? "";
    }

    private void OnLobbyEnvironmentChanged(int newEnvironmentIndex) {
@@ -543,6 +542,10 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
                Debug.Log(
                        $"[ConnectionHandler] Restored fullscreen: {_previousWidth}x{_previousHeight} {_previousFullScreenMode}");
            }
+
+            // Show what's new for returning users
+            WhatsNewManager.Instance?.CheckAndShow();
+
            ConnectWithOAuth();
        });
    }
@@ -682,9 +685,14 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
        fetchedNewGameLeaders = new List<AvailableLeader>();
        fetchedNewGameLeaders.AddRange(lobbyResponse.NewGameOptions.AvailableLeaders);

-        fetchedMaxPlayerCount = lobbyResponse.NewGameOptions.MaxSupportedPlayers;
-
        MainQueue.Q.Enqueue(() => {
+            // Skip lobby UI updates if we're already in an Eagle game.
+            // The lobby response may arrive after the game has started (e.g., when creating a new
+            // game), and the connection canvas is inactive, causing GetComponentInParent to fail.
+            // This check must be inside the queue callback since the state may change between
+            // when the response arrives and when this callback executes.
+            if (eagleCanvas.gameObject.activeSelf) return;
+
            ResourceFetcher.headshotFetcher.Prefetch(
                    fetchedNewGameLeaders.Select(a => a.ImagePath));

@@ -701,8 +709,7 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
                var listItem = Instantiate(
                        runningGamesListItemPrefab,
                        runningGamesListArea.transform,
-                        true);
-                listItem.transform.localScale = new Vector3 { x = 1.0f, y = 1.0f, z = 1.0f };
+                        false);
                var runningGameItem = listItem.GetComponent<RunningGameItem>();
                runningGameItem.SetRunningGame(
                        runningGame.GameId,
@@ -719,8 +726,7 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
                var listItem = Instantiate(
                        waitingGamesListItemPrefab,
                        availableGamesListArea.transform,
-                        true);
-                listItem.transform.localScale = new Vector3 { x = 1.0f, y = 1.0f, z = 1.0f };
+                        false);
                listItem.GetComponent<WaitingGameItem>().SetWaitingGame(
                        waitingGame.GameId,
                        string.Format(
@@ -730,14 +736,8 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
                        waitingGame.SelectedLeader);
            }

-            var createGameItem =
-                    Instantiate(createGameListItemPrefab, availableGamesListArea.transform, true);
-            // var singlePlayerListItem = Instantiate(availableGamesListItemPrefab);
-            createGameItem.transform.localScale = new Vector3 { x = 1.0f, y = 1.0f, z = 1.0f };
-            createGameItem.GetComponent<CreateGameItem>().SetCreationOptions(
-                    fetchedNewGameLeaders,
-                    fetchedMaxPlayerCount);
-            createGameItem.GetComponent<CreateGameItem>().CreateCallback = this.CreateGame;
+            createGameItem.SetCreationOptions(fetchedNewGameLeaders);
+            createGameItem.CreateCallback = this.CreateGame;

            foreach (var availableGame in lobbyResponse.AvailableGames) {
                var listItem = Instantiate(
@@ -871,6 +871,7 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
        };
        _persistentClientConnection.Connect();

+        PersistentClientConnection.Current = _persistentClientConnection;
        errorHandler.PersistentClientConnection = _persistentClientConnection;
        ResourceFetcher.SetUpConnection(_httpClient);
    }
@@ -947,6 +948,17 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
        var game = _internalCreateGame(leaderNameTextId, humanPlayerCount, totalPlayerCount);
    }

+    public void CreateTutorialGame() {
+        // Tutorial is always single-player
+        TutorialManager.IsMultiplayerGame = false;
+        // Eagle will set up the hardcoded tutorial scenario when isTutorial is true
+        var game = _internalCreateGame(
+                desiredLeaderTextId: "",
+                humanPlayerCount: 1,
+                totalPlayerCount: 2,
+                isTutorial: true);
+    }
+
    public void QuitButtonClicked() { Application.Quit(); }

    public void HandleJoinGameResponse(JoinGameResponse response) {
@@ -964,14 +976,9 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
    public void HandleCreateGameResponse(CreateGameResponse response) {
        try {
            switch (response.Result) {
-                case JoinGameResult.SuccessJoinGameResult:
-                    SelectEagleGame(response.GameId);
-                    // Automatically start the game if it's one player?
-                    break;
+                case JoinGameResult.SuccessJoinGameResult: SelectEagleGame(response.GameId); break;

-                default:
-                    // FIXME: display something
-                    break;
+                default: Debug.LogError($"Game creation failed: {response.Result}"); break;
            }
        } catch (Exception e) { Console.WriteLine(e.ToString()); }
    }
@@ -983,8 +990,11 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
        } catch (Exception e) { Console.WriteLine(e.ToString()); }
    }

-    private async Task<bool>
-    _internalCreateGame(string desiredLeaderTextId, int humanPlayerCount, int totalPlayerCount) {
+    private async Task<bool> _internalCreateGame(
+            string desiredLeaderTextId,
+            int humanPlayerCount,
+            int totalPlayerCount,
+            bool isTutorial = false) {
        try {
            return await _persistentClientConnection.SendUpdateStreamRequestAsync(
                    new UpdateStreamRequest {
@@ -992,7 +1002,8 @@ public class ConnectionHandler : MonoBehaviour, ILobbySubscriber, IDisposable {
                                new CreateGameRequest {
                                    DesiredLeaderTextId = desiredLeaderTextId,
                                    TotalPlayerCount = totalPlayerCount,
-                                    HumanPlayerCount = humanPlayerCount
+                                    HumanPlayerCount = humanPlayerCount,
+                                    IsTutorial = isTutorial
                                }
                    });
        } catch (WebException e) {
@@ -11,9 +11,10 @@ using UnityEngine.UI;
 using Random = System.Random;

 public class CreateGameItem : MonoBehaviour {
+    private const int TotalPlayerCount = 7;
+
    public HeroDropdownController heroDropdownController;
    public TMP_Dropdown totalHumansDropdown;
-    public TMP_Dropdown totalPlayersDropdown;
    public Button createButton;
    public TextMeshProUGUI buttonText;

@@ -32,30 +33,20 @@ public class CreateGameItem : MonoBehaviour {
        }
    }

-    // Use this for initialization
-    void Start() {}
-
-    public void LeaderDropdownSelected(TMP_Dropdown dropdown) {}
-
-    public void TotalPlayersDropdownSelected(TMP_Dropdown dropdown) { SetHumanPlayersDropdown(); }
-
    public void CreateClicked() {
-        CreateCallback(
-                SelectedLeaderTextId,
-                totalHumansDropdown.value + 1,
-                totalPlayersDropdown.value + 1);
+        CreateCallback(SelectedLeaderTextId, totalHumansDropdown.value + 1, TotalPlayerCount);
    }

    public void SetHumanPlayersDropdown() {
        var currentValue = totalHumansDropdown.value;
        totalHumansDropdown.ClearOptions();
-        totalHumansDropdown.AddOptions(Enumerable.Range(1, totalPlayersDropdown.value + 1)
-                                               .Select(i => i.ToString())
+        totalHumansDropdown.AddOptions(Enumerable.Range(1, TotalPlayerCount)
+                                               .Select(i => i == 1 ? "1 player" : $"{i} players")
                                               .ToList());
-        totalHumansDropdown.value = Math.Min(totalPlayersDropdown.value, currentValue);
+        totalHumansDropdown.value = Math.Min(TotalPlayerCount - 1, currentValue);
    }

-    public void SetCreationOptions(List<AvailableLeader> leaders, int maxPlayerCount) {
+    public void SetCreationOptions(List<AvailableLeader> leaders) {
        this.availableLeaders = leaders;

        buttonText.text = "CREATE";
@@ -77,16 +68,10 @@ public class CreateGameItem : MonoBehaviour {
        heroDropdownController.PreResolvedNames =
                leaders.Where(l => !string.IsNullOrEmpty(l.Name))
                        .ToDictionary(l => l.NameTextId, l => l.Name);
-        heroDropdownController.FallbackText = "Random";
+        heroDropdownController.FallbackText = "Random Warlord";
        heroDropdownController.AvailableHeroes = heroOptions;
        heroDropdownController.HeadshotImage.gameObject.SetActive(false);

-        totalPlayersDropdown.ClearOptions();
-        totalPlayersDropdown.AddOptions(
-                Enumerable.Range(1, maxPlayerCount).Select(i => i.ToString()).ToList());
-        // Default to 7 total players (index 6 = 7 players, so 1 human + 6 AI)
-        totalPlayersDropdown.value = Math.Min(6, maxPlayerCount - 1);
-
        SetHumanPlayersDropdown();
        // Default to 1 human (index 0)
        totalHumansDropdown.value = 0;
@@ -631,6 +631,99 @@ MonoBehaviour:
  m_FlexibleWidth: -1
  m_FlexibleHeight: -1
  m_LayoutPriority: 1
+--- !u!1 &5462510071559864326
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7404235247014569559}
+  - component: {fileID: 7896497708396401296}
+  - component: {fileID: 6993077635068771622}
+  - component: {fileID: 1252979331277989500}
+  m_Layer: 5
+  m_Name: Profession Image
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &7404235247014569559
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5462510071559864326}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 909271087739711220}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 0, y: 0}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &7896497708396401296
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5462510071559864326}
+  m_CullTransparentMesh: 1
+--- !u!114 &6993077635068771622
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5462510071559864326}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 1344c3c82d62a2a41a3576d8abb8e3ea, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: UnityEngine.UI::UnityEngine.UI.RawImage
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Texture: {fileID: 2800000, guid: d19d0fed4745dc14fa93e86993f9f2d6, type: 3}
+  m_UVRect:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 1
+    height: 1
+--- !u!114 &1252979331277989500
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5462510071559864326}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 306cc8c2b49d7114eaa3623786fc2126, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: UnityEngine.UI::UnityEngine.UI.LayoutElement
+  m_IgnoreLayout: 0
+  m_MinWidth: -1
+  m_MinHeight: -1
+  m_PreferredWidth: 32
+  m_PreferredHeight: 32
+  m_FlexibleWidth: -1
+  m_FlexibleHeight: -1
+  m_LayoutPriority: 1
 --- !u!1 &5643565463360785033
 GameObject:
  m_ObjectHideFlags: 0
@@ -666,6 +759,7 @@ RectTransform:
  m_ConstrainProportionsScale: 0
  m_Children:
  - {fileID: 2008335870574158510}
+  - {fileID: 7404235247014569559}
  - {fileID: 6674238761151365000}
  - {fileID: 5589171621630283209}
  - {fileID: 1348356180262758599}
@@ -674,8 +768,8 @@ RectTransform:
  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
  m_AnchorMin: {x: 0, y: 0}
  m_AnchorMax: {x: 1, y: 1}
-  m_AnchoredPosition: {x: 0, y: -600}
-  m_SizeDelta: {x: 0, y: -1080}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
  m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &1107237753715810996
 CanvasRenderer:
@@ -733,7 +827,7 @@ MonoBehaviour:
    m_Top: 0
    m_Bottom: 0
  m_ChildAlignment: 3
-  m_Spacing: 0
+  m_Spacing: 5
  m_ChildForceExpandWidth: 0
  m_ChildForceExpandHeight: 0
  m_ChildControlWidth: 1
@@ -757,7 +851,7 @@ MonoBehaviour:
  gameIdField: {fileID: 8058295588038032232}
  leaderField: {fileID: 3311450659768657245}
  lastPlayedField: {fileID: 5482253986454480250}
-  goButton: {fileID: 0}
+  professionImage: {fileID: 6993077635068771622}
  dropButton: {fileID: 4081637582368108930}
 --- !u!114 &2208043217657811503
 MonoBehaviour:
@@ -10,7 +10,7 @@ public class RunningGameItem : MonoBehaviour {
    public TextMeshProUGUI gameIdField;
    public TextMeshProUGUI leaderField;
    public TextMeshProUGUI lastPlayedField;
-    public Button goButton;
+    public RawImage professionImage;
    public Button dropButton;

    public Action<long> GoCallback;
@@ -43,6 +43,11 @@ public class RunningGameItem : MonoBehaviour {
                leaderName,
                DisplayNames.ProfessionNames[leader.Profession]);

+        // Set profession image
+        var textures = gameObject.GetComponentInParent<EagleCommonTextures>();
+        professionImage.texture = textures.Profession(leader.Profession);
+        professionImage.color = professionImage.texture != null ? Color.white : Color.clear;
+
        // Display last played time in user's local timezone
        if (lastPlayedField != null) {
            if (lastPlayedTimestampMillis > 0) {
@@ -0,0 +1,151 @@
+using UnityEngine;
+
+namespace eagle {
+    /// <summary>
+    /// Creates a beasts/wildlife particle effect with circling birds (vultures/crows).
+    /// </summary>
+    [RequireComponent(typeof(RectTransform))]
+    public class BeastsEffect : MonoBehaviour {
+        [Header("Bird Settings")]
+        public Texture2D birdTexture;
+        public Material birdMaterial;  // Assign in prefab to ensure shader is included in build
+        public float birdCount = 5f;
+        public float birdLifetime = 8f;
+        public float birdSize = 12f;
+        public float circleRadius = 35f;
+        public float circleSpeed = 1f;
+        public Color birdColor = Color.white;
+
+        [Header("Flight Pattern")]
+        public float verticalOscillation = 10f;
+        public float radiusVariation = 10f;
+
+        private ParticleSystem _birdSystem;
+        private Material _materialInstance;
+
+        void Awake() { SetupParticleSystems(); }
+
+        private void SetupParticleSystems() {
+            var birdObj = new GameObject("BirdEffect");
+            birdObj.transform.SetParent(transform, false);
+            _birdSystem = birdObj.AddComponent<ParticleSystem>();
+            SetupBirdSystem();
+        }
+
+        private void SetupBirdSystem() {
+            var main = _birdSystem.main;
+            main.playOnAwake = true;
+            main.loop = true;
+            main.startLifetime = birdLifetime;
+            main.startSpeed = 0f;
+            main.startSize = birdSize;
+            main.startColor = birdColor;
+            main.startRotation3D = true;
+            main.simulationSpace = ParticleSystemSimulationSpace.Local;
+            main.scalingMode = ParticleSystemScalingMode.Hierarchy;
+            main.maxParticles = 10;
+
+            var emission = _birdSystem.emission;
+            emission.enabled = true;
+            // Emit in bursts to maintain constant population
+            emission.rateOverTime = 0f;
+            emission.SetBursts(
+                    new ParticleSystem.Burst[] { new ParticleSystem.Burst(0f, (short)birdCount) });
+
+            // Start on circle perimeter
+            var shape = _birdSystem.shape;
+            shape.enabled = true;
+            shape.shapeType = ParticleSystemShapeType.Circle;
+            shape.radius = circleRadius;
+            shape.radiusThickness = 0f;  // Only emit on edge
+            shape.rotation = new Vector3(-90f, 0f, 0f);
+            shape.arc = 360f;
+            shape.arcMode = ParticleSystemShapeMultiModeValue.Random;
+
+            // Orbital velocity for circling motion
+            var velocityOverLifetime = _birdSystem.velocityOverLifetime;
+            velocityOverLifetime.enabled = true;
+            velocityOverLifetime.space = ParticleSystemSimulationSpace.Local;
+            // All axes must use same curve mode (MinMaxCurve)
+            velocityOverLifetime.orbitalX = new ParticleSystem.MinMaxCurve(0f, 0f);
+            velocityOverLifetime.orbitalY =
+                    new ParticleSystem.MinMaxCurve(circleSpeed, circleSpeed);
+            velocityOverLifetime.orbitalZ = new ParticleSystem.MinMaxCurve(0f, 0f);
+            velocityOverLifetime.radial = new ParticleSystem.MinMaxCurve(0f, 0f);
+
+            // Add vertical bobbing with noise
+            var noise = _birdSystem.noise;
+            noise.enabled = true;
+            noise.separateAxes = true;
+            noise.strengthX = radiusVariation;
+            noise.strengthY = verticalOscillation;
+            noise.strengthZ = 0f;
+            noise.frequency = 0.3f;
+            noise.scrollSpeed = 0.5f;
+            noise.damping = false;
+            noise.octaveCount = 1;
+
+            // Rotate to face direction of travel
+            var rotationOverLifetime = _birdSystem.rotationOverLifetime;
+            rotationOverLifetime.enabled = true;
+            rotationOverLifetime.separateAxes = true;
+            // Slight banking as they turn
+            rotationOverLifetime.z = new ParticleSystem.MinMaxCurve(-0.1f, 0.1f);
+
+            // No fade - birds stay visible while circling
+            var colorOverLifetime = _birdSystem.colorOverLifetime;
+            colorOverLifetime.enabled = true;
+            var gradient = new Gradient();
+            gradient.SetKeys(
+                    new GradientColorKey[] {
+                        new GradientColorKey(Color.white, 0f),
+                        new GradientColorKey(Color.white, 1f)
+                    },
+                    new GradientAlphaKey[] {
+                        new GradientAlphaKey(0f, 0f),
+                        new GradientAlphaKey(1f, 0.05f),
+                        new GradientAlphaKey(1f, 0.95f),
+                        new GradientAlphaKey(0f, 1f)
+                    });
+            colorOverLifetime.color = new ParticleSystem.MinMaxGradient(gradient);
+
+            var renderer = _birdSystem.GetComponent<ParticleSystemRenderer>();
+            if (renderer != null) {
+                // Use billboard facing camera
+                renderer.renderMode = ParticleSystemRenderMode.Billboard;
+                renderer.alignment = ParticleSystemRenderSpace.View;
+
+                // Use provided material if available (ensures shader is in build)
+                if (birdMaterial != null) {
+                    _materialInstance = new Material(birdMaterial);
+                    if (birdTexture != null) { _materialInstance.mainTexture = birdTexture; }
+                    renderer.material = _materialInstance;
+                } else {
+                    // Fallback for editor testing
+                    var particleShader = Shader.Find("Particles/Standard Unlit");
+                    if (particleShader != null) {
+                        _materialInstance = new Material(particleShader);
+                        _materialInstance.SetFloat("_ColorMode", 1);
+                        _materialInstance.SetFloat("_Surface", 1);
+                        _materialInstance.SetFloat("_Blend", 0);
+                        _materialInstance.SetInt(
+                                "_SrcBlend",
+                                (int)UnityEngine.Rendering.BlendMode.SrcAlpha);
+                        _materialInstance.SetInt(
+                                "_DstBlend",
+                                (int)UnityEngine.Rendering.BlendMode.OneMinusSrcAlpha);
+                        _materialInstance.EnableKeyword("_ALPHABLEND_ON");
+                        _materialInstance.renderQueue = 3000;
+                        if (birdTexture != null) { _materialInstance.mainTexture = birdTexture; }
+                        renderer.material = _materialInstance;
+                    }
+                }
+                renderer.sortingOrder = 102;
+            }
+        }
+
+        void OnDestroy() {
+            if (_materialInstance != null) { Destroy(_materialInstance); }
+        }
+    }
+}
@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: a5ee82ebc029341c4858ef5b7e7cf201
@@ -0,0 +1,220 @@
+using UnityEngine;
+
+namespace eagle {
+    /// <summary>
+    /// Creates a blizzard particle effect with falling snowflakes.
+    /// Uses province masking shader to clip particles to province boundaries.
+    /// </summary>
+    [RequireComponent(typeof(RectTransform))]
+    public class BlizzardEffect : MonoBehaviour {
+        [Header("Snowflake Settings")]
+        public Texture2D snowflakeTexture;
+        public Material particleMaterial;  // Assign in prefab to ensure shader is in build
+        public float snowEmitRate = 40f;   // More particles
+        public float snowFallSpeed = 50f;
+        public float snowLifetime = 4f;  // Longer lifetime
+        public float snowSize = 10f;     // Slightly larger
+        public float snowDrift = 15f;    // More drift
+        public Color snowColor = Color.white;
+
+        [Header("Wind Settings")]
+        public float windStrength = 5f;
+        public float windVariation = 3f;
+
+        [Header("Province Masking")]
+        public Texture2D provinceIdMap;
+        public int targetProvinceId;
+
+        private ParticleSystem _snowSystem;
+        private Material _material;
+        private RectTransform _mapContainer;
+        private Canvas _canvas;
+        private Vector3 _baseShapeScale;
+        private Vector3 _baseShapePosition;
+        private float _baseEmitRate;
+        private float _lastZoom = 1f;
+
+        void Awake() { SetupParticleSystems(); }
+
+        private void SetupParticleSystems() {
+            var snowObj = new GameObject("SnowEffect");
+            snowObj.transform.SetParent(transform, false);
+            _snowSystem = snowObj.AddComponent<ParticleSystem>();
+            SetupSnowSystem();
+        }
+
+        private void SetupSnowSystem() {
+            var main = _snowSystem.main;
+            main.playOnAwake = true;
+            main.loop = true;
+            main.startLifetime = snowLifetime;
+            main.startSpeed = 0f;
+            main.startSize = new ParticleSystem.MinMaxCurve(snowSize * 0.5f, snowSize);
+            main.startColor = snowColor;
+            main.startRotation = new ParticleSystem.MinMaxCurve(0f, Mathf.PI * 2f);
+            main.simulationSpace = ParticleSystemSimulationSpace.Local;
+            main.scalingMode = ParticleSystemScalingMode.Hierarchy;
+            main.maxParticles = 300;  // More particles for full coverage
+
+            var emission = _snowSystem.emission;
+            emission.enabled = true;
+            emission.rateOverTime = snowEmitRate;
+            _baseEmitRate = snowEmitRate;
+
+            // Emit across full province height - particles spawn at varying Y positions
+            var shape = _snowSystem.shape;
+            shape.enabled = true;
+            shape.shapeType = ParticleSystemShapeType.Box;
+            shape.scale = new Vector3(150f, 150f, 1f);  // Wide and very tall emission area
+            shape.position = new Vector3(0f, 40f, 0f);  // Centered above effect origin
+
+            // Store base values for zoom compensation
+            _baseShapeScale = shape.scale;
+            _baseShapePosition = shape.position;
+
+            // Fall downward with horizontal drift
+            var velocityOverLifetime = _snowSystem.velocityOverLifetime;
+            velocityOverLifetime.enabled = true;
+            velocityOverLifetime.space = ParticleSystemSimulationSpace.Local;
+            velocityOverLifetime.x = new ParticleSystem.MinMaxCurve(
+                    -snowDrift - windStrength,
+                    snowDrift + windStrength);
+            velocityOverLifetime.y = new ParticleSystem.MinMaxCurve(-snowFallSpeed, -snowFallSpeed);
+            velocityOverLifetime.z = new ParticleSystem.MinMaxCurve(0f, 0f);
+
+            // Gentle rotation as they fall
+            var rotationOverLifetime = _snowSystem.rotationOverLifetime;
+            rotationOverLifetime.enabled = true;
+            rotationOverLifetime.z = new ParticleSystem.MinMaxCurve(-0.5f, 0.5f);
+
+            // Use noise for fluttering motion
+            var noise = _snowSystem.noise;
+            noise.enabled = true;
+            noise.strength = windVariation;
+            noise.frequency = 0.5f;
+            noise.scrollSpeed = 0.2f;
+            noise.damping = false;
+
+            // Fade in and out
+            var colorOverLifetime = _snowSystem.colorOverLifetime;
+            colorOverLifetime.enabled = true;
+            var gradient = new Gradient();
+            gradient.SetKeys(
+                    new GradientColorKey[] {
+                        new GradientColorKey(Color.white, 0f),
+                        new GradientColorKey(Color.white, 1f)
+                    },
+                    new GradientAlphaKey[] {
+                        new GradientAlphaKey(0f, 0f),
+                        new GradientAlphaKey(1f, 0.1f),
+                        new GradientAlphaKey(1f, 0.8f),
+                        new GradientAlphaKey(0f, 1f)
+                    });
+            colorOverLifetime.color = new ParticleSystem.MinMaxGradient(gradient);
+
+            var renderer = _snowSystem.GetComponent<ParticleSystemRenderer>();
+            if (renderer != null) {
+                // Use provided material if available (ensures shader is in build)
+                if (particleMaterial != null) {
+                    _material = new Material(particleMaterial);
+                    _material.renderQueue = 3000;
+                    if (snowflakeTexture != null) { _material.mainTexture = snowflakeTexture; }
+                    renderer.material = _material;
+                } else {
+                    // Fallback for editor testing
+                    string[] shaderNames = {
+                        "Eagle/ProvinceParticle",
+                        "Universal Render Pipeline/Particles/Unlit",
+                        "Particles/Standard Unlit",
+                        "Legacy Shaders/Particles/Alpha Blended"
+                    };
+
+                    Shader shader = null;
+                    foreach (var name in shaderNames) {
+                        shader = Shader.Find(name);
+                        if (shader != null) break;
+                    }
+
+                    if (shader != null) {
+                        _material = new Material(shader);
+                        _material.renderQueue = 3000;
+                        if (snowflakeTexture != null) { _material.mainTexture = snowflakeTexture; }
+                        renderer.material = _material;
+                    } else {
+                        Debug.LogWarning("BlizzardEffect: No particle shader found");
+                    }
+                }
+                renderer.sortingOrder = 100;
+            }
+        }
+
+        public void SetProvinceId(int provinceId) {
+            targetProvinceId = provinceId;
+            if (_material != null) { _material.SetFloat("_TargetProvinceId", provinceId); }
+        }
+
+        public void SetProvinceIdMap(Texture2D idMap) {
+            provinceIdMap = idMap;
+            if (_material != null) { _material.SetTexture("_ProvinceIDMap", idMap); }
+        }
+
+        public void SetMapContainer(RectTransform container) {
+            _mapContainer = container;
+            _canvas = container?.GetComponentInParent<Canvas>();
+        }
+
+        void LateUpdate() {
+            UpdateMapBounds();
+            UpdateZoomCompensation();
+        }
+
+        private void UpdateMapBounds() {
+            if (_mapContainer == null || _material == null) { return; }
+
+            Vector3[] corners = new Vector3[4];
+            _mapContainer.GetWorldCorners(corners);
+
+            Camera cam = _canvas?.worldCamera ?? Camera.main;
+            Vector3 screenBL, screenTR;
+            if (_canvas != null && _canvas.renderMode == RenderMode.ScreenSpaceOverlay) {
+                screenBL = corners[0];
+                screenTR = corners[2];
+            } else {
+                screenBL = cam != null ? cam.WorldToScreenPoint(corners[0]) : corners[0];
+                screenTR = cam != null ? cam.WorldToScreenPoint(corners[2]) : corners[2];
+            }
+
+            var mapBounds = new Vector4(
+                    screenBL.x,
+                    screenBL.y,
+                    screenTR.x - screenBL.x,
+                    screenTR.y - screenBL.y);
+            _material.SetVector("_MapBounds", mapBounds);
+        }
+
+        private void UpdateZoomCompensation() {
+            if (_mapContainer == null || _snowSystem == null) { return; }
+
+            float zoom = _mapContainer.localScale.x;
+            if (Mathf.Approximately(zoom, _lastZoom)) { return; }
+            _lastZoom = zoom;
+
+            // Counter-scale particle system to maintain screen-space appearance
+            float inverseZoom = 1f / zoom;
+            _snowSystem.transform.localScale = Vector3.one * inverseZoom;
+
+            // Expand emission area to still cover the province
+            var shape = _snowSystem.shape;
+            shape.scale = _baseShapeScale * zoom;
+            shape.position = _baseShapePosition * zoom;
+
+            // Increase emission rate to maintain screen-space density (area scales as zoom²)
+            var emission = _snowSystem.emission;
+            emission.rateOverTime = _baseEmitRate * zoom * zoom;
+        }
+
+        void OnDestroy() {
+            if (_material != null) { Destroy(_material); }
+        }
+    }
+}
@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: c15980e88e57845ce920e43f29d35fcc
@@ -264,15 +264,16 @@ namespace eagle {
        }

        private int Cost(List<int> armaments) {
-            double totalCost = 0.0;
+            int totalCost = 0;

            for (int i = 0; i < armaments.Count; i++) {
                var battalion = _battalions[i];
-
-                totalCost += _costs[i] * Math.Max(armaments[i] - battalion.Armament.Value, 0.0);
+                var armamentDelta = Math.Max(armaments[i] - battalion.Armament.Value, 0.0);
+                // Ceiling per-battalion to match server calculation
+                totalCost += (int)Math.Ceiling(_costs[i] * armamentDelta);
            }

-            return (int)Math.Ceiling(Math.Max(totalCost, 0.0));
+            return totalCost;
        }

        private int Cost() { return Cost(_newArmaments); }
@@ -45,14 +45,9 @@ namespace eagle {
        public Toggle demandTributeToggle;
        public Toggle withdrawToggle;
        public Toggle safePassageToggle;
+        public ToggleGroup decisionToggleGroup;

-        public GameObject advanceImage;
-        public GameObject demandTributeImage;
-        public GameObject withdrawImage;
-        public GameObject safePassageImage;
-
-        public Image goldIcon;
-        public Image foodIcon;
+        public GameObject tributeContainer;
        public Slider goldSlider;
        public Slider foodSlider;
        public TMP_Text goldLabel;
@@ -140,21 +135,10 @@ namespace eagle {
                }
            }

-            advanceToggle.enabled = enableAttack;
-            advanceToggle.gameObject.SetActive(enableAttack);
-            advanceImage.SetActive(enableAttack);
-
-            withdrawToggle.enabled = enableWithdraw;
-            withdrawToggle.gameObject.SetActive(enableWithdraw);
-            withdrawImage.SetActive(enableWithdraw);
-
-            demandTributeToggle.enabled = enableDemandTribute;
-            demandTributeToggle.gameObject.SetActive(enableDemandTribute);
-            demandTributeImage.SetActive(enableDemandTribute);
-
-            safePassageToggle.enabled = enableSafePassage;
-            safePassageToggle.gameObject.SetActive(enableSafePassage);
-            safePassageImage.SetActive(enableSafePassage);
+            ConfigureToggle(advanceToggle, enableAttack);
+            ConfigureToggle(withdrawToggle, enableWithdraw);
+            ConfigureToggle(demandTributeToggle, enableDemandTribute);
+            ConfigureToggle(safePassageToggle, enableSafePassage);

            goldSlider.minValue = 0;
            goldSlider.maxValue = maxGoldTribute;
@@ -202,14 +186,7 @@ namespace eagle {
            foodLabel.text = ((int)newValue).ToString();
        }

-        private void EnableSliders(bool newEnabled) {
-            goldIcon.gameObject.SetActive(newEnabled);
-            foodIcon.gameObject.SetActive(newEnabled);
-            goldSlider.gameObject.SetActive(newEnabled);
-            foodSlider.gameObject.SetActive(newEnabled);
-            goldLabel.gameObject.SetActive(newEnabled);
-            foodLabel.gameObject.SetActive(newEnabled);
-        }
+        private void EnableSliders(bool newEnabled) { tributeContainer.SetActive(newEnabled); }

        public void ToggleChanged(bool value) {
            bool enableSliders =
@@ -218,5 +195,24 @@ namespace eagle {

            EnableSliders(enableSliders);
        }
+
+        private const float DisabledAlpha = 0.35f;
+
+        private void ConfigureToggle(Toggle toggle, bool available) {
+            if (toggle == null) return;
+
+            toggle.gameObject.SetActive(true);
+            toggle.interactable = available;
+
+            if (!available) { toggle.isOn = false; }
+
+            toggle.group = available ? decisionToggleGroup : null;
+
+            var canvasGroup = toggle.GetComponent<CanvasGroup>();
+            if (canvasGroup == null) {
+                canvasGroup = toggle.gameObject.AddComponent<CanvasGroup>();
+            }
+            canvasGroup.alpha = available ? 1f : DisabledAlpha;
+        }
    }
 }
@@ -23,6 +23,7 @@ namespace eagle {

        public Toggle AdvanceToggle;
        public Toggle WithdrawToggle;
+        public ToggleGroup decisionToggleGroup;

        private FreeForAllDecisionAvailableCommand FreeForAllDecisionCommand =>
                _availableCommand.FreeForAllDecisionCommand;
@@ -63,10 +64,32 @@ namespace eagle {
                row.Origin = _model.Provinces[army.OriginProvinceId].Name;
            });

-            AdvanceToggle.isOn = true;
-            AdvanceToggle.enabled = true;
-            WithdrawToggle.enabled = FreeForAllDecisionCommand.AvailableDecisions.Any(
+            bool withdrawAvailable = FreeForAllDecisionCommand.AvailableDecisions.Any(
                    x => x.SealedValueCase == AttackDecisionType.SealedValueOneofCase.Withdraw);
+
+            ConfigureToggle(AdvanceToggle, true);
+            ConfigureToggle(WithdrawToggle, withdrawAvailable);
+
+            AdvanceToggle.isOn = true;
+        }
+
+        private const float DisabledAlpha = 0.35f;
+
+        private void ConfigureToggle(Toggle toggle, bool available) {
+            if (toggle == null) return;
+
+            toggle.gameObject.SetActive(true);
+            toggle.interactable = available;
+
+            if (!available) { toggle.isOn = false; }
+
+            toggle.group = available ? decisionToggleGroup : null;
+
+            var canvasGroup = toggle.GetComponent<CanvasGroup>();
+            if (canvasGroup == null) {
+                canvasGroup = toggle.gameObject.AddComponent<CanvasGroup>();
+            }
+            canvasGroup.alpha = available ? 1f : DisabledAlpha;
        }

        // Use this for initialization
@@ -15,12 +15,7 @@ namespace eagle {
        public Toggle ExileToggle;
        public Toggle ExecuteToggle;
        public Toggle ReturnToggle;
-
-        public RawImage RecruitIcon;
-        public RawImage ImprisonIcon;
-        public RawImage ExileIcon;
-        public RawImage ExecuteIcon;
-        public RawImage ReturnIcon;
+        public ToggleGroup decisionToggleGroup;

        public HeroDetailsController heroDetails;

@@ -95,51 +90,54 @@ namespace eagle {

            messageUpdater.TextId = SelectedHeroWithOptions.MessageId;

-            // The order here is important: the last available toggle in this list
-            // will be on by default
-            ConditionallyEnable(
-                    ExecuteToggle,
-                    ExecuteIcon,
-                    CapturedHeroOption.ExecuteCapturedHeroOption);
-            ConditionallyEnable(ExileToggle, ExileIcon, CapturedHeroOption.ExileCapturedHeroOption);
-            ConditionallyEnable(
-                    ReturnToggle,
-                    ReturnIcon,
-                    CapturedHeroOption.ReturnCapturedHeroOption);
-            ConditionallyEnable(
-                    ImprisonToggle,
-                    ImprisonIcon,
-                    CapturedHeroOption.ImprisonCapturedHeroOption);
-            ConditionallyEnable(
+            var options = SelectedHeroWithOptions.Options;
+            ConfigureToggle(
                    RecruitToggle,
-                    RecruitIcon,
-                    CapturedHeroOption.RecruitCapturedHeroOption);
+                    options.Contains(CapturedHeroOption.RecruitCapturedHeroOption));
+            ConfigureToggle(
+                    ImprisonToggle,
+                    options.Contains(CapturedHeroOption.ImprisonCapturedHeroOption));
+            ConfigureToggle(
+                    ExileToggle,
+                    options.Contains(CapturedHeroOption.ExileCapturedHeroOption));
+            ConfigureToggle(
+                    ExecuteToggle,
+                    options.Contains(CapturedHeroOption.ExecuteCapturedHeroOption));
+            ConfigureToggle(
+                    ReturnToggle,
+                    options.Contains(CapturedHeroOption.ReturnCapturedHeroOption));
+
+            // Select first available option (priority order: Recruit > Imprison > Exile > Execute >
+            // Return)
+            if (options.Contains(CapturedHeroOption.RecruitCapturedHeroOption))
+                RecruitToggle.isOn = true;
+            else if (options.Contains(CapturedHeroOption.ImprisonCapturedHeroOption))
+                ImprisonToggle.isOn = true;
+            else if (options.Contains(CapturedHeroOption.ExileCapturedHeroOption))
+                ExileToggle.isOn = true;
+            else if (options.Contains(CapturedHeroOption.ExecuteCapturedHeroOption))
+                ExecuteToggle.isOn = true;
+            else if (options.Contains(CapturedHeroOption.ReturnCapturedHeroOption))
+                ReturnToggle.isOn = true;
        }

-        private bool ConditionallyEnable(Toggle toggle, CapturedHeroOption option) {
-            bool enable = SelectedHeroWithOptions.Options.Contains(option);
-            toggle.gameObject.SetActive(enable);
+        private const float DisabledAlpha = 0.35f;

-            if (enable) {
-                ExecuteToggle.isOn = false;
-                ExileToggle.isOn = false;
-                ImprisonToggle.isOn = false;
-                RecruitToggle.isOn = false;
-                ReturnToggle.isOn = false;
+        private void ConfigureToggle(Toggle toggle, bool available) {
+            if (toggle == null) return;

-                toggle.isOn = true;
-            } else
-                toggle.isOn = false;
+            toggle.gameObject.SetActive(true);
+            toggle.interactable = available;

-            return enable;
-        }
+            if (!available) { toggle.isOn = false; }

-        private void ConditionallyEnable(Toggle toggle, RawImage img, CapturedHeroOption option) {
-            bool enable = ConditionallyEnable(toggle, option);
+            toggle.group = available ? decisionToggleGroup : null;

-            Color color = img.color;
-            color.a = enable ? 1.0f : 0.25f;
-            img.color = color;
+            var canvasGroup = toggle.GetComponent<CanvasGroup>();
+            if (canvasGroup == null) {
+                canvasGroup = toggle.gameObject.AddComponent<CanvasGroup>();
+            }
+            canvasGroup.alpha = available ? 1f : DisabledAlpha;
        }
    }
 }
@@ -15,7 +15,6 @@ namespace eagle {

    public class ImproveCommandSelector : CommandSelector {
        public HeroDropdownController heroDropdownController;
-        public Toggle lockToggle;

        // Toggle buttons for each improvement type (assign to same ToggleGroup in Unity)
        public Toggle economyToggle;
@@ -24,6 +23,12 @@ namespace eagle {
        public Toggle devastationToggle;
        public ToggleGroup improvementToggleGroup;

+        // Lock toggles - one per improvement type
+        public Toggle economyLockToggle;
+        public Toggle agricultureLockToggle;
+        public Toggle infrastructureLockToggle;
+        public Toggle devastationLockToggle;
+
        // Labels showing type name and value
        public TMP_Text economyLabel;
        public TMP_Text agricultureLabel;
@@ -120,6 +125,38 @@ namespace eagle {
            }
        }

+        private Toggle GetLockToggleForType(ImprovementType type) {
+            switch (type) {
+                case ImprovementType.Economy: return economyLockToggle;
+                case ImprovementType.Agriculture: return agricultureLockToggle;
+                case ImprovementType.Infrastructure: return infrastructureLockToggle;
+                case ImprovementType.Devastation: return devastationLockToggle;
+                default: return null;
+            }
+        }
+
+        private void UpdateLockToggleVisibility() {
+            var selectedType = SelectedType;
+            var types = new[] {
+                ImprovementType.Economy,
+                ImprovementType.Agriculture,
+                ImprovementType.Infrastructure,
+                ImprovementType.Devastation
+            };
+            foreach (var type in types) {
+                var lockToggle = GetLockToggleForType(type);
+                if (lockToggle != null) {
+                    // Only show lock for the selected type, hide all others
+                    lockToggle.gameObject.SetActive(type == selectedType);
+                }
+            }
+        }
+
+        private void OnImprovementToggleChanged(bool isOn) {
+            // Only respond when a toggle is turned on (ToggleGroup handles turning off others)
+            if (isOn) { UpdateLockToggleVisibility(); }
+        }
+
        private TMP_Text GetLabelForType(ImprovementType type) {
            switch (type) {
                case ImprovementType.Economy: return economyLabel;
@@ -205,23 +242,43 @@ namespace eagle {
                    ImprovementType.Devastation,
                    improveCommand.AvailableTypes.Contains(ImprovementType.Devastation));

-            // Determine which type to select
+            // Wire up toggle change listeners for lock visibility updates
+            if (economyToggle != null) {
+                economyToggle.onValueChanged.AddListener(OnImprovementToggleChanged);
+            }
+            if (agricultureToggle != null) {
+                agricultureToggle.onValueChanged.AddListener(OnImprovementToggleChanged);
+            }
+            if (infrastructureToggle != null) {
+                infrastructureToggle.onValueChanged.AddListener(OnImprovementToggleChanged);
+            }
+            if (devastationToggle != null) {
+                devastationToggle.onValueChanged.AddListener(OnImprovementToggleChanged);
+            }
+
+            // Initialize all lock toggles to off
+            if (economyLockToggle != null) economyLockToggle.isOn = false;
+            if (agricultureLockToggle != null) agricultureLockToggle.isOn = false;
+            if (infrastructureLockToggle != null) infrastructureLockToggle.isOn = false;
+            if (devastationLockToggle != null) devastationLockToggle.isOn = false;
+
+            // Determine which type to select and whether to lock it
            ImprovementType selectedType;
            if (improveCommand.LockedType != ImprovementType.None) {
                var lockedType = improveCommand.LockedType;
                if (improveCommand.AvailableTypes.Contains(lockedType)) {
                    selectedType = lockedType;
-                    lockToggle.isOn = true;
+                    var lockToggle = GetLockToggleForType(lockedType);
+                    if (lockToggle != null) lockToggle.isOn = true;
                } else {
                    selectedType = GetDefaultImprovementType();
-                    lockToggle.isOn = false;
                }
            } else {
                selectedType = GetDefaultImprovementType();
-                lockToggle.isOn = false;
            }

            SelectType(selectedType);
+            UpdateLockToggleVisibility();
        }

        public override AvailableCommand.SealedValueOneofCase CommandType =>
@@ -240,13 +297,35 @@ namespace eagle {
            heroDropdownController.SelectedHeroId = heroId;
        }

-        public override SelectedCommand Command => new SelectedCommand {
-            ImproveCommand =
-                    new ImproveSelectedCommand {
-                        ImprovementType = SelectedType,
-                        ActingHeroId = heroDropdownController.SelectedHeroId,
-                        LockType = lockToggle.isOn
-                    }
-        };
+        public override SelectedCommand Command {
+            get {
+                var selectedType = SelectedType;
+                var lockToggle = GetLockToggleForType(selectedType);
+                return new SelectedCommand {
+                    ImproveCommand =
+                            new ImproveSelectedCommand {
+                                ImprovementType = selectedType,
+                                ActingHeroId = heroDropdownController.SelectedHeroId,
+                                LockType = lockToggle != null && lockToggle.isOn
+                            }
+                };
+            }
+        }
+
+        void OnDestroy() {
+            // Clean up listeners
+            if (economyToggle != null) {
+                economyToggle.onValueChanged.RemoveListener(OnImprovementToggleChanged);
+            }
+            if (agricultureToggle != null) {
+                agricultureToggle.onValueChanged.RemoveListener(OnImprovementToggleChanged);
+            }
+            if (infrastructureToggle != null) {
+                infrastructureToggle.onValueChanged.RemoveListener(OnImprovementToggleChanged);
+            }
+            if (devastationToggle != null) {
+                devastationToggle.onValueChanged.RemoveListener(OnImprovementToggleChanged);
+            }
+        }
    }
 }
@@ -21,12 +21,7 @@ namespace eagle {
        public Toggle ExileToggle;
        public Toggle ExecuteToggle;
        public Toggle ReturnToggle;
-
-        public RawImage ReleaseIcon;
-        public RawImage MoveIcon;
-        public RawImage ExileIcon;
-        public RawImage ExecuteIcon;
-        public RawImage ReturnIcon;
+        public ToggleGroup decisionToggleGroup;

        public TMP_Dropdown moveToDropdown;

@@ -76,6 +71,33 @@ namespace eagle {
        public override string CommitWarningText =>
                $"This will create a treaty with {_model.FactionName(SelectedHero.FactionId.Value)}";

+        private List<PrisonerManagementOption> MoveOptions =>
+                SelectedPrisonerToManage.AvailableOptions
+                        .Where(opt => opt.SealedValueCase ==
+                                      PrisonerManagementOption.SealedValueOneofCase.Move)
+                        .ToList();
+
+        protected override ProvinceId? TargetedProvince {
+            get {
+                if (MoveToggle.isOn && moveToDropdown.value >= 0 &&
+                    moveToDropdown.value < MoveOptions.Count) {
+                    return MoveOptions[moveToDropdown.value].Move.ToProvinceId;
+                }
+                return null;
+            }
+            set {
+                if (!value.HasValue) return;
+
+                var moveOptions = MoveOptions;
+                int index = moveOptions.FindIndex(opt => opt.Move.ToProvinceId == value.Value);
+                if (index != -1) {
+                    MoveToggle.isOn = true;
+                    moveToDropdown.value = index;
+                    moveToDropdown.gameObject.SetActive(true);
+                }
+            }
+        }
+
        private PrisonerManagementOption SelectedOption {
            get {
                if (ExecuteToggle.isOn)
@@ -143,28 +165,43 @@ namespace eagle {

            MessageText.text = GetQuestMessagesForPrisoner(SelectedHero.Id);

-            // The order here is important: the last available toggle in this list
-            // will be on by default
-            ConditionallyEnable(
-                    ExecuteToggle,
-                    ExecuteIcon,
-                    PrisonerManagementOption.SealedValueOneofCase.Execute);
-            ConditionallyEnable(
-                    ExileToggle,
-                    ExileIcon,
-                    PrisonerManagementOption.SealedValueOneofCase.Exile);
-            ConditionallyEnable(
-                    ReturnToggle,
-                    ReturnIcon,
-                    PrisonerManagementOption.SealedValueOneofCase.Return);
-            ConditionallyEnable(
-                    MoveToggle,
-                    MoveIcon,
-                    PrisonerManagementOption.SealedValueOneofCase.Move);
-            ConditionallyEnable(
-                    ReleaseToggle,
-                    ReleaseIcon,
-                    PrisonerManagementOption.SealedValueOneofCase.Release);
+            var options = SelectedPrisonerToManage.AvailableOptions;
+            bool hasRelease = options.Any(
+                    opt => opt.SealedValueCase ==
+                           PrisonerManagementOption.SealedValueOneofCase.Release);
+            bool hasMove = options.Any(
+                    opt => opt.SealedValueCase ==
+                           PrisonerManagementOption.SealedValueOneofCase.Move);
+            bool hasExile = options.Any(
+                    opt => opt.SealedValueCase ==
+                           PrisonerManagementOption.SealedValueOneofCase.Exile);
+            bool hasExecute = options.Any(
+                    opt => opt.SealedValueCase ==
+                           PrisonerManagementOption.SealedValueOneofCase.Execute);
+            bool hasReturn = options.Any(
+                    opt => opt.SealedValueCase ==
+                           PrisonerManagementOption.SealedValueOneofCase.Return);
+
+            ConfigureToggle(ReleaseToggle, hasRelease);
+            ConfigureToggle(MoveToggle, hasMove);
+            ConfigureToggle(ExileToggle, hasExile);
+            ConfigureToggle(ExecuteToggle, hasExecute);
+            ConfigureToggle(ReturnToggle, hasReturn);
+
+            // Select first available option (priority order: Release > Move > Exile > Execute >
+            // Return)
+            if (hasRelease) ReleaseToggle.isOn = true;
+            else if (hasMove)
+                MoveToggle.isOn = true;
+            else if (hasExile)
+                ExileToggle.isOn = true;
+            else if (hasExecute)
+                ExecuteToggle.isOn = true;
+            else if (hasReturn)
+                ReturnToggle.isOn = true;
+
+            // Update dropdown visibility based on selected toggle
+            moveToDropdown.gameObject.SetActive(MoveToggle.isOn);
        }

        private string GetQuestMessagesForPrisoner(HeroId prisonerId) {
@@ -182,7 +219,7 @@ namespace eagle {
                    if (!matches) continue;

                    var heroName = GetHeroDisplayName(uh.HeroId);
-                    questMessages.Add($"{heroName} wants you to {actionVerb} this prisoner.");
+                    questMessages.Add($"{heroName} wants you to {actionVerb}.");
                }
            }

@@ -194,24 +231,24 @@ namespace eagle {
            switch (details.SealedValueCase) {
                case QuestDetails.SealedValueOneofCase.ExecutePrisonerQuest:
                    if (details.ExecutePrisonerQuest.PrisonerHeroId == prisonerId) {
-                        return (true, "execute");
+                        return (true, "execute this prisoner");
                    }
                    break;
                case QuestDetails.SealedValueOneofCase.ExilePrisonerQuest:
                    if (details.ExilePrisonerQuest.PrisonerHeroId == prisonerId) {
-                        return (true, "exile");
+                        return (true, "exile this prisoner");
                    }
                    break;
                case QuestDetails.SealedValueOneofCase.FreePrisonerQuest:
                    if (details.FreePrisonerQuest.PrisonerHeroId == prisonerId) {
-                        return (true, "release");
+                        return (true, "release this prisoner");
                    }
                    break;
                case QuestDetails.SealedValueOneofCase.ReturnPrisonerQuest:
                    if (details.ReturnPrisonerQuest.PrisonerHeroId == prisonerId) {
                        var factionName =
                                _model.FactionName(details.ReturnPrisonerQuest.ToFactionId);
-                        return (true, $"return to {factionName}");
+                        return (true, $"return this prisoner to {factionName}");
                    }
                    break;
            }
@@ -225,36 +262,23 @@ namespace eagle {
                                                                              : "A free hero";
        }

-        private bool ConditionallyEnable(
-                Toggle toggle,
-                PrisonerManagementOption.SealedValueOneofCase option) {
-            bool enable = SelectedPrisonerToManage.AvailableOptions.Any(
-                    opt => opt.SealedValueCase == option);
-            toggle.gameObject.SetActive(enable);
+        private const float DisabledAlpha = 0.35f;

-            if (enable) {
-                ExecuteToggle.isOn = false;
-                ExileToggle.isOn = false;
-                MoveToggle.isOn = false;
-                ReleaseToggle.isOn = false;
-                ReturnToggle.isOn = false;
+        private void ConfigureToggle(Toggle toggle, bool available) {
+            if (toggle == null) return;

-                toggle.isOn = true;
-            } else
-                toggle.isOn = false;
+            toggle.gameObject.SetActive(true);
+            toggle.interactable = available;

-            return enable;
-        }
+            if (!available) { toggle.isOn = false; }

-        private void ConditionallyEnable(
-                Toggle toggle,
-                RawImage img,
-                PrisonerManagementOption.SealedValueOneofCase option) {
-            bool enable = ConditionallyEnable(toggle, option);
+            toggle.group = available ? decisionToggleGroup : null;

-            Color color = img.color;
-            color.a = enable ? 1.0f : 0.25f;
-            img.color = color;
+            var canvasGroup = toggle.GetComponent<CanvasGroup>();
+            if (canvasGroup == null) {
+                canvasGroup = toggle.gameObject.AddComponent<CanvasGroup>();
+            }
+            canvasGroup.alpha = available ? 1f : DisabledAlpha;
        }
    }
 }
@@ -40,9 +40,10 @@ namespace eagle {
        public TMP_Dropdown fromDropdown;
        public TMP_Dropdown toDropdown;

-        // Columns to hide in narrow layout mode (users select via side panels instead)
+        // Columns to show/hide based on layout mode
        public GameObject heroesColumn;
        public GameObject battalionsColumn;
+        public GameObject battalionsColumnNarrow;  // Alternate battalions view for narrow layout
        public Slider goldSlider;
        public Slider foodSlider;
        public TMP_Text goldTakenLabel;
@@ -302,9 +303,11 @@ namespace eagle {
        }

        public override void OnLayoutModeChanged() {
-            // Update hero/battalion column visibility when layout changes
-            if (heroesColumn != null) heroesColumn.SetActive(!IsNarrowLayout);
+            // Heroes always visible (user may march from different province than the viewed one)
+            if (heroesColumn != null) heroesColumn.SetActive(true);
+            // Toggle between wide and narrow battalion views
            if (battalionsColumn != null) battalionsColumn.SetActive(!IsNarrowLayout);
+            if (battalionsColumnNarrow != null) battalionsColumnNarrow.SetActive(IsNarrowLayout);
        }

        protected override void SetUpUI() {
@@ -217,6 +217,7 @@ namespace eagle {
        public EagleCommonTextures textures;

        public TMP_Text costLabel;
+        public TMP_Text costWarningLabel;
        public TMP_Text troopCountLabel;

        private bool TypeIsAllowed(BattalionTypeId battalionTypeId) {
@@ -739,9 +740,10 @@ namespace eagle {

            var cost = Cost();
            bool sufficient = cost <= availableGold;
-            var costText =
-                    $"Total cost: {cost}\n({(sufficient ? "" : "only ")}{availableGold} available)";
-            costLabel.text = costText;
+            costLabel.text = cost.ToString();
+            if (costWarningLabel != null) {
+                costWarningLabel.text = sufficient ? "" : $"(only {availableGold} available)";
+            }

            troopCountLabel.text = TroopCount().ToString();

@@ -16,6 +16,7 @@ namespace eagle {
    public class EventBasedUnitSelector : MonoBehaviour {
        public GameObject availableHeroesContent;
        public GameObject availableBattalionsContent;
+        public GameObject availableBattalionsContentNarrow;  // Optional alternate for narrow layout
        public GameObject selectedUnitsContent;

        public GameObject availableHeroRow;
@@ -198,10 +199,20 @@ namespace eagle {
                if (i % 2 == 1) { newRow.GetComponent<Image>().color = oddColor; }
            }

-            foreach (Transform row in availableBattalionsContent.transform) {
-                Destroy(row.gameObject);
+            PopulateBattalionsContent(availableBattalionsContent, oddColor);
+            if (availableBattalionsContentNarrow != null) {
+                PopulateBattalionsContent(availableBattalionsContentNarrow, oddColor);
            }
-            parentTransform = availableBattalionsContent.transform;
+
+            heroesAndBattalionsPanelController.UpdateTables();
+
+            selectionChanged.Invoke();
+        }
+
+        private void PopulateBattalionsContent(GameObject content, Color oddColor) {
+            foreach (Transform row in content.transform) { Destroy(row.gameObject); }
+
+            var parentTransform = content.transform;
            for (int i = 0; i < AvailableBattalions.Count; i++) {
                var battalion = AvailableBattalions[i];

@@ -217,10 +228,6 @@ namespace eagle {

                if (i % 2 == 1) { newRow.GetComponent<Image>().color = oddColor; }
            }
-
-            heroesAndBattalionsPanelController.UpdateTables();
-
-            selectionChanged.Invoke();
        }

        public void availableHeroButtonClicked(int index) {
@@ -23,7 +23,9 @@ namespace eagle {
    /// Attach to a TextMeshProUGUI component to display status.
    /// </summary>
    public class ConnectionStatusUI : MonoBehaviour {
-        private TextMeshProUGUI _textComponent;
+        [Header("UI References")]
+        public TextMeshProUGUI statusText;
+
        private PersistentClientConnection _connection;
        private IGameStateProvider _gameStateProvider;
        private string _environmentName;
@@ -39,10 +41,8 @@ namespace eagle {
        private float _timeSinceLastUpdate = 0f;

        void Start() {
-            _textComponent = GetComponent<TextMeshProUGUI>();
-            if (_textComponent == null) {
-                Debug.LogError(
-                        "ConnectionStatusUI must be attached to a TextMeshProUGUI component");
+            if (statusText == null) {
+                Debug.LogError("ConnectionStatusUI: statusText reference not assigned");
                enabled = false;
                return;
            }
@@ -78,7 +78,7 @@ namespace eagle {
        }

        void Update() {
-            if (_connection == null || _textComponent == null) { return; }
+            if (_connection == null || statusText == null) { return; }

            _timeSinceLastUpdate += Time.deltaTime;
            if (_timeSinceLastUpdate < UpdateInterval) { return; }
@@ -97,16 +97,15 @@ namespace eagle {
                    var timeUntilTest = nextTest.Value - DateTime.UtcNow;
                    if (timeUntilTest.TotalSeconds > 0) {
                        int seconds = Math.Min(10, (int)Math.Ceiling(timeUntilTest.TotalSeconds));
-                        _textComponent.text =
-                                $"<color=red>●</color> Server down. Retry in {seconds}s";
+                        statusText.text = $"<color=red>●</color> Server down. Retry in {seconds}s";
                        return;
                    }
                }
-                _textComponent.text = "<color=red>●</color> Server unavailable";
+                statusText.text = "<color=red>●</color> Server unavailable";
                return;
            } else if (circuitState == ConnectionCircuitBreaker.State.HalfOpen) {
                SetRetryButtonVisible(false);
-                _textComponent.text = "<color=yellow>●</color> Testing connection...";
+                statusText.text = "<color=yellow>●</color> Testing connection...";
                return;
            }

@@ -119,7 +118,7 @@ namespace eagle {
                                  (nextAttempt.Value - DateTime.UtcNow).TotalSeconds > 0;
            SetRetryButtonVisible(isCountingDown);

-            string statusText = state switch {
+            string displayText = state switch {
                ConnectionState.Connected => GetConnectedStatusText(),
                ConnectionState.Connecting => "<color=yellow>●</color> Connecting...",
                ConnectionState.Disconnected => "<color=red>●</color> Disconnected",
@@ -128,7 +127,7 @@ namespace eagle {
                _ => "<color=gray>●</color> Unknown"
            };

-            _textComponent.text = statusText;
+            statusText.text = displayText;
        }

        private string GetConnectedStatusText() {
@@ -0,0 +1,121 @@
+using TMPro;
+using UnityEngine;
+
+namespace eagle {
+    /// <summary>
+    /// Curves TextMeshPro text along an arc.
+    /// Attach to a GameObject with TextMeshProUGUI component.
+    /// </summary>
+    [RequireComponent(typeof(TextMeshProUGUI))]
+    public class CurvedText : MonoBehaviour {
+        [Tooltip(
+                "Curvature amount. Positive curves upward (convex), negative curves downward (concave). 0 = no curve.")]
+        public float curvature = 0f;
+
+        private TextMeshProUGUI _textComponent;
+        private bool _needsUpdate = true;
+
+        void Awake() { _textComponent = GetComponent<TextMeshProUGUI>(); }
+
+        void OnEnable() {
+            TMPro_EventManager.TEXT_CHANGED_EVENT.Add(OnTextChanged);
+            _needsUpdate = true;
+        }
+
+        void OnDisable() { TMPro_EventManager.TEXT_CHANGED_EVENT.Remove(OnTextChanged); }
+
+        void OnTextChanged(Object obj) {
+            if (obj == _textComponent) { _needsUpdate = true; }
+        }
+
+        void LateUpdate() {
+            if (_needsUpdate && _textComponent != null) {
+                _needsUpdate = false;
+                ApplyCurve();
+            }
+        }
+
+        public void SetCurvature(float newCurvature) {
+            curvature = newCurvature;
+            _needsUpdate = true;
+        }
+
+        private void ApplyCurve() {
+            if (Mathf.Approximately(curvature, 0f)) { return; }
+
+            _textComponent.ForceMeshUpdate();
+
+            TMP_TextInfo textInfo = _textComponent.textInfo;
+            if (textInfo == null || textInfo.characterCount == 0) { return; }
+
+            // Find the bounds of all characters
+            float minX = float.MaxValue;
+            float maxX = float.MinValue;
+
+            for (int i = 0; i < textInfo.characterCount; i++) {
+                if (!textInfo.characterInfo[i].isVisible) { continue; }
+
+                var charInfo = textInfo.characterInfo[i];
+                minX = Mathf.Min(minX, charInfo.bottomLeft.x);
+                maxX = Mathf.Max(maxX, charInfo.bottomRight.x);
+            }
+
+            float textWidth = maxX - minX;
+            if (textWidth <= 0) { return; }
+
+            float centerX = (minX + maxX) / 2f;
+
+            // Apply curve to each character
+            for (int i = 0; i < textInfo.characterCount; i++) {
+                if (!textInfo.characterInfo[i].isVisible) { continue; }
+
+                var charInfo = textInfo.characterInfo[i];
+                int materialIndex = charInfo.materialReferenceIndex;
+                int vertexIndex = charInfo.vertexIndex;
+
+                Vector3[] vertices = textInfo.meshInfo[materialIndex].vertices;
+
+                // Get character center X position
+                float charCenterX = (vertices[vertexIndex].x + vertices[vertexIndex + 2].x) / 2f;
+
+                // Calculate normalized position (-1 to 1) from center
+                float normalizedX = (charCenterX - centerX) / (textWidth / 2f);
+
+                // Calculate Y offset using parabola: y = -curvature * (1 - x^2)
+                // Negated because Unity Y is up, but our curvature convention has positive = convex
+                // down. Scale by 0.25 to reduce intensity.
+                float scaledCurvature = curvature * 0.25f;
+                float yOffset = -scaledCurvature * (1f - normalizedX * normalizedX);
+
+                // Calculate rotation angle based on tangent of the curve
+                // Derivative of y = -c * (1 - x^2) is dy/dx = 2cx
+                float tangentSlope = 2f * scaledCurvature * normalizedX / (textWidth / 2f);
+                float angle = Mathf.Atan(tangentSlope) * Mathf.Rad2Deg;
+
+                // Apply transformation to all 4 vertices of the character
+                Vector3 charCenter = new Vector3(
+                        charCenterX,
+                        (vertices[vertexIndex].y + vertices[vertexIndex + 2].y) / 2f,
+                        0);
+
+                for (int j = 0; j < 4; j++) {
+                    Vector3 offset = vertices[vertexIndex + j] - charCenter;
+
+                    // Rotate around character center
+                    float rad = angle * Mathf.Deg2Rad;
+                    float rotatedX = offset.x * Mathf.Cos(rad) - offset.y * Mathf.Sin(rad);
+                    float rotatedY = offset.x * Mathf.Sin(rad) + offset.y * Mathf.Cos(rad);
+
+                    vertices[vertexIndex + j] =
+                            charCenter + new Vector3(rotatedX, rotatedY + yOffset, offset.z);
+                }
+            }
+
+            // Update the mesh
+            for (int i = 0; i < textInfo.meshInfo.Length; i++) {
+                textInfo.meshInfo[i].mesh.vertices = textInfo.meshInfo[i].vertices;
+                _textComponent.UpdateGeometry(textInfo.meshInfo[i].mesh, i);
+            }
+        }
+    }
+}
@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 299f66fc896a34cdeb95e92e927a6f10
@@ -15,6 +15,7 @@ namespace eagle {
        }

        public static readonly Dictionary<Profession, string> ProfessionNames = new() {
+            { Profession.UnknownProfession, "Unknown" },
            { Profession.NoProfession, "None" },
            { Profession.Engineer, "Engineer" },
            { Profession.Mage, "Mage" },
@@ -25,6 +26,7 @@ namespace eagle {
        };

        public static readonly Dictionary<Profession, string> ShortProfessionNames = new() {
+            { Profession.UnknownProfession, "?" },
            { Profession.NoProfession, "None" },
            { Profession.Engineer, "Engr" },
            { Profession.Mage, "Mage" },
@@ -104,6 +106,9 @@ namespace eagle {
                    return $"{name} is unlikely to stay here long enough to impress with a quest.";

                case RecruitmentStatus.Sworn: return $"{name} is dedicated to another faction.";
+
+                case RecruitmentStatus.WouldNeverJoin:
+                    return $"{name} would never join your faction.";
            }

            return $"Unknown!";
@@ -128,6 +133,8 @@ namespace eagle {
                case RecruitmentStatus.Traveler: return "Traveler";

                case RecruitmentStatus.Sworn: return "Dedicated to another faction";
+
+                case RecruitmentStatus.WouldNeverJoin: return "Would never join";
            }

            return $"Unknown!";
@@ -163,6 +170,27 @@ namespace eagle {
                case SealedValueOneofCase.TotalDevelopmentQuest: return "Total Development";
                case SealedValueOneofCase.SuppressRiotByForceQuest: return "Suppress Riot";
                case SealedValueOneofCase.FightBeastsAloneQuest: return "Fight Beasts Alone";
+                case SealedValueOneofCase.DevelopProvincesQuest: return "Develop Provinces";
+                case SealedValueOneofCase.MobilizeProvincesQuest: return "Mobilize Provinces";
+                case SealedValueOneofCase.BattalionDiversityQuest: return "Battalion Diversity";
+                case SealedValueOneofCase.ReleaseAllPrisonersQuest: return "Release All Prisoners";
+                case SealedValueOneofCase.SwearBrotherhoodWithHeroQuest: return "Swear Brotherhood";
+                case SealedValueOneofCase.BetrayAllyQuest: return "Betray Ally";
+                case SealedValueOneofCase.BorderSecurityQuest: return "Border Security";
+                case SealedValueOneofCase.WinBattleOutnumberedQuest:
+                    return "Win Battle Outnumbered";
+                case SealedValueOneofCase.WinBattlesQuest: return "Win Battles";
+                case SealedValueOneofCase.ApprehendOutlawQuest: return "Apprehend Outlaw";
+                case SealedValueOneofCase.StartBlizzardQuest: return "Start Blizzard";
+                case SealedValueOneofCase.StartDroughtQuest: return "Start Drought";
+                case SealedValueOneofCase.StartEpidemicQuest: return "Start Epidemic";
+                case SealedValueOneofCase.SpendOnFeastsQuest: return "Host Feasts";
+                case SealedValueOneofCase.SendSuppliesQuest: return "Send Supplies";
+                case SealedValueOneofCase.RestProvinceQuest: return "Rest Province";
+                case SealedValueOneofCase.ReconProvincesQuest: return "Recon Provinces";
+                case SealedValueOneofCase.RepairDevastationQuest: return "Repair Devastation";
+                case SealedValueOneofCase.ReconSpecificProvincesQuest:
+                    return "Recon Specific Provinces";
            }

            throw new ArgumentException($"unknown quest {quest}");
@@ -0,0 +1,152 @@
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace eagle {
+    /// <summary>
+    /// Creates a drought effect with a hot sun and heat shimmer overlay.
+    /// The heat shimmer distorts the province using a shader that masks to province boundaries.
+    /// </summary>
+    [RequireComponent(typeof(RectTransform))]
+    public class DroughtEffect : MonoBehaviour {
+        [Header("Sun Settings")]
+        public Sprite sunSprite;
+        public float sunSize = 40f;
+        public float sunVerticalOffset = 40f;
+        public Color sunColor = new Color(1f, 0.9f, 0.3f, 0.9f);
+        public float sunPulseSpeed = 1.5f;
+        public float sunPulseAmount = 0.15f;
+        public float sunWaveAmountX = 8f;   // Horizontal wave distance
+        public float sunWaveAmountY = 5f;   // Vertical wave distance
+        public float sunWaveSpeedX = 0.4f;  // Horizontal wave speed
+        public float sunWaveSpeedY =
+                0.6f;  // Vertical wave speed (slightly different for organic feel)
+
+        [Header("Heat Shimmer Settings")]
+        public Material shimmerMaterial;
+        public float shimmerSize = 300f;  // Large enough to cover province
+
+        [Header("Province Masking")]
+        public Texture2D provinceIdMap;
+        public int targetProvinceId;
+        public Vector4 mapBounds;  // x=minX, y=minY, z=width, w=height
+
+        private GameObject _sunObject;
+        private Image _sunImage;
+        private GameObject _shimmerObject;
+        private RawImage _shimmerImage;  // RawImage renders without sprite
+        private Material _shimmerMatInstance;
+        private Texture2D _whiteTexture;
+        private float _baseSunScale;
+        private Vector2 _baseSunPosition;
+
+        void Start() { SetupEffect(); }
+
+        private void SetupEffect() {
+            SetupSun();
+            // Note: Shimmer disabled - GrabPass doesn't work well with UI Canvas
+            // TODO: Consider alternative shimmer approach (animated texture overlay)
+            // SetupShimmer();
+        }
+
+        private void SetupSun() {
+            _sunObject = new GameObject("Sun");
+            _sunObject.transform.SetParent(transform, false);
+
+            _sunImage = _sunObject.AddComponent<Image>();
+            if (sunSprite != null) { _sunImage.sprite = sunSprite; }
+            _sunImage.color = sunColor;
+
+            var rectTransform = _sunObject.GetComponent<RectTransform>();
+            rectTransform.sizeDelta = new Vector2(sunSize, sunSize);
+            _baseSunPosition = new Vector2(0f, sunVerticalOffset);
+            rectTransform.anchoredPosition = _baseSunPosition;
+
+            _baseSunScale = 1f;
+        }
+
+        private void SetupShimmer() {
+            // Try to find the shader and create material
+            var shader = Shader.Find("Eagle/HeatShimmer");
+            if (shader == null) {
+                Debug.LogWarning("DroughtEffect: Could not find Eagle/HeatShimmer shader");
+                return;
+            }
+
+            _shimmerObject = new GameObject("HeatShimmer");
+            _shimmerObject.transform.SetParent(transform, false);
+            // Put shimmer behind sun
+            _shimmerObject.transform.SetAsFirstSibling();
+
+            // Create a white texture for RawImage (required for rendering)
+            _whiteTexture = new Texture2D(1, 1);
+            _whiteTexture.SetPixel(0, 0, Color.white);
+            _whiteTexture.Apply();
+
+            // Use RawImage which renders without needing a sprite
+            _shimmerImage = _shimmerObject.AddComponent<RawImage>();
+            _shimmerImage.texture = _whiteTexture;
+            _shimmerMatInstance = new Material(shader);
+            _shimmerImage.material = _shimmerMatInstance;
+            _shimmerImage.color = Color.white;
+
+            var rectTransform = _shimmerObject.GetComponent<RectTransform>();
+            rectTransform.sizeDelta = new Vector2(shimmerSize, shimmerSize);
+            rectTransform.anchoredPosition = Vector2.zero;
+
+            // Set shader properties
+            if (provinceIdMap != null) {
+                _shimmerMatInstance.SetTexture("_ProvinceIDMap", provinceIdMap);
+            }
+            _shimmerMatInstance.SetFloat("_TargetProvinceId", targetProvinceId);
+            _shimmerMatInstance.SetVector("_MapBounds", mapBounds);
+        }
+
+        public void SetProvinceId(int provinceId) {
+            targetProvinceId = provinceId;
+            if (_shimmerMatInstance != null) {
+                _shimmerMatInstance.SetFloat("_TargetProvinceId", provinceId);
+            }
+        }
+
+        public void SetProvinceIdMap(Texture2D idMap) {
+            provinceIdMap = idMap;
+            if (_shimmerMatInstance != null) {
+                _shimmerMatInstance.SetTexture("_ProvinceIDMap", idMap);
+            }
+        }
+
+        public void SetMapBounds(Vector4 bounds) {
+            mapBounds = bounds;
+            if (_shimmerMatInstance != null) {
+                _shimmerMatInstance.SetVector("_MapBounds", bounds);
+            }
+        }
+
+        public void SetShimmerSize(float size) {
+            shimmerSize = size;
+            if (_shimmerObject != null) {
+                var rt = _shimmerObject.GetComponent<RectTransform>();
+                rt.sizeDelta = new Vector2(size, size);
+            }
+        }
+
+        void Update() {
+            if (_sunObject != null) {
+                // Pulse the sun size
+                float pulse = 1f + Mathf.Sin(Time.time * sunPulseSpeed) * sunPulseAmount;
+                _sunObject.transform.localScale = Vector3.one * (_baseSunScale * pulse);
+
+                // Wave the sun position slowly
+                var rectTransform = _sunObject.GetComponent<RectTransform>();
+                float waveX = Mathf.Sin(Time.time * sunWaveSpeedX) * sunWaveAmountX;
+                float waveY = Mathf.Sin(Time.time * sunWaveSpeedY) * sunWaveAmountY;
+                rectTransform.anchoredPosition = _baseSunPosition + new Vector2(waveX, waveY);
+            }
+        }
+
+        void OnDestroy() {
+            if (_shimmerMatInstance != null) { Destroy(_shimmerMatInstance); }
+            if (_whiteTexture != null) { Destroy(_whiteTexture); }
+        }
+    }
+}
@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: f64938ef171de43dba1b0a865fc86f60
@@ -21,12 +21,15 @@ public class EagleCommonTextures : MonoBehaviour {
    public Texture2D Profession(Profession profession) {
        if (profession == Net.Eagle0.Eagle.Common.Profession.NoProfession)
            return professionTextures.Last();
+        if (profession == Net.Eagle0.Eagle.Common.Profession.UnknownProfession) return null;
        return professionTextures[(int)profession];
    }

    public Texture2D Profession(HeroView.Types.ProfessionSpecificInfo.Types.Profession profession) {
        if (profession == HeroView.Types.ProfessionSpecificInfo.Types.Profession.NoProfession)
            return professionTextures.Last();
+        if (profession == HeroView.Types.ProfessionSpecificInfo.Types.Profession.Unknown)
+            return null;
        return professionTextures[(int)profession];
    }

@@ -28,46 +28,46 @@ namespace eagle {
    public enum LayoutMode { Wide, Medium, Narrow }

    public class EagleGameController : MonoBehaviour {
+        [Header("Audio")]
        public SoundManager soundManager;

+        [Header("Status Labels")]
        public TextMeshProUGUI roundStatusLabel;
-        public TextMeshProUGUI connectionStatusLabel;
-        private bool _connectionStatusUIInitialized = false;

+        [Header("Main Panels")]
        public ProvinceInfoPanelController provinceInfoPanelController;
        public FreeHeroesTableController freeHeroesTableController;
+        public HeroesAndBattalionsPanelController heroesAndBattalionsPanelController;
+        public MapController mapController;
+        public CommandButtonPanelController commandButtonPanelController;
+        public ChronicleCanvasController chronicleCanvasController;
+        public ErrorHandler errorHandler;
+        public NotificationPanel notificationPanel;
+        public GameObject popupCanvas;

-        // Containers for factions & moving armies panels (enable/disable these)
-        public GameObject factionsAndMovingArmiesNarrow;  // Row beneath Free Heroes
-        public GameObject factionsAndMovingArmiesWide;    // Column to right of Province Info
-
-        // Controller references for updating data (panels inside containers)
+        [Header("Factions & Armies (Wide/Narrow)")]
+        public GameObject factionsAndMovingArmiesNarrow;
+        public GameObject factionsAndMovingArmiesWide;
        public FactionsTableController factionsTableControllerNarrow;
        public MovingArmiesTableController movingArmiesTableControllerNarrow;
        public FactionsTableController factionsTableControllerWide;
        public MovingArmiesTableController movingArmiesTableControllerWide;
-
-        public HeroesAndBattalionsPanelController heroesAndBattalionsPanelController;
-        public MapController mapController;
-        public CommandButtonPanelController commandButtonPanelController;
-
-        // Narrow: toggleable above Province Info; Wide: always-on below Free Heroes
        public DominionPanelController dominionPanelControllerNarrow;
        public DominionPanelController dominionPanelControllerWide;
-        public ChronicleCanvasController chronicleCanvasController;
+
+        [Header("Layout Spacers")]
+        public GameObject wideSpacer;
+        public LayoutElement heroesAndBattalionsLayoutElement;
+        public LayoutElement popupCanvasLeftSpacer;
+        public LayoutElement popupCanvasRightSpacer;
+
+        [Header("Clicked Province Panel")]
+        public GameObject clickedProvincePanel;
+        public GameObject underClickedProvincePanel;

        public ProvinceId? SelectedProvince => mapController.SelectedProvinceId;

-        public ErrorHandler errorHandler;
-        public NotificationPanel notificationPanel;
-        public GameObject popupCanvas;
-        public GameObject wideSpacer;
-
-        // Widescreen layout: match HeroesAndBattalions width to Popup Canvas spacers
-        public LayoutElement heroesAndBattalionsLayoutElement;
-        public LayoutElement popupCanvasLeftSpacer;
-        public LayoutElement popupCanvasRightSpacer;  // Same object as wideSpacer
-
+        [Header("Buttons")]
        public Button showChronicleButton;
        public Button commitCommandButton;
        public Button goToBattleButton;
@@ -75,11 +75,10 @@ namespace eagle {
        public Button gameIdButton;
        public Button nextActiveProvinceButton;

+        [Header("Commands")]
        public MouseHandler mouseHandlerPrefab;
-
        public GameObject commandPanel;
        private CommandPanelController _commandPanelController;
-
        public PleaseRecruitMeCommandSelector pleaseRecruitMeCommandSelector;
        public ResolveTruceCommandSelector resolveTruceCommandSelector;
        public ResolveAllianceCommandSelector resolveAllianceCommandSelector;
@@ -144,16 +143,6 @@ namespace eagle {

            if (newWidth == _lastWidth && newHeight == _lastHeight) { return; }

-            // Initialize ConnectionStatusUI component once when connection is available
-            if (!_connectionStatusUIInitialized &&
-                errorHandler.PersistentClientConnection != null) {
-                var statusUI = connectionStatusLabel.GetComponent<ConnectionStatusUI>();
-                if (statusUI != null) {
-                    statusUI.SetConnection(errorHandler.PersistentClientConnection);
-                    _connectionStatusUIInitialized = true;
-                }
-            }
-
            _lastWidth = newWidth;
            _lastHeight = newHeight;

@@ -200,6 +189,11 @@ namespace eagle {

                provinceInfoPanelController.WideScreen = false;
            }
+
+            // Clicked province panel: regular for medium/wide, under for narrow
+            if (clickedProvincePanel != null) clickedProvincePanel.SetActive(!IsNarrowScreen);
+            if (underClickedProvincePanel != null)
+                underClickedProvincePanel.SetActive(IsNarrowScreen);
        }

        private void SetPopupColumnSpacerWidth(float width) {
@@ -219,12 +213,21 @@ namespace eagle {
            }
            SwapModel();
            Model = null;
+
+            // Clear stale province state from the previous game so it doesn't
+            // get used with the next game's hero/battalion maps.
+            provinceInfoPanelController.Province = null;
+            freeHeroesTableController.CurrentProvince = null;
+            movingArmiesTableControllerNarrow.CurrentProvince = null;
+            movingArmiesTableControllerWide.CurrentProvince = null;
+            factionsTableControllerNarrow.CurrentProvince = null;
+            factionsTableControllerWide.CurrentProvince = null;
+            heroesAndBattalionsPanelController.CurrentProvince = null;
            chronicleCanvasController.Entries = new List<ChronicleEntry>();
            SetMusic();

            // Clear game state provider when leaving game
-            var statusUI = connectionStatusLabel.GetComponent<ConnectionStatusUI>();
-            if (statusUI != null) { statusUI.SetGameStateProvider(null); }
+            PersistentUIManager.Instance?.connectionStatusUI?.SetGameStateProvider(null);
        }

        void MapControllerChangedTarget(List<ProvinceId> newTarget) {
@@ -329,7 +332,7 @@ namespace eagle {
            ModelUpdater.ErrorHandler = errorHandler;

            // Set up game state provider and environment for connection status UI
-            var statusUI = connectionStatusLabel.GetComponent<ConnectionStatusUI>();
+            var statusUI = PersistentUIManager.Instance?.connectionStatusUI;
            if (statusUI != null) {
                statusUI.SetGameStateProvider(ModelUpdater);
                statusUI.SetEnvironment(environmentName);
@@ -789,7 +792,6 @@ namespace eagle {
            }

            shardokController.SetUpGame(shardokModel);
-            shardokController.SetConnection(errorHandler.PersistentClientConnection);
            gameObject.SetActive(false);
        }

@@ -260,7 +260,7 @@ namespace eagle {
            if (battleView == null) {
                // Battle was removed (e.g., it ended) before we could create the model.
                // This is expected when Eagle's RemovedBattleIds update arrives before a
-                // pending Shardok update - the UI already shows "Back to Eagle" via
+                // pending Shardok update - the UI already shows "Exit Battle" via
                // MarkBattleEnded(), so we just skip this stale update.
                return null;
            }
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 33c3d3ae0724f43b6990a941f06026cd
+guid: 0a32317c8e94148f1b87a7f66c498077
 folderAsset: yes
 DefaultImporter:
  externalObjects: {}
@@ -0,0 +1,60 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &7893566172152383399
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 9219784709551883713}
+  - component: {fileID: 618063871244848148}
+  m_Layer: 0
+  m_Name: BeastsEffect
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &9219784709551883713
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &618063871244848148
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a5ee82ebc029341c4858ef5b7e7cf201, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::eagle.BeastsEffect
+  birdTexture: {fileID: 2800000, guid: 7b6ab1e235eea4e4e9319c88bb1cdc70, type: 3}
+  birdMaterial: {fileID: 2100000, guid: 67dcb765c9c324ff9a103624340bc9b5, type: 2}
+  birdCount: 5
+  birdLifetime: 8
+  birdSize: 12
+  circleRadius: 35
+  circleSpeed: 1
+  birdColor: {r: 1, g: 1, b: 1, a: 1}
+  verticalOscillation: 10
+  radiusVariation: 10
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 81b03eaddf4de4a4aa385617e4881511
+guid: 1c093deb39df94fbca5faa9f015a2331
 PrefabImporter:
  externalObjects: {}
  userData: 
@@ -0,0 +1,63 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &7893566172152383399
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 9219784709551883713}
+  - component: {fileID: 3572684436619911535}
+  m_Layer: 0
+  m_Name: BlizzardEffect
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &9219784709551883713
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &3572684436619911535
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: c15980e88e57845ce920e43f29d35fcc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::eagle.BlizzardEffect
+  snowflakeTexture: {fileID: 2800000, guid: 9a5b4e8c3d2f6b0a7c1e9d5f8a3b2c4d, type: 3}
+  particleMaterial: {fileID: 2100000, guid: b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6, type: 2}
+  snowEmitRate: 15
+  snowFallSpeed: 40
+  snowLifetime: 3
+  snowSize: 8
+  snowDrift: 10
+  snowColor: {r: 1, g: 1, b: 1, a: 1}
+  windStrength: 5
+  windVariation: 3
+  provinceIdMap: {fileID: 0}
+  targetProvinceId: 0
+  mapBounds: {x: 0, y: 0, z: 0, w: 0}
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 0cf4724a235af4fb8abab6456789936a
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,61 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &7893566172152383399
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 9219784709551883713}
+  - component: {fileID: -4077358403987153371}
+  m_Layer: 0
+  m_Name: DroughtEffect
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &9219784709551883713
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &-4077358403987153371
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: f64938ef171de43dba1b0a865fc86f60, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::eagle.DroughtEffect
+  sunSprite: {fileID: 21300000, guid: ecdaab62f65f19745aee51dc3e5be2fc, type: 3}
+  sunSize: 20
+  sunVerticalOffset: 30
+  sunColor: {r: 1, g: 0.9019608, b: 0.29803923, a: 0.68235296}
+  sunPulseSpeed: 1.5
+  sunPulseAmount: 0.1
+  shimmerMaterial: {fileID: 10303, guid: 0000000000000000f000000000000000, type: 0}
+  shimmerSize: 15
+  provinceIdMap: {fileID: 0}
+  targetProvinceId: 0
+  mapBounds: {x: 0, y: 0, z: 0, w: 0}
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 1be06ed8f9be949478a81914e2479d4d
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,63 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &7893566172152383399
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 9219784709551883713}
+  - component: {fileID: 8607881802583290962}
+  m_Layer: 0
+  m_Name: EpidemicEffect
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &9219784709551883713
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &8607881802583290962
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7893566172152383399}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 727093fab7ebc43dc94ee59675164706, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::eagle.EpidemicEffect
+  skullMaterial: {fileID: 2100000, guid: c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7, type: 2}
+  skullEmitRate: 1.5
+  skullRiseSpeed: 25
+  skullLifetime: 3
+  skullSize: 25
+  skullSway: 8
+  skullColor: {r: 1, g: 1, b: 1, a: 1}
+  hazeMaterial: {fileID: 2100000, guid: c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7, type: 2}
+  hazeEmitRate: 10
+  hazeSpeed: 8
+  hazeLifetime: 4
+  hazeSize: 10
+  hazeColor: {r: 0.4, g: 0.54901963, b: 0.34901962, a: 0.50980395}
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 5315bdd018d9e420dbbf55a0508a7f14
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,61 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &529533522556784756
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7895772391506986011}
+  - component: {fileID: 4807333260855875379}
+  m_Layer: 0
+  m_Name: Fireworks
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &7895772391506986011
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 529533522556784756}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &4807333260855875379
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 529533522556784756}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 01a76cb7235d04623be14e4b01f18754, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::eagle.FireworksEffect
+  burstInterval: 1.5
+  particlesPerBurst: 30
+  particleLifetime: 1.5
+  startSpeed: 200
+  gravity: 100
+  fireworkColors:
+  - {r: 1, g: 0.3, b: 0.3, a: 1}
+  - {r: 1, g: 0.8, b: 0.2, a: 1}
+  - {r: 0.3, g: 0.8, b: 1, a: 1}
+  - {r: 0.3, g: 1, b: 0.3, a: 1}
+  - {r: 1, g: 0.5, b: 1, a: 1}
--- a/Show More
+++ b/Show More
@@ -1 +1 @@
 .6.1
 .5.1