kwcli 0.1.0__py3-none-any.whl

kiwoom_cli/maps/order_confirmation_commands.csv

@@ -0,0 +1,13 @@
+command_path,kind,message
+kiwoomcli domestic orders buy,주식 매수,주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders sell,주식 매도,주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders modify,주식 정정,정정주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders cancel,주식 취소,취소주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders credit-buy,신용 매수,주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders credit-sell,신용 매도,주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders credit-modify,신용 정정,정정주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders credit-cancel,신용 취소,취소주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders gold-buy,금현물 매수,금현물 주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders gold-sell,금현물 매도,금현물 주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders gold-modify,금현물 정정,금현물 정정주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.
+kiwoomcli domestic orders gold-cancel,금현물 취소,금현물 취소주문은 아직 전송되지 않았습니다. 실제 전송하려면 같은 명령에 --confirm을 붙여 다시 실행하세요.

kiwoom_cli/maps/order_confirmation_fields.csv

@@ -0,0 +1,71 @@
+command_path,output_key,label,arg_name,value_label_group,include_if_empty,empty_display
+kiwoomcli domestic orders buy,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders buy,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders buy,code,종목,code,,Y,
+kiwoomcli domestic orders buy,quantity,수량,qty,,Y,
+kiwoomcli domestic orders buy,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders buy,price,가격,price,,Y,없음
+kiwoomcli domestic orders sell,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders sell,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders sell,code,종목,code,,Y,
+kiwoomcli domestic orders sell,quantity,수량,qty,,Y,
+kiwoomcli domestic orders sell,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders sell,price,가격,price,,Y,없음
+kiwoomcli domestic orders modify,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders modify,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders modify,code,종목,code,,Y,
+kiwoomcli domestic orders modify,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders modify,quantity,정정수량,qty,,Y,
+kiwoomcli domestic orders modify,price,정정가격,price,,Y,
+kiwoomcli domestic orders cancel,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders cancel,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders cancel,code,종목,code,,Y,
+kiwoomcli domestic orders cancel,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders cancel,quantity,취소수량,qty,,Y,
+kiwoomcli domestic orders credit-buy,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders credit-buy,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders credit-buy,code,종목,code,,Y,
+kiwoomcli domestic orders credit-buy,quantity,수량,qty,,Y,
+kiwoomcli domestic orders credit-buy,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders credit-buy,price,가격,price,,Y,없음
+kiwoomcli domestic orders credit-buy,condition_price,조건가격,condition_price,,N,
+kiwoomcli domestic orders credit-sell,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders credit-sell,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders credit-sell,code,종목,code,,Y,
+kiwoomcli domestic orders credit-sell,quantity,수량,qty,,Y,
+kiwoomcli domestic orders credit-sell,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders credit-sell,price,가격,price,,Y,없음
+kiwoomcli domestic orders credit-sell,credit_deal,신용거래,credit_deal,credit_deal,Y,
+kiwoomcli domestic orders credit-sell,loan_date,대출일,loan_date,,N,
+kiwoomcli domestic orders credit-sell,condition_price,조건가격,condition_price,,N,
+kiwoomcli domestic orders credit-modify,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders credit-modify,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders credit-modify,code,종목,code,,Y,
+kiwoomcli domestic orders credit-modify,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders credit-modify,quantity,정정수량,qty,,Y,
+kiwoomcli domestic orders credit-modify,price,정정가격,price,,Y,
+kiwoomcli domestic orders credit-modify,condition_price,정정조건가격,condition_price,,N,
+kiwoomcli domestic orders credit-cancel,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders credit-cancel,exchange,시장,exchange,,Y,
+kiwoomcli domestic orders credit-cancel,code,종목,code,,Y,
+kiwoomcli domestic orders credit-cancel,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders credit-cancel,quantity,취소수량,qty,,Y,
+kiwoomcli domestic orders gold-buy,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders gold-buy,code,종목,code,,Y,
+kiwoomcli domestic orders gold-buy,quantity,수량,qty,,Y,
+kiwoomcli domestic orders gold-buy,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders gold-buy,price,가격,price,,Y,
+kiwoomcli domestic orders gold-sell,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders gold-sell,code,종목,code,,Y,
+kiwoomcli domestic orders gold-sell,quantity,수량,qty,,Y,
+kiwoomcli domestic orders gold-sell,order_type,유형,order_type,order_type,Y,
+kiwoomcli domestic orders gold-sell,price,가격,price,,Y,
+kiwoomcli domestic orders gold-modify,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders gold-modify,code,종목,code,,Y,
+kiwoomcli domestic orders gold-modify,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders gold-modify,quantity,정정수량,qty,,Y,
+kiwoomcli domestic orders gold-modify,price,정정가격,price,,Y,
+kiwoomcli domestic orders gold-cancel,kind,구분,__kind__,,Y,
+kiwoomcli domestic orders gold-cancel,original_order_id,원주문번호,order_id,,Y,
+kiwoomcli domestic orders gold-cancel,code,종목,code,,Y,
+kiwoomcli domestic orders gold-cancel,quantity,취소수량,qty,,Y,

