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
@@ -134,3 +134,43 @@
 - AC-2: tests/adapters/portfolio/test_postgresql_pause_store.py::test_durability_simulated_via_fresh_store_instance.
 - AC-3: tests/application/test_pause_handler.py::test_resume_clears_pause.
 - AC-4: tests/application/test_pause_handler.py::test_cli_pause_visible_to_rpc_list_via_shared_store + 실 daemon RPC 운영 검증.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-016) 운영자 CLI 확장: `universe`/`slots`/`enter`/`exit` 서브커맨드 추가(전부 데몬 RabbitMQ RPC). 인스턴스 라우팅(`--config` canonical/`--instance` 단축/default), enter/exit 안전장치(확인 프롬프트 기본 ON + `--yes`(paper)/`--yes --live`(live 이중 ack)/`--dry-run`), 전 명령 `--json`. pause/resume/paused 는 기존 direct-DB 유지(OQ-3). BAT-020 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 운영자가 조회·매수(enter)·매도(exit)·일시정지를 CLI 로 수행하되, 매매는 데몬 admission(단일 writer)을 거쳐 불변식·portfolio_id 검증을 보존(DB 직접 쓰기 없음, NFR-1).
+
+#### Acceptance Criteria Delta
+
+- Added:
+  - universe/slots(snapshot RPC)·enter(buy intent RPC)·exit(sell intent RPC) CLI + 인스턴스 라우팅 + enter/exit 안전장치 + `--json`.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/runtime/cli.py`(서브커맨드/가드/라우팅/RPC 클라이언트)
+- Docs: `docs/interface-contract.md`, `docs/runtime-flows.md`
+- Tests: tests/runtime/test_cli_operator.py
+
+#### Delivery Trace Delta
+
+- Batches: BAT-020
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-020 에서 완료)
+- Existing Implementation Invalidated: no (pause/resume 불변, 명령 추가)
+- Status Recommendation: Implemented (change-req → BAT-020 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-020).
+
+#### Validation Plan
+
+- BAT-020: CLI universe/slots/enter/exit RPC payload·안전장치·라우팅·--json 단위.
@@ -113,3 +113,42 @@
 - Existing Implementation Invalidated: no
 - Status Recommendation: keep-current
 - Follow-up Action: suggest-batch-reqs 후 batch 배정
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-016) 워치독 갱신 부수효과를 운영자 조회에서 억제: snapshot RPC 핸들러가 `touch_watchdog=false`/`actor="operator"` 요청에 대해 holding 슬롯 `last_seen_at` 갱신을 건너뛴다. 전략 폴링 기본 동작은 불변(REQ-034 핵심 의미 유지). BAT-020 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 운영자 CLI(`universe`/`slots`) 조회가 워치독 생존 신호로 작동해 죽은 전략의 safety-sell 을 억제하는 안전 결함(R-4)을 제거.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - 워치독 `last_seen_at` 갱신은 전략 폴링(기본)에만 적용; 운영자 억제 플래그 요청은 제외.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/application/messaging_handlers.py`(snapshot 핸들러 워치독 분기)
+- Tests: tests/application/test_messaging_snapshot_consumer.py::test_operator_query_suppresses_watchdog_touch
+
+#### 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: operator 요청 시 watchdog.update 미호출, 기본 요청 시 호출 단위.