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>
2026-06-08 16:48:26 +09:00
parent b851b927ee
commit d09b93195f
20 changed files with 1185 additions and 28 deletions
@@ -182,3 +182,43 @@
 #### Validation Plan

 - BAT-015: buy payload portfolio_id 기반 핸들러 단위 + RabbitMQ e2e.
+
+### CHG-20260608-02
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-016/REQ-034 연계) snapshot 요청 payload 에 워치독 억제 플래그 추가: `touch_watchdog`(기본 true) / `actor="operator"`. `make_snapshot_rpc_handler` 가 플래그 시 holding 슬롯 `last_seen_at` 갱신을 건너뛴다. 기본값=현행(전략 폴링=워치독 갱신) 유지(하위호환). BAT-020 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 운영자 CLI 조회가 전략 생존 신호로 오인되어 safety-sell 을 무력화하는 것 방지(R-4). 메시지 계약에 억제 플래그를 정식화.
+
+#### Acceptance Criteria Delta
+
+- Added:
+  - snapshot 요청 payload `touch_watchdog`/`actor` 플래그(기본 미지정=touch). 운영자 조회는 억제.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/application/messaging_handlers.py`(make_snapshot_rpc_handler 억제 분기)
+- Docs: `docs/interface-contract.md`
+- Tests: tests/application/test_messaging_snapshot_consumer.py(touch vs suppress)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-020
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-020 에서 완료)
+- Existing Implementation Invalidated: no (기본값 현행 유지, 플래그 추가)
+- Status Recommendation: Implemented (change-req → BAT-020 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-020).
+
+#### Validation Plan
+
+- BAT-020: 기본 요청 touch / operator 요청 suppress 단위(caplog/recorder).
@@ -152,3 +152,42 @@
 - AC-3: tests/runtime/test_daemon_no_http_surface.py::test_daemon_module_has_no_fastapi_or_uvicorn_import + Daemon 4 스레드 코드.
 - AC-4: RabbitMQTransport 재연결 백오프 코드 + tests/adapters/messaging/test_in_memory_transport.py::test_unavailable_transport_raises_on_publish_and_rpc.
 - AC-5: tests/domain/test_domain_import_sweep.py.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-016) 운영자 CLI 가 transport 의 request-reply RPC 클라이언트(`call_rpc`)를 재사용해 snapshot/intent 큐로 요청한다(전략 모듈과 동일 클라이언트, NFR-3). CLI 는 config 기반으로 transport 를 빌드하고 `call_rpc` 후 close 한다. BAT-020 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- CLI 와 전략 모듈이 동일 transport RPC 계약을 공유해 표면 분기 없는 일관 동작.
+
+#### Acceptance Criteria Delta
+
+- Added:
+  - CLI 가 `MessagingTransport.call_rpc(queue, payload, correlation_id, timeout)` 로 RPC 수행(주입 가능, 테스트는 fake rpc).
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/runtime/cli.py`(transport 빌드 + call_rpc), 기존 `RabbitMQTransport.call_rpc` 재사용
+- Tests: tests/runtime/test_cli_operator.py(주입 rpc)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-020
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-020 에서 완료)
+- Existing Implementation Invalidated: no (클라이언트 재사용)
+- Status Recommendation: Implemented (change-req → BAT-020 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-020).
+
+#### Validation Plan
+
+- BAT-020: CLI RPC 호출 큐/payload/타임아웃 + 실패 표시 단위.