kiwoom_cli/maps/order_price_policies.csv

@@ -0,0 +1,47 @@
+command_path,order_type,price_option,price_policy,condition_price_option,condition_price_policy,description
+kiwoomcli domestic orders buy,limit,--price,required,,,지정가 매수는 주문단가가 필요합니다.
+kiwoomcli domestic orders buy,market,--price,forbidden,,,시장가 매수는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders sell,limit,--price,required,,,지정가 매도는 주문단가가 필요합니다.
+kiwoomcli domestic orders sell,market,--price,forbidden,,,시장가 매도는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,limit,--price,required,,,지정가 신용매수는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,market,--price,forbidden,,,시장가 신용매수는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,conditional-limit,--price,required,,,조건부지정가는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,after-hours-close,--price,forbidden,,,장마감후시간외는 별도 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,pre-open,--price,forbidden,,,장시작전시간외는 별도 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,after-hours-single,--price,required,,,시간외단일가는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,best-limit,--price,forbidden,,,최유리지정가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,top-priority,--price,forbidden,,,최우선지정가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,limit-ioc,--price,required,,,보통 IOC는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,market-ioc,--price,forbidden,,,시장가 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,best-ioc,--price,forbidden,,,최유리 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,limit-fok,--price,required,,,보통 FOK는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,market-fok,--price,forbidden,,,시장가 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,best-fok,--price,forbidden,,,최유리 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,stop-limit,--price,required,--condition-price,required,스톱지정가는 주문단가와 조건단가가 필요합니다.
+kiwoomcli domestic orders credit-buy,mid,--price,forbidden,,,중간가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,mid-ioc,--price,forbidden,,,중간가 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-buy,mid-fok,--price,forbidden,,,중간가 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,limit,--price,required,,,지정가 신용매도는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,market,--price,forbidden,,,시장가 신용매도는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,conditional-limit,--price,required,,,조건부지정가는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,after-hours-close,--price,forbidden,,,장마감후시간외는 별도 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,pre-open,--price,forbidden,,,장시작전시간외는 별도 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,after-hours-single,--price,required,,,시간외단일가는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,best-limit,--price,forbidden,,,최유리지정가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,top-priority,--price,forbidden,,,최우선지정가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,limit-ioc,--price,required,,,보통 IOC는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,market-ioc,--price,forbidden,,,시장가 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,best-ioc,--price,forbidden,,,최유리 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,limit-fok,--price,required,,,보통 FOK는 주문단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,market-fok,--price,forbidden,,,시장가 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,best-fok,--price,forbidden,,,최유리 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,stop-limit,--price,required,--condition-price,required,스톱지정가는 주문단가와 조건단가가 필요합니다.
+kiwoomcli domestic orders credit-sell,mid,--price,forbidden,,,중간가는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,mid-ioc,--price,forbidden,,,중간가 IOC는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders credit-sell,mid-fok,--price,forbidden,,,중간가 FOK는 주문단가를 보내지 않습니다.
+kiwoomcli domestic orders gold-buy,limit,--price,required,,,금현물 지정가 매수는 주문단가가 필요합니다.
+kiwoomcli domestic orders gold-buy,limit-ioc,--price,required,,,금현물 IOC 매수는 주문단가가 필요합니다.
+kiwoomcli domestic orders gold-buy,limit-fok,--price,required,,,금현물 FOK 매수는 주문단가가 필요합니다.
+kiwoomcli domestic orders gold-sell,limit,--price,required,,,금현물 지정가 매도는 주문단가가 필요합니다.
+kiwoomcli domestic orders gold-sell,limit-ioc,--price,required,,,금현물 IOC 매도는 주문단가가 필요합니다.
+kiwoomcli domestic orders gold-sell,limit-fok,--price,required,,,금현물 FOK 매도는 주문단가가 필요합니다.

