Add copilot-setup-steps.yml as GitHub Actions workflow for automated agent environment configuration (#382)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: thomasturrell <1552612+thomasturrell@users.noreply.github.com>

Author: Copilot

.github/copilot-instructions.md

@@ -22,25 +22,7 @@ xAPI Java is a library that helps you create applications that send or receive x
 
 ## Environment Setup
 
-### Java Installation with SDKMAN
-
-This project requires Java 25. We recommend using [SDKMAN!](https://sdkman.io/) to manage Java versions:
-
-```bash
-# Install SDKMAN (if not already installed)
-curl -s "https://get.sdkman.io" | bash
-
-# Install Java 25 (Temurin distribution recommended)
-sdk install java 25.0.1-tem
-
-# Set as default (optional)
-sdk default java 25.0.1-tem
-
-# Verify installation
-java -version
-```
-
-**Note**: The exact identifier (e.g., `25.0.1-tem`) may vary by platform and availability. Use `sdk list java` to see available Java 25 versions for your system.
+**Note**: For GitHub Copilot agents, automated environment setup is configured in [copilot-setup-steps.yml](workflows/copilot-setup-steps.yml). The workflow automatically sets up Java 25 (Temurin distribution) and caches Maven dependencies.
 
 ## Building and Testing
 

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,43 @@
+# GitHub Copilot Setup Steps for xAPI Java
+# This workflow configures the environment for GitHub Copilot agents working on this repository.
+# See: https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment
+
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy validation, and
+# allow manual testing through the repository's "Actions" tab
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+
+    # Set the permissions to the lowest permissions possible needed for your steps.
+    # Copilot will be given its own token for its operations.
+    permissions:
+      # Contents read permission is needed to clone the repository to install dependencies
+      contents: read
+
+    # You can define any steps you want, and they will run before the agent starts.
+    # If you do not check out your code, Copilot will do this for you.
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 25
+        uses: actions/setup-java@v5
+        with:
+          java-version: "25"
+          distribution: "temurin"
+          cache: maven
+
+      - name: Build with Maven
+        run: ./mvnw -B clean verify -DskipTests --file pom.xml