Clarify the Copilot PR-review prompt to execute five explicit phases (Understanding, Test Review, Fix Exploration, Alternative Comparison, Final Review). Add a new pipeline step that invokes a Copilot "post-comment" skill, captures its exit code, logs output to $(Build.ArtifactStagingDirectory)/copilot-logs, and sets a PostCommentFailed variable on failure. Ensure artifacts dir exists, surface warnings on failure, and make the original post-comment fallback step run only when the skill step failed. Update step display names and preserve artifact publishing.

Add a pipeline step (Cache Prompt File) that loads eng/pipelines/prompts/pr-review-prompt.md and copies it to /tmp/copilot-prompts/pr-review-prompt.md before the PR branch checkout. Update the later Copilot step to read the prompt from the cached location and adjust the error message. This prevents failures when the prompt file is absent on the PR branch by ensuring a stable copy is available for the review step.

Replace brittle iPhone Xs + iOS 18.5 lookup with a prioritized selection routine. The script now iterates preferred iOS versions and device models, picks the first available preferred device or falls back to the first available iPhone, and finally falls back to any available simulator. It also surfaces runtime info when listing available simulators and reports the selected device name and UDID before booting.

Replace direct checkout of the PR branch with logic that fetches the PR, computes the merge-base against the current branch, and cherry-picks commits from the merge-base..PR_HEAD onto the current branch (using --no-commit). Adds commit counting, a warning when no commits are found, conflict handling with status and diff output, and extra logging (current branch, merge base, commit count, last commit and status). Also updates the pipeline step display name to 'Cherry-pick PR Changes' and tweaks the fetch message.

Add a CI step to run ./build.ps1 --target=dotnet-buildtasks (Release, diagnostic) to compile MSBuild tasks required for MAUI builds. The step includes a retry on failure and sets DOTNET_TOKEN and PRIVATE_BUILD environment variables for accessing internal artifacts. Placed before the simulator/emulator listing to ensure tasks are available for subsequent MAUI jobs.

Remove stale agent session notes and tighten PR scripting behavior.

Changes:
- Deleted .github/agent-pr-session/*.md (removed archived agent session files).
- .github/scripts/Review-PR.ps1: updated PR log directory and display path to use "PRAgent/copilot-logs" subfolder.
- .github/skills/verify-tests-fail-without-fix/scripts/verify-tests-fail.ps1: stop falling back to an "unknown" PR folder; now errors and exits if -PRNumber is not provided.

Reason: avoid ambiguous "unknown" PR artifacts and standardize log location under PRAgent; fail early when PR number is missing to prevent accidental runs with incorrect paths.

Align docs and script to the new path layout under CustomAgentLogsTmp/PRState/{number}/PRAgent. Updated PLAN-TEMPLATE.md (post-pr-finalize SummaryFile path), SKILL.md (auto-loading description), and post-try-fix-comment.ps1 (examples, parameter docs, and path regex) so try-fix and finalize operations look in the PRAgent/try-fix and PRAgent/pr-finalize locations.

Replace CI-specific language with general "autonomous/non-interactive" phrasing and tighten guidance to not prompt a human operator. Updates remove or reword references to "CI mode" and emphasize skipping blocked phases, retrying once, and continuing autonomously. Affected files: .github/agents/pr.md, .github/agents/pr/PLAN-TEMPLATE.md, .github/agents/pr/SHARED-RULES.md, .github/agents/pr/post-gate.md, and .github/scripts/Review-PR.ps1.

Remove the optional -Content parameter and make post-ai-summary-comment.ps1 always load phase content from CustomAgentLogsTmp/PRState/<PRNumber>/PRAgent/*/content.md. Update script help, examples, and validation messages; refactor auto-load logic to locate the repo root, load available phase files (pre-flight, gate, try-fix, report), build a status table and per-phase details, and synthesize the final comment. Also update SKILL.md to remove the "Provide content directly" section, adjust the Parameters table, and clarify the auto-loading behavior in the documentation.

Save the current branch and commit SHA before running the PR agent and use that pinned restore point to reliably restore the working tree between phases. Detects if the agent or finalize step changed branch/HEAD and recovers via git checkout/reset to the saved branch+SHA; otherwise performs targeted checkouts from the pinned SHA. Also update targeted file recoveries to use the pinned SHA.

Additionally, clarify the try-fix skill docs: the baseline script requires the PR changes to be present on the current branch and should be reported as Blocked rather than switching branches when fix files are missing.

Introduce a -Unified mode to post-pr-finalize-comment.ps1 and call it from Review-PR.ps1. When enabled, the script injects or updates a PR Finalization section inside the existing AI Summary comment (or creates a new unified AI Summary comment) using explicit markers and a collapsible details block; it also removes any legacy standalone finalize comment. Dry-run preview support was added (writes preview file), and existing standalone behavior remains the default when -Unified is not passed. Changes made in .github/scripts/Review-PR.ps1 and .github/skills/ai-summary-comment/scripts/post-pr-finalize-comment.ps1.

