feat(alarm): trex-core 알람 emitter + trex.alerts exchange (dcy-033 BAT-049, Implemented)

AlarmEmitter(application, best-effort 비차단)+trex.alerts topic exchange 가산·격리+8 CRITICAL code 배선. 608 passed, opus QC PASS, 팀장 e2e(텔레그램 HTTP200) 통과. REQ-098~101 Implemented.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHtM5Ws1HKCKQ4JGi6GRb5

trex_core/application/ledger_outbox.py

@@ -30,6 +30,7 @@ from datetime import datetime, timedelta, timezone
 from enum import Enum
 from typing import Callable, Optional, Protocol
 
+from trex_core.application.alarm_emitter import AlarmEmitter
 from trex_core.application.ledger_port import (
     LedgerConflictError,
     LedgerPermanentError,
@@ -169,6 +170,7 @@ class LedgerWriter:
         max_attempts: int = _DEFAULT_MAX_ATTEMPTS,
         clock: Optional[Callable[[], datetime]] = None,
         rng: Optional[Callable[[], float]] = None,
+        alarm_emitter: Optional[AlarmEmitter] = None,
     ) -> None:
         self._outbox = outbox
         self._ledger = ledger
@@ -181,6 +183,8 @@ class LedgerWriter:
         self._max_attempts = max_attempts
         self._clock = clock or (lambda: datetime.now(tz=timezone.utc))
         self._rng = rng or random.random  # jitter source; inject for determinism
+        # dcy-033 / REQ-100: best-effort alarm emitter.
+        self._alarm_emitter = alarm_emitter
 
     def enqueue_fill(self, trade: LedgerTrade) -> LedgerWorkItem:
         return self._outbox.enqueue(trade)
@@ -219,6 +223,15 @@ class LedgerWriter:
             self._outbox.mark_outcome(
                 item.correlation_id, OutboxOutcome.CONFLICT_BLOCKED, error=str(exc)
             )
+            # dcy-033 / REQ-100: CRITICAL alarm — 409 conflict, operator resolution needed.
+            if self._alarm_emitter is not None:
+                self._alarm_emitter.publish_alarm(
+                    "ledger_delivery_failed",
+                    f"원장 409 충돌 (conflict_blocked): {item.correlation_id}",
+                    fields={"correlation_id": item.correlation_id,
+                            "asset_id": item.trade.asset_id,
+                            "reason": "conflict_blocked"},
+                )
             return OutboxOutcome.CONFLICT_BLOCKED
         except LedgerPermanentError as exc:
             # dcy-015 / REQ-017/018 (issue #13): non-retryable client error →
@@ -230,6 +243,15 @@ class LedgerWriter:
                 "ledger delivery_failed (permanent): correlation_id=%s reason=%s",
                 item.correlation_id, exc,
             )
+            # dcy-033 / REQ-100: CRITICAL alarm — permanent failure, no retry.
+            if self._alarm_emitter is not None:
+                self._alarm_emitter.publish_alarm(
+                    "ledger_delivery_failed",
+                    f"원장 영구 실패 (permanent): {item.correlation_id}",
+                    fields={"correlation_id": item.correlation_id,
+                            "asset_id": item.trade.asset_id,
+                            "reason": "permanent_failure"},
+                )
             return OutboxOutcome.PERMANENT_FAILURE
         except LedgerRetryableError as exc:
             # dcy-015 / REQ-019: backoff, or dead-letter once max_attempts hit.
@@ -243,6 +265,16 @@ class LedgerWriter:
                     "correlation_id=%s reason=%s",
                     new_attempts, item.correlation_id, exc,
                 )
+                # dcy-033 / REQ-100: CRITICAL alarm — dead-lettered after max retries.
+                if self._alarm_emitter is not None:
+                    self._alarm_emitter.publish_alarm(
+                        "ledger_delivery_failed",
+                        f"원장 데드레터 (attempts={new_attempts}): {item.correlation_id}",
+                        fields={"correlation_id": item.correlation_id,
+                                "asset_id": item.trade.asset_id,
+                                "attempts": new_attempts,
+                                "reason": "dead_lettered"},
+                    )
                 return OutboxOutcome.DEAD_LETTERED
             next_retry_at = self._clock() + timedelta(
                 seconds=self._backoff_delay(new_attempts)