Add restart command and --watch option to wp shell

[Copilot]

• Implement restart functionality in REPL class
• Implement wrapper loop in Shell_Command to restart REPL
  • Spawn new PHP process using pcntl_exec() to fully reload all code
  • Simplify WP-CLI script path detection (if/elseif instead of foreach)
  • Use WP_CLI::get_runner()->config for robust --path, --user, --url preservation
• Add comprehensive tests for restart and exit functionality
• Implement --watch option for auto-restart on file changes
• Update documentation in docblocks with examples
• Fix PHPCS alignment issues
• Remove unnecessary PHPStan ignore directive
• Add SplFileInfo type hint for PHPStan

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Support restarting a shell</issue_title>
<issue_description>The wp shell command is super useful for debugging sessions, however it is quite tedious when you need to make code changes, as it does not reload the modified code.

By properly spawning the actual REPL in a new PHP process, and by checking the exit state for a specific result, it should be possible to inject a command that allows for restarting the REPL.

Bonus points: provide a wp shell --watch=<folder> command that watches for changes in a specific folder and restarts the shell automatically.</issue_description>

Comments on the Issue (you are @copilot in this section)

@danielbachhuber 💯

• Fixes Support restarting a shell #76

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[codecov]

Codecov Report

❌ Patch coverage is 14.60674% with 76 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/Shell_Command.php	16.32%	41 Missing ⚠️
src/WP_CLI/Shell/REPL.php	12.50%	35 Missing ⚠️

📢 Thoughts on this report? Let us know!