Add rootName propagation from runner -> shell -> help

Push custom root names all the way down to the help text for commands.

src/Console/CommandRunner.php

@@ -169,6 +169,7 @@ protected function getShell(ConsoleIo $io, CommandCollection $commands, $name)
         if (method_exists($instance, 'setCommandCollection')) {
             $instance->setCommandCollection($commands);
         }
+        $instance->setRootName($this->root);
 
         return $instance;
     }

src/Console/Shell.php

@@ -162,6 +162,13 @@ class Shell
      */
     protected $_io;
 
+    /**
+     * The root command name used when generating help output.
+     *
+     * @var string
+     */
+    protected $rootName = 'cake';
+
     /**
      * Constructs this Shell instance.
      *
@@ -190,6 +197,19 @@ public function __construct(ConsoleIo $io = null)
         }
     }
 
+    /**
+     * Set the root command name for help output.
+     *
+     * @param string $name The name of the root command.
+     * @return $this
+     */
+    public function setRootName($name)
+    {
+        $this->rootName = (string)$name;
+
+        return $this;
+    }
+
     /**
      * Get the io object for this shell.
      *
@@ -550,8 +570,10 @@ protected function _displayHelp($command)
     public function getOptionParser()
     {
         $name = ($this->plugin ? $this->plugin . '.' : '') . $this->name;
+        $parser = new ConsoleOptionParser($name);
+        $parser->setRootName($this->rootName);
 
-        return new ConsoleOptionParser($name);
+        return $parser;
     }
 
     /**

tests/TestCase/Console/CommandRunnerTest.php

@@ -241,6 +241,30 @@ public function testRunValidCommandReturnInteger()
         $this->assertSame(99, $result);
     }
 
+    /**
+     * Ensure that the root command name propagates to shell help
+     *
+     * @return void
+     */
+    public function testRunRootNamePropagates()
+    {
+        $app = $this->getMockBuilder(BaseApplication::class)
+            ->setMethods(['middleware', 'bootstrap', 'console'])
+            ->setConstructorArgs([$this->config])
+            ->getMock();
+
+        $commands = new CommandCollection(['sample' => SampleShell::class]);
+        $app->method('console')->will($this->returnValue($commands));
+
+        $output = new ConsoleOutput();
+
+        $runner = new CommandRunner($app, 'widget');
+        $runner->run(['widget', 'sample', '-h'], $this->getMockIo($output));
+        $result = implode("\n", $output->messages());
+        $this->assertContains('widget sample [-h]', $result);
+        $this->assertNotContains('cake sample [-h]', $result);
+    }
+
     protected function getMockIo($output)
     {
         $io = $this->getMockBuilder(ConsoleIo::class)

tests/TestCase/Console/ShellTest.php

@@ -1339,6 +1339,17 @@ public function testGetSetIo()
         $this->assertSame($this->Shell->getIo(), $this->io);
     }
 
+    /**
+     * Test setRootName filters into the option parser help text.
+     *
+     * @return void
+     */
+    public function testSetRootNamePropagatesToHelpText()
+    {
+        $this->assertSame($this->Shell, $this->Shell->setRootName('tool'), 'is chainable');
+        $this->assertContains('tool shell_test_shell [-h]', $this->Shell->getOptionParser()->help());
+    }
+
     /**
      * Tests __debugInfo
      *