kiwoom_cli/maps/order_value_labels.csv

@@ -0,0 +1,28 @@
+group,value,label
+order_type,limit,지정가
+order_type,market,시장가
+order_type,conditional-limit,조건부지정가
+order_type,after-hours-close,장마감후시간외
+order_type,pre-open,장시작전시간외
+order_type,after-hours-single,시간외단일가
+order_type,best-limit,최유리지정가
+order_type,top-priority,최우선지정가
+order_type,limit-ioc,보통(IOC)
+order_type,market-ioc,시장가(IOC)
+order_type,best-ioc,최유리(IOC)
+order_type,limit-fok,보통(FOK)
+order_type,market-fok,시장가(FOK)
+order_type,best-fok,최유리(FOK)
+order_type,stop-limit,스톱지정가
+order_type,mid,중간가
+order_type,mid-ioc,중간가(IOC)
+order_type,mid-fok,중간가(FOK)
+credit_deal,financing,융자
+credit_deal,financing-all,융자합
+order_type,vwap-limit,VWAP지정가
+order_type,twap-limit,TWAP지정가
+order_type,loc,LOC
+order_type,moc,MOC
+order_type,vwap-market,VWAP시장가
+order_type,twap-market,TWAP시장가
+order_type,stop,STOP

kiwoom_cli/maps/positional_arguments.csv

@@ -0,0 +1,21 @@
+command_path,canonical_form,positional_form,position,name,dest,option,status,reason
+kiwoomcli setup,kiwoomcli setup --alias <alias> --mode <mode>,kiwoomcli setup <alias> --mode <mode>,1,alias,alias,--alias,allow,setup/login target alias is the primary operand
+kiwoomcli auth login,kiwoomcli auth login --alias <alias> --mode <mode>,kiwoomcli auth login <alias> --mode <mode>,1,alias,alias,--alias,allow,auth login target alias is the primary operand
+kiwoomcli auth status,kiwoomcli auth status --profile <alias>,kiwoomcli auth status <alias>,1,alias,profile,--profile,allow,profile status naturally targets one alias
+kiwoomcli auth refresh,kiwoomcli auth refresh --profile <alias>,kiwoomcli auth refresh <alias>,1,alias,profile,--profile,allow,profile refresh naturally targets one alias
+kiwoomcli auth revoke,kiwoomcli auth revoke --profile <alias>,kiwoomcli auth revoke <alias>,1,alias,profile,--profile,allow,profile token revoke naturally targets one alias
+kiwoomcli auth clear,kiwoomcli auth clear --profile <alias> --all,kiwoomcli auth clear <alias> --all,1,alias,profile,--profile,allow,profile credential cleanup naturally targets one alias
+kiwoomcli domestic stocks info,kiwoomcli domestic stocks info --code <code>,kiwoomcli domestic stocks info <code>,1,code,code,--code,candidate,common single-stock lookup shorthand
+kiwoomcli domestic quotes price,kiwoomcli domestic quotes price --code <code>,kiwoomcli domestic quotes price <code>,1,code,code,--code,candidate,common single-stock quote shorthand
+kiwoomcli domestic orderbooks list,kiwoomcli domestic orderbooks list --code <code>,kiwoomcli domestic orderbooks list <code>,1,code,code,--code,candidate,common single-stock orderbook shorthand
+kiwoomcli domestic candles daily,kiwoomcli domestic candles daily --code <code>,kiwoomcli domestic candles daily <code>,1,code,code,--code,candidate,common single-stock chart shorthand
+kiwoomcli domestic streams trades,kiwoomcli domestic streams trades --code <code>,kiwoomcli domestic streams trades <code>,1,code,code,--code,candidate,common single-stock realtime shorthand
+kiwoomcli domestic streams conditions-search,kiwoomcli domestic streams conditions-search [--seq <seq>] --exchange <exchange>,defer,1,seq,seq,--seq,defer,seq is optional because the command internally loads saved conditions with CNSRLST
+kiwoomcli domestic streams conditions-subscribe,kiwoomcli domestic streams conditions-subscribe [--seq <seq>] --exchange <exchange>,defer,1,seq,seq,--seq,defer,seq is optional because the command internally loads saved conditions with CNSRLST
+kiwoomcli domestic streams conditions-unsubscribe,kiwoomcli domestic streams conditions-unsubscribe [--seq <seq>],defer,1,seq,seq,--seq,defer,one-shot clear is same-session only; positional shorthand would hide that constraint
+kiwoomcli domestic orders buy,kiwoomcli domestic orders buy --code <code> --qty <qty> --price <price> --order-type <type>,defer,1,code,code,--code,defer,write-like order shorthand is deferred for safety and ambiguity
+kiwoomcli domestic orders sell,kiwoomcli domestic orders sell --code <code> --qty <qty> --price <price> --order-type <type>,defer,1,code,code,--code,defer,write-like order shorthand is deferred for safety and ambiguity
+kiwoomcli domestic orders modify,kiwoomcli domestic orders modify --code <code> --order-id <order-id> --qty <qty> --price <price>,defer,1,code,code,--code,defer,modify shorthand is deferred because order-id qty price order can be confused
+kiwoomcli domestic orders modify,kiwoomcli domestic orders modify --code <code> --order-id <order-id> --qty <qty> --price <price>,defer,2,order-id,order_id,--order-id,defer,modify shorthand is deferred because order-id qty price order can be confused
+kiwoomcli domestic orders cancel,kiwoomcli domestic orders cancel --code <code> --order-id <order-id> --qty <qty>,defer,1,code,code,--code,defer,cancel shorthand is deferred because order-id and quantity mistakes are high impact
+kiwoomcli domestic orders cancel,kiwoomcli domestic orders cancel --code <code> --order-id <order-id> --qty <qty>,defer,2,order-id,order_id,--order-id,defer,cancel shorthand is deferred because order-id and quantity mistakes are high impact

