Files
trex-core/docs/batches/bat-022_20260608_slot-state-snapshot-visibility/index.md
T
genichinandClaude Opus 4.8 63da87c9b3 fix(cli): BAT-022 slots 명령이 universe 대신 실제 슬롯 상태 표시 (dcy-016 후속)
`trex-core slots` 가 snapshot RPC 의 universe `assets`(portfolio)를 슬롯 상태로
오인 표시하던 갭 정정. snapshot envelope 이 슬롯 상태를 운반하지 않아 발생
(10개 슬롯인데 universe 1개·status 없음 — BAT-007 HTTP 슬롯 read 제거 후
슬롯 상태 read 표면 부재가 근인).

- REQ-028 (CHG-20260608-01): snapshot envelope 에 read-only per-slot `slots[]`
  additive 추가(AC-4). strategy `assets[]`(universe, no-price) 불변.
- REQ-032 (CHG-20260608-03): `_cmd_slots` 가 envelope `slots[]`(실제 슬롯 상태)
  표시 + `--status` 를 슬롯 status 기준 client-side 필터 + watchdog 결합.
  `universe` 는 `assets[]` 유지. `universe --json` 도 universe 데이터로 scope.
- canonical `portfolio.slot_to_dict` 단일화 — BAT-007 stub / BAT-008 envelope
  두 경로가 동일 슬롯 스키마(외부명 `entry_price` 유지, dcy-012 호환).
- interface-contract 에 `slots[]` 계약 + `assets[]` vs `slots[]` 구분 반영.

검증: 단위 338 passed + ruff clean + 신규 코드 데몬으로 실 PostgreSQL/RabbitMQ
운영 재현 PASS(slots=10·status·DB 일치·universe 분리·비침습). REQ-028/032
Implemented, BAT-022 release-candidate. pytest 인프라 게이트는 Human Approval
Memo 수용(운영 재현이 실 경로 커버).

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

2.7 KiB

BAT-022: 슬롯 상태 스냅샷 가시화 — slots 명령이 universe 대신 실제 슬롯 상태 표시 (dcy-016 후속)

  • Status: release-candidate
  • Profile: standard
  • Source Discovery: dcy-016 (후속 change-req)
  • Included REQ: REQ-028 (CHG-20260608-01), REQ-032 (CHG-20260608-03)

Summary

  • dcy-016 으로 추가된 trex-core slots 가 snapshot RPC 의 universe assets(portfolio: asset_id/symbol/asset_quantity)를 슬롯 상태로 오인 표시하던 갭을 정정한다(운영 관측: 10개 슬롯인데 universe 1개·status 없음). 근인은 BAT-007 에서 HTTP 슬롯 read(REQ-008/025) 제거 후 슬롯 상태 read 표면 부재 + snapshot envelope 이 슬롯 상태를 운반하지 않음.
  • 핵심: snapshot envelope 에 read-only per-slot slots[](slot_id/status/symbol/qty/limit_price/avg_price/portfolio_id)를 additive 추가(REQ-028 AC-4)하고, trex-core slots 가 이를 표시(REQ-032). strategy-facing assets[](universe) 계약은 불변, universe 명령은 assets[] 유지로 둘을 명확히 분리. dcy-017 의 per-slot watchdog[] 동봉 선례와 동일 방식.

Scope

  • In Scope:
    • snapshot envelope 에 read-only slots[] 필드 추가 (REQ-028 AC-4) — build_snapshot_envelope
    • trex-core slots 가 slots[](실제 슬롯 상태, status 포함)를 표시, --status 필터를 슬롯 상태 기준으로 적용 (REQ-032)
    • universe 명령은 assets[](universe) 유지 — 두 명령 표면 분리
    • watchdog-owned 표시(REQ-032 CHG-20260608-02)를 slots[] 항목과 결합
    • interface-contract 정합 (snapshot 응답 slots[] 필드)
  • Out of Scope:
    • strategy-facing assets[](universe) 계약 변경 (불변)
    • 슬롯 상태 도메인/전이 로직 변경 (가시화·노출만)
    • WatchdogStore in-memory → 영속 승격
    • 신규 슬롯 read RPC/HTTP 표면 (기존 snapshot envelope 확장으로 충족)

Documents

Notes

  • Source discovery 단일(dcy-016 후속). REQ-028 CHG-20260608-01 / REQ-032 CHG-20260608-03 change-req 로 두 REQ 가 Implemented→Approved 로 내려옴.
  • 설계 정합성: dcy-017/BAT-021 이 이미 envelope 에 top-level watchdog[] 를 additive 동봉한 선례 → slots[] 도 동일 패턴(additive, strict envelope 비파괴).
  • 1차 게이트: 전체 회귀 green — strategy assets[](REQ-028 AC-1~3)·snapshot 동작 무회귀(필드 추가만).
  • slots[] 와 watchdog[] 는 둘 다 슬롯 단위 read-only projection — CLI slots 에서 결합 표시.