feat(cli): dcy-016 운영자 CLI 확장 (universe/slots/enter/exit) + 워치독 억제 (BAT-020)

운영자가 조회·매수·매도를 CLI 로 수행하되 데몬 RabbitMQ RPC 로 통일해 단일
writer admission·불변식을 보존(DB 직접 쓰기 없음)하고, 운영자 조회가 전략
생존 신호로 오인되지 않게 워치독을 억제한다.

거버넌스: 전부 change-req (신규 REQ 없음, dcy-016 OQ-3).
- REQ-032: CLI universe/slots(snapshot RPC) + enter(buy)/exit(sell) intent RPC
  + 인스턴스 라우팅(--config/--instance/default) + enter/exit 안전장치
  (확인 프롬프트 기본 ON / --yes(paper) / --yes --live(이중 ack) / --dry-run)
  + 전 명령 --json. pause/resume 는 direct-DB 유지
- REQ-022: CLI request-reply RPC 클라이언트(call_rpc) 재사용
- REQ-021/034: snapshot 요청 워치독 억제 플래그(touch_watchdog/actor=operator)
  → 핸들러가 last_seen_at 갱신 스킵. 기본값 현행 유지(하위호환). 운영자
  조회가 죽은 전략의 safety-sell 을 무력화하던 결함(R-4) 제거
- REQ-026: interface-contract/runtime-flows 정합

CLI 는 rpc/confirm 주입 가능(테스트 broker/DB-free). snapshot envelope 은
asset-centric 이라 exit 은 운영자 제공 slot_id 사용(slot_id 노출은 본 주기 밖).

검증: 단위 327 passed/34 skipped, 인프라 게이트(PG+RabbitMQ) 361 passed, ruff clean.
신규 test_cli_operator(14) + snapshot 워치독 억제(2). BAT-020 release-candidate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-08 16:48:26 +09:00
co-authored by Claude Opus 4.8
parent b851b927ee
commit d09b93195f
20 changed files with 1185 additions and 28 deletions
@@ -75,3 +75,45 @@ def test_snapshot_strategy_id_filter():
assert len(resp.payload["slots"]) == 1
assert resp.payload["slots"][0]["strategy_id"] == "A"
assert resp.payload["slots"][0]["symbol"] == "005930"
# --- dcy-016 / REQ-021/034: operator query watchdog suppression -------------
class _RecWatchdog:
def __init__(self):
self.updated = []
def update(self, slot_id):
self.updated.append(str(slot_id))
def _holding_slot(repo, svc):
from trex_core.domain.slot import SlotState
slot = next(s for s in repo.list_slots(DAY) if s.status is SlotState.IDLE)
svc.transit_slot(slot.slot_id, SlotState.IDLE, SlotState.PENDING_BUY,
reason="t", actor="t", symbol="005930", portfolio_id="PF-1", qty=10)
svc.transit_slot(slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="t", actor="t", avg_price=1000)
return str(slot.slot_id)
def test_strategy_poll_touches_watchdog_by_default():
repo, svc, intents = _wire()
sid = _holding_slot(repo, svc)
wd = _RecWatchdog()
handler = make_snapshot_rpc_handler(repo, svc, watchdog_store=wd)
handler(_req()) # no actor flag => legacy liveness touch (REQ-034)
assert sid in wd.updated
def test_operator_query_suppresses_watchdog_touch():
repo, svc, intents = _wire()
_holding_slot(repo, svc)
wd = _RecWatchdog()
handler = make_snapshot_rpc_handler(repo, svc, watchdog_store=wd)
req = RpcRequest(
payload={"view": "all", "trading_date": DAY.isoformat(),
"actor": "operator", "touch_watchdog": False},
correlation_id="op",
)
handler(req)
assert wd.updated == [] # dcy-016 R-4: operator query is not a liveness signal