kiwoom_cli/order_confirmation.py

@@ -0,0 +1,167 @@
+"""Order confirmation output for confirm-gated domestic order commands."""
+
+from __future__ import annotations
+
+import argparse
+import csv
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+from kiwoom_cli.errors import CliInternalError
+from kiwoom_cli.output import format_payload
+from kiwoom_cli.registry import CommandDefinition
+
+MAP_ROOT = Path(__file__).resolve().parent / "maps"
+COMMANDS_PATH = MAP_ROOT / "order_confirmation_commands.csv"
+FIELDS_PATH = MAP_ROOT / "order_confirmation_fields.csv"
+VALUE_LABELS_PATH = MAP_ROOT / "order_value_labels.csv"
+
+
+@dataclass(frozen=True)
+class OrderConfirmationCommand:
+    command_path: str
+    kind: str
+    message: str
+
+
+@dataclass(frozen=True)
+class OrderConfirmationField:
+    command_path: str
+    output_key: str
+    label: str
+    arg_name: str
+    value_label_group: str
+    include_if_empty: bool
+    empty_display: str
+
+
+def build_order_confirmation(
+    definition: CommandDefinition,
+    args: argparse.Namespace,
+) -> dict[str, Any]:
+    command = get_order_confirmation_command(definition.command_path)
+    if command is None:
+        raise CliInternalError(
+            f"{definition.command_path}: 주문 확인 출력 매핑이 없습니다."
+        )
+    fields = get_order_confirmation_fields(definition.command_path)
+    value_labels = load_value_labels()
+    order: dict[str, str] = {}
+    display_rows: list[dict[str, str]] = []
+    for field in fields:
+        value = _field_value(
+            field, command=command, args=args, value_labels=value_labels
+        )
+        if value == "" and not field.include_if_empty:
+            continue
+        display_value = field.empty_display if value == "" else value
+        order[field.output_key] = display_value
+        display_rows.append(
+            {
+                "key": field.output_key,
+                "label": field.label,
+                "value": display_value,
+            }
+        )
+    return {
+        "message": command.message,
+        "order": order,
+        "_display_rows": display_rows,
+    }
+
+
+def format_order_confirmation(payload: dict[str, Any], *, output_format: str) -> str:
+    if output_format == "pretty":
+        return _format_order_confirmation_pretty(payload)
+    machine_payload = {
+        "message": payload["message"],
+        "order": payload["order"],
+    }
+    return format_payload(machine_payload, output_format=output_format)
+
+
+def load_order_confirmation_commands(
+    map_path: Path | None = None,
+) -> list[OrderConfirmationCommand]:
+    resolved_path = map_path or COMMANDS_PATH
+    with resolved_path.open(encoding="utf-8", newline="") as file:
+        return [
+            OrderConfirmationCommand(
+                command_path=row["command_path"],
+                kind=row["kind"],
+                message=row["message"],
+            )
+            for row in csv.DictReader(file)
+        ]
+
+
+def get_order_confirmation_command(
+    command_path: str,
+) -> OrderConfirmationCommand | None:
+    for row in load_order_confirmation_commands():
+        if row.command_path == command_path:
+            return row
+    return None
+
+
+def load_order_confirmation_fields(
+    map_path: Path | None = None,
+) -> list[OrderConfirmationField]:
+    resolved_path = map_path or FIELDS_PATH
+    with resolved_path.open(encoding="utf-8", newline="") as file:
+        return [_field_from_row(row) for row in csv.DictReader(file)]
+
+
+def get_order_confirmation_fields(command_path: str) -> list[OrderConfirmationField]:
+    return [
+        field
+        for field in load_order_confirmation_fields()
+        if field.command_path == command_path
+    ]
+
+
+def load_value_labels(map_path: Path | None = None) -> dict[tuple[str, str], str]:
+    resolved_path = map_path or VALUE_LABELS_PATH
+    with resolved_path.open(encoding="utf-8", newline="") as file:
+        return {
+            (row["group"], row["value"]): row["label"] for row in csv.DictReader(file)
+        }
+
+
+def _field_from_row(row: dict[str, str]) -> OrderConfirmationField:
+    return OrderConfirmationField(
+        command_path=row["command_path"],
+        output_key=row["output_key"],
+        label=row["label"],
+        arg_name=row["arg_name"],
+        value_label_group=row["value_label_group"],
+        include_if_empty=row["include_if_empty"] == "Y",
+        empty_display=row["empty_display"],
+    )
+
+
+def _field_value(
+    field: OrderConfirmationField,
+    *,
+    command: OrderConfirmationCommand,
+    args: argparse.Namespace,
+    value_labels: dict[tuple[str, str], str],
+) -> str:
+    if field.arg_name == "__kind__":
+        value = command.kind
+    else:
+        value = getattr(args, field.arg_name, "")
+        if value is None:
+            value = ""
+        value = str(value)
+    if value and field.value_label_group:
+        return value_labels.get((field.value_label_group, value), value)
+    return value
+
+
+def _format_order_confirmation_pretty(payload: dict[str, Any]) -> str:
+    lines = [payload["message"], "", "주문 확인:"]
+    for row in payload["_display_rows"]:
+        lines.append(f"- {row['label']}: {row['value']}")
+    return "\n".join(lines)

