feat(slot): BAT-030 — 자산 중심 cutover 완성 (dcy-020 BAT-δ, REQ-056·057·062·064·065)

M1 literal inactive 전면화: SlotState 5-state(idle/closed 별칭 제거),
마이그레이션 010(CHECK 교체+행 rewrite), ops_checks 를 transition_log 기반 재작성.
M2 집행 매도 수량 브로커 정본(D3): dispatch 매도 qty=broker hldg_qty,
미러 fallback 없음, 브로커 0 → skip+WARN, 리스트 기반 dispatch(head-block 방지).
M3 컬럼 drop + legacy pool 제거: 마이그레이션 011(trading_date·entry_count DROP),
repo 계약 instance 스코프 개편(집행 큐 포함), preallocation 폐기(데몬 7스레드),
admission 자산 중심 단일 경로(slot_id 정본), capacity 재정의(available=M−active),
daily_symbol_entries 코드 경로 제거.
M4 cutover 도구(D1·D4): trex-core-cutover(전체 rebuild, preflight/브로커 carry-over/
--allow-unmapped/--promote-unique/dry-run) + PG 리허설 테스트 8건.
M5 baseline 마감: data-model/runtime-flows/project-structure/interface-contract
자산 중심 최종 갱신 + run-trex-core-daemon 스킬 정합.

검증: 단위 367 passed + ruff clean; PG-gated 29 passed(010/011 round-trip·드리프트
가드·cutover 리허설); RabbitMQ 21 passed; run-the-app e2e(test DB+실 MQ, M=1):
reconcile 슬롯 생성→slot_id 매수→dedup→capacity_full→fill→already_active→
매도→inactive(자산 바인딩 보존)→영구 슬롯 재활성 전 구간 green.
실 cutover 는 운영자 실행(REL 단계, D4).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/interface-contract.md

@@ -63,7 +63,7 @@
 
 | 패턴 | 표면 | 요청 속성 | 응답 |
 |---|---|---|---|
-| 스냅샷 RPC | `trex.snapshot.req` | `correlation_id`, `reply_to=amq.rabbitmq.reply-to` | reply-to 큐로 `{view, strategy_id, trading_date, slots[], capacity{}}` |
+| 스냅샷 RPC | `trex.snapshot.req` | `correlation_id`, `reply_to=amq.rabbitmq.reply-to` | reply-to 큐로 envelope(`assets[]`/`slots[]`/`available_slots`/…); stub 경로는 `{view, strategy_id, slots[], capacity{}}` |
 | intent RPC | `trex.intent.req` | `correlation_id` = intent 멱등키, `reply_to=amq.rabbitmq.reply-to`, `delivery_mode=2` | reply-to 큐로 `{intent_id, status:admitted|rejected, slot_id?, reason?}`. 체결/종료는 응답 아닌 이벤트로 |
 | update_thresholds | `trex.intent.req` | `action="update_thresholds"`, `reply_to` | reply-to 큐로 `{status:updated|ignored, slot_id, reason?}` (REQ-040) |
 | 이벤트 pub/sub | `trex.events` (topic) | routing key `{event_type}.{strategy_id}.{symbol}` | 전략 큐가 자기 `strategy_id` 패턴으로 바인딩 |
@@ -72,22 +72,25 @@
 
 #### `trex.snapshot.req` 요청 payload
 ```
-{ "view": "open" | "all", "strategy_id": str | null, "trading_date": "YYYY-MM-DD" }
+{ "view": "open" | "all", "strategy_id": str | null,
+  "trading_date": "YYYY-MM-DD"?  # optional — kill-switch 당일 제외 마스크 기준일만 (BAT-030)
+}
 ```
-응답 payload는 슬롯 목록과 capacity 를 운반한다. view 모드와 strategy_id 는 payload(요청 매핑 원칙 — REQ-021).
+응답 payload는 슬롯 목록과 capacity 를 운반한다. view 모드와 strategy_id 는 payload(요청 매핑 원칙 — REQ-021). BAT-030: 슬롯 조회는 instance 스코프(영구 슬롯)라 `trading_date` 로 필터하지 않는다.
 
 #### `trex.intent.req` 요청 payload (buy)
 ```
 { "intent_type": "buy",
   "intent_id":   "<correlation_id 와 동일>",
-  "trading_date": "YYYY-MM-DD",
-  "portfolio_id": str,                 # REQUIRED (dcy-011/REQ-007) — canonical key(asset_id)
+  "slot_id": str(UUID),                # CANONICAL key (dcy-020/REQ-061) — snapshot slots[] round-trip
+  "portfolio_id": str?,                # legacy dual-accept 매핑(점진 전환용)
   "qty": float?, "allocated_capital": float?,
   "entry_price": float?, "strategy_id": str?, "sell_strategy_id": str?,
   "forced_close_at": "ISO-8601"?,
   "stop_loss_price": number?, "take_profit_price": number? }
 ```
