Updates installation command to synchronize scripts, GitHub workflows, and .editorconfig files.

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

Author: coisa

README.md

@@ -52,8 +52,8 @@ composer dev-tools wiki
 # Generate documentation frontpage and related reports
 composer dev-tools reports
 
-# Installs and synchronizes development scripts in the root composer.json
-composer dev-tools install-scripts
+# Installs and synchronizes dev-tools scripts, GitHub Actions workflows, and .editorconfig
+composer dev-tools install
 ```
 
 ## 📄 License

docs/running/specialized-commands.rst

@@ -73,11 +73,11 @@ Structurally consolidates distinct reporting commands, accurately aggregating te
 
    composer dev-tools reports
 
-8. Install Scripts (``install-scripts``)
-----------------------------------------
+8. Install (``install``)
+------------------------
 
-Adds or updates useful development tool scripts directly in your ``composer.json``, making it easier to standardize your team's workflow. This command ensures that all recommended scripts for QA and automation are present and up to date.
+Adds or updates dev-tools scripts in your ``composer.json``, copies reusable GitHub Actions workflows, and ensures the ``.editorconfig`` file is present and up to date. This command helps standardize your team's workflow and automation setup.
 
 .. code-block:: bash
 
-   composer dev-tools install-scripts
+   composer dev-tools install

src/Command/InstallScriptsCommand.php src/Command/InstallCommand.phpsrc/Command/InstallScriptsCommand.php renamed to src/Command/InstallCommand.php

@@ -29,7 +29,7 @@
  * Represents the command responsible for installing development scripts into `composer.json`.
  * This class MUST NOT be overridden and SHALL rely on the `ScriptsInstallerTrait`.
  */
-final class InstallScriptsCommand extends AbstractCommand
+final class InstallCommand extends AbstractCommand
 {
     /**
      * Configures the current command.
@@ -42,9 +42,9 @@ final class InstallScriptsCommand extends AbstractCommand
     protected function configure(): void
     {
         $this
-            ->setName('install-scripts')
-            ->setDescription('Installs and synchronizes development scripts in the root composer.json.')
-            ->setHelp('This command adds common development tool scripts to your composer.json file.');
+            ->setName('install')
+            ->setDescription('Installs and synchronizes dev-tools scripts, GitHub Actions workflows, and .editorconfig in the root project.')
+            ->setHelp('This command adds or updates dev-tools scripts in composer.json, copies reusable GitHub Actions workflows, and ensures .editorconfig is present and up to date.');
     }
 
     /**
@@ -64,6 +64,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $this->updateComposerJson();
         $this->createGitHubActionWorkflows();
+        $this->copyEditorConfig();
 
         return self::SUCCESS;
     }
@@ -120,7 +121,7 @@ private function updateComposerJson(): void
      *
      * @return void
      */
-    public function createGitHubActionWorkflows(): void
+    private function createGitHubActionWorkflows(): void
     {
         $finder = Finder::create()
             ->files()
@@ -138,4 +139,25 @@ public function createGitHubActionWorkflows(): void
             $this->filesystem->dumpFile($targetPath, $content);
         }
     }
+
+    /**
+     * Installs or updates the .editorconfig file in the root project directory.
+     *
+     * This method copies the .editorconfig from the package resources to the project root,
+     * always overwriting to ensure it is up to date.
+     *
+     * @return void
+     */
+    private function copyEditorConfig(): void
+    {
+        $source = $this->getConfigFile('.editorconfig');
+        $target = $this->getConfigFile('.editorconfig', true);
+
+        if ($this->filesystem->exists($target)) {
+            return;
+        }
+
+        $content = $this->filesystem->readFile($source);
+        $this->filesystem->dumpFile($target, $content);
+    }
 }

src/Composer/Capability/DevToolsCommandProvider.php

@@ -28,7 +28,7 @@
 use FastForward\DevTools\Command\StandardsCommand;
 use FastForward\DevTools\Command\TestsCommand;
 use FastForward\DevTools\Command\WikiCommand;
-use FastForward\DevTools\Command\InstallScriptsCommand;
+use FastForward\DevTools\Command\InstallCommand;
 
 /**
  * Provides a registry of custom dev-tools commands mapped for Composer integration.
@@ -55,7 +55,7 @@ public function getCommands()
             new StandardsCommand(),
             new ReportsCommand(),
             new WikiCommand(),
-            new InstallScriptsCommand(),
+            new InstallCommand(),
         ];
     }
 }

src/Composer/Plugin.php

@@ -79,7 +79,7 @@ public function onPostInstall(Event $event): void
     {
         $event->getComposer()
             ->getEventDispatcher()
-            ->dispatchScript('install-scripts', true);
+                ->dispatchScript('install', true);
     }
 
     /**
@@ -96,7 +96,7 @@ public function onPostUpdate(Event $event): void
     {
         $event->getComposer()
             ->getEventDispatcher()
-            ->dispatchScript('install-scripts', true);
+                ->dispatchScript('install', true);
     }
 
     /**

tests/Composer/Capability/DevToolsCommandProviderTest.php

@@ -21,7 +21,7 @@
 use FastForward\DevTools\Command\AbstractCommand;
 use FastForward\DevTools\Command\CodeStyleCommand;
 use FastForward\DevTools\Command\DocsCommand;
-use FastForward\DevTools\Command\InstallScriptsCommand;
+use FastForward\DevTools\Command\InstallCommand;
 use FastForward\DevTools\Command\PhpDocCommand;
 use FastForward\DevTools\Command\RefactorCommand;
 use FastForward\DevTools\Command\ReportsCommand;
@@ -43,7 +43,7 @@
 #[UsesClass(StandardsCommand::class)]
 #[UsesClass(ReportsCommand::class)]
 #[UsesClass(WikiCommand::class)]
-#[UsesClass(InstallScriptsCommand::class)]
+#[UsesClass(InstallCommand::class)]
 final class DevToolsCommandProviderTest extends TestCase
 {
     private DevToolsCommandProvider $commandProvider;
@@ -72,7 +72,7 @@ public function getCommandsWillReturnAllSupportedCommandsInExpectedOrder(): void
                 new StandardsCommand(),
                 new ReportsCommand(),
                 new WikiCommand(),
-                new InstallScriptsCommand(),
+                new InstallCommand(),
             ],
             $this->commandProvider->getCommands(),
         );

tests/Composer/PluginTest.php

@@ -138,7 +138,7 @@ public function onPostInstallWillInstallScripts(): void
 
         // Mock EventDispatcher
         $eventDispatcher = $this->prophesize(EventDispatcher::class);
-        $eventDispatcher->dispatchScript('install-scripts', true)
+        $eventDispatcher->dispatchScript('install', true)
             ->willReturn(0);
         $this->composer->getEventDispatcher()
             ->willReturn($eventDispatcher->reveal());
@@ -170,7 +170,7 @@ public function onPostUpdateWillInstallScripts(): void
 
         // Mock EventDispatcher
         $eventDispatcher = $this->prophesize(EventDispatcher::class);
-        $eventDispatcher->dispatchScript('install-scripts', true)
+        $eventDispatcher->dispatchScript('install', true)
             ->willReturn(0);
         $this->composer->getEventDispatcher()
             ->willReturn($eventDispatcher->reveal());