add Annabel CLI with built-in commands and lazy-loaded database migration tooling

Author: KolesnikovKirill

CHANGELOG.md

@@ -2,11 +2,14 @@
 
 All notable changes to **codemonster-ru/annabel** will be documented in this file.
 
-## [Unreleased]
+## [1.12.0]
 
 ### Added
 
 -   New `annabel` CLI entry point (`php vendor/bin/annabel`) with built-in help output inspired by Laravel's artisan, including colorized terminal formatting.
+-   Added initial CLI commands: `about`, `route:list`, `config:get`, `container:list`, and `serve`.
+-   When `codemonster-ru/database` is installed, Annabel CLI now auto-loads database commands (`make:migration`, `migrate`, `migrate:rollback`, `migrate:status`) via the package's CLI kernel.
+-   Database CLI integration is now lazy: migration repository/connection initialize only when commands run, so commands are visible even without an active DB connection.
 
 ## [1.11.0] – 2025-12-09
 

README.md

@@ -39,7 +39,14 @@ router()->get('/', fn() => view('home', ['title' => 'Welcome to Annabel']));
 
 ## CLI
 
-Annabel ships with a lightweight CLI similar to Laravel's `artisan`. For now it provides helpful usage information and a command list.
+Annabel ships with a lightweight CLI similar to Laravel's `artisan`. It already supports:
+
+- `about` — show version, base path, and loaded providers
+- `route:list` — list registered routes
+- `config:get key` — read a config value
+- `container:list` — show container bindings/instances
+- `serve` — run PHP built-in server (default 127.0.0.1:8000)
+- With `codemonster-ru/database` installed: `make:migration`, `migrate`, `migrate:rollback`, `migrate:status` (appear in `annabel list`; connection is checked when commands run)
 
 ```bash
 php vendor/bin/annabel

src/Console/Commands/AboutCommand.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Codemonster\Annabel\Console\Commands;
+
+use Codemonster\Annabel\Console\Command;
+
+class AboutCommand extends Command
+{
+    public function getName(): string
+    {
+        return 'about';
+    }
+
+    public function getDescription(): string
+    {
+        return 'Show basic information about the Annabel application.';
+    }
+
+    public function handle(array $arguments = []): int
+    {
+        $console = $this->console();
+        $app = $console->getApplication();
+
+        $console->writeln($console->color('About', 'label'));
+        $console->writeln('  Version: ' . $console->color($console->getVersion(), 'command'));
+        $console->writeln('  Base path: ' . $app->getBasePath());
+
+        $providers = $app->getProviders();
+        $console->writeln('  Providers: ' . count($providers));
+
+        foreach ($providers as $provider) {
+            $console->writeln('    - ' . get_class($provider));
+        }
+
+        return 0;
+    }
+}

src/Console/Commands/ConfigGetCommand.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Codemonster\Annabel\Console\Commands;
+
+use Codemonster\Annabel\Console\Command;
+use Codemonster\Config\Config;
+
+class ConfigGetCommand extends Command
+{
+    public function getName(): string
+    {
+        return 'config:get';
+    }
+
+    public function getDescription(): string
+    {
+        return 'Get a configuration value by key (dot notation).';
+    }
+
+    public function getUsage(): string
+    {
+        return 'config:get key';
+    }
+
+    public function handle(array $arguments = []): int
+    {
+        $console = $this->console();
+
+        if (empty($arguments[0])) {
+            $console->writeln($console->color('Usage: php vendor/bin/annabel config:get key', 'error'));
+
+            return 1;
+        }
+
+        $key = $arguments[0];
+        $app = $console->getApplication();
+
+        $config = $app->make(Config::class);
+        $value = $config->get($key);
+
+        if ($value === null) {
+            $console->writeln($console->color("null (or key not found): {$key}", 'muted'));
+
+            return 0;
+        }
+
+        $console->writeln($console->color($key, 'label') . ':');
+        $console->writeln($this->formatValue($value));
+
+        return 0;
+    }
+
+    protected function formatValue(mixed $value): string
+    {
+        if (is_scalar($value) || $value === null) {
+            return '  ' . var_export($value, true);
+        }
+
+        $json = json_encode($value, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+
+        if ($json !== false) {
+            $lines = explode("\n", $json);
+
+            return '  ' . implode("\n  ", $lines);
+        }
+
+        return '  ' . print_r($value, true);
+    }
+}

src/Console/Commands/ContainerListCommand.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace Codemonster\Annabel\Console\Commands;
+
+use Codemonster\Annabel\Console\Command;
+
+class ContainerListCommand extends Command
+{
+    public function getName(): string
+    {
+        return 'container:list';
+    }
+
+    public function getDescription(): string
+    {
+        return 'Show container bindings and instantiated singletons.';
+    }
+
+    public function getUsage(): string
+    {
+        return 'container:list';
+    }
+
+    public function handle(array $arguments = []): int
+    {
+        $console = $this->console();
+        $app = $console->getApplication();
+        $container = $app->getContainer();
+
+        $bindings = $container->getBindings();
+        $instances = $container->getInstances();
+
+        $console->writeln($console->color('Bindings:', 'label'));
+
+        if (empty($bindings)) {
+            $console->writeln('  ' . $console->color('none', 'muted'));
+        } else {
+            foreach ($bindings as $abstract => $binding) {
+                $concrete = is_string($binding['concrete']) ? $binding['concrete'] : 'Closure';
+                $console->writeln(sprintf(
+                    '  %s => %s%s',
+                    $console->color($abstract, 'command'),
+                    $concrete,
+                    $binding['singleton'] ? ' (singleton)' : ''
+                ));
+            }
+        }
+
+        $console->writeln('');
+        $console->writeln($console->color('Instances:', 'label'));
+
+        if (empty($instances)) {
+            $console->writeln('  ' . $console->color('none', 'muted'));
+        } else {
+            foreach ($instances as $abstract => $instance) {
+                $console->writeln(sprintf(
+                    '  %s => %s',
+                    $console->color($abstract, 'command'),
+                    get_class($instance)
+                ));
+            }
+        }
+
+        return 0;
+    }
+}

src/Console/Commands/DatabaseCommand.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Codemonster\Annabel\Console\Commands;
+
+use Codemonster\Annabel\Console\Command;
+use Codemonster\Database\CLI\DatabaseCLIKernel;
+
+class DatabaseCommand extends Command
+{
+    public function __construct(
+        protected string $signature,
+        protected string $description
+    ) {}
+
+    public function getName(): string
+    {
+        return $this->signature;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description;
+    }
+
+    public function getUsage(): string
+    {
+        return $this->signature;
+    }
+
+    public function handle(array $arguments = []): int
+    {
+        $console = $this->console();
+
+        try {
+            /** @var DatabaseCLIKernel $kernel */
+            $kernel = $console->getApplication()->make(DatabaseCLIKernel::class);
+            $command = $kernel->getRegistry()->get($this->signature);
+
+            if (!$command) {
+                $console->writeln($console->color("Database command [{$this->signature}] not found.", 'error'));
+
+                return 1;
+            }
+
+            return $command->handle($arguments);
+        } catch (\Throwable $e) {
+            $console->writeln($console->color(
+                "Cannot run database command [{$this->signature}]. Check database configuration and connection. Error: {$e->getMessage()}",
+                'error'
+            ));
+
+            return 1;
+        }
+    }
+}

src/Console/Commands/HelpCommand.php

@@ -61,13 +61,22 @@ protected function renderApplicationHelp(): void
         $console->writeln('');
         $console->writeln($console->color('Available commands:', 'label'));
 
-        foreach ($console->getCommands() as $command) {
+        $commands = $console->getCommands();
+        $maxLength = 0;
+
+        foreach ($commands as $cmd) {
+            $maxLength = max($maxLength, strlen($cmd->getName()));
+        }
+
+        $maxLength = max($maxLength, 12);
+
+        foreach ($commands as $command) {
             $aliases = $console->getAliasesFor($command->getName());
             $aliasText = $aliases ? ' [' . implode(', ', $aliases) . ']' : '';
 
             $console->writeln(sprintf(
                 '  %s  %s%s',
-                $console->color(str_pad($command->getName(), 12), 'command'),
+                $console->color(str_pad($command->getName(), $maxLength), 'command'),
                 $command->getDescription(),
                 $aliasText ? ' ' . $console->color($aliasText, 'muted') : ''
             ));