Files
trex-core/trex_core/application/killswitch.py
T
genichinandClaude Opus 4.8 7d727824dc feat(slot): BAT-030 — 자산 중심 cutover 완성 (dcy-020 BAT-δ, REQ-056·057·062·064·065)
M1 literal inactive 전면화: SlotState 5-state(idle/closed 별칭 제거),
마이그레이션 010(CHECK 교체+행 rewrite), ops_checks 를 transition_log 기반 재작성.
M2 집행 매도 수량 브로커 정본(D3): dispatch 매도 qty=broker hldg_qty,
미러 fallback 없음, 브로커 0 → skip+WARN, 리스트 기반 dispatch(head-block 방지).
M3 컬럼 drop + legacy pool 제거: 마이그레이션 011(trading_date·entry_count DROP),
repo 계약 instance 스코프 개편(집행 큐 포함), preallocation 폐기(데몬 7스레드),
admission 자산 중심 단일 경로(slot_id 정본), capacity 재정의(available=M−active),
daily_symbol_entries 코드 경로 제거.
M4 cutover 도구(D1·D4): trex-core-cutover(전체 rebuild, preflight/브로커 carry-over/
--allow-unmapped/--promote-unique/dry-run) + PG 리허설 테스트 8건.
M5 baseline 마감: data-model/runtime-flows/project-structure/interface-contract
자산 중심 최종 갱신 + run-trex-core-daemon 스킬 정합.

검증: 단위 367 passed + ruff clean; PG-gated 29 passed(010/011 round-trip·드리프트
가드·cutover 리허설); RabbitMQ 21 passed; run-the-app e2e(test DB+실 MQ, M=1):
reconcile 슬롯 생성→slot_id 매수→dedup→capacity_full→fill→already_active→
매도→inactive(자산 바인딩 보존)→영구 슬롯 재활성 전 구간 green.
실 cutover 는 운영자 실행(REL 단계, D4).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 15:16:15 +09:00

91 lines
3.2 KiB
Python

"""Kill-switch execution service (REQ-045 / BAT-012).
Operator emergency stop: liquidate all `holding` slots in a scope
(portfolio or global) by reusing SlotService.sell() (REQ-036), then mark the
scope day-excluded (REQ-044) so strategy execution is masked for the day
(REQ-046). Independent of the dcy-007 safety-sell worker — concurrent sells
on the same slot are idempotent (REQ-036 PENDING_SELL guard).
"""
from __future__ import annotations
import logging
from datetime import date as date_cls
from datetime import datetime, timezone
from trex_core.application.portfolio import GLOBAL_KILLSWITCH, KillSwitchStore
from trex_core.domain.slot import SlotRepository, SlotService
_log = logging.getLogger(__name__)
_ACTOR = "kill-switch"
class KillSwitchService:
"""Range-scoped emergency liquidation + day-scoped exclusion (REQ-045)."""
def __init__(
self,
*,
slot_repo: SlotRepository,
slot_service: SlotService,
killswitch_store: KillSwitchStore,
instance_key: str = "default",
) -> None:
self._repo = slot_repo
self._svc = slot_service
self._store = killswitch_store
self._instance_key = instance_key # dcy-020/REQ-056: instance-scoped sweep
@staticmethod
def _trading_date(now: datetime) -> date_cls:
return now.astimezone(timezone.utc).date()
def fire(
self,
*,
scope: str,
portfolio_id: str | None = None,
actor: str = "operator",
now: datetime | None = None,
) -> int:
"""Liquidate holding slots in scope + mark day-excluded. Returns count.
scope: "portfolio" (requires portfolio_id) | "global".
"""
now = now or datetime.now(tz=timezone.utc)
day = self._trading_date(now) # day-scoped exclusion key (REQ-044)
holding = self._repo.list_holding_slots(self._instance_key)
if scope == "portfolio":
holding = [s for s in holding if s.portfolio_id == portfolio_id]
liquidated = 0
for s in holding:
try:
self._svc.sell(s.slot_id, actor=_ACTOR, reason="emergency_stop")
liquidated += 1
except Exception: # noqa: BLE001 - one slot must not stop the sweep
_log.warning("kill-switch sell failed (slot=%s)", s.slot_id, exc_info=True)
# Mark the scope day-excluded so strategy execution is masked (REQ-046).
key = GLOBAL_KILLSWITCH if scope == "global" else (portfolio_id or "")
self._store.exclude(key, day, actor=actor)
_log.warning(
"kill-switch fired: actor=%s scope=%s portfolio_id=%s liquidated=%d",
actor, scope, portfolio_id, liquidated,
)
return liquidated
def resume(
self,
*,
scope: str,
portfolio_id: str | None = None,
now: datetime | None = None,
) -> None:
"""Manually clear the day-scoped exclusion (REQ-046). Sold slots stay sold."""
now = now or datetime.now(tz=timezone.utc)
day = self._trading_date(now)
key = GLOBAL_KILLSWITCH if scope == "global" else (portfolio_id or "")
self._store.clear(key, day)
_log.info("kill-switch resume: scope=%s portfolio_id=%s", scope, portfolio_id)