kiwoom_cli/output.py

@@ -0,0 +1,136 @@
+"""Output formatting for CLI command results."""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Iterable
+
+from kiwoom.core.types import KiwoomResponse
+from kiwoom_cli.errors import CliInternalError
+
+
+OUTPUT_FORMATS = ("pretty", "json", "jsonl", "yaml")
+ACCOUNT_IDENTIFIER_FIELDS = frozenset(
+    {
+        "acctNo",
+        "acctno",
+        "acct_no",
+        "account_no",
+        "account_number",
+        "acnt_no",
+        "acntNo",
+        "acntno",
+        "acnt_num",
+        "cano",
+    }
+)
+# Order numbers are operational identifiers the user needs to manage their own
+# orders (e.g. read an `ord_no` from a buy/list response and pass it to
+# modify/cancel), so they are NOT redacted. Account numbers are sensitive PII
+# and stay redacted.
+ACCOUNT_REDACT_FIELDS = ACCOUNT_IDENTIFIER_FIELDS
+
+
+def format_response(
+    response: KiwoomResponse,
+    *,
+    output_format: str = "pretty",
+    redact_fields: Iterable[str] = (),
+) -> str:
+    return format_payload(response.body, output_format=output_format, redact_fields=redact_fields)
+
+
+def format_payload(
+    payload: Any,
+    *,
+    output_format: str = "pretty",
+    redact_fields: Iterable[str] = (),
+) -> str:
+    payload = _redact_payload(payload, set(redact_fields))
+
+    if output_format == "pretty":
+        return json.dumps(payload, ensure_ascii=False, indent=2)
+    if output_format == "json":
+        return json.dumps(payload, ensure_ascii=False, separators=(",", ":"))
+    if output_format == "jsonl":
+        return _to_jsonl(payload)
+    if output_format == "yaml":
+        return _to_yaml(payload)
+    raise CliInternalError(f"지원하지 않는 출력 형식입니다: {output_format}")
+
+
+def _to_jsonl(payload: Any) -> str:
+    rows = payload if isinstance(payload, list) else [payload]
+    return "\n".join(
+        json.dumps(row, ensure_ascii=False, separators=(",", ":")) for row in rows
+    )
+
+
+def _redact_payload(value: Any, redact_fields: set[str]) -> Any:
+    if not redact_fields:
+        return value
+    if isinstance(value, dict):
+        return {
+            key: _redact_sensitive_value(item)
+            if _should_redact_key(key, redact_fields)
+            else _redact_payload(item, redact_fields)
+            for key, item in value.items()
+        }
+    if isinstance(value, list):
+        return [_redact_payload(item, redact_fields) for item in value]
+    return value
+
+
+def _should_redact_key(key: Any, redact_fields: set[str]) -> bool:
+    text = str(key)
+    return text in redact_fields or text.lower() in redact_fields
+
+
+def _redact_sensitive_value(value: Any) -> Any:
+    if isinstance(value, dict):
+        return {key: _redact_sensitive_value(item) for key, item in value.items()}
+    if isinstance(value, list):
+        return [_redact_sensitive_value(item) for item in value]
+    return _redact_value(value)
+
+
+def _redact_value(value: Any) -> Any:
+    if value is None:
+        return None
+    text = str(value)
+    if len(text) <= 4:
+        return "****"
+    return f"{'*' * (len(text) - 4)}{text[-4:]}"
+
+
+def _to_yaml(value: Any, *, indent: int = 0) -> str:
+    prefix = " " * indent
+    if isinstance(value, dict):
+        lines: list[str] = []
+        for key, item in value.items():
+            if isinstance(item, (dict, list)):
+                lines.append(f"{prefix}{key}:")
+                lines.append(_to_yaml(item, indent=indent + 2))
+            else:
+                lines.append(f"{prefix}{key}: {_yaml_scalar(item)}")
+        return "\n".join(lines)
+    if isinstance(value, list):
+        lines = []
+        for item in value:
+            if isinstance(item, (dict, list)):
+                lines.append(f"{prefix}-")
+                lines.append(_to_yaml(item, indent=indent + 2))
+            else:
+                lines.append(f"{prefix}- {_yaml_scalar(item)}")
+        return "\n".join(lines)
+    return f"{prefix}{_yaml_scalar(value)}"
+
+
+def _yaml_scalar(value: Any) -> str:
+    if value is None:
+        return "null"
+    if isinstance(value, bool):
+        return "true" if value else "false"
+    if isinstance(value, (int, float)):
+        return str(value)
+    return json.dumps(str(value), ensure_ascii=False)

