Merge pull request #10 from theokeist/codex/update-documentation-with-types-and-arguments-5y0vyq

Extend `serve` gate output: add DHD view, runtime/errors sections, and `--gate-filter` alias

Author: theokeist

docs/CLI.md

@@ -72,8 +72,8 @@ php pipeflow serve [--host=<string>] [--port=<int>] [--gate[=<view>]] [--gate-se
 - `--host=<string>`: Host interface to bind (default: `127.0.0.1`).
 - `--port=<int>`: Port to bind (default: `8000`).
 - `--gate` (`bool`, optional): Enable the playful, colorful gate-style output.
-- `--gate=<view>` (`string`, optional): Select a gate view (`full` or `summary`).
-- `--gate-sections=<list>` (`string`, optional): Comma-separated sections to show (`portal,paths,tips`).
+- `--gate=<view>` (`string`, optional): Select a gate view (`full`, `summary`, or `dhd`).
+- `--gate-sections=<list>` (`string`, optional): Comma-separated sections to show (`portal,paths,runtime,errors,tips`).
 - `--gate-filter=<list>` (`string`, optional): Alias for `--gate-sections` to filter displayed sections.
 
 **Related classes:**

src/Console/Commands/ServeCommand.php

@@ -18,7 +18,7 @@ public function handle(array $args, Application $app): int
         $port = '8000';
         $gate = false;
         $gateView = 'full';
-        $gateSections = ['portal', 'paths', 'tips'];
+        $gateSections = ['portal', 'paths', 'runtime', 'tips'];
 
         foreach ($args as $a) {
             if (str_starts_with($a, '--host=')) $host = substr($a, 7);
@@ -56,13 +56,22 @@ public function handle(array $args, Application $app): int
 
     private function renderGate(string $host, string $port, string $docroot, string $view, array $sections): void
     {
+        $startedAt = date('Y-m-d H:i:s');
         echo "\033[2J\033[H";
-        echo $this->colorize("╔════════════════════════════════╗\n", 'cyan');
-        echo $this->colorize("║   PIPEFLOW STARGATE CONSOLE    ║\n", 'bold_cyan');
-        echo $this->colorize("╚════════════════════════════════╝\n\n", 'cyan');
+        if ($view === 'dhd') {
+            echo $this->colorize("╔════════════════════════════════╗\n", 'cyan');
+            echo $this->colorize("║      PIPEFLOW D.H.D. PANEL     ║\n", 'bold_cyan');
+            echo $this->colorize("╚════════════════════════════════╝\n", 'cyan');
+            echo $this->colorize("   [1] [2] [3]  [4] [5] [6]\n", 'blue');
+            echo $this->colorize("   [7] [8] [9]  [0] [⋆] [#]\n\n", 'blue');
+        } else {
+            echo $this->colorize("╔════════════════════════════════╗\n", 'cyan');
+            echo $this->colorize("║   PIPEFLOW STARGATE CONSOLE    ║\n", 'bold_cyan');
+            echo $this->colorize("╚════════════════════════════════╝\n\n", 'cyan');
+        }
 
         if ($view === 'summary') {
-            $sections = array_values(array_intersect($sections, ['portal', 'paths']));
+            $sections = array_values(array_intersect($sections, ['portal', 'paths', 'runtime']));
         }
 
         if (in_array('portal', $sections, true)) {
@@ -77,11 +86,24 @@ private function renderGate(string $host, string $port, string $docroot, string
             echo $this->colorize("  ▸ Docroot {$docroot}\n\n", 'cyan');
         }
 
+        if (in_array('runtime', $sections, true)) {
+            echo $this->title('RUNTIME');
+            echo $this->colorize("  ▸ Started {$startedAt}\n", 'cyan');
+            echo $this->colorize("  ▸ PHP     " . PHP_VERSION . "\n", 'cyan');
+            echo $this->colorize("  ▸ PID     " . getmypid() . "\n\n", 'cyan');
+        }
+
+        if (in_array('errors', $sections, true)) {
+            echo $this->title('ERRORS');
+            echo $this->colorize("  ▸ No errors captured (dev server)\n\n", 'green');
+        }
+
         if (in_array('tips', $sections, true)) {
             echo $this->title('COMMANDS');
             echo $this->colorize("  ▸ php pipeflow route:list\n", 'blue');
             echo $this->colorize("  ▸ php pipeflow serve --gate=summary\n", 'blue');
-            echo $this->colorize("  ▸ php pipeflow serve --gate-sections=portal,paths\n\n", 'blue');
+            echo $this->colorize("  ▸ php pipeflow serve --gate-sections=portal,paths,runtime\n", 'blue');
+            echo $this->colorize("  ▸ php pipeflow serve --gate=dhd --gate-filter=portal,errors\n\n", 'blue');
         }
     }