Merge branch 'main' into dependabot/composer/drupal/animated_gif-2.0.5

.github/workflows/continuous_integration.yml

@@ -1,8 +1,5 @@
 name: Continuous Integration
-on:
-  pull_request:
-    paths-ignore:
-      - '**.md'
+on: [pull_request]
 permissions:
   pull-requests: write
   issues: write

.github/workflows/set-tugboat-tests-pending.yml

@@ -0,0 +1,43 @@
+name: Set Tugboat Tests Pending
+on:
+  - pull_request_target
+permissions:
+  pull-requests: write
+  checks: write
+  contents: write
+  statuses: write
+jobs:
+  # Tugboat tests are not automatically set pending, even though they are
+  # required in branch protection rules (see #10553).
+  #
+  # Therefore, a PR can inappropriately appear to be ready to merge if,
+  # for instance, a composer.lock merge conflict prevents the Tugboat
+  # preview from successfully building.
+  #
+  # This action sets these tests pending from an immediate GitHub Action
+  # so that we can trust our automated code review processes more.
+  set-tugboat-tests-pending:
+    name: Set Tugboat Tests Pending
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+      - name: Set status for Tugboat tasks.
+        run: |
+          test_names=(
+            va/tests/cypress
+            va/tests/phpunit
+            va/tests/content-build-gql
+            va/tests/status-error
+          )
+          for test_name in "${test_names[@]}"; do
+            gh api \
+              --method POST \
+              -H "Accept: application/vnd.github+json" \
+              "/repos/${GITHUB_REPOSITORY}/statuses/${SHA}" \
+              -f state='pending' \
+              -f context="${test_name}";
+          done;
+        env:
+          SHA: ${{ github.event.pull_request.head.sha }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -144,7 +144,7 @@ This section outlines only the systems utilized by the CMS. See the READMEs in t
 - A single "mirror" environment is regularly populated with a sanitized production database copy.
 - Open Pull Requests get environments created automatically, cloned from the "mirror" environment, with URLs like:
    - [pr123-{hash}.ci.cms.va.gov](https://pr123-{hash}.ci.cms.va.gov) for the CMS
-      - Cypress test logs and artifacts, see [Testing](READMES/testing.md) for details.
+      - To access Cypress test logs and artifacts, see [Testing](READMES/testing.md) for details.
    - [web-{hash}.ci.cms.va.gov](http://web-{hash}.ci.cms.va.gov) for the frontend web build
    - [storybook-{hash}.ci.cms.va.gov](http://storybook-{hash}.ci.cms.va.gov) for design system documentation
 - Ad-hoc environments can be created and deleted at any time by any logged in user on [tugboat.vfs.va.gov/](https://tugboat.vfs.va.gov/):