kiwoom_cli/registry.py

@@ -0,0 +1,95 @@
+"""Load curated CLI command mappings."""
+
+from __future__ import annotations
+
+import csv
+from dataclasses import dataclass
+from functools import lru_cache
+from pathlib import Path
+
+from kiwoom_cli.errors import CliInternalError
+
+
+MAP_PATH = Path(__file__).resolve().parent / "maps" / "api_commands.csv"
+
+
+@dataclass(frozen=True)
+class CommandDefinition:
+    api_id: str
+    api_name: str
+    cli_group: str
+    cli_command: str
+    command_path: str
+    status: str
+    coverage_status: str
+    safety_policy: str
+    method: str
+    path: str
+    required_body_fields: tuple[str, ...]
+
+
+def load_command_definitions(map_path: Path | None = None) -> list[CommandDefinition]:
+    resolved_path = map_path or MAP_PATH
+    if map_path is None:
+        return list(_load_default_command_definitions())
+    return _load_command_definitions_from_path(resolved_path)
+
+
+@lru_cache(maxsize=1)
+def _load_default_command_definitions() -> tuple[CommandDefinition, ...]:
+    return tuple(_load_command_definitions_from_path(MAP_PATH))
+
+
+def _load_command_definitions_from_path(resolved_path: Path) -> list[CommandDefinition]:
+    with resolved_path.open(encoding="utf-8", newline="") as file:
+        return [_definition_from_row(row) for row in csv.DictReader(file)]
+
+
+def get_implemented_command(group: str, command: str) -> CommandDefinition:
+    matches = [
+        definition
+        for definition in load_command_definitions()
+        if definition.cli_group == group
+        and definition.cli_command == command
+        and definition.status == "implemented"
+    ]
+    if not matches:
+        raise CliInternalError(f"구현된 명령을 찾을 수 없습니다: kiwoom {group} {command}")
+    if len(matches) > 1:
+        api_ids = ", ".join(definition.api_id for definition in matches)
+        raise CliInternalError(f"구현된 명령 매핑이 중복됩니다: kiwoom {group} {command} ({api_ids})")
+    return matches[0]
+
+
+def get_command_by_path(command_path: str) -> CommandDefinition:
+    matches = [
+        definition
+        for definition in load_command_definitions()
+        if definition.command_path == command_path
+    ]
+    if not matches:
+        raise CliInternalError(f"명령 매핑을 찾을 수 없습니다: {command_path}")
+    if len(matches) > 1:
+        api_ids = ", ".join(definition.api_id for definition in matches)
+        raise CliInternalError(f"명령 경로 매핑이 중복됩니다: {command_path} ({api_ids})")
+    return matches[0]
+
+
+def _definition_from_row(row: dict[str, str]) -> CommandDefinition:
+    return CommandDefinition(
+        api_id=row["api_id"],
+        api_name=row["api_name"],
+        cli_group=row["cli_group"],
+        cli_command=row["cli_command"],
+        command_path=row["command_path"],
+        status=row["status"],
+        coverage_status=row["coverage_status"],
+        safety_policy=row["safety_policy"],
+        method=row["method"],
+        path=row["path"],
+        required_body_fields=_split_fields(row["required_body_fields"]),
+    )
+
+
+def _split_fields(value: str) -> tuple[str, ...]:
+    return tuple(part.strip() for part in value.split(";") if part.strip())

