v2.5.0 — 에이전트 네이티브: 정규화 데이터·NDJSON 스트리밍·녹화/히스토리

⚠️ 기존 -f json 소비자에게 breaking change입니다 — API 응답의 data가
정규화된 타입 있는 필드(canonical 영문 이름, 숫자는 number)로 바뀌고 원본은
data.raw로 이동했습니다 (리스트 응답은 {"items": [...], "raw": [...]}).
기존 키를 그대로 쓰던 스크립트는 data.raw에서 읽거나 canonical 이름으로
옮기면 됩니다. table/csv 모드와 exit code 계약(0/1/2/3)은 변경 없습니다.

Added

• 정규화된 json data: cur_prc→price, stk_cd→symbol, flu_rt→change_pct 등
  canonical 이름 + 타입 변환(부호 문자열 파싱 불필요), ABS 필드는
  change_direction(up/down) 동반, 날짜/시각은 ISO-8601(+09:00).
• 전역 --fields a,b: json data(및 내부 리스트 요소)를 지정 키로 투영하고
  raw를 제거 — 에이전트 토큰 절약.
• kiwoom describe [명령...]: 명령 트리/인자/옵션(타입·기본값·choices)
  자기서술. 도움말 파싱 대신 스키마로.
• NDJSON 스트리밍: -f json에서 모든 stream 명령이 REAL 이벤트당 compact
  envelope 한 줄을 출력. 종료조건 --max-events N / --duration 30s|5m|2h /
  --until <ISO-8601> 도달 시 exit 0. ws 오류는 envelope 오류 한 줄 + exit 2(인증 3).
• 녹화와 히스토리: 모든 stream 명령의 --record [경로]가 이벤트를 NDJSON
  파일로 저장 (기본 ~/.kiwoom/data/<심볼>_<날짜>.ndjson). history list /
  history query CODE --from --to [--type] / history export CODE --dest sqlite|csv|parquet.
• AGENTS.md: envelope·오류코드·안전장치·스트리밍의 기계 계약 문서.
• benchmark/litmus.sh: 모의투자 대상 재현 가능한 litmus loop 증명
  (시세→사전점검→dry-run→멱등 매수→재실행 replay 검증→미체결→잔고, 매 단계 jq -e).
• docs/vs-official.md: 공식 CLI(kwcli) 대비 정직한 역량 비교.

전체 변경: v2.4.0...v2.5.0

🤖 Generated with Claude Code