Add restart command and --watch option to wp shell

[Copilot]

• Understand current codebase structure and how REPL works
• Implement restart functionality in REPL class
  • Add special command detection for 'restart'
  • Return special exit code (10) when restart is requested
  • Update REPL loop to return instead of infinite loop on restart
  • Add 'exit' command support for clean exit
• Implement wrapper loop in Shell_Command to restart REPL
  • Check return value and restart if needed
  • Handle restart loop with do-while pattern
  • Spawn new PHP process using pcntl_exec() to fully reload all code
  • Preserve command arguments (--basic, --watch, --path) when restarting
  • Fallback to in-process restart if pcntl_exec() unavailable
• Add comprehensive tests for restart and exit functionality
• Implement --watch option for auto-restart on file changes
  • Add --watch parameter handling with validation
  • Add file modification time tracking
  • Implement recursive directory monitoring
  • Auto-restart when changes detected
  • Force --basic mode when --watch is used
• Update documentation in docblocks with examples
• Document pcntl_exec() requirement and fallback behavior
• Run code review (passed with no issues)
• Run security checks (no issues found)
• Fix PHPCS alignment issues
• Remove unnecessary PHPStan ignore directive
• Add SplFileInfo type hint for PHPStan

Implementation Complete

The restart command now spawns a new PHP process using pcntl_exec(), which fully reloads all code including files loaded with require_once/include_once. This addresses the original issue requirement to "properly spawn the actual REPL in a new PHP process" for reloading modified code. If pcntl_exec() is not available, the shell falls back to in-process restart with a debug message.

All requirements from the issue have been implemented and code style issues have been addressed.

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 13.63636% 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	10.25%	35 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

This PR adds restart functionality and a file watching feature to the wp shell command. The restart command allows users to reset the REPL state, and the --watch option automatically restarts the shell when files change in a specified directory.

Changes:

• Added restart and exit commands to the built-in REPL
• Implemented --watch option to monitor file changes and auto-restart
• Added comprehensive Behat tests for restart and exit commands

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
src/WP_CLI/Shell/REPL.php	Implements restart/exit command detection, file watching logic with recursive directory scanning, and returns appropriate exit codes
src/Shell_Command.php	Adds --watch parameter handling, implements restart loop wrapper, forces --basic mode for watch functionality, and validates watch paths
features/shell.feature	Adds test scenarios for restart and exit commands to ensure proper functionality

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.