[E2E][QIT] Add QIT E2E shopper checkout specs

This establishes the foundation for migrating E2E tests to QIT
with working checkout tests that exercise the new infrastructure.

Author: mgascam

split-shopper-specs-plan.md

@@ -0,0 +1,351 @@
+# Stacked PR Reorganization Plan
+
+## Goal
+Remove PR #11054 and consolidate its foundation files into PR #11069, creating a cleaner 4-PR stack instead of 5.
+
+## Current Structure
+```
+develop
+  ↓
+PR #11054 (dev/qit-e2e-workflows) - foundation + workflow
+  ↓
+PR #11069 (dev/qit-e2e-shopper-specs-migration) - shopper specs
+  ↓
+PR #11071 (dev/qit-e2e-merchant-specs-migration) - merchant specs
+  ↓
+PR #11078 (dev/qit-e2e-subscriptions-specs-migration) - subscriptions specs
+  ↓
+PR #11082 (dev/qit-e2e-enhance-workflows) - enhanced workflows
+```
+
+## Target Structure
+```
+develop
+  ↓
+PR #11069 (foundation + shopper specs)
+  ↓
+PR #11071 (merchant specs)
+  ↓
+PR #11078 (subscriptions specs)
+  ↓
+PR #11082 (GitHub Actions workflows)
+```
+
+---
+
+## Foundation Changes Analysis
+
+### Files #11069 Already Modifies from #11054
+- `tests/qit/e2e-runner.sh` - Simplifies QIT binary handling
+- `tests/qit/e2e/bootstrap/setup.sh` - Enhances setup logic
+- `tests/qit/qit.yml` - Minor tweaks
+
+### Files #11069 Already Deletes from #11054
+- `tests/qit/e2e/basic.spec.js` - Converts to TypeScript
+- `tests/qit/e2e/checkout.spec.js` - Converts to TypeScript
+
+### Foundation Files from #11054 That Come Along
+These files are already in the git history when rebasing #11069 onto develop:
+
+**Bootstrap scripts (Jetpack integration):**
+- `tests/qit/e2e/bootstrap/class-wp-cli-qit-dev-command.php`
+- `tests/qit/e2e/bootstrap/qit-jetpack-connection.php`
+- `tests/qit/e2e/bootstrap/qit-jetpack-status.php`
+
+**Configuration files:**
+- `tests/qit/config/default.env`
+- `tests/qit/e2e/.eslintrc.js`
+- `tests/js/jest.config.js`
+
+**Dependencies:**
+- `composer.json` (QIT CLI 0.4.0 → 0.10.0)
+- `composer.lock`
+- `package.json`
+
+**Changelog:**
+- `changelog/dev-qit-e2e-foundation`
+
+### File to Remove
+- `.github/workflows/qit-e2e.yml` - Will be added properly in #11082
+- `changelog/dev-qit-e2e-workflows` - Workflow-specific changelog
+
+---
+
+## Step-by-Step Execution Plan
+
+### Step 1: Create Backup Branches (Safety First!)
+
+```bash
+# Fetch latest from remote
+git fetch origin
+
+# Create backup branches in case we need to revert
+git branch backup-dev-qit-e2e-workflows origin/dev/qit-e2e-workflows
+git branch backup-dev-qit-e2e-shopper-specs-migration origin/dev/qit-e2e-shopper-specs-migration
+git branch backup-dev-qit-e2e-merchant-specs-migration origin/dev/qit-e2e-merchant-specs-migration
+git branch backup-dev-qit-e2e-subscriptions-specs-migration origin/dev/qit-e2e-subscriptions-specs-migration
+git branch backup-dev-qit-e2e-enhance-workflows origin/dev/qit-e2e-enhance-workflows
+
+echo "✅ Backups created! If anything goes wrong, you can restore with:"
+echo "   git checkout dev/qit-e2e-shopper-specs-migration"
+echo "   git reset --hard backup-dev-qit-e2e-shopper-specs-migration"
+```
+
+### Step 2: Rebase #11069 onto develop
+
+```bash
+# Checkout #11069 branch
+git checkout dev/qit-e2e-shopper-specs-migration
+
+# Update develop locally
+git fetch origin develop:develop
+
+# Rebase onto develop (this brings all commits from #11054 + #11069)
+git rebase origin/develop
+
+# ✅ At this point, the branch has foundation + shopper specs
+# ❌ But it also has the workflow file from #11054 that we don't want
+```
+
+### Step 3: Remove the workflow file
+
+**Simple approach (recommended):**
+```bash
+# Remove the workflow file (we'll add it properly in #11082)
+git rm .github/workflows/qit-e2e.yml
+
+# Remove workflow changelog (keep foundation changelog)
+git rm changelog/dev-qit-e2e-workflows
+
+# Commit the removal
+git commit -m "Remove workflow file - will be added in final PR
+
+The workflow file from #11054 will be replaced by the enhanced
+workflows in the final PR. This keeps the foundation separate
+from workflow implementation."
+
+# ✅ Now #11069 has: foundation + shopper specs, no workflow
+```
+
+**Alternative (interactive rebase to edit history):**
+```bash
+# Interactive rebase to clean up properly
+git rebase -i origin/develop
+
+# In the editor:
+# - Find the commit that added .github/workflows/qit-e2e.yml
+# - Change 'pick' to 'edit' for that commit
+# - Save and close
+
+# When rebase pauses:
+git rm .github/workflows/qit-e2e.yml
+git rm changelog/dev-qit-e2e-workflows || true
+git commit --amend --no-edit
+git rebase --continue
+```
+
+### Step 4: Force push the updated branch
+
+```bash
+# Force push to update PR #11069
+git push origin dev/qit-e2e-shopper-specs-migration --force-with-lease
+
+echo "✅ PR #11069 updated! It now targets develop and includes foundation"
+```
+
+### Step 5: Rebase #11071 (merchant specs) onto the new #11069
+
+```bash
+# Checkout #11071
+git checkout dev/qit-e2e-merchant-specs-migration
+
+# Rebase onto the updated #11069
+git rebase dev/qit-e2e-shopper-specs-migration
+
+# Force push
+git push origin dev/qit-e2e-merchant-specs-migration --force-with-lease
+
+echo "✅ PR #11071 rebased onto new #11069"
+```
+
+### Step 6: Rebase #11078 (subscriptions specs) onto the new #11071
+
+```bash
+# Checkout #11078
+git checkout dev/qit-e2e-subscriptions-specs-migration
+
+# Rebase onto the updated #11071
+git rebase dev/qit-e2e-merchant-specs-migration
+
+# Force push
+git push origin dev/qit-e2e-subscriptions-specs-migration --force-with-lease
+
+echo "✅ PR #11078 rebased onto new #11071"
+```
+
+### Step 7: Rebase #11082 (workflows) onto the new #11078
+
+```bash
+# Checkout #11082
+git checkout dev/qit-e2e-enhance-workflows
+
+# Rebase onto the updated #11078
+git rebase dev/qit-e2e-subscriptions-specs-migration
+
+# ⚠️ You might see a conflict for .github/workflows/qit-e2e.yml
+# This is expected! The file doesn't exist in the base anymore.
+```
+
+**If you get a conflict:**
+```bash
+# Check the status
+git status
+
+# The workflow file changes should be applied as a new file creation
+# If git shows a conflict, resolve it by accepting the new version:
+git add .github/workflows/qit-e2e.yml
+
+# Continue the rebase
+git rebase --continue
+```
+
+**Force push:**
+```bash
+git push origin dev/qit-e2e-enhance-workflows --force-with-lease
+
+echo "✅ PR #11082 rebased onto new #11078"
+```
+
+### Step 8: Update PR targets on GitHub
+
+The force pushes automatically update the PR bases in most cases, but let's verify:
+
+```bash
+# Check current PR information
+gh pr view 11069 --json baseRefName,headRefName
+gh pr view 11071 --json baseRefName,headRefName
+gh pr view 11078 --json baseRefName,headRefName
+gh pr view 11082 --json baseRefName,headRefName
+```
+
+**If any PR still shows the wrong base**, update it via GitHub CLI:
+
+```bash
+# Update PR #11069 to target develop (if not already)
+gh pr edit 11069 --base develop
+
+# Verify the others target the right branches
+# #11071 should target dev/qit-e2e-shopper-specs-migration
+# #11078 should target dev/qit-e2e-merchant-specs-migration
+# #11082 should target dev/qit-e2e-subscriptions-specs-migration
+```
+
+**Update PR #11069 description** to mention it includes foundation:
+
+```bash
+gh pr edit 11069 --body "This PR migrates shopper E2E specs to QIT and includes the foundation from the removed PR #11054.
+
+**Includes:**
+- QIT E2E foundation (bootstrap scripts, runner, config)
+- QIT CLI upgrade (0.4.0 → 0.10.0)
+- Jetpack integration for QIT environment
+- Shopper spec migration to TypeScript
+
+**Note:** The GitHub Actions workflows will be added in the final PR (#11082)."
+```
+
+### Step 9: Close PR #11054
+
+```bash
+# Close PR #11054 with a comment explaining why
+gh pr close 11054 --comment "Closing this PR as the foundation has been merged into PR #11069 to reduce the number of stacked PRs. The GitHub Actions workflows will be added in the final PR #11082.
+
+The foundation changes from this PR are preserved in #11069."
+```
+
+---
+
+## Verification Steps
+
+After completing all the above steps, verify everything:
+
+```bash
+# Verify PR chain
+gh pr view 11069 --json baseRefName,headRefName,title
+gh pr view 11071 --json baseRefName,headRefName,title
+gh pr view 11078 --json baseRefName,headRefName,title
+gh pr view 11082 --json baseRefName,headRefName,title
+
+# Verify #11054 is closed
+gh pr view 11054 --json state
+
+# Check that workflow file exists in #11082 but not in #11078
+git checkout dev/qit-e2e-subscriptions-specs-migration
+ls -la .github/workflows/qit-e2e.yml  # Should NOT exist
+
+git checkout dev/qit-e2e-enhance-workflows
+ls -la .github/workflows/qit-e2e.yml  # Should exist
+ls -la .github/workflows/qit-e2e-pull-request.yml  # Should exist
+
+# Return to develop
+git checkout develop
+```
+
+---
+
+## Rollback Procedure
+
+If any step fails or produces unexpected results:
+
+```bash
+# Restore from backups
+git checkout dev/qit-e2e-shopper-specs-migration
+git reset --hard backup-dev-qit-e2e-shopper-specs-migration
+git push origin dev/qit-e2e-shopper-specs-migration --force-with-lease
+
+# Repeat for other branches as needed
+git checkout dev/qit-e2e-merchant-specs-migration
+git reset --hard backup-dev-qit-e2e-merchant-specs-migration
+git push origin dev/qit-e2e-merchant-specs-migration --force-with-lease
+
+git checkout dev/qit-e2e-subscriptions-specs-migration
+git reset --hard backup-dev-qit-e2e-subscriptions-specs-migration
+git push origin dev/qit-e2e-subscriptions-specs-migration --force-with-lease
+
+git checkout dev/qit-e2e-enhance-workflows
+git reset --hard backup-dev-qit-e2e-enhance-workflows
+git push origin dev/qit-e2e-enhance-workflows --force-with-lease
+```
+
+---
+
+## Expected Outcomes
+
+### PR Sizes After Reorganization
+- **#11069**: ~5,800 additions (foundation + shopper specs)
+- **#11071**: ~3,400 additions (merchant specs)
+- **#11078**: ~1,500 additions (subscriptions specs)
+- **#11082**: ~750 additions (workflows)
+
+### Benefits
+✅ Eliminates PR #11054 from the review queue
+✅ Consolidates foundation + shopper specs into #11069
+✅ Keeps workflow complexity separate in final PR #11082
+✅ Clean linear PR chain: develop → specs → workflows
+✅ Reduces total number of PRs from 5 to 4
+✅ Avoids reviewing intermediate workflow version
+
+### Review Strategy
+1. **Merge #11069** - Review foundation + shopper specs together
+2. **Merge #11071** - Review merchant specs
+3. **Merge #11078** - Review subscriptions specs
+4. **Merge #11082** - Review final workflow implementation
+
+---
+
+## Notes
+
+- The workflow file in #11082 will show as a file creation (not modification) since it was removed from the history
+- All foundation changes from #11054 are preserved in #11069's git history
+- The commit history remains clean with clear separation between foundation and workflows
+- Each PR can still be reviewed and merged independently in sequence