feat(payload-passthrough): 0.4.0 — isReservationOrder pass-through + /create/direct fix

[pghoya2956]

Summary

• Payload pass-through framework — bridge 가 정책성 boolean/enum flag 를 hardcoded 가 아닌 외부 인자로 받아 그대로 transport. AI Native 정공 (bridge transport / wrapper enum→bool / SKILL 결정). 1차 적용 = isReservationOrder.
• /api/v2/wts/trading/order/create/direct endpoint fix — KRX 휴장 시 broker create 거절 (HTTP 400 / DC-3850) 결함 해소. 토스 web UI 와 동일 endpoint 호출.
• _market_status_issue 화이트리스트 fix — "N" 제거 (휴장 KRX 시 false-positive 우회 차단). 정규장 화이트리스트 = {ACTIVE, NORMAL, OPEN, TRADING}.

Changes

submit.py

• build_order_prepare_payload — is_reservation_order: bool | None = None keyword-only arg 추가. isReservationOrder payload field 외부 인자 그대로 송출 (None → False default).
• validate_place_order_params — type validation 추가 (bool | None 만 수용. enum string 송출 시 MutationValidationError).

daemon.py

• _run_prepare_preflight — normalized params 의 is_reservation_order 를 build_order_prepare_payload 로 전달.
• _market_status_issue — 화이트리스트 {"ACTIVE", "NORMAL", "OPEN", "TRADING"} ("N" 제거).
• broker create endpoint = /api/v2/wts/trading/order/create/direct (P6-01.1 진단 fix).

cli.py

• place-order 에 --reservation-mode {auto, on, off} 인자 추가. enum → Optional[bool] 변환은 wrapper layer 까지 (bridge 내부는 Optional[bool]).

tests/test_submit_runtime.py

• 신규 10건: build_order_prepare_payload 3 case (None/True/False) + validate_place_order_params 4 case (omit/True/False/string reject) + _market_status_issue 3 case ("N" → review, "ACTIVE" → None, "HALT" → blocking).
• 회귀 0 (총 86 passed, 1 skipped).

Supervised live 검증 결과

financier-v2 tasks/20260505-toss-bridge-payload-passthrough/ Phase 5 양쪽 path 통과:

P5-01 reservation=on (KRX 휴장 어린이날, 2026-05-05 17:23 KST)

• 379800 KODEX 미국S&P500 1주 limit ₩20,000 reservation=on 매수 예약
• broker_ack is_reserved: true, code: OK, http_status: 200, order_no: 251199
• P6-01.1 broker create 거절 결함 해소 보증

P5-02 reservation=off user_override (NYSE 정규장, 2026-05-05 23:04 KST)

• SCHD 1주 limit $31.50 즉시 체결 (user_override force_off)
• broker_ack is_reserved: false, code: OK, http_status: 200, order_no: 5
• 실 체결 (position +1주 + cash -$31.49)

OQ-04 자연 capture 핵심 통찰

• 토스 wts derived.market_status 가 정규장/휴장 모두 "N" default — UI 표시용 enum 한계
• 화이트리스트 보강만으론 불충분 → 시간 기반 lookup 정공 (follow-up task 20260505-toss-market-status-time-lookup/)

Test plan

• env -u TOSS_BRIDGE_PORT -u TOSS_BRIDGE_HOME uv run pytest tests/ — 86 passed, 1 skipped
• supervised live P5-01 reservation=on broker_ack capture
• supervised live P5-02 reservation=off (user_override) broker_ack capture
• audit log entry 양쪽 path 신규 schema (is_reservation_order + reservation_decision_source) 정합

Task spec

• 본 task: financier-v2/tasks/20260505-toss-bridge-payload-passthrough/
• 후속 task stub 4건: OQ-08 시간 기반 lookup / OQ-09 verification_state 보강 / KIS 일반화 / candidate flag 4건
• Phase 6 unblock 보증: financier-v2/tasks/20260430-toss-bridge-live-order/ Phase 6 P6-02~04 재개 가능

🤖 Generated with Claude Code