Files
trex-core/docs/batches/bat-014_20260608_safety-sell-cooldown/implementation.md
T
genichinandClaude Opus 4.8 565af6792c feat(safety-sell): dcy-010 BAT-014 — 영속 거부 재시도 쿨다운 (REQ-052~054)
dcy-010(safety-sell 영속 거부 재시도 백오프) 전체 SDLC: draft-req → confirm-req →
draft-batch(BAT-014 batch-lite) → run-batch-delivery → confirm-req-implemented.
2026-06-07 실 KIS LIVE SL/TP e2e에서 발견한 KIS 주문 spam 위험(영속 거부 시
매도 무한 재제출) 차단.

- REQ-052 (Integration): SafetySellService per-slot 인메모리 쿨다운
  (_in_cooldown/_attempt_sell/_prune_cooldown) — forced_close·stop-loss·take-profit
  트리거에 min_retry_interval_sec(600s) 이내 재시도 skip(가격 poll 포함) +
  max_retry_warn_count(3) 도달 시 WARNING + holding 이탈 정리. market_close 제외.
- REQ-053 (Configuration): SafetySellConfig min_retry_interval_sec/max_retry_warn_count
  + TREX_SAFETY_SELL_MIN_RETRY_INTERVAL/MAX_RETRY_WARN_COUNT env (additive)
- REQ-054 (Documentation): runtime-flows 쿨다운 flow + 가격체크 tr_id(FHKST01010100) 정정

인메모리 only(DB/스레드/인터페이스 변경 없음), default 미설정 시 기존 동작 불변.
검증: 신규 8 단위(쿨다운 6 + config 2), 전체 278 passed, ruff clean.
REQ-052~054 Implemented, BAT-014 release-candidate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-08 00:35:11 +09:00

2.1 KiB

BAT-014 Implementation

  • Status: completed
  • Batch: BAT-014

Plan Summary

  • REQ-053(config 2종) → REQ-052(쿨다운 로직) → REQ-054(runtime-flows). 인메모리만, DB/스레드/인터페이스 변경 없음.

Changed Files

  • 수정:
    • trex_core/runtime/config.py — SafetySellConfig.min_retry_interval_sec(기본 600)·max_retry_warn_count(기본 3) + from_env 파싱(TREX_SAFETY_SELL_MIN_RETRY_INTERVAL/TREX_SAFETY_SELL_MAX_RETRY_WARN_COUNT) (REQ-053)
    • trex_core/application/safety_sell.py — _last_attempt/_attempt_count dict, _in_cooldown/_attempt_sell/_prune_cooldown, check_forced_close·check_prices 쿨다운 gate(skip→KIS poll skip 포함)·경고, run_once 시작 시 prune. market_close 는 미적용 (REQ-052)
    • docs/runtime-flows.md — safety-sell 재시도 쿨다운 flow + 가격체크 tr_id(FHKST01010100) 정정 (REQ-054)
    • tests/runtime/test_safety_sell_config.py — 쿨다운 env 기본값/파싱 2종
    • tests/application/test_safety_sell_worker.py — TestRetryCooldown 6종(skip/만료 재시도/경고/prune/market_close 제외/트리거 해소)

Execution Log

  1. REQ-053 config 2종 + from_env → test_safety_sell_config.py green.
  2. REQ-052 쿨다운(_in_cooldown/_attempt_sell/_prune_cooldown + forced_close/prices gate) → TestRetryCooldown 6 green (non-transitioning sell stub 으로 영속 거부 시뮬).
  3. REQ-054 runtime-flows 쿨다운 flow 추가.
  4. 전체 회귀: 단위 278 passed / 30 skipped, ruff clean.

Validation

  • pytest tests/application/test_safety_sell_worker.py tests/runtime/test_safety_sell_config.py → 34 passed.
  • 전체 pytest -q --deselect ...::test_sandbox_token_and_submit → 278 passed / 30 skipped.
  • ruff check trex_core tests → All passed.

Remaining Risks

  • R-2(재시작 시 쿨다운 초기화 → 1회 즉시 재시도): 허용(문서 명시).
  • 실 운영 거부 시나리오(휴장/잔고)에서의 쿨다운 동작은 차기 거래일 실 관찰로 보강(단위는 stub 로 시뮬). 인메모리·additive 변경이라 release 위험 낮음.