feat: server crud commands

.cursor/rules/01-architecture.mdc

@@ -141,3 +141,5 @@ vendor/bin/pint $CHANGED_PHP_FILES    # Fix code style (changed files only)
 # Static analysis excluding tests (never do static analysis against tests)
 vendor/bin/phpstan analyze $CHANGED_PHP_FILES_EXCEPT_TESTS
 ```
+
+**Important: ** Don't run PHPStan on test files; tests are excluded from static analysis.

.cursor/rules/02-tests.mdc

@@ -123,5 +123,7 @@ $mock->shouldReceive('method')->with('param')->andReturn('result');
 
 ### Static Analysis
 
+**Running PHPStan applies to PRODUCTION code, not tests.**
+
 - Ignore PHPStan issues in tests - focus on test functionality over compliance
 - Avoid excessive phpdoc just to appease types

app/Console/Server/ServerAddCommand.php

@@ -0,0 +1,246 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bigpixelrocket\DeployerPHP\Console\Server;
+
+use Bigpixelrocket\DeployerPHP\Contracts\BaseCommand;
+use Bigpixelrocket\DeployerPHP\DTOs\ServerDTO;
+use Bigpixelrocket\DeployerPHP\Traits\ServerHelpersTrait;
+use Bigpixelrocket\DeployerPHP\Traits\ServerValidationTrait;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Add and register a new server to the inventory.
+ *
+ * Prompts for server details and verifies SSH connectivity before saving.
+ */
+#[AsCommand(name: 'server:add', description: 'Add a new server to the inventory')]
+class ServerAddCommand extends BaseCommand
+{
+    use ServerHelpersTrait;
+    use ServerValidationTrait;
+
+    //
+    // Configuration
+    // -------------------------------------------------------------------------------
+
+    protected function configure(): void
+    {
+        parent::configure();
+
+        $this
+            ->addOption('name', null, InputOption::VALUE_REQUIRED, 'Server name')
+            ->addOption('host', null, InputOption::VALUE_REQUIRED, 'Host/IP address')
+            ->addOption('port', null, InputOption::VALUE_REQUIRED, 'SSH port (default: 22)')
+            ->addOption('username', null, InputOption::VALUE_REQUIRED, 'SSH username (default: root)')
+            ->addOption('private-key-path', null, InputOption::VALUE_REQUIRED, 'SSH private key path')
+            ->addOption('skip', null, InputOption::VALUE_NONE, 'Skip SSH connection check')
+            ->addOption('yes', 'y', InputOption::VALUE_NONE, 'Skip confirmation prompt');
+    }
+
+    //
+    // Execution
+    // -------------------------------------------------------------------------------
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        parent::execute($input, $output);
+
+        $this->hr();
+
+        $this->h1('Add New Server');
+
+        //
+        // Gather server details
+
+        /** @var string $name */
+        $name = $this->getOptionOrPrompt(
+            'name',
+            fn (): string => $this->promptText(
+                label: 'Server name:',
+                placeholder: 'web1',
+                required: true
+            )
+        );
+
+        /** @var string $host */
+        $host = $this->getOptionOrPrompt(
+            'host',
+            fn (): string => $this->promptText(
+                label: 'Host/IP address:',
+                placeholder: '192.168.1.100',
+                required: true
+            )
+        );
+
+        $this->validateHost($host);
+
+        /** @var string $portString */
+        $portString = $this->getOptionOrPrompt(
+            'port',
+            fn (): string => $this->promptText(
+                label: 'SSH port:',
+                default: '22',
+                required: true
+            )
+        );
+
+        $port = (int) $portString;
+        $this->validatePort($port);
+
+        /** @var string $username */
+        $username = $this->getOptionOrPrompt(
+            'username',
+            fn (): string => $this->promptText(
+                label: 'SSH username:',
+                default: 'root',
+                required: true
+            )
+        );
+
+        /** @var string $privateKeyPathRaw */
+        $privateKeyPathRaw = $this->getOptionOrPrompt(
+            'private-key-path',
+            fn (): string => $this->promptText(
+                label: 'SSH private key path (leave empty for default ~/.ssh/id_ed25519 or ~/.ssh/id_rsa):',
+                default: '',
+                required: false
+            )
+        );
+
+        /** @var ?string $privateKeyPath */
+        $privateKeyPath = $privateKeyPathRaw !== '' ? $privateKeyPathRaw : null;
+
+        //
+        // Create DTO and display server info
+
+        $server = new ServerDTO(
+            name: $name,
+            host: $host,
+            port: $port,
+            username: $username,
+            privateKeyPath: $privateKeyPath
+        );
+
+        $this->hr();
+
+        $this->displayServerInfo($server);
+
+        //
+        // Verify connectivity
+
+        /** @var bool $skipCheck */
+        $skipCheck = $this->getOptionOrPrompt(
+            'skip',
+            fn (): bool => !$this->promptConfirm(
+                label: 'Test SSH connection before saving?',
+                default: true
+            )
+        );
+
+        if ($skipCheck) {
+            $this->warning('Skipping SSH connection check');
+            $this->writeln('');
+        } else {
+            if (!$this->testConnection($server)) {
+                return Command::FAILURE;
+            }
+        }
+
+        //
+        // Confirm creation
+
+        /** @var bool $confirmed */
+        $confirmed = $this->getOptionOrPrompt(
+            'yes',
+            fn (): bool => $this->promptConfirm(
+                label: 'Save this server to inventory?',
+                default: true
+            )
+        );
+
+        if (!$confirmed) {
+            $this->warning('Cancelled adding server');
+            $this->writeln('');
+
+            return Command::SUCCESS;
+        }
+
+        //
+        // Save to repository
+
+        try {
+            $this->servers->create($server);
+        } catch (\RuntimeException $e) {
+            $this->error('Failed to add server: ' . $e->getMessage());
+
+            return Command::FAILURE;
+        }
+
+        $this->success('Server added successfully');
+        $this->writeln('');
+
+        //
+        // Show command hint
+
+        $this->showCommandHint('server:add', [
+            'name' => $name,
+            'host' => $host,
+            'port' => $port,
+            'username' => $username,
+            'private-key-path' => $privateKeyPath,
+            'skip' => $skipCheck,
+            'yes' => $confirmed,
+        ]);
+
+        return Command::SUCCESS;
+    }
+
+    //
+    // Private Helpers
+    // -------------------------------------------------------------------------------
+
+    /**
+     * Test SSH connection to server with detailed output.
+     */
+    private function testConnection(ServerDTO $server): bool
+    {
+        try {
+            $this->promptSpin(
+                callback: fn () => $this->ssh->assertCanConnect(
+                    $server->host,
+                    $server->port,
+                    $server->username,
+                    $server->privateKeyPath
+                ),
+                message: 'Connecting to server...'
+            );
+
+            $this->success('SSH connection successful');
+
+            return true;
+        } catch (\RuntimeException $e) {
+            $this->error($e->getMessage());
+
+            $this->writeln([
+                '',
+                '  <fg=yellow>Common issues:</>',
+                '',
+                '  <fg=gray>• Check that the server is accessible from your network</>',
+                '  <fg=gray>• Verify SSH is running on the server (port '.$server->port.')</>',
+                '  <fg=gray>• Ensure your SSH key has correct permissions (chmod 600)</>',
+                '  <fg=gray>• Confirm username "'.$server->username.'" exists on the server</>',
+                '',
+                '  <fg=gray>Tip: Use</> <fg=cyan>--skip</> <fg=gray>to add server without testing connection.</>',
+                '',
+            ]);
+
+            return false;
+        }
+    }
+}

app/Console/Server/ServerDeleteCommand.php

@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bigpixelrocket\DeployerPHP\Console\Server;
+
+use Bigpixelrocket\DeployerPHP\Contracts\BaseCommand;
+use Bigpixelrocket\DeployerPHP\DTOs\ServerDTO;
+use Bigpixelrocket\DeployerPHP\Traits\ServerHelpersTrait;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Delete a server from the inventory.
+ */
+#[AsCommand(name: 'server:delete', description: 'Delete a server from the inventory')]
+class ServerDeleteCommand extends BaseCommand
+{
+    use ServerHelpersTrait;
+
+    //
+    // Configuration
+    // -------------------------------------------------------------------------------
+
+    protected function configure(): void
+    {
+        parent::configure();
+
+        $this
+            ->addOption('name', null, InputOption::VALUE_REQUIRED, 'Server name')
+            ->addOption('yes', 'y', InputOption::VALUE_NONE, 'Skip confirmation prompt');
+    }
+
+    //
+    // Execution
+    // -------------------------------------------------------------------------------
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        parent::execute($input, $output);
+
+        $this->hr();
+
+        //
+        // Get all servers
+
+        $allServers = $this->servers->all();
+        if (count($allServers) === 0) {
+            $this->warning('No servers found in inventory');
+            $this->writeln([
+                '',
+                'Use <fg=cyan>server:add</> to add a server',
+                '',
+            ]);
+
+            return Command::SUCCESS;
+        }
+
+        // Extract server names from DTOs for promptSelect
+        $serverNames = array_map(fn (ServerDTO $server) => $server->name, $allServers);
+
+        //
+        // Select server to delete
+
+        $this->h1('Delete Server');
+
+        $name = (string) $this->getOptionOrPrompt(
+            'name',
+            fn () => $this->promptSelect(
+                label: 'Select server:',
+                options: $serverNames,
+            )
+        );
+
+        //
+        // Find server and display info
+
+        $server = null;
+        foreach ($allServers as $s) {
+            if ($s->name === $name) {
+                $server = $s;
+                break;
+            }
+        }
+
+        if ($server === null) {
+            $this->error("Server '{$name}' not found in inventory");
+            return Command::FAILURE;
+        }
+
+        $this->displayServerInfo($server);
+
+        //
+        // Confirm deletion
+
+        /** @var bool $confirmed */
+        $confirmed = $this->getOptionOrPrompt(
+            'yes',
+            fn (): bool => $this->promptConfirm(
+                label: 'Are you sure you want to delete this server?',
+                default: true
+            )
+        );
+
+        if (!$confirmed) {
+            $this->warning('Cancelled deleting server');
+            $this->writeln('');
+
+            return Command::SUCCESS;
+        }
+
+        //
+        // Delete server
+
+        $this->servers->delete($name);
+
+        $this->success("Server '{$name}' deleted successfully");
+        $this->writeln('');
+
+        //
+        // Show command hint
+
+        $this->showCommandHint('server:delete', [
+            'name' => $name,
+            'yes' => $confirmed,
+        ]);
+
+        return Command::SUCCESS;
+    }
+}