chore: add agentic action

Author: HardeepAsrani

.github/ISSUE_TEMPLATE/agent-task.yml

@@ -0,0 +1,50 @@
+name: "Agent Task"
+description: "Structured task for coding agents"
+labels: ["agent"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal / Acceptance Criteria
+      description: "What does 'done' look like? Be specific."
+      placeholder: "Example: Add a new customizer control to the dashboard app and ensure it renders on the frontend."
+    validations:
+      required: true
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: Constraints / Do Not Touch
+      description: "List files/areas to avoid or any guardrails."
+      placeholder: "Example: Do not edit build outputs directly; do not change vendor/ or node_modules/."
+    validations:
+      required: false
+
+  - type: textarea
+    id: relevant_files
+    attributes:
+      label: Relevant Files (if known)
+      description: "Optional: point the agent to likely files."
+      placeholder: "Example: assets/apps/dashboard/src/, inc/customizer/, AGENTS.md"
+    validations:
+      required: false
+
+  - type: textarea
+    id: tests
+    attributes:
+      label: Tests to Run
+      description: "Default is PHP lint/PHPStan/PHPUnit unless explicitly scoped out. Add the JS/E2E steps when those areas are touched."
+      value: |
+        Default:
+        - composer run lint
+        - composer run phpstan
+        - phpunit
+
+        When JS/TS files are touched:
+        - yarn run lint
+        - yarn run build
+
+        When UI/E2E flows are touched:
+        - yarn run test:playwright
+    validations:
+      required: true

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

@@ -0,0 +1,61 @@
+name: "Copilot Setup Steps"
+
+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` for the Copilot coding agent to pick it up.
+  copilot-setup-steps:
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+    services:
+      mysql:
+        image: mysql:5.7
+        env:
+          MYSQL_ROOT_PASSWORD: root
+        ports:
+          - 3306/tcp
+        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
+
+    # These steps run before the agent starts, to pre-install dependencies and tools.
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "16"
+          cache: "yarn"
+
+      - name: Install JavaScript dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps chromium
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "7.4"
+          extensions: simplexml, mysql
+          tools: phpunit, phpunit-polyfills, wp-cli, phpcs, phpstan
+
+      - name: Install PHP dependencies
+        env:
+          GITHUB_TOKEN: ${{ secrets.BOT_TOKEN }}
+        run: COMPOSER=composer-dev.json composer install --prefer-dist --no-progress
+
+      - name: Build assets
+        run: yarn run build
+
+      - name: Install WordPress Test Suite
+        run: |
+          bash bin/install-wp-tests.sh wordpress_test root root 127.0.0.1:${{ job.services.mysql.ports['3306'] }}

AGENTS.md

@@ -49,9 +49,15 @@ yarn run format:scss
 ## Testing
 
 ```bash
-# PHP unit tests
-./vendor/bin/phpunit
-./vendor/bin/phpunit tests/test-neve.php                 # Single test file
+# PHP unit tests. Prerequisites: MySQL, the WordPress test suite, and the PHPUnit
+# Polyfills. Neither PHPUnit nor the Polyfills are composer deps here: GitHub-hosted
+# runners ship PHPUnit preinstalled globally, and setup-php adds the Polyfills
+# (tools: phpunit-polyfills). copilot-setup-steps.yml installs both. Install the suite once:
+bash bin/install-wp-tests.sh wordpress_test root root 127.0.0.1
+# On macOS the suite installs under $TMPDIR; export WP_TESTS_DIR so PHPUnit finds it:
+#   export WP_TESTS_DIR="$TMPDIR/wordpress-tests-lib"
+phpunit                                                   # phpunit is NOT a composer dep here; use the global one (CI/copilot-setup provide it)
+phpunit tests/test-neve.php                               # Single test file
 
 # E2E tests (Playwright, requires WordPress environment)
 yarn run test:playwright