Publish embedded role-topology diagnostics for workflow doctor

Publish embedded role topology in doctor output

Author: rmcdaniel

docs/architecture/control-plane-split.md

@@ -590,9 +590,14 @@ are degraded without reading model tables directly:
 - The standalone server exposes
   `GET /api/cluster/info`, backed by
   `App\Support\ServerTopology`, so operators can read the current
-  role split (`current_shape`, `current_roles`, `matching_role`,
-  and `shape_assignments`) without inferring it from deployment
-  notes.
+  role split (`current_shape`, `current_process_class`,
+  `current_roles`, `matching_role`, and `shape_assignments`)
+  without inferring it from deployment notes.
+- Embedded or package-local installs expose the same
+  `durable-workflow.v2.role-topology` manifest through
+  `php artisan workflow:v2:doctor --json` under the `topology`
+  key, so operators can read the current application-process
+  role bundle without standing up the standalone server first.
 - `Workflow\V2\Support\OperatorMetrics::snapshot()` reports per-role
   health signals: `tasks.ready`, `tasks.leased`,
   `tasks.claim_failed`, `repair.missing_task_candidates`,

src/Commands/V2DoctorCommand.php

@@ -9,6 +9,7 @@
 use Symfony\Component\Console\Attribute\AsCommand;
 use Workflow\V2\Support\BackendCapabilities;
 use Workflow\V2\Support\MatchingRoleSnapshot;
+use Workflow\V2\Support\RoleTopologySnapshot;
 
 #[AsCommand(name: 'workflow:v2:doctor')]
 class V2DoctorCommand extends Command
@@ -23,6 +24,7 @@ public function handle(): int
     {
         $snapshot = BackendCapabilities::snapshot();
         $snapshot['matching_role'] = MatchingRoleSnapshot::current();
+        $snapshot['topology'] = RoleTopologySnapshot::current();
 
         if ((bool) $this->option('json')) {
             try {
@@ -54,6 +56,7 @@ private function renderHumanSnapshot(array $snapshot): void
         $this->componentLine('queue', $snapshot['queue'] ?? []);
         $this->componentLine('cache', $snapshot['cache'] ?? []);
         $this->componentLine('codec', $snapshot['codec'] ?? []);
+        $this->topologyLine($snapshot['topology'] ?? null);
         $this->matchingRoleLine($snapshot['matching_role'] ?? null);
 
         $issues = $snapshot['issues'] ?? [];
@@ -132,4 +135,33 @@ private function matchingRoleLine(mixed $matchingRole): void
             $dispatchMode,
         ));
     }
+
+    private function topologyLine(mixed $topology): void
+    {
+        if (! is_array($topology)) {
+            $this->line('[INFO] topology: unavailable');
+
+            return;
+        }
+
+        $shape = is_string($topology['current_shape'] ?? null) ? $topology['current_shape'] : 'unknown';
+        $processClass = is_string($topology['current_process_class'] ?? null)
+            ? $topology['current_process_class']
+            : 'unknown';
+        $executionMode = is_string($topology['execution_mode'] ?? null)
+            ? $topology['execution_mode']
+            : 'unknown';
+        $roles = array_values(array_filter(
+            is_array($topology['current_roles'] ?? null) ? $topology['current_roles'] : [],
+            static fn (mixed $role): bool => is_string($role) && $role !== '',
+        ));
+
+        $this->line(sprintf(
+            '[INFO] topology: %s/%s (execution_mode=%s, roles=%s)',
+            $shape,
+            $processClass,
+            $executionMode,
+            $roles === [] ? 'none' : implode(',', $roles),
+        ));
+    }
 }