feat(multi-instance): dcy-009 BAT-013 — RabbitMQ 다중 인스턴스 토폴로지 (REQ-048~051)

dcy-009(다중 인스턴스 RabbitMQ 토폴로지) 전체 SDLC: draft-req → confirm-req →
draft-batch(BAT-013) → run-batch-delivery → confirm-req-implemented.

- REQ-048 (Configuration): DaemonInstanceConfig.from_toml + DaemonConfig.from_config
  (env 병합, portfolio_hub_token 주입) + 데몬 --config 필수 argparse + .gitignore 인스턴스
  TOML + config/instance.example.toml
- REQ-049 (Interface): topology 동적 큐명 빌더 intent/snapshot/control_queue(instance_key)
  — default=리터럴 큐명(하위호환), named=`{base}.{instance_key}` + daemon per-instance 구독
- REQ-050 (Integration): trex.direct(topic)/trex.broadcast(fanout) exchange +
  declare_topology(instance_key) per-instance binding + control dual binding + direct_routing_key
- REQ-051 (Documentation): interface-contract/runtime-flows/project-structure 정합

하위호환: instance_key="default" → 기존 리터럴 큐명·RPC 경로 무회귀(FR-5).
split-brain 방지(NFR-3): 인스턴스 전용 큐. 민감값(NFR-4): TOML + gitignore.

검증: 신규 9 단위 + RabbitMQ 라우팅 2, 단위 271 passed,
인프라 게이트 301 passed(directed 격리 S-2 + broadcast dual S-3 + default 무회귀 S-4),
ruff clean. REQ-048~051 Implemented, BAT-013 release-candidate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

trex_core/adapters/messaging/rabbitmq.py

@@ -28,14 +28,19 @@ import pika
 import pika.exceptions
 
 from trex_core.adapters.messaging.topology import (
-    CONTROL_REQ_QUEUE,
+    BROADCAST_EXCHANGE,
+    DEFAULT_INSTANCE_KEY,
+    DIRECT_EXCHANGE,
     EVENTS_DLQ_EXCHANGE,
     EVENTS_DLQ_QUEUE,
     EVENTS_EXCHANGE,
     INTENT_REQ_QUEUE,
     PAUSE_REQ_QUEUE,
-    SNAPSHOT_REQ_QUEUE,
     STRATEGY_QUEUE_ARGS,
+    control_queue,
+    direct_routing_key,
+    intent_queue,
+    snapshot_queue,
 )
 from trex_core.application.messaging import (
     EventHandler,
@@ -118,37 +123,33 @@ class RabbitMQTransport:
             return self._health
 
     # ------------------------------------------------------------ topology
-    def declare_topology(self) -> None:
+    def declare_topology(self, instance_key: str = DEFAULT_INSTANCE_KEY) -> None:
         self._ensure_connected()
         ch = self._channel
         assert ch is not None
+        dlx = {"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE}
         # Events topic + DLQ
         ch.exchange_declare(EVENTS_EXCHANGE, exchange_type="topic", durable=True)
         ch.exchange_declare(EVENTS_DLQ_EXCHANGE, exchange_type="fanout", durable=True)
         ch.queue_declare(EVENTS_DLQ_QUEUE, durable=True)
         ch.queue_bind(EVENTS_DLQ_QUEUE, EVENTS_DLQ_EXCHANGE)
-        # RPC queues (durable for intent + snapshot)
-        ch.queue_declare(
-            INTENT_REQ_QUEUE,
-            durable=True,
-            arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
-        )
-        ch.queue_declare(
-            SNAPSHOT_REQ_QUEUE,
-            durable=True,
-            arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
-        )
-        ch.queue_declare(
-            PAUSE_REQ_QUEUE,
-            durable=True,
-            arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
-        )
-        # BAT-012 / REQ-043: operator control channel (action dispatch).
-        ch.queue_declare(
-            CONTROL_REQ_QUEUE,
-            durable=True,
-            arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
-        )
+        # BAT-013 / REQ-050: multi-instance control exchanges.
+        ch.exchange_declare(DIRECT_EXCHANGE, exchange_type="topic", durable=True)
+        ch.exchange_declare(BROADCAST_EXCHANGE, exchange_type="fanout", durable=True)
+        # Per-instance RPC queues (default → literal names, REQ-049 backward-compat).
+        iq = intent_queue(instance_key)
+        sq = snapshot_queue(instance_key)
+        cq = control_queue(instance_key)
+        for q, channel_type in ((iq, "intent"), (sq, "snapshot"), (cq, "control")):
+            ch.queue_declare(q, durable=True, arguments=dlx)
+            # Directed binding: trex.direct → {instance_key}.{channel_type}
+            ch.queue_bind(q, DIRECT_EXCHANGE,
+                          routing_key=direct_routing_key(instance_key, channel_type))
+        # Control queue is also fanout-bound so global broadcasts hit every instance.
+        ch.queue_bind(cq, BROADCAST_EXCHANGE)
+        # Legacy pause queue — declared for the default instance only (REQ-032 alias).
+        if instance_key == DEFAULT_INSTANCE_KEY:
+            ch.queue_declare(PAUSE_REQ_QUEUE, durable=True, arguments=dlx)
 
     def declare_strategy_queue(self, queue: str, binding_pattern: str) -> None:
         """Per-strategy durable queue (REQ-023 AC-4) bound to events exchange."""