refactor: simplify E2E test command and update README instructions

Author: mgascam

package.json

@@ -48,8 +48,7 @@
     "test:qit-phpstan": "npm run build:release && ./tests/qit/phpstan.sh",
     "test:qit-phpstan-local": "npm run build:release && ./tests/qit/phpstan.sh --local",
     "test:qit-malware": "npm run build:release && ./tests/qit/malware.sh --local",
-    "test:qit-e2e": "./vendor/bin/qit run:e2e woocommerce-payments --config tests/qit/qit.json --profile=default --env_file ${QIT_ENV_FILE:-tests/qit/config/local.env}",
-    "test:qit-e2e:args": "./vendor/bin/qit run:e2e woocommerce-payments --config tests/qit/qit.json --profile=default --env_file ${QIT_ENV_FILE:-tests/qit/config/local.env} --",
+    "test:qit-e2e": "./vendor/bin/qit run:e2e woocommerce-payments --config tests/qit/qit.json --profile=default",
     "watch": "webpack --watch",
     "hmr": "webpack server",
     "start": "npm run watch",

tests/qit/README.md

@@ -5,11 +5,13 @@ We use the [QIT toolkit](https://qit.woo.com/docs/) for automated testing includ
 ### Setup
 
 1. Create `local.env` inside the `tests/qit/config/` directory by copying the variables from `default.env`.
-2. To get the actual values for local config, refer to this [secret store](https://mc.a8c.com/secret-store/?secret_id=11043) link.
-3. Use standard `KEY=VALUE` format (no `export` keyword needed).
+2. Use standard `KEY=VALUE` format (no `export` keyword needed).
+3. Configure the required credentials:
+   - **QIT authentication**: Get credentials from the [secret store](https://mc.a8c.com/secret-store/?secret_id=11043). These authenticate you with the QIT service.
+   - **E2E Jetpack credentials** (`E2E_JP_SITE_ID`, `E2E_JP_BLOG_TOKEN`, `E2E_JP_USER_TOKEN`): Get these from a Jurassic Ninja site already onboarded in test mode.
 4. Once configured, the first time you run a test command, it will create a local auth file for subsequent runs.
 
-**Note:** E2E tests require the dev version of `qit-cli`. Run `composer require woocommerce/qit-cli:dev-trunk --dev` to install it locally.
+**Note:** E2E tests require the dev version of `qit-cli` (test packages are not yet in stable releases). Run `composer require woocommerce/qit-cli:dev-trunk --dev --ignore-platform-reqs` to install it locally.
 
 ### Running Tests
 
@@ -31,43 +33,26 @@ Before running E2E tests, build the plugin package:
 npm run build:release
 ```
 
-This creates `woocommerce-payments.zip` which is used by QIT. Then run the tests:
+This creates `woocommerce-payments.zip` which is used by QIT. Then run the tests with the required environment variables:
 
 ```bash
-# Run all E2E tests
-npm run test:qit-e2e
+# Run all E2E tests (prepend with env vars from local.env)
+E2E_JP_SITE_ID='<value>' E2E_JP_BLOG_TOKEN='<value>' E2E_JP_USER_TOKEN='<value>' npm run test:qit-e2e
+
+# Run specific test file (passthrough to Playwright)
+E2E_JP_SITE_ID='<value>' E2E_JP_BLOG_TOKEN='<value>' E2E_JP_USER_TOKEN='<value>' npm run test:qit-e2e -- -- shopper-checkout-purchase.spec.ts
 
-# Run tests matching a pattern (e.g., @shopper tag, test name, or file path)
-npm run test:qit-e2e:args -- --grep "@shopper"
-npm run test:qit-e2e:args -- --grep "shopper-checkout-purchase"
+# Run tests filtered by tag (e.g., @blocks, @shopper)
+E2E_JP_SITE_ID='<value>' E2E_JP_BLOG_TOKEN='<value>' E2E_JP_USER_TOKEN='<value>' npm run test:qit-e2e -- -- --grep "@blocks"
 ```
 
-You can also run QIT directly for more control:
+**Tip:** You can export the variables once per shell session instead of prepending each command:
 
 ```bash
-# Run all tests
-./vendor/bin/qit run:e2e woocommerce-payments \
-  --config tests/qit/qit.json \
-  --profile=default \
-  --env_file tests/qit/config/local.env
-
-# Run specific test file via Playwright options
-./vendor/bin/qit run:e2e woocommerce-payments \
-  --config tests/qit/qit.json \
-  --profile=default \
-  --env_file tests/qit/config/local.env \
-  --pw_options "woopayments/shopper/shopper-checkout-purchase.spec.ts"
-
-# Run tests with specific tag
-./vendor/bin/qit run:e2e woocommerce-payments \
-  --config tests/qit/qit.json \
-  --profile=default \
-  --env_file tests/qit/config/local.env \
-  --pw_test_tag="@critical"
+set -a && source tests/qit/config/local.env && set +a
+npm run test:qit-e2e
 ```
 
-**Note:** E2E tests require valid Jetpack credentials in `local.env` (`E2E_JP_SITE_ID`, `E2E_JP_BLOG_TOKEN`, `E2E_JP_USER_TOKEN`).
-
 ### Analyzing Results
 
 - Once the test run completes, you'll see a result URL along with the test summary.