kiwoom_cli/safety.py

@@ -0,0 +1,30 @@
+"""Safety policy checks for CLI command execution."""
+
+from __future__ import annotations
+
+from kiwoom_cli.errors import CliInputError, CliInternalError
+from kiwoom_cli.registry import CommandDefinition
+
+
+def enforce_before_request(definition: CommandDefinition, *, confirm: bool = False) -> None:
+    if definition.coverage_status == "planned":
+        raise CliInternalError(f"{definition.command_path}: 아직 실행 정책과 명령 UX가 확정되지 않은 명령입니다.")
+
+    if definition.safety_policy in {"read", "account_read", "auth_write"}:
+        return
+
+    if definition.coverage_status == "preview-only":
+        raise CliInternalError(f"{definition.command_path}: 미리보기 전용 명령이라 실제 쓰기 요청을 전송할 수 없습니다.")
+
+    if definition.safety_policy == "order_write" and not confirm:
+        raise CliInputError(f"{definition.command_path}: 실제 주문 전송에는 --confirm 옵션이 필요합니다.")
+
+    if definition.safety_policy == "review_required":
+        raise CliInternalError(f"{definition.command_path}: 실행 전에 정책 검토가 필요한 명령입니다.")
+
+
+def enforce_before_preview(definition: CommandDefinition) -> None:
+    if definition.safety_policy != "order_write":
+        raise CliInternalError(f"{definition.command_path}: 요청 미리보기를 지원하지 않는 명령입니다.")
+    if definition.coverage_status not in {"preview-only", "guarded"}:
+        raise CliInternalError(f"{definition.command_path}: 현재 적용 상태에서는 요청 미리보기를 사용할 수 없습니다.")