-- **`portfolio_id` 필수(dcy-011/REQ-007/021)**: 매수의 정식 식별자. 누락 시 admission 에서 `portfolio_id_required` 로 거부. **`symbol` 은 client payload 에 없다** — core 가 admission 시 universe(`SnapshotStore`)에서 `portfolio_id → symbol` 을 resolve 해 슬롯/KIS 주문에 사용한다. universe 에 portfolio_id 가 없으면 `unknown_portfolio` 로 거부(하위호환·symbol fallback 없음, hard cutover).
+- **`slot_id` 정본(dcy-020/REQ-061, BAT-029/030)**: 매수의 정식 키 — 전략 모듈은 snapshot `slots[]` 의 `slot_id` 를 그대로 회신한다. 미스 시 `unknown_slot` 거부. `portfolio_id` 는 legacy dual-accept(미스 시 `unknown_portfolio`); 둘 다 없으면 `slot_id_or_portfolio_required`. `trading_date` 는 계약에서 제거(BAT-030).
+- admission(REQ-059): 대상 영구 자산 슬롯이 active(holding/pending) 면 `already_active`; instance active 수 ≥ `max_active_slots`(M) 면 `capacity_full`(FCFS·무치환). **`symbol` 은 client payload 에 없다** — core 가 슬롯의 `portfolio_id` 로 universe 에서 resolve 한다.
 - `stop_loss_price`/`take_profit_price`(선택, REQ-035/038): 매수 시 설정하면 워치독 만료 후 safety-sell 가격 트리거의 기준이 된다. 미포함 시 NULL(트리거 비활성).
 - `forced_close_at`(선택, REQ-066/037): 시간 기반 자동청산(만기) 절대시각. 운영자 CLI `enter --forced-close-at <ISO8601>`(절대시간)로 설정하며(REQ-032 CHG-20260609-01, issue #17, BAT-024), 미지정 시 payload 에 미포함(NULL). 설정 시 forced-close 만기 매도 루프(REQ-037)가 그 시각에 시장가 청산한다. 상대시간 옵션은 제공하지 않는다.
 sell payload 는 `{"intent_type":"sell", "intent_id":..., "slot_id":..., "reason":..., "sell_strategy_id":..., "limit_price": float?}`.
@@ -111,8 +114,8 @@ sell payload 는 `{"intent_type":"sell", "intent_id":..., "slot_id":..., "reason
 { "event_type": "slot_filled_buy"|"slot_filled_sell"|...,
   "slot_id": str, "strategy_id": str?, "symbol": str?,
   "status": "<SlotState 값>", "qty": float?, "avg_price": float?,
-  "portfolio_id": str?, "trading_date": "YYYY-MM-DD",
-  "sequence_at": "ISO-8601" }
+  "portfolio_id": str?,
+  "sequence_at": "ISO-8601" }   # BAT-030: trading_date 키 제거(영구 슬롯)
 ```
 - `sequence_at` = 슬롯 `updated_at` 의 단조 증가 토큰. 수신자는 last-wins 적용 가능 → 순서 보증 불요.
 - 이벤트의 `strategy_id`/`symbol` 은 routing key 에, 본문에도 함께 운반(이벤트 매핑 원칙 — REQ-021).
@@ -156,7 +159,7 @@ sell payload 는 `{"intent_type":"sell", "intent_id":..., "slot_id":..., "reason
     }, ...
   ],
   "view": "all" | "buyable" | "held",  # echo
-  "available_slots": int,              # idle_count snapshot
+  "available_slots": int,              # admission headroom = max(0, M − active); M 미설정 시 inactive 수 (REQ-059)
   "degraded": bool,                    # REQ-028 AC-2
   "reason":  "portfolio_hub_unavailable" | "snapshot_fetch_failed"
            | "cash_position_stale" | null,
@@ -168,17 +171,17 @@ sell payload 는 `{"intent_type":"sell", "intent_id":..., "slot_id":..., "reason
 - 슬롯 상태 (REQ-028 AC-4, BAT-022): envelope 은 strategy `assets[]`(universe) 와 **별도로** 데몬의 per-slot 상태를 운반한다. 운영자용(`trex-core slots`)이며 universe 와 명확히 구분된다.
 ```
 "slots": [                             # always a list (REQ-028 AC-4, never null)
-  { "slot_id": str,
-    "trading_date": "YYYY-MM-DD",
-    "status": "idle"|"pending_buy"|"holding"|"pending_sell"|"closed",
+  { "slot_id": str,                    # buy intent 의 canonical key (REQ-061)
+    "status": "inactive"|"pending_buy"|"holding"|"pending_sell"|"error",
     "symbol": str | null,
     "qty": number | null,
     "avg_price": number | null,        # 매수 체결가/평단
     "entry_price": number | null,      # pending 주문 지정가 (dcy-012 외부 호환명; 내부 limit_price)
     "allocated_capital": number | null,
     "strategy_id": str | null, "sell_strategy_id": str | null,
-    "portfolio_id": str | null,        # == asset_id
-    "forced_close_at": "ISO-8601" | null }
+    "portfolio_id": str | null,        # == asset_id (영구 자산 바인딩)
+    "forced_close_at": "ISO-8601" | null,
+    "universe_detached": bool }        # soft-retire/tombstone 마커 (REQ-058/063)
 ]
 ```
   - BAT-007 stub 경로와 BAT-008 envelope 경로가 **동일 `slots[]` 스키마**(`portfolio.slot_to_dict`)를 낸다. `assets[]`(portfolio 단위, universe, no-price) 와 독립이며 strategy 소비자는 무시 가능(additive, 하위호환). `slots[]` 는 operator-facing 이라 `entry_price`/`avg_price` 가격을 노출한다(no-price 규칙은 `assets[]` 한정).
@@ -318,16 +321,15 @@ resume_kill_switch 요청·응답 (REQ-046):
 
 ### Inputs
 
-- preallocate_daily_slots(trading_date, count) :: 거래일 idle 슬롯 멱등 사전 할당 (count > 0)
-- transit_slot(slot_id, from_state, to_state, reason, actor, **fields) :: advisory lock 하 원자 상태 전이
-- get_today_entry_count(trading_date, symbol) :: 재진입 정책 입력 조회
-- compute_slot_capacity(trading_date, total_slots) :: 가용성 스냅샷 계산 (total_slots > 0)
+- transit_slot(slot_id, from_state, to_state, reason, actor, **fields) :: advisory lock 하 원자 상태 전이 (INACTIVE 진입 시 점유 초기화 + 자산 정체성 보존)
+- sell(slot_id, actor, reason, limit_price=None) :: holding 슬롯 자율 매도(멱등)
+- update_thresholds(slot_id, ...) :: SL/TP/forced_close 부분 갱신
+- compute_slot_capacity(max_active_slots=None) :: instance 스코프 가용성 스냅샷 (BAT-030)
 
 ### Outputs
 
 - Slot :: 전이 후 슬롯 행 스냅샷
-- SlotCapacity :: idle/holding/pending 카운트 + scarcity_ratio
-- int :: 사전 할당 수 / 재진입 카운트
+- SlotCapacity :: inactive/holding/pending/active/available 카운트 + total + scarcity_ratio
 - slot_transition_log append :: 모든 전이의 append-only 감사 기록(부수 효과)
 
 ### Error Contract
@@ -335,12 +337,11 @@ resume_kill_switch 요청·응답 (REQ-046):
 - SlotTransitionError :: 허용되지 않은 (from_state, to_state) 전이
 - SlotStateMismatchError :: read-write 사이 상태 변동(레이스 감지)
 - SlotNotFoundError :: 존재하지 않는 slot_id
-- ValueError :: count <= 0 또는 total_slots <= 0
 
 ### Compatibility Rules
 
-- 6 상태 / 8 전이 패밀리 계약을 깨는 변경은 breaking 으로 취급한다.
-- 상태 변경 API 는 transactional_advisory_lock 안에서만 수행하고 lock 보유 중 외부 I/O 를 금지한다.
+- 5 상태 / 12 전이 계약(REQ-057)을 깨는 변경은 breaking 으로 취급한다.
+- 상태 변경 API 는 transactional_advisory_lock(인스턴스 스코프 lock id) 안에서만 수행하고 lock 보유 중 외부 I/O 를 금지한다.
 
 ## Interface: `SlotRepository (Protocol)`
 
@@ -352,16 +353,17 @@ resume_kill_switch 요청·응답 (REQ-046):
 ### Inputs
 
 - transactional_advisory_lock(lock_id) :: 단일 트랜잭션 + advisory lock 컨텍스트 매니저
-- pre_allocate_slots / fetch_slot / find_idle_slot / update_slot :: daily_slot CRUD
+- list_slots(instance_key) / fetch_slot / update_slot :: daily_slot CRUD (instance 스코프)
+- find_slot_by_portfolio / count_active / list_holding_slots / reconcile_universe :: 자산 중심 표면 (REQ-058/059/062)
+- list_undispatched_pending / mark_dispatched / list_dispatched_pending / clear_dispatch :: 집행 큐 (instance 스코프)
 - append_transition_log :: append-only 전이 로그
-- increment_symbol_entry / get_symbol_entry_count :: 재진입 카운터
-- count_slots_by_status :: 상태별 집계
+- count_slots_by_status(instance_key) :: 상태별 집계
 
 ### Outputs
 
 - Slot / SlotTransitionRecord :: 도메인 모델
 - dict[SlotState, int] :: 상태별 카운트
-- int :: 재진입 카운트 / 사전 할당 수
+- dict[str, int] :: reconcile 결과 {created, retired, tombstoned}
 
 ### Error Contract
 
@@ -456,8 +458,8 @@ resume_kill_switch 요청·응답 (REQ-046):
   - `cancelled :: bool` :: 외부 취소 감지(dcy-013/REQ-012, issue #9). 기본 False.
 - `state` 값과 집행 처리(dcy-013):
   - `accepted` / `partially_filled`(취소 아님) :: 다음 tick 대기. (FR-3) `TREX_PENDING_STALE_THRESHOLD`(초, 0=비활성) 초과 시 Alert-only WARN+카운터(상태 미변경).
-  - `filled` :: 전량 체결 → `pending_buy→holding` / `pending_sell→closed` + 원장 1건.
-  - `cancelled`(체결 0 외부 취소) :: `is_terminal_reject` → 롤백(`pending_sell→holding` / `pending_buy→idle`), `clear_dispatch` → 자동 재매도 가능.
+  - `filled` :: 전량 체결 → `pending_buy→holding` / `pending_sell→inactive` + 원장 1건.
+  - `cancelled`(체결 0 외부 취소) :: `is_terminal_reject` → 롤백(`pending_sell→holding` / `pending_buy→inactive`), `clear_dispatch` → 자동 재매도 가능.
   - `partially_filled` + `cancelled=True`(부분 체결 후 외부 취소) :: `is_partial_cancel` → 체결분 원장 1회 기록 + 슬롯 qty 차감(매도: 잔여 held / 매수: 체결분만) + `holding` 복귀. 매도는 cost basis(`avg_price`) 유지.
 - KIS 매핑: `inquire-daily-ccld` 응답 row 의 `cncl_yn="Y"` 를 취소로 해석한다(미지/부재 값은 보수적으로 비취소 처리, stale 워치독이 backstop).
 
@@ -516,3 +518,4 @@ resume_kill_switch 요청·응답 (REQ-046):
 - 2026-06-04 :: BAT-006 — LedgerPort/LedgerTrade/LedgerWriteResult 계약, LedgerOutbox/LedgerWriter, portfolio-hub `/v1/assets/{asset_id}/ledger/trades` 엔드포인트 + 409→`LedgerConflictError`, FillStatus.execution_id/fee/tax 확장 (REQ-017~020).
 - 2026-06-05 :: BAT-007 — HTTP `/v1` API 인터페이스 제거(adapters/api + fastapi/uvicorn 의존 정리), RabbitMQ messaging 계약 추가(스냅샷 RPC `trex.snapshot.req`, intent RPC `trex.intent.req`, 이벤트 topic `trex.events`, 전략별 durable queue + TTL/max-length, DLQ, publisher confirms, ack-after-commit), `MessagingTransport` Protocol + `TransportHealth` 노출 (REQ-021~026).
 - 2026-06-06 :: BAT-008 — `trex.snapshot.req` envelope 계약 정의(`assets[]/view/available_slots/degraded/reason/message`, no price field), `trex.pause.req` 제어 RPC 추가, `PortfolioHubReadPort`/`SnapshotStore`/`PauseStore`/`SnapshotScheduler` 인터페이스, `BrokerPort.get_balance()` 확장, `trex-core` CLI 추가 (REQ-027~033; REQ-030 옵션 D 는 portfolio-hub#8 배포 후).
+- 2026-06-10 :: BAT-030 (dcy-020 마감) — buy intent 계약 키 `slot_id` 정본(+`portfolio_id` dual-accept, `trading_date` 제거), 거부 어휘(`unknown_slot`/`already_active`/`capacity_full`/`slot_id_or_portfolio_required`), `slots[]` 5-state + `universe_detached`(trading_date 키 제거), 이벤트 payload trading_date 제거, `available_slots`=admission headroom, SlotService/SlotRepository 자산 중심 계약, 매도 체결 `pending_sell→inactive` (REQ-056~065).