Added a landing.meta console command that resolves descriptors from CLI arguments or configuration and emits the resulting metadata as formatted JSON.

Registered the new generator in the console kernel so it appears in the Bamboo CLI command list.

Added PHPUnit coverage that verifies default metadata output and type-specific overrides supplied via CLI arguments.

Author: greenarmor

src/Console/Command/LandingMeta.php

@@ -0,0 +1,104 @@
+<?php
+namespace Bamboo\Console\Command;
+
+use Bamboo\Web\View\LandingPageContent;
+use JsonException;
+
+class LandingMeta extends Command {
+  public function name(): string { return 'landing.meta'; }
+
+  public function description(): string {
+    return 'Generate landing metadata for a given content descriptor';
+  }
+
+  public function handle(array $args): int {
+    $descriptor = $this->resolveDescriptor($args);
+    $builder = new LandingPageContent($this->app);
+
+    $payload = $builder->payload($descriptor);
+    $meta = $payload['meta'] ?? [];
+
+    if (!is_array($meta) || $meta === []) {
+      echo "No metadata available.\n";
+      return 0;
+    }
+
+    try {
+      $encoded = json_encode($meta, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR);
+    } catch (JsonException $exception) {
+      fwrite(STDERR, 'Failed to encode metadata: ' . $exception->getMessage() . "\n");
+      return 1;
+    }
+
+    if ($encoded === false) {
+      fwrite(STDERR, "Failed to encode metadata.\n");
+      return 1;
+    }
+
+    echo $encoded . "\n";
+
+    return 0;
+  }
+
+  /**
+   * @param list<string> $args
+   *
+   * @return array<string, string>
+   */
+  private function resolveDescriptor(array $args): array {
+    $descriptor = [];
+
+    if ($args !== [] && !str_contains($args[0], '=')) {
+      $type = trim($args[0]);
+      if ($type !== '') {
+        $descriptor['type'] = strtolower($type);
+      }
+      $args = array_slice($args, 1);
+    }
+
+    foreach ($args as $argument) {
+      if (!str_contains($argument, '=')) {
+        continue;
+      }
+
+      [$key, $value] = explode('=', $argument, 2);
+      $key = trim($key);
+      $value = trim($value);
+
+      if ($key === '' || $value === '') {
+        continue;
+      }
+
+      if ($key === 'type') {
+        $descriptor['type'] = strtolower($value);
+        continue;
+      }
+
+      $descriptor[$key] = $value;
+    }
+
+    if ($descriptor !== []) {
+      return $descriptor;
+    }
+
+    $configured = $this->app->config('landing.content');
+    if (!is_array($configured)) {
+      return [];
+    }
+
+    $clean = [];
+    foreach ($configured as $key => $value) {
+      if (!is_scalar($value) || $value === '') {
+        continue;
+      }
+
+      $clean[(string) $key] = (string) $value;
+    }
+
+    if (isset($clean['type'])) {
+      $clean['type'] = strtolower($clean['type']);
+    }
+
+    return $clean;
+  }
+}

src/Console/Kernel.php

@@ -3,14 +3,15 @@
 use Bamboo\Console\Command\{
   HttpServe, RoutesShow, RoutesCache, CachePurge, AppKeyMake,
   QueueWork, WsServe, DevWatch, ScheduleRun, PkgInfo, ClientCall,
-  ConfigValidate, AuthJwtSetup
+  ConfigValidate, AuthJwtSetup, LandingMeta
 };
 
 class Kernel {
   protected array $commands = [
     HttpServe::class, RoutesShow::class, RoutesCache::class, CachePurge::class,
     AppKeyMake::class, QueueWork::class, WsServe::class, DevWatch::class, ScheduleRun::class,
-    PkgInfo::class, ClientCall::class, ConfigValidate::class, AuthJwtSetup::class
+    PkgInfo::class, ClientCall::class, ConfigValidate::class, AuthJwtSetup::class,
+    LandingMeta::class
   ];
   public function __construct(protected \Bamboo\Core\Application $app) {}
   public function run(array $argv): int {

tests/Console/LandingMetaCommandTest.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Console;
+
+use Bamboo\Console\Command\LandingMeta;
+use Bamboo\Core\Application;
+use Bamboo\Core\Config;
+use Bamboo\Provider\AppProvider;
+use Bamboo\Provider\MetricsProvider;
+use PHPUnit\Framework\TestCase;
+
+final class LandingMetaCommandTest extends TestCase
+{
+    public function testOutputsDefaultMetadataAsJson(): void
+    {
+        $app = $this->createApplication();
+        $command = new LandingMeta($app);
+
+        ob_start();
+        $exitCode = $command->handle([]);
+        $output = ob_get_clean();
+
+        if ($output === false) {
+            $output = '';
+        }
+
+        $this->assertSame(0, $exitCode);
+
+        $meta = json_decode(trim($output), true, flags: JSON_THROW_ON_ERROR);
+
+        $this->assertIsArray($meta);
+        $this->assertSame(
+            sprintf('%s | Modern PHP Microframework', $app->config('app.name', 'Bamboo')),
+            $meta['title'] ?? null
+        );
+        $this->assertSame('Bamboo makes high-performance PHP approachable.', $meta['description'] ?? null);
+        $this->assertArrayHasKey('generated_at', $meta);
+    }
+
+    public function testAllowsTypeAndOverrideArguments(): void
+    {
+        $app = $this->createApplication();
+        $command = new LandingMeta($app);
+
+        ob_start();
+        $exitCode = $command->handle(['article', 'author=Jane Doe']);
+        $output = ob_get_clean();
+
+        if ($output === false) {
+            $output = '';
+        }
+
+        $this->assertSame(0, $exitCode);
+
+        $meta = json_decode(trim($output), true, flags: JSON_THROW_ON_ERROR);
+
+        $this->assertIsArray($meta);
+        $this->assertSame('Jane Doe', $meta['author'] ?? null);
+        $this->assertSame('Green Armor Engineering', $meta['publication'] ?? null);
+        $this->assertStringContainsString('Async PHP in Production', $meta['title'] ?? '');
+    }
+
+    private function createApplication(): Application
+    {
+        $config = new Config(dirname(__DIR__, 2) . '/etc');
+        $app = new Application($config);
+        $app->register(new AppProvider());
+        $app->register(new MetricsProvider());
+        $app->register(new \Bamboo\Provider\ResilienceProvider());
+
+        return $app;
+    }
+}