[FEATURE] ✨ Add option to halt before commit

Add the option `--halt-before-commit` to pause Patchbot
before a commit. This way users may review changes manually
instead of letting the CI do the job, which may be usefull
for sensitive changes.
Patchbot will ask to continue and abort of the user denies it.

Refs #10

Author: pixelbrackets

README.md

@@ -124,6 +124,14 @@ the feature branch instead of a random name:
 ./vendor/bin/patchbot patch --branch-name=feature-1337-add-license-file --patch-name=template --repository-url=https://git.example.com/repository
 ```
 
+It is recommend to let a CI run all tests, that's why Patchbot creates a feature
+branch by default. If you want to review changes manually before the commit,
+then use the `halt-before-commit` option:
+
+```bash
+./vendor/bin/patchbot patch --halt-before-commit --patch-name=template --repository-url=https://git.example.com/repository
+```
+
 ### Merge feature branch
 
 When you reviewed the feature branch and all tests are successful then

src/RoboFile.php

@@ -22,6 +22,7 @@ class RoboFile extends \Robo\Tasks
      * @option $patch-name Name of the directory where the patch code resides
      * @option $source-branch Name of the branch to create a new branch upon
      * @option $branch-name Name of the feature branch to be created
+     * @option $halt-before-commit Pause before changes are commited, asks to continue
      * @throws \Robo\Exception\TaskException
      */
     public function patch(array $options = [
@@ -31,6 +32,7 @@ public function patch(array $options = [
         'patch-name|p' => 'template',
         'source-branch' => 'master', // rename to main in next mayor release
         'branch-name' => null,
+        'halt-before-commit' => false,
     ])
     {
         if (empty($options['repository-url'])) {
@@ -78,12 +80,27 @@ public function patch(array $options = [
         }
         chdir($currentDirectory);
 
-        // Commit changes
+        // Check for changes
         $this->say('Commit changes');
-        if (empty(exec('git status -s'))) {
+        $fileChanges = exec('git status -s');
+        if (empty($fileChanges)) {
             $this->say('Nothing to commit, no changes in repository');
             return;
         }
+
+        // Halt for manual review before commit
+        if ($options['halt-before-commit']) {
+            $this->say('Halt for manual review');
+            $this->say('Working directory: ' . PHP_EOL . $currentDirectory);
+            $this->say('File changes: ' . PHP_EOL . $fileChanges);
+            $question = $this->io()->confirm('Continue?', true);
+            if ($question === false) {
+                return;
+            }
+        }
+
+        // Commit changes
+        $this->say('Commit changes');
         $commitMessage = file_get_contents($patchSourceDirectory . $options['patch-name'] . '/commit-message.txt');
         $this->taskGitStack()
             ->add('-A')