Pin compose topology identity for split-role services

Author: durable-workflow-ops

README.md

@@ -672,7 +672,10 @@ execution through local Laravel queue workers. Set
 `DW_SERVER_TOPOLOGY_SHAPE` and `DW_SERVER_PROCESS_CLASS` when a deployment
 splits scheduler, matching, or execution work away from the default
 `server_http_node` so discovery reports the live node identity instead of a
-generic HTTP shape. `topology.matching_role` adds the live matching-role
+generic HTTP shape. The published Compose artifacts set these per service for
+the supported `server`, `worker`, and `scheduler` nodes, so `GET /api/cluster/info`
+and local diagnostics report the same node class the operator actually
+deployed. `topology.matching_role` adds the live matching-role
 deployment knobs for that node: `queue_wake_enabled`, the matching-role
 `shape` (`in_worker` or `dedicated`), who owns the broad-poll wake
 (`worker_loop` or `dedicated_repair_pass`), the active `task_dispatch_mode`

docker-compose.published.yml

@@ -44,6 +44,8 @@ services:
       - "${SERVER_PORT:-8080}:8080"
     environment:
       <<: *server-environment
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: server_http_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully
@@ -63,6 +65,8 @@ services:
     command: php artisan queue:work --sleep=1 --tries=3 --max-time=3600
     environment:
       <<: *server-environment
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: worker_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully
@@ -81,6 +85,8 @@ services:
       sh -c 'while true; do php artisan schedule:evaluate --limit=100; php artisan activity:timeout-enforce --limit=100; php artisan history:prune --limit=100; sleep 10; done'
     environment:
       <<: *server-environment
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: scheduler_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully

docker-compose.small-cluster.yml

@@ -51,6 +51,8 @@ services:
     environment:
       <<: *server-environment
       DW_SERVER_ID: server-a
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: server_http_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully
@@ -70,6 +72,8 @@ services:
     environment:
       <<: *server-environment
       DW_SERVER_ID: server-b
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: server_http_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully
@@ -90,6 +94,8 @@ services:
     environment:
       <<: *server-environment
       DW_SERVER_ID: scheduler
+      DW_SERVER_TOPOLOGY_SHAPE: standalone_server
+      DW_SERVER_PROCESS_CLASS: scheduler_node
     depends_on:
       bootstrap:
         condition: service_completed_successfully

tests/Unit/DedicatedMatchingComposeContractTest.php

@@ -58,6 +58,24 @@ public function test_override_uses_the_same_image_alias_as_published_compose():
         }
     }
 
+    public function test_published_compose_pins_topology_identity_for_supported_processes(): void
+    {
+        $published = $this->read('docker-compose.published.yml');
+
+        foreach ([
+            'DW_SERVER_TOPOLOGY_SHAPE: standalone_server',
+            'DW_SERVER_PROCESS_CLASS: server_http_node',
+            'DW_SERVER_PROCESS_CLASS: worker_node',
+            'DW_SERVER_PROCESS_CLASS: scheduler_node',
+        ] as $needle) {
+            $this->assertStringContainsString(
+                $needle,
+                $published,
+                "published compose must contain {$needle} so long-running services advertise their real role class",
+            );
+        }
+    }
+
     public function test_readme_documents_the_override_alongside_the_dedicated_daemon_section(): void
     {
         $readme = $this->read('README.md');
@@ -69,6 +87,8 @@ public function test_readme_documents_the_override_alongside_the_dedicated_daemo
             '-f docker-compose.dedicated-matching.yml',
             'php artisan workflow:v2:repair-pass --loop',
             'DW_V2_MATCHING_ROLE_QUEUE_WAKE',
+            'DW_SERVER_TOPOLOGY_SHAPE',
+            'DW_SERVER_PROCESS_CLASS',
         ] as $needle) {
             $this->assertStringContainsString(
                 $needle,

tests/Unit/SmallClusterContractTest.php

@@ -61,6 +61,9 @@ public function test_compose_harness_proves_the_narrow_cluster_shape(): void
             'pgsql:',
             'DW_SERVER_ID: server-a',
             'DW_SERVER_ID: server-b',
+            'DW_SERVER_TOPOLOGY_SHAPE: standalone_server',
+            'DW_SERVER_PROCESS_CLASS: server_http_node',
+            'DW_SERVER_PROCESS_CLASS: scheduler_node',
             'CACHE_STORE: redis',
             'QUEUE_CONNECTION: redis',
         ] as $needle) {