Update Start-Emulator.ps1 to select iOS simulators that match UI test baseline devices. Replace the single preferred device list with a per-iOS-version mapping (iOS-18/iOS-17 prefer iPhone Xs; iOS-26 prefers iPhone 11 Pro) and adjust the selection logic to use the version-specific preferences. Comments were updated to document why certain devices are preferred to ensure consistency with UITest.cs baselines.

When deploying or starting iOS simulators, add logic to detect any other booted simulators and shut them down to prevent Appium from connecting to the wrong device. Implements parsing of `xcrun simctl list devices --json` and shuts down any booted simulator whose UDID does not match the target in both Build-AndDeploy.ps1 and Start-Emulator.ps1. Also update the success message to include the simulator name for clearer logs.

…ype unavailable

iPhone Xs device type (com.apple.CoreSimulator.SimDeviceType.iPhone-Xs) is not available
on newer Xcode versions on CI agents. iPhone 11 Pro has the same screen resolution
(1125x2436 @3x) so snapshots match the baselines captured on iPhone Xs.

Fallback order: iPhone Xs (existing) → iPhone 11 Pro (existing) → create iPhone Xs
→ create iPhone 11 Pro → first available iPhone.

Fix: Start-Emulator.ps1 respects DEVICE_UDID env var and prefers iPhone 11 Pro

Two fixes:
1. Check $env:DEVICE_UDID before auto-detecting - the CI pipeline sets this
   via ##vso[task.setvariable] but Start-Emulator.ps1 was ignoring it
2. Add iPhone 11 Pro as second preferred device for iOS 18/17 (same 1125x2436
   resolution as iPhone Xs) - iPhone Xs device type is unavailable on CI agents

Fix CI iOS simulator selection to use iPhone Xs for snapshot baselines

The CI pipeline was selecting iPhone 16 Pro (1206x2472) which doesn't
match the UI test baseline screenshots captured on iPhone Xs (1124x2286).

Changes:
- Create iPhone Xs simulator if not available on CI agent
- Target the latest stable iOS runtime (18.x preferred)
- Shutdown other booted simulators to prevent Appium conflicts

Co-Authored-By: Copilot <[email protected]>

dotnet#34156)

Pipeline runs for the Copilot CI pipeline had no meaningful title,
making it hard to identify runs at a glance. This adds a step
immediately after `Validate Parameters` that renames the run to `PR:
{PRNumber} {Platform}` using the Azure DevOps logging command.

## Change

- **`eng/pipelines/ci-copilot.yml`**: Adds a `Set Pipeline Run Title`
step after `Validate Parameters`:

```yaml
- script: |
    echo "##vso[build.updatebuildnumber]PR: ${{ parameters.PRNumber }} ${{ parameters.Platform }}"
  displayName: 'Set Pipeline Run Title'
```

Produces titles like `PR: 1234 android` or `PR: 5678 ios`. Implemented
as a bash `script:` for compatibility with the macOS agents used by this
pipeline.

<!-- START COPILOT ORIGINAL PROMPT -->



<details>

<summary>Original prompt</summary>

> Create a pull request in `dotnet/maui` (base branch `copilot-ci`) to
update the Azure DevOps pipeline at `eng/pipelines/ci-copilot.yml` so
that the pipeline run title/build number is updated early in the run.
> 
> Requirements:
> - Add a step shortly after the existing **Validate Parameters** step
to rename the pipeline run using Azure DevOps logging command
`##vso[build.updatebuildnumber]...`.
> - The run title should be exactly: `PR: {PR number} {Platform}` where:
>   - PR number comes from parameter `${{ parameters.PRNumber }}`
>   - Platform comes from parameter `${{ parameters.Platform }}`
> - Use a clear `displayName`, e.g. `Set Pipeline Run Title`.
> - Keep the change minimal and do not alter existing behavior beyond
setting the run title.
> 
> Context:
> - File source URL:
https://github.com/dotnet/maui/blob/copilot-ci/eng/pipelines/ci-copilot.yml
> - CommitOID (context): 4896e12
> 
> Notes:
> - Implement as a YAML step using `script:` (bash) for maximum
compatibility on macOS agents.
> - Ensure the title format does not include parentheses—use a single
space between PR number and platform, e.g. `PR: 1234 android`.


</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

*This pull request was created from Copilot chat.*
>

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/dotnet/maui/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: jfversluis <[email protected]>

Second test

This reverts commit 28bc3cc.

Introduce automated agent labeling for PR reviews: add a new shared labeler script (.github/scripts/shared/Update-AgentLabels.ps1) and wire it into Review-PR.ps1 as Phase 4 (Apply Labels). The labeler parses phase content.md files (gate/try-fix/report) to determine outcome, gate and fix signal labels, ensures labels exist, and applies/removes mutually-exclusive outcome/signal labels plus a tracking label (s/agent-reviewed). Add comprehensive docs (.github/docs/agent-labels.md) and update the PR agent SHARED-RULES.md to describe label meanings and expectations. Operations are idempotent and non-fatal; Review-PR.ps1 attempts a targeted recovery if the helper is missing.