chore(ci): add manual e2e workflow and docs updates

Author: homotechsual

.github/workflows/manual-e2e-tests.yml

@@ -0,0 +1,68 @@
+name: Manual E2E Tests
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+on:
+  workflow_dispatch:
+    inputs:
+      confirm_destructive:
+        description: Confirm this run is allowed to execute destructive E2E tests
+        required: true
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: haloapi-manual-e2e
+  cancel-in-progress: false
+
+jobs:
+  e2e:
+    name: Run E2E Tests
+    runs-on: windows-latest
+    env:
+      HaloTestingURL: ${{ secrets.HaloTestingURL }}
+      HaloTestingClientID: ${{ secrets.HaloTestingClientID }}
+      HaloTestingClientSecret: ${{ secrets.HaloTestingClientSecret }}
+      HaloTestingTenant: ${{ secrets.HaloTestingTenant }}
+    steps:
+      - name: Validate destructive test confirmation
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+          if ('${{ inputs.confirm_destructive }}' -ne 'true') {
+            throw 'This workflow runs destructive E2E tests. Set confirm_destructive=true to proceed.'
+          }
+
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Bootstrap environment
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+          & "$env:GITHUB_WORKSPACE\Bootstrap.ps1"
+
+      - name: Run E2E tests
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+          pwsh -NoProfile -File "$env:GITHUB_WORKSPACE\DevOps\Quality\test.ps1" -Suite E2E -Verbosity Detailed
+
+      - name: Upload E2E test results
+        if: always()
+        uses: actions/upload-artifact@v6
+        with:
+          name: pester-e2e-results
+          path: .artifacts/TestResults.e2e.xml
+
+      - name: Publish E2E test results
+        if: always()
+        uses: dorny/test-reporter@v3
+        with:
+          name: Pester Tests (E2E)
+          path: .artifacts/TestResults.e2e.xml
+          reporter: java-junit

Docs/HaloAPI/development/index.mdx

@@ -47,7 +47,27 @@ Do not invoke `Invoke-Pester` directly as the normal validation path in the VS C
 * Run `Bootstrap.ps1` after changing local dependencies.
 * Run `run-pssa.ps1` to validate PowerShell style and custom repo rules.
 * Run `test.ps1 -Suite Meta` for the safe baseline test suite.
-* Only run `Core` tests when the required Halo testing environment variables are available.
+* Only run `Live` tests when the required Halo testing environment variables are available.
+
+## Manual E2E Workflow
+
+Destructive end-to-end tests are executed through a dedicated manual workflow.
+
+Workflow: `Manual E2E Tests`
+Path: `.github/workflows/manual-e2e-tests.yml`
+
+Run steps:
+
+1. Open **Actions** in GitHub and select **Manual E2E Tests**.
+2. Click **Run workflow**.
+3. Set `confirm_destructive` to `true`.
+4. Run the workflow and review published `Pester Tests (E2E)` results.
+
+Notes:
+
+* The workflow requires Halo test secrets (`HaloTestingURL`, `HaloTestingClientID`, `HaloTestingClientSecret`, `HaloTestingTenant`).
+* The workflow runs `DevOps\Quality\test.ps1 -Suite E2E` and uploads `.artifacts/TestResults.e2e.xml`.
+* Keep E2E runs manual/on-demand to avoid destructive test execution in normal PR CI.
 
 ## Release and Workflow Notes