project-auto-wizard 0.14.0 → 0.15.1

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml

@@ -94,6 +94,7 @@ jobs:
       - name: Load messages
         working-directory: ${{ github.workspace }}
         run: |
+          [ -f .paw-msg/.github/scripts/messages.py ] || { echo "::error::messages.py is missing; rerun \`npx project-auto-wizard --mode full --force\`"; exit 1; }
           cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
           LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
           rm -rf .paw-msg
@@ -104,14 +105,18 @@ jobs:
       - name: Verify the branch exists up front
         id: verify_branch
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_PR_NUMBER: ${{ github.event.client_payload.pr_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const prNumber = '${{ github.event.client_payload.pr_number }}';
-            const runId = '${{ github.run_id }}';
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const prNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_PR_NUMBER;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             console.log(msg('ios_test_tf.branch_check_log', { branch: branchName }));
@@ -162,16 +167,21 @@ jobs:
         if: github.event.client_payload.pr_number != ''
         continue-on-error: true
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_PR_NUMBER: ${{ github.event.client_payload.pr_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const prNumber = parseInt('${{ github.event.client_payload.pr_number }}');
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const runId = '${{ github.run_id }}';
+            const prNumber = parseInt(process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_PR_NUMBER);
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
             const startTime = Date.now();
 
@@ -227,6 +237,7 @@ jobs:
       branch_name: ${{ steps.issue_info.outputs.branch_name }}
       pr_number: ${{ steps.test_version.outputs.pr_number }}
       commit_hash: ${{ steps.release_notes.outputs.commit_hash }}
+      commit_sha: ${{ steps.release_notes.outputs.commit_sha }}
 
     steps:
       # Fetch the message catalog from the triggering ref first — the feature branch being built may predate it
@@ -240,8 +251,10 @@ jobs:
           sparse-checkout-cone-mode: false
 
       - name: Load messages
+        id: load_messages
         working-directory: ${{ github.workspace }}
         run: |
+          [ -f .paw-msg/.github/scripts/messages.py ] || { echo "::error::messages.py is missing; rerun \`npx project-auto-wizard --mode full --force\`"; exit 1; }
           cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
           LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
           rm -rf .paw-msg
@@ -256,7 +269,9 @@ jobs:
           ref: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref }}
 
       - name: Pull latest changes
-        run: git pull origin ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
+        env:
+          PAW_BRANCH_NAME: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
+        run: git pull origin "$PAW_BRANCH_NAME"
 
       # Report every missing setting up front, before importing certificates or building — otherwise the macOS runner builds for a long time and fails at an unrelated step
       - name: Validate deploy settings
@@ -301,18 +316,22 @@ jobs:
         env:
           SECRETS_XCCONFIG_CONTENT: ${{ secrets.SECRETS_XCCONFIG }}
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           mkdir -p ios/Flutter
           if [ -n "$SECRETS_XCCONFIG_CONTENT" ]; then
             echo "$SECRETS_XCCONFIG_CONTENT" > ios/Flutter/Secrets.xcconfig
-            echo "✅ Secrets.xcconfig created"
+            m wf_flutter.secrets_xcconfig_created_ok
           else
             echo "// No secrets provided" > ios/Flutter/Secrets.xcconfig
-            echo "ℹ️ Empty Secrets.xcconfig created (no secrets provided)"
+            m wf_flutter.secrets_xcconfig_empty
           fi
 
       - name: Set test build version
         id: test_version
         working-directory: ${{ github.workspace }}   # version_manager.py must read version.yml at the repo root
+        env:
+          PAW_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_PR_NUMBER: ${{ github.event.client_payload.pr_number }}
         run: |
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           # Get the version through version_manager.py (same approach as the production workflow)
@@ -321,8 +340,8 @@ jobs:
 
           # For repository_dispatch events, use the PR number as the build number
           if [ "${{ github.event_name }}" == "repository_dispatch" ]; then
-            BUILD_NUMBER="${{ github.event.client_payload.build_number }}"
-            PR_NUMBER="${{ github.event.client_payload.pr_number }}"
+            BUILD_NUMBER="$PAW_BUILD_NUMBER"
+            PR_NUMBER="$PAW_PR_NUMBER"
             m ios_test_tf.event_dispatch
             m ios_test_tf.event_pr_number pr="$PR_NUMBER"
             m ios_test_tf.event_build_number_pr build="$BUILD_NUMBER"
@@ -339,14 +358,18 @@ jobs:
 
       - name: Extract issue info from the branch name
         id: issue_info
+        env:
+          PAW_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_ISSUE_NUMBER: ${{ github.event.client_payload.issue_number }}
+          PAW_REF_NAME: ${{ github.ref_name }}
         run: |
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           # For repository_dispatch, take the branch name from client_payload
           if [ "${{ github.event_name }}" == "repository_dispatch" ]; then
-            BRANCH_NAME="${{ github.event.client_payload.branch_name }}"
-            ISSUE_NUMBER="${{ github.event.client_payload.issue_number }}"
+            BRANCH_NAME="$PAW_BRANCH_NAME"
+            ISSUE_NUMBER="$PAW_ISSUE_NUMBER"
           else
-            BRANCH_NAME="${{ github.ref_name }}"
+            BRANCH_NAME="$PAW_REF_NAME"
             # Extract the issue number from the branch name (`<date>_#<number>_...` format)
             ISSUE_NUMBER=$(echo "$BRANCH_NAME" | sed -n 's/.*#\([0-9]*\).*/\1/p')
           fi
@@ -387,15 +410,20 @@ jobs:
       - name: Generate release notes
         id: release_notes
         working-directory: ${{ github.workspace }}   # final_release_notes.txt (paired with the upload step) is relative to the repo root
+        env:
+          PAW_BRANCH_NAME: ${{ steps.issue_info.outputs.branch_name }}
+          PAW_ISSUE_TITLE: ${{ steps.issue_info.outputs.issue_title }}
         run: |
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           BUILD_NUMBER="${{ steps.test_version.outputs.build_number }}"
-          BRANCH_NAME="${{ steps.issue_info.outputs.branch_name }}"
-          COMMIT_SHA="${{ github.sha }}"
+          BRANCH_NAME="$PAW_BRANCH_NAME"
+          # github.sha is the default-branch commit for repository_dispatch; report the commit actually checked out
+          COMMIT_SHA=$(git rev-parse HEAD)
           COMMIT_SHORT=$(echo "$COMMIT_SHA" | cut -c1-7)
-          BUILD_DATE=$(date '+%Y-%m-%d %H:%M:%S')
+          BUILD_DATE=$(date -u '+%Y-%m-%d %H:%M:%S UTC')
 
           echo "commit_hash=$COMMIT_SHORT" >> $GITHUB_OUTPUT
+          echo "commit_sha=$COMMIT_SHA" >> $GITHUB_OUTPUT
 
           {
             m ios_test_tf.notes_build build="$BUILD_NUMBER"
@@ -409,7 +437,7 @@ jobs:
           # Add the issue info when available
           if [ -n "${{ steps.issue_info.outputs.issue_number }}" ]; then
             ISSUE_NUMBER="${{ steps.issue_info.outputs.issue_number }}"
-            ISSUE_TITLE="${{ steps.issue_info.outputs.issue_title }}"
+            ISSUE_TITLE="$PAW_ISSUE_TITLE"
             ISSUE_URL="${{ steps.issue_info.outputs.issue_url }}"
 
             {
@@ -444,19 +472,25 @@ jobs:
           retention-days: 1
 
       - name: Progress update - prepare failed
-        if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
+        if: failure() && steps.load_messages.outcome == 'success' && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME: ${{ needs.notify-start.outputs.start_time }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const startTime = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME);
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();
@@ -523,8 +557,10 @@ jobs:
           sparse-checkout-cone-mode: false
 
       - name: Load messages
+        id: load_messages
         working-directory: ${{ github.workspace }}
         run: |
+          [ -f .paw-msg/.github/scripts/messages.py ] || { echo "::error::messages.py is missing; rerun \`npx project-auto-wizard --mode full --force\`"; exit 1; }
           cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
           LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
           rm -rf .paw-msg
@@ -537,18 +573,25 @@ jobs:
         id: progress_step1
         if: github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME: ${{ needs.notify-start.outputs.start_time }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION: ${{ needs.prepare-test-build.outputs.version }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const version = '${{ needs.prepare-test-build.outputs.version }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const startTime = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME);
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const version = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();
@@ -595,7 +638,9 @@ jobs:
           ref: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref }}
 
       - name: Pull latest changes
-        run: git pull origin ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
+        env:
+          PAW_BRANCH_NAME: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
+        run: git pull origin "$PAW_BRANCH_NAME"
 
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
@@ -605,16 +650,21 @@ jobs:
           # xcode-select alone does not propagate to subprocesses, so set it explicitly
           DEVELOPER_DIR: /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
         run: |
-          echo "=== iPhoneOS.platform check ==="
-          ls "$DEVELOPER_DIR/Platforms/iPhoneOS.platform/" 2>/dev/null && echo "iPhoneOS.platform EXISTS" || echo "iPhoneOS.platform NOT FOUND"
-          echo "=== Installing MobileDevice packages ==="
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          m wf_flutter.xcode_platform_check
+          if ls "$DEVELOPER_DIR/Platforms/iPhoneOS.platform/" 2>/dev/null; then
+            m wf_flutter.xcode_platform_exists
+          else
+            m wf_flutter.xcode_platform_missing
+          fi
+          m wf_flutter.xcode_install_pkgs
           sudo installer -pkg /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Resources/Packages/MobileDevice.pkg -target /
           sudo installer -pkg /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Resources/Packages/MobileDeviceDevelopment.pkg -target /
-          echo "=== Accepting Xcode license ==="
+          m wf_flutter.xcode_license
           sudo xcodebuild -license accept
-          echo "=== Initializing Xcode components ==="
+          m wf_flutter.xcode_init
           xcrun simctl list >/dev/null 2>&1 || true
-          echo "=== Downloading iOS platform ==="
+          m wf_flutter.xcode_download
           xcodebuild -downloadPlatform iOS
 
       - name: Download project files
@@ -627,14 +677,15 @@ jobs:
         env:
           ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           if [ "$ENV_MODE" = "dotenv" ]; then
             printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
-            echo "✅ $ENV_FILE_PATH file created"
+            m wf_flutter.env_file_created file="$ENV_FILE_PATH"
           elif [ -n "$ENV_CONTENT" ]; then
             DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
             printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
             echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
-            echo "dart-define file prepared"
+            m wf_flutter.dart_define_prepared
           fi
 
       - name: Set up Flutter
@@ -676,7 +727,7 @@ jobs:
           fi
 
       - name: Import Code-Signing Certificates
-        uses: Apple-Actions/import-codesign-certs@v2
+        uses: Apple-Actions/import-codesign-certs@v7
         with:
           p12-file-base64: ${{ secrets.APPLE_CERTIFICATE_BASE64 }}
           p12-password: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
@@ -737,13 +788,15 @@ jobs:
             -exportOptionsPlist ExportOptions.plist
 
       - name: Create build metadata file
+        env:
+          PAW_BRANCH_NAME: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
         run: |
           cat > build-metadata.json << EOF
           {
             "pr_number": "${{ needs.prepare-test-build.outputs.pr_number }}",
             "build_number": "${{ needs.prepare-test-build.outputs.build_number }}",
             "issue_number": "${{ needs.prepare-test-build.outputs.issue_number }}",
-            "branch_name": "${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
+            "branch_name": "$PAW_BRANCH_NAME"
           }
           EOF
           cat build-metadata.json
@@ -761,19 +814,27 @@ jobs:
         id: progress_step2
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION: ${{ needs.prepare-test-build.outputs.version }}
+          PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_ELAPSED: ${{ steps.progress_step1.outputs.elapsed }}
+          PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_END_TIME: ${{ steps.progress_step1.outputs.end_time }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const step1EndTime = parseInt('${{ steps.progress_step1.outputs.end_time }}');
-            const step1Elapsed = '${{ steps.progress_step1.outputs.elapsed }}';
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const version = '${{ needs.prepare-test-build.outputs.version }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const step1EndTime = parseInt(process.env.PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_END_TIME);
+            const step1Elapsed = process.env.PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_ELAPSED;
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const version = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();
@@ -816,23 +877,33 @@ jobs:
             core.setOutput('end_time', now.toString());
 
       - name: Update the progress comment on build failure
-        if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
+        if: failure() && steps.load_messages.outcome == 'success' && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME: ${{ needs.notify-start.outputs.start_time }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH: ${{ needs.prepare-test-build.outputs.commit_hash }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION: ${{ needs.prepare-test-build.outputs.version }}
+          PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_ELAPSED: ${{ steps.progress_step1.outputs.elapsed }}
+          PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_END_TIME: ${{ steps.progress_step1.outputs.end_time }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
-            const step1EndTime = parseInt('${{ steps.progress_step1.outputs.end_time }}') || 0;
-            const step1Elapsed = '${{ steps.progress_step1.outputs.elapsed }}';
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const version = '${{ needs.prepare-test-build.outputs.version }}';
-            const commitHash = '${{ needs.prepare-test-build.outputs.commit_hash }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const startTime = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME);
+            const step1EndTime = parseInt(process.env.PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_END_TIME) || 0;
+            const step1Elapsed = process.env.PAW_IN_STEPS_PROGRESS_STEP1_OUTPUTS_ELAPSED;
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const version = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION;
+            const commitHash = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();
@@ -899,8 +970,10 @@ jobs:
           sparse-checkout-cone-mode: false
 
       - name: Load messages
+        id: load_messages
         working-directory: ${{ github.workspace }}
         run: |
+          [ -f .paw-msg/.github/scripts/messages.py ] || { echo "::error::messages.py is missing; rerun \`npx project-auto-wizard --mode full --force\`"; exit 1; }
           cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
           LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
           rm -rf .paw-msg
@@ -956,7 +1029,7 @@ jobs:
             printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
           fi
           bundle install
-          echo "✅ Fastlane installed (Bundler)"
+          m flutter_a.fastlane_installed_bundler
 
       - name: Upload to TestFlight
         env:
@@ -966,7 +1039,7 @@ jobs:
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           # Find the IPA file
           IPA_PATH=$(find "$GITHUB_WORKSPACE/${FLUTTER_PROJECT_DIR}/ios/build/ipa" -name "*.ipa" | head -1)
-          echo "📦 Found IPA at: $IPA_PATH"
+          m wf_flutter.ipa_found path="$IPA_PATH"
 
           if [ ! -f "$IPA_PATH" ]; then
             m ios_test_tf.ipa_missing
@@ -977,7 +1050,7 @@ jobs:
           # Prepare release notes (final_release_notes.txt is relative to the repo root — use an absolute path since working-directory is FLUTTER_PROJECT_DIR)
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             RELEASE_NOTES=$(cat "$GITHUB_WORKSPACE/final_release_notes.txt")
-            echo "📝 Release Notes:"
+            m wf_flutter.release_notes_heading
             echo "$RELEASE_NOTES"
           else
             RELEASE_NOTES="$(m ios_test_tf.notes_build build="${{ needs.prepare-test-build.outputs.build_number }}")"
@@ -989,7 +1062,7 @@ jobs:
           export IPA_PATH="$IPA_PATH"
           export RELEASE_NOTES="$RELEASE_NOTES"
 
-          echo "🔧 Working directory: $(pwd)"
+          m wf_flutter.working_dir dir="$(pwd)"
           echo "🔧 IPA_PATH: $IPA_PATH"
           echo "🔧 API_KEY_PATH: $API_KEY_PATH"
 
@@ -999,6 +1072,8 @@ jobs:
 
       - name: Notify TestFlight Upload Success
         if: success()
+        env:
+          PAW_BRANCH_NAME: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
         run: |
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           m ios_test_tf.upload_ok
@@ -1007,14 +1082,14 @@ jobs:
           if [ -n "${{ needs.prepare-test-build.outputs.pr_number }}" ]; then
             m ios_test_tf.upload_pr pr="${{ needs.prepare-test-build.outputs.pr_number }}"
           fi
-          m ios_test_tf.upload_branch branch="${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
-          m ios_test_tf.upload_commit sha="${{ github.sha }}"
+          m ios_test_tf.upload_branch branch="$PAW_BRANCH_NAME"
+          m ios_test_tf.upload_commit sha="${{ needs.prepare-test-build.outputs.commit_sha }}"
           if [ -n "${{ needs.prepare-test-build.outputs.issue_url }}" ]; then
             m ios_test_tf.upload_issue url="${{ needs.prepare-test-build.outputs.issue_url }}"
           fi
 
       - name: Notify on Failure
-        if: failure()
+        if: failure() && steps.load_messages.outcome == 'success'
         run: |
           m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           m ios_test_tf.upload_failed
@@ -1023,22 +1098,33 @@ jobs:
       - name: Final progress update - success
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP1_ELAPSED: ${{ needs.build-ios-test.outputs.step1_elapsed }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_ELAPSED: ${{ needs.build-ios-test.outputs.step2_elapsed }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_END_TIME: ${{ needs.build-ios-test.outputs.step2_end_time }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME: ${{ needs.notify-start.outputs.start_time }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH: ${{ needs.prepare-test-build.outputs.commit_hash }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION: ${{ needs.prepare-test-build.outputs.version }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
-            const step2EndTime = parseInt('${{ needs.build-ios-test.outputs.step2_end_time }}');
-            const step1Elapsed = '${{ needs.build-ios-test.outputs.step1_elapsed }}';
-            const step2Elapsed = '${{ needs.build-ios-test.outputs.step2_elapsed }}';
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const version = '${{ needs.prepare-test-build.outputs.version }}';
-            const commitHash = '${{ needs.prepare-test-build.outputs.commit_hash }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const startTime = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME);
+            const step2EndTime = parseInt(process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_END_TIME);
+            const step1Elapsed = process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP1_ELAPSED;
+            const step2Elapsed = process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_ELAPSED;
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const version = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION;
+            const commitHash = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();
@@ -1086,24 +1172,35 @@ jobs:
             console.log(msg('ios_test_tf.log_all_done', { elapsed: totalElapsed }));
 
       - name: Final progress update - failure
-        if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
+        if: failure() && steps.load_messages.outcome == 'success' && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
+        env:
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME: ${{ github.event.client_payload.branch_name }}
+          PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER: ${{ github.event.client_payload.build_number }}
+          PAW_IN_GITHUB_RUN_ID: ${{ github.run_id }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP1_ELAPSED: ${{ needs.build-ios-test.outputs.step1_elapsed }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_ELAPSED: ${{ needs.build-ios-test.outputs.step2_elapsed }}
+          PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_END_TIME: ${{ needs.build-ios-test.outputs.step2_end_time }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID: ${{ needs.notify-start.outputs.comment_id }}
+          PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME: ${{ needs.notify-start.outputs.start_time }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH: ${{ needs.prepare-test-build.outputs.commit_hash }}
+          PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION: ${{ needs.prepare-test-build.outputs.version }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const M = JSON.parse(process.env.PAW_MSG);
             const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
-            const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
-            const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
-            const step2EndTime = parseInt('${{ needs.build-ios-test.outputs.step2_end_time }}') || 0;
-            const step1Elapsed = '${{ needs.build-ios-test.outputs.step1_elapsed }}';
-            const step2Elapsed = '${{ needs.build-ios-test.outputs.step2_elapsed }}';
-            const branchName = '${{ github.event.client_payload.branch_name }}';
-            const buildNumber = '${{ github.event.client_payload.build_number }}';
-            const version = '${{ needs.prepare-test-build.outputs.version }}';
-            const commitHash = '${{ needs.prepare-test-build.outputs.commit_hash }}';
-            const runId = '${{ github.run_id }}';
+            const commentId = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_COMMENT_ID);
+            const startTime = parseInt(process.env.PAW_IN_NEEDS_NOTIFY_START_OUTPUTS_START_TIME);
+            const step2EndTime = parseInt(process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_END_TIME) || 0;
+            const step1Elapsed = process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP1_ELAPSED;
+            const step2Elapsed = process.env.PAW_IN_NEEDS_BUILD_IOS_TEST_OUTPUTS_STEP2_ELAPSED;
+            const branchName = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BRANCH_NAME;
+            const buildNumber = process.env.PAW_IN_GITHUB_EVENT_CLIENT_PAYLOAD_BUILD_NUMBER;
+            const version = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_VERSION;
+            const commitHash = process.env.PAW_IN_NEEDS_PREPARE_TEST_BUILD_OUTPUTS_COMMIT_HASH;
+            const runId = process.env.PAW_IN_GITHUB_RUN_ID;
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
             const now = Date.now();