Deprecate Annotated Commands in favor of native Symfony Console commands

src/Application.php

@@ -352,4 +352,14 @@ protected function addListeners($commandfileSearchpath): void
         $listenerClasses = $this->serviceManager->filterListeners($listenerClasses);
         $this->serviceManager->addListeners($listenerClasses, Drush::getContainer());
     }
+
+    // Remove a command. Initially used by WootDefinitionListener and its test.
+    public function remove(string $id): void
+    {
+        $rf = new \ReflectionProperty(\Symfony\Component\Console\Application::class, 'commands');
+        $rf->setAccessible(true);
+        $commands = $rf->getValue($this);
+        unset($commands[$id]);
+        $rf->setValue($this, $commands);
+    }
 }

sut/modules/unish/woot/src/Drush/Listeners/WootDefinitionListener.php

@@ -24,7 +24,9 @@ public function __invoke(ConsoleDefinitionsEvent $event): void
         foreach ($event->getApplication()->all() as $id => $command) {
             if ($command->getName() === 'woot:altered') {
                 $command->setAliases(['woot-new-alias']);
-                // @todo Remove the command keyed with the old alias.
+                if ($id == 'woot-initial-alias') {
+                    $event->getApplication()->remove('woot-initial-alias');
+                }
                 $this->logger->debug(dt("Module 'woot' changed the alias of 'woot:altered' command into 'woot-new-alias' in " . __METHOD__ . '().'));
             }
         }