@2oolkit/kiwoom-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,2049 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/commands/config.ts
+var readline = __toESM(require("readline"));
+
+// src/config/store.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var os = __toESM(require("os"));
+
+// src/config/constants.ts
+var BASE_URLS = {
+  real: "https://api.kiwoom.com",
+  mock: "https://mockapi.kiwoom.com"
+};
+var ENV_ALIASES = {
+  real: "real",
+  prod: "real",
+  production: "real",
+  live: "real",
+  \uC2E4\uC804: "real",
+  \uC2E4\uC804\uD22C\uC790: "real",
+  mock: "mock",
+  test: "mock",
+  paper: "mock",
+  demo: "mock",
+  \uBAA8\uC758: "mock",
+  \uBAA8\uC758\uD22C\uC790: "mock"
+};
+var TOKEN_PATH = "/oauth2/token";
+var REVOKE_PATH = "/oauth2/revoke";
+var CONFIG_DIR_NAME = ".kiwoom-cli";
+var CONFIG_FILE_NAME = "config.json";
+var TOKEN_FILE_NAME = "token.json";
+var ENV_VARS = {
+  appkey: "KIWOOM_APPKEY",
+  secretkey: "KIWOOM_SECRETKEY",
+  env: "KIWOOM_ENV"
+};
+var TOKEN_REFRESH_BUFFER_MS = 6e4;
+var REQUEST_TIMEOUT_MS = 3e4;
+var SOFT_EMPTY_RETURN_CODES = /* @__PURE__ */ new Set([20]);
+var ORDER_EXCHANGE_TYPES = ["KRX", "NXT", "SOR"];
+var ACCOUNT_EXCHANGE_TYPES = ["KRX", "NXT", "%"];
+var ORDER_TYPES = {
+  "0": "\uBCF4\uD1B5(\uC9C0\uC815\uAC00/limit)",
+  "3": "\uC2DC\uC7A5\uAC00(market)",
+  "5": "\uC870\uAC74\uBD80\uC9C0\uC815\uAC00",
+  "6": "\uCD5C\uC720\uB9AC\uC9C0\uC815\uAC00",
+  "7": "\uCD5C\uC6B0\uC120\uC9C0\uC815\uAC00",
+  "10": "\uBCF4\uD1B5(IOC)",
+  "13": "\uC2DC\uC7A5\uAC00(IOC)",
+  "16": "\uCD5C\uC720\uB9AC(IOC)",
+  "20": "\uBCF4\uD1B5(FOK)",
+  "23": "\uC2DC\uC7A5\uAC00(FOK)",
+  "26": "\uCD5C\uC720\uB9AC(FOK)",
+  "28": "\uC2A4\uD1B1\uC9C0\uC815\uAC00(stop-limit)",
+  "29": "\uC911\uAC04\uAC00",
+  "30": "\uC911\uAC04\uAC00(IOC)",
+  "31": "\uC911\uAC04\uAC00(FOK)",
+  "61": "\uC7A5\uC2DC\uC791\uC804\uC2DC\uAC04\uC678",
+  "62": "\uC2DC\uAC04\uC678\uB2E8\uC77C\uAC00",
+  "81": "\uC7A5\uB9C8\uAC10\uD6C4\uC2DC\uAC04\uC678"
+};
+var MARKET_ORDER_TYPES = /* @__PURE__ */ new Set(["3", "13", "23"]);
+
+// src/config/store.ts
+var DEFAULT_CONFIG = { env: "real" };
+function getConfigDir() {
+  return path.join(os.homedir(), CONFIG_DIR_NAME);
+}
+function getConfigPath() {
+  return path.join(getConfigDir(), CONFIG_FILE_NAME);
+}
+function getTokenPath() {
+  return path.join(getConfigDir(), TOKEN_FILE_NAME);
+}
+function ensureConfigDir() {
+  const dir = getConfigDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { mode: 448, recursive: true });
+  } else {
+    try {
+      fs.chmodSync(dir, 448);
+    } catch {
+    }
+  }
+}
+function writeSecure(filePath, data) {
+  fs.writeFileSync(filePath, data, { mode: 384 });
+  try {
+    fs.chmodSync(filePath, 384);
+  } catch {
+  }
+}
+function loadConfig() {
+  try {
+    const raw = fs.readFileSync(getConfigPath(), "utf-8");
+    return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+function saveConfig(partial) {
+  ensureConfigDir();
+  const current = loadConfig();
+  const merged = { ...current, ...partial };
+  writeSecure(getConfigPath(), JSON.stringify(merged, null, 2));
+}
+function getEffectiveConfig() {
+  const disk = loadConfig();
+  const envVal = process.env[ENV_VARS.env];
+  const env = envVal && ENV_ALIASES[envVal.toLowerCase()] ? ENV_ALIASES[envVal.toLowerCase()] : disk.env;
+  return {
+    env,
+    appkey: disk.appkey ?? process.env[ENV_VARS.appkey],
+    secretkey: disk.secretkey ?? process.env[ENV_VARS.secretkey]
+  };
+}
+function maskSecret(value) {
+  if (!value) return "(not set)";
+  if (value.length <= 10) return "****";
+  return value.slice(0, 6) + "..." + value.slice(-4);
+}
+function loadTokenCache() {
+  try {
+    return JSON.parse(fs.readFileSync(getTokenPath(), "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function getCachedToken(env) {
+  return loadTokenCache()[env];
+}
+function saveCachedToken(env, token) {
+  ensureConfigDir();
+  const cache = loadTokenCache();
+  cache[env] = token;
+  writeSecure(getTokenPath(), JSON.stringify(cache, null, 2));
+}
+function clearCachedToken(env) {
+  if (!env) {
+    try {
+      fs.rmSync(getTokenPath());
+    } catch {
+    }
+    return;
+  }
+  const cache = loadTokenCache();
+  delete cache[env];
+  try {
+    ensureConfigDir();
+    writeSecure(getTokenPath(), JSON.stringify(cache, null, 2));
+  } catch {
+  }
+}
+
+// src/output/error.ts
+var ActionableError = class extends Error {
+  suggestedCommand;
+  constructor(message, suggestedCommand) {
+    super(message);
+    this.name = "ActionableError";
+    this.suggestedCommand = suggestedCommand;
+  }
+};
+var KiwoomApiError = class extends Error {
+  returnCode;
+  returnMsg;
+  apiId;
+  constructor(returnCode, returnMsg, apiId) {
+    super(`[${returnCode}] ${returnMsg}`);
+    this.name = "KiwoomApiError";
+    this.returnCode = returnCode;
+    this.returnMsg = returnMsg;
+    this.apiId = apiId;
+  }
+};
+function handleError(err) {
+  if (err instanceof ActionableError) {
+    console.error(`
+Error: ${err.message}`);
+    if (err.suggestedCommand) {
+      console.error(`
+Try: ${err.suggestedCommand}`);
+    }
+    process.exit(1);
+  }
+  if (err instanceof KiwoomApiError) {
+    console.error(`
+Error: ${err.returnMsg} (code ${err.returnCode})`);
+    if (isAuthError(err.returnMsg) || err.returnCode === 3) {
+      console.error(`
+Try: kiwoom-cli config init`);
+    }
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    let message = err.message;
+    if (message.length > 500) {
+      message = message.slice(0, 500) + "...";
+    }
+    if (isAuthError(message)) {
+      console.error(`
+Error: ${message}`);
+      console.error(`
+Try: kiwoom-cli config init`);
+      process.exit(1);
+    }
+    console.error(`
+Error: ${message}`);
+    process.exit(1);
+  }
+  console.error(`
+Unknown error:`, err);
+  process.exit(1);
+}
+function isAuthError(message) {
+  return /unauthorized|forbidden|not authenticated|토큰|인증|appkey|access token|만료/i.test(
+    message
+  );
+}
+
+// src/utils/helpers.ts
+function parseIntStrict(value, name) {
+  const n = parseInt(value, 10);
+  if (Number.isNaN(n)) {
+    throw new Error(`Invalid ${name}: "${value}" is not a valid integer`);
+  }
+  return n;
+}
+function normalizeStockCode(code) {
+  const trimmed = code.trim().toUpperCase();
+  const stripped = trimmed.replace(/^A(?=\d)/, "");
+  const base = stripped.split("_")[0];
+  if (!/^\d{6}$/.test(base)) {
+    throw new ActionableError(
+      `Invalid stock code "${code}". Expected a 6-digit code like 005930 (\uC0BC\uC131\uC804\uC790).`
+    );
+  }
+  return base;
+}
+function parseKiwoomExpiry(expiresDt) {
+  const m = expiresDt.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/);
+  if (!m) return NaN;
+  const [, y, mo, d, h, mi, s] = m;
+  return Date.parse(`${y}-${mo}-${d}T${h}:${mi}:${s}+09:00`);
+}
+function isTokenExpired(expiresDt, bufferMs = 0) {
+  const expiry = parseKiwoomExpiry(expiresDt);
+  if (Number.isNaN(expiry)) return true;
+  return Date.now() + bufferMs >= expiry;
+}
+function todayKst() {
+  const now = new Date(Date.now() + 9 * 3600 * 1e3);
+  return now.toISOString().slice(0, 10).replace(/-/g, "");
+}
+
+// src/client/api-client.ts
+function fetchWithTimeout(url, init) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  return fetch(url, { ...init, signal: controller.signal }).finally(
+    () => clearTimeout(timeoutId)
+  );
+}
+var KiwoomClient = class {
+  env;
+  baseUrl;
+  appkey;
+  secretkey;
+  tokenOverride;
+  memoToken;
+  constructor(opts) {
+    this.env = opts.env;
+    this.baseUrl = BASE_URLS[opts.env];
+    if (!this.baseUrl) {
+      throw new Error(`Invalid environment: ${opts.env}. Use: real, mock`);
+    }
+    this.appkey = opts.appkey;
+    this.secretkey = opts.secretkey;
+    this.tokenOverride = opts.token;
+  }
+  getEnv() {
+    return this.env;
+  }
+  /** Ensure a valid token exists (issuing + caching as needed) and return it. */
+  async authenticate() {
+    return this.getToken();
+  }
+  // ─── OAuth2 ───────────────────────────────────────────────────────────────
+  /** Issue a fresh access token from the app key + secret key. */
+  async issueToken() {
+    if (!this.appkey || !this.secretkey) {
+      throw new ActionableError(
+        "App key and secret key are required to issue a token.",
+        "kiwoom-cli config init"
+      );
+    }
+    const res = await fetchWithTimeout(`${this.baseUrl}${TOKEN_PATH}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json;charset=UTF-8" },
+      body: JSON.stringify({
+        grant_type: "client_credentials",
+        appkey: this.appkey,
+        secretkey: this.secretkey
+      })
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body.return_code !== 0 || !body.token) {
+      throw new KiwoomApiError(
+        body.return_code ?? res.status,
+        body.return_msg ?? `Token request failed (HTTP ${res.status})`
+      );
+    }
+    return { token: body.token, expiresDt: body.expires_dt };
+  }
+  /** Revoke an access token (defaults to the cached/override token). */
+  async revokeToken(token) {
+    if (!this.appkey || !this.secretkey) {
+      throw new ActionableError(
+        "App key and secret key are required to revoke a token.",
+        "kiwoom-cli config init"
+      );
+    }
+    const target = token ?? this.tokenOverride ?? getCachedToken(this.env)?.token;
+    if (!target) {
+      throw new ActionableError("No token to revoke.");
+    }
+    const res = await fetchWithTimeout(`${this.baseUrl}${REVOKE_PATH}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json;charset=UTF-8" },
+      body: JSON.stringify({
+        appkey: this.appkey,
+        secretkey: this.secretkey,
+        token: target
+      })
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body.return_code !== 0) {
+      throw new KiwoomApiError(
+        body.return_code ?? res.status,
+        body.return_msg ?? `Token revoke failed (HTTP ${res.status})`
+      );
+    }
+    clearCachedToken(this.env);
+    return body;
+  }
+  /**
+   * Return a valid token, reusing the cache when possible and issuing+caching a
+   * new one when missing or near expiry.
+   */
+  async getToken() {
+    if (this.tokenOverride) return this.tokenOverride;
+    if (this.memoToken) return this.memoToken;
+    const cached = getCachedToken(this.env);
+    const hint = this.appkey?.slice(0, 6);
+    if (cached && cached.appkeyHint === hint && !isTokenExpired(cached.expiresDt, TOKEN_REFRESH_BUFFER_MS)) {
+      this.memoToken = cached.token;
+      return cached.token;
+    }
+    const { token, expiresDt } = await this.issueToken();
+    this.memoToken = token;
+    if (hint) {
+      saveCachedToken(this.env, { token, expiresDt, appkeyHint: hint });
+    }
+    return token;
+  }
+  // ─── Generic TR request ──────────────────────────────────────────────────
+  /**
+   * Execute a TR. `apiId` is sent in the api-id header; `path` is the category
+   * route (e.g. /api/dostk/stkinfo). Returns the parsed body plus pagination.
+   */
+  async request(apiId, path2, body = {}, options = {}) {
+    const send = async (token) => fetchWithTimeout(`${this.baseUrl}${path2}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json;charset=UTF-8",
+        authorization: `Bearer ${token}`,
+        "api-id": options.apiId ?? apiId,
+        "cont-yn": options.contYn ?? "N",
+        "next-key": options.nextKey ?? ""
+      },
+      body: JSON.stringify(body)
+    });
+    let res = await send(await this.getToken());
+    if (res.status === 401 && !this.tokenOverride) {
+      clearCachedToken(this.env);
+      this.memoToken = void 0;
+      res = await send(await this.getToken());
+    }
+    const payload = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new KiwoomApiError(
+        payload.return_code ?? res.status,
+        payload.return_msg ?? `Request failed (HTTP ${res.status})`,
+        apiId
+      );
+    }
+    if (typeof payload.return_code === "number" && payload.return_code !== 0 && !SOFT_EMPTY_RETURN_CODES.has(payload.return_code)) {
+      throw new KiwoomApiError(payload.return_code, payload.return_msg ?? "Error", apiId);
+    }
+    return {
+      data: payload,
+      contYn: res.headers.get("cont-yn") === "Y",
+      nextKey: res.headers.get("next-key") ?? ""
+    };
+  }
+  /**
+   * Execute an endpoint from the registry. When `paginate` is set and the
+   * endpoint declares a listKey, all pages are fetched and concatenated.
+   */
+  async callEndpoint(def, body = {}, opts = {}) {
+    if (opts.paginate && def.listKey) {
+      const data = await this.requestAll(def.apiId, def.path, body, def.listKey);
+      return { data, contYn: false, nextKey: "" };
+    }
+    return this.request(def.apiId, def.path, body, {
+      contYn: opts.contYn,
+      nextKey: opts.nextKey
+    });
+  }
+  /**
+   * Fetch all pages of a TR, concatenating the array under `listKey`.
+   * Caps at `maxPages` to avoid runaway loops.
+   */
+  async requestAll(apiId, path2, body, listKey, maxPages = 20) {
+    let page = await this.request(apiId, path2, body);
+    const acc = Array.isArray(page.data[listKey]) ? [...page.data[listKey]] : [];
+    let pages = 1;
+    while (page.contYn && page.nextKey && pages < maxPages) {
+      page = await this.request(apiId, path2, body, {
+        contYn: "Y",
+        nextKey: page.nextKey
+      });
+      if (Array.isArray(page.data[listKey])) acc.push(...page.data[listKey]);
+      pages += 1;
+    }
+    return { ...page.data, [listKey]: acc };
+  }
+};
+
+// src/output/formatter.ts
+function getOutputFormat(options) {
+  return options.output === "json" ? "json" : "table";
+}
+function output(data, format = "table") {
+  if (format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log("No data");
+      return;
+    }
+    if (typeof data[0] === "object" && data[0] !== null) {
+      console.table(data);
+    } else {
+      for (const item of data) console.log(`  ${String(item)}`);
+    }
+    return;
+  }
+  if (data !== null && typeof data === "object") {
+    const entries = Object.entries(data);
+    if (entries.length === 0) {
+      console.log("No data");
+      return;
+    }
+    const maxKeyLen = Math.max(...entries.map(([k]) => k.length));
+    for (const [key, value] of entries) {
+      const displayValue = value !== null && typeof value === "object" ? JSON.stringify(value) : String(value);
+      console.log(`  ${key.padEnd(maxKeyLen + 2)} ${displayValue}`);
+    }
+    return;
+  }
+  console.log(String(data));
+}
+
+// src/commands/config.ts
+function prompt(question, hidden = false) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    if (hidden) {
+      process.stdout.write(question);
+      const stdin = process.stdin;
+      const wasRaw = stdin.isRaw;
+      if (stdin.isTTY) stdin.setRawMode(true);
+      let input = "";
+      const onData = (char) => {
+        const c = char.toString();
+        const code = char[0];
+        if (c === "\n" || c === "\r") {
+          stdin.removeListener("data", onData);
+          if (stdin.isTTY) stdin.setRawMode(wasRaw ?? false);
+          process.stdout.write("\n");
+          rl.close();
+          resolve(input);
+        } else if (code === 3) {
+          process.exit(0);
+        } else if (code === 127 || code === 8) {
+          if (input.length > 0) {
+            input = input.slice(0, -1);
+            process.stdout.write("\b \b");
+          }
+        } else {
+          input += c;
+          process.stdout.write("*");
+        }
+      };
+      stdin.on("data", onData);
+    } else {
+      rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer.trim());
+      });
+    }
+  });
+}
+async function verifyAndCacheToken(env, appkey, secretkey) {
+  try {
+    const client = new KiwoomClient({ env, appkey, secretkey });
+    await client.authenticate();
+    console.log("Access token issued and cached.");
+  } catch (err) {
+    console.error(
+      `
+Keys saved, but token issuance failed: ${err instanceof Error ? err.message : String(err)}`
+    );
+    console.error("Double-check the app key / secret key and environment.");
+  }
+}
+function registerConfigCommands(program2) {
+  const configCmd = program2.command("config").description("Manage CLI configuration (keys, environment)");
+  configCmd.command("init").description("Interactive setup wizard").action(async () => {
+    try {
+      console.log("Kiwoom CLI Setup\n");
+      const envInput = await prompt("Environment (real/mock) [real]: ");
+      const env = ENV_ALIASES[envInput.toLowerCase()] ?? "real";
+      const appkey = await prompt("App key: ");
+      if (!appkey) {
+        console.error("App key is required.");
+        process.exit(1);
+      }
+      const secretkey = await prompt("Secret key: ", true);
+      if (!secretkey) {
+        console.error("Secret key is required.");
+        process.exit(1);
+      }
+      saveConfig({ env, appkey, secretkey });
+      console.log("\nConfiguration saved to ~/.kiwoom-cli/config.json");
+      if (env === "real") {
+        console.log('NOTE: "real" places live orders with real money. Use "mock" to practice.');
+      }
+      await verifyAndCacheToken(env, appkey, secretkey);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  configCmd.command("set").description("Set configuration values").option("--env <environment>", "Environment (real/mock)").option("--appkey <key>", "Kiwoom app key").option("--secretkey <key>", "Kiwoom secret key").action(async (options) => {
+    try {
+      const updates = {};
+      if (options.env) {
+        const resolved = ENV_ALIASES[options.env.toLowerCase()];
+        if (!resolved) {
+          console.error(`Unknown environment: ${options.env}. Use: real, mock`);
+          process.exit(1);
+        }
+        updates.env = resolved;
+      }
+      if (options.appkey) updates.appkey = options.appkey;
+      if (options.secretkey) updates.secretkey = options.secretkey;
+      if (Object.keys(updates).length === 0) {
+        console.log("No values to set. Use --env, --appkey, or --secretkey");
+        return;
+      }
+      saveConfig(updates);
+      console.log("Configuration updated.");
+      const cfg = getEffectiveConfig();
+      if ((updates.appkey || updates.secretkey) && cfg.appkey && cfg.secretkey) {
+        await verifyAndCacheToken(cfg.env, cfg.appkey, cfg.secretkey);
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  configCmd.command("get <key>").description("Get a configuration value (env, appkey, secretkey)").action((key) => {
+    try {
+      const config = getEffectiveConfig();
+      const value = config[key];
+      if (value === void 0) {
+        console.log(`Key "${key}" not found. Available: env, appkey, secretkey`);
+      } else if (key === "secretkey" || key === "appkey") {
+        console.log(maskSecret(value));
+      } else {
+        console.log(String(value));
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  configCmd.command("list").description("Show all configuration").option("-o, --output <format>", "Output format (table/json)", "table").action((options) => {
+    try {
+      const config = getEffectiveConfig();
+      output(
+        {
+          env: config.env,
+          appkey: maskSecret(config.appkey),
+          secretkey: maskSecret(config.secretkey)
+        },
+        getOutputFormat(options)
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/_helpers.ts
+function createClient() {
+  const config = getEffectiveConfig();
+  if (!config.appkey || !config.secretkey) {
+    throw new ActionableError(
+      "App key / secret key are not configured.",
+      "kiwoom-cli config init"
+    );
+  }
+  return new KiwoomClient({
+    env: config.env,
+    appkey: config.appkey,
+    secretkey: config.secretkey
+  });
+}
+
+// src/utils/format.ts
+var NUMERIC_RE = /^([+-]*)0*(\d+)(\.\d+)?$/;
+function unpad(value) {
+  if (value === null || value === void 0) return "";
+  const str = String(value).trim();
+  const m = str.match(NUMERIC_RE);
+  if (!m) return str;
+  const sign = m[1].includes("-") ? "-" : m[1].includes("+") ? "+" : "";
+  const intPart = m[2].replace(/^0+(?=\d)/, "");
+  return `${sign}${intPart}${m[3] ?? ""}`;
+}
+function toNumber(value) {
+  if (value === null || value === void 0 || value === "") return NaN;
+  const cleaned = unpad(value).replace(/^\+/, "");
+  if (cleaned === "" || cleaned === "-" || cleaned === "+") return NaN;
+  const n = Number(cleaned);
+  return Number.isNaN(n) ? NaN : n;
+}
+function withCommas(value) {
+  const m = value.match(/^([+-]?)(\d+)(\.\d+)?$/);
+  if (!m) return value;
+  const grouped = m[2].replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  return `${m[1]}${grouped}${m[3] ?? ""}`;
+}
+function won(value) {
+  return withCommas(unpad(value));
+}
+function price(value) {
+  return withCommas(unpad(value).replace(/^[+-]/, ""));
+}
+function formatStamp(value) {
+  if (!value) return "";
+  const s = String(value).trim();
+  if (/^\d{14}$/.test(s)) {
+    return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)} ${s.slice(8, 10)}:${s.slice(10, 12)}:${s.slice(12, 14)}`;
+  }
+  if (/^\d{8}$/.test(s)) {
+    return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}`;
+  }
+  if (/^\d{6}$/.test(s)) {
+    return `${s.slice(0, 2)}:${s.slice(2, 4)}:${s.slice(4, 6)}`;
+  }
+  return s;
+}
+function formatFields(row, formatters) {
+  const out = { ...row };
+  for (const [key, fn] of Object.entries(formatters)) {
+    if (fn && out[key] !== void 0 && out[key] !== null) {
+      out[key] = fn(String(out[key]));
+    }
+  }
+  return out;
+}
+
+// src/commands/auth.ts
+function registerAuthCommands(program2) {
+  const authCmd = program2.command("auth").description("Access-token management (OAuth2)");
+  authCmd.command("token").description("Issue (or reuse) an access token and cache it").option("--force", "Force a fresh token even if a valid one is cached").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const cfg = getEffectiveConfig();
+      const client = createClient();
+      if (options.force) clearCachedToken(cfg.env);
+      await client.authenticate();
+      const cached = getCachedToken(cfg.env);
+      output(
+        {
+          env: cfg.env,
+          token: maskSecret(cached?.token),
+          expiresAt: formatStamp(cached?.expiresDt),
+          valid: cached ? !isTokenExpired(cached.expiresDt) : false
+        },
+        getOutputFormat(options)
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  authCmd.command("status").description("Show the cached token status").option("-o, --output <format>", "Output format (table/json)", "table").action((options) => {
+    try {
+      const cfg = getEffectiveConfig();
+      const cached = getCachedToken(cfg.env);
+      if (!cached) {
+        output({ env: cfg.env, cached: false }, getOutputFormat(options));
+        return;
+      }
+      output(
+        {
+          env: cfg.env,
+          cached: true,
+          token: maskSecret(cached.token),
+          expiresAt: formatStamp(cached.expiresDt),
+          valid: !isTokenExpired(cached.expiresDt)
+        },
+        getOutputFormat(options)
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  authCmd.command("revoke").description("Revoke the cached access token").action(async () => {
+    try {
+      const cfg = getEffectiveConfig();
+      const cached = getCachedToken(cfg.env);
+      if (!cached) {
+        throw new ActionableError("No cached token to revoke.", "kiwoom-cli auth token");
+      }
+      const client = createClient();
+      await client.revokeToken(cached.token);
+      console.log("Token revoked and cache cleared.");
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/client/endpoints.ts
+var PATHS = {
+  stkinfo: "/api/dostk/stkinfo",
+  mrkcond: "/api/dostk/mrkcond",
+  chart: "/api/dostk/chart",
+  acnt: "/api/dostk/acnt",
+  ordr: "/api/dostk/ordr",
+  crdordr: "/api/dostk/crdordr",
+  rkinfo: "/api/dostk/rkinfo",
+  sect: "/api/dostk/sect"
+};
+var ENDPOINTS = {
+  // ── Stock info (종목정보) ──────────────────────────────────────────────────
+  stockInfo: { apiId: "ka10001", path: PATHS.stkinfo, korean: "\uC8FC\uC2DD\uAE30\uBCF8\uC815\uBCF4\uC694\uCCAD" },
+  tradingMembers: { apiId: "ka10002", path: PATHS.stkinfo, korean: "\uC8FC\uC2DD\uAC70\uB798\uC6D0\uC694\uCCAD" },
+  stockTrades: { apiId: "ka10003", path: PATHS.stkinfo, korean: "\uCCB4\uACB0\uC815\uBCF4\uC694\uCCAD", listKey: "cntr_infr" },
+  watchlist: { apiId: "ka10095", path: PATHS.stkinfo, korean: "\uAD00\uC2EC\uC885\uBAA9\uC815\uBCF4\uC694\uCCAD", listKey: "atn_stk_infr" },
+  stockList: { apiId: "ka10099", path: PATHS.stkinfo, korean: "\uC885\uBAA9\uC815\uBCF4 \uB9AC\uC2A4\uD2B8", listKey: "list" },
+  stockInfoSingle: { apiId: "ka10100", path: PATHS.stkinfo, korean: "\uC885\uBAA9\uC815\uBCF4 \uC870\uD68C" },
+  sectorCodeList: { apiId: "ka10101", path: PATHS.stkinfo, korean: "\uC5C5\uC885\uCF54\uB4DC \uB9AC\uC2A4\uD2B8", listKey: "list" },
+  creditTrend: { apiId: "ka10013", path: PATHS.stkinfo, korean: "\uC2E0\uC6A9\uB9E4\uB9E4\uB3D9\uD5A5\uC694\uCCAD", listKey: "crd_trde_trend" },
+  // ── Market quote (시세) ────────────────────────────────────────────────────
+  orderbook: { apiId: "ka10004", path: PATHS.mrkcond, korean: "\uC8FC\uC2DD\uD638\uAC00\uC694\uCCAD" },
+  quoteSnapshot: { apiId: "ka10006", path: PATHS.mrkcond, korean: "\uC8FC\uC2DD\uC2DC\uBD84\uC694\uCCAD" },
+  priceTableInfo: { apiId: "ka10007", path: PATHS.mrkcond, korean: "\uC2DC\uC138\uD45C\uC131\uC815\uBCF4\uC694\uCCAD" },
+  dailyPrice: { apiId: "ka10086", path: PATHS.mrkcond, korean: "\uC77C\uBCC4\uC8FC\uAC00\uC694\uCCAD", listKey: "daly_stkpc" },
+  instTradedStocks: { apiId: "ka10044", path: PATHS.mrkcond, korean: "\uC77C\uBCC4\uAE30\uAD00\uB9E4\uB9E4\uC885\uBAA9\uC694\uCCAD", listKey: "daly_orgn_trde_stk" },
+  instForeignTrend: { apiId: "ka10045", path: PATHS.mrkcond, korean: "\uC885\uBAA9\uBCC4\uAE30\uAD00\uB9E4\uB9E4\uCD94\uC774\uC694\uCCAD", listKey: "stk_orgn_trde_trnsn" },
+  strengthByTime: { apiId: "ka10046", path: PATHS.mrkcond, korean: "\uCCB4\uACB0\uAC15\uB3C4\uC2DC\uAC04\uBCC4\uC694\uCCAD", listKey: "cntr_str_tm" },
+  strengthByDay: { apiId: "ka10047", path: PATHS.mrkcond, korean: "\uCCB4\uACB0\uAC15\uB3C4\uC77C\uBCC4\uC694\uCCAD", listKey: "cntr_str_daly" },
+  afterHoursOrderbook: { apiId: "ka10087", path: PATHS.mrkcond, korean: "\uC2DC\uAC04\uC678\uB2E8\uC77C\uAC00\uC694\uCCAD" },
+  // ── Chart (차트) ───────────────────────────────────────────────────────────
+  tickChart: { apiId: "ka10079", path: PATHS.chart, korean: "\uC8FC\uC2DD\uD2F1\uCC28\uD2B8\uC870\uD68C", listKey: "stk_tic_chart_qry" },
+  minuteChart: { apiId: "ka10080", path: PATHS.chart, korean: "\uC8FC\uC2DD\uBD84\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_min_pole_chart_qry" },
+  dailyChart: { apiId: "ka10081", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC77C\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_dt_pole_chart_qry" },
+  // NOTE: weekly list key is the doubled "stk_stk_..." — verified live, not a typo.
+  weeklyChart: { apiId: "ka10082", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC8FC\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_stk_pole_chart_qry" },
+  monthlyChart: { apiId: "ka10083", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC6D4\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_mth_pole_chart_qry" },
+  yearlyChart: { apiId: "ka10094", path: PATHS.chart, korean: "\uC8FC\uC2DD\uB144\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_yr_pole_chart_qry" },
+  // ── Account (계좌) ─────────────────────────────────────────────────────────
+  balance: { apiId: "kt00018", path: PATHS.acnt, korean: "\uACC4\uC88C\uD3C9\uAC00\uC794\uACE0\uB0B4\uC5ED\uC694\uCCAD", listKey: "acnt_evlt_remn_indv_tot" },
+  deposit: { apiId: "kt00001", path: PATHS.acnt, korean: "\uC608\uC218\uAE08\uC0C1\uC138\uD604\uD669\uC694\uCCAD", listKey: "stk_entr_prst" },
+  evalStatus: { apiId: "kt00004", path: PATHS.acnt, korean: "\uACC4\uC88C\uD3C9\uAC00\uD604\uD669\uC694\uCCAD", listKey: "stk_acnt_evlt_prst" },
+  settledBalance: { apiId: "kt00005", path: PATHS.acnt, korean: "\uCCB4\uACB0\uC794\uACE0\uC694\uCCAD", listKey: "stk_cntr_remn" },
+  orderDetail: { apiId: "kt00007", path: PATHS.acnt, korean: "\uACC4\uC88C\uBCC4\uC8FC\uBB38\uCCB4\uACB0\uB0B4\uC5ED\uC0C1\uC138\uC694\uCCAD", listKey: "acnt_ord_cntr_prps_dtl" },
+  orderStatus: { apiId: "kt00009", path: PATHS.acnt, korean: "\uACC4\uC88C\uBCC4\uC8FC\uBB38\uCCB4\uACB0\uD604\uD669\uC694\uCCAD", listKey: "acnt_ord_cntr_prst" },
+  openOrders: { apiId: "ka10075", path: PATHS.acnt, korean: "\uBBF8\uCCB4\uACB0\uC694\uCCAD", listKey: "oso" },
+  executions: { apiId: "ka10076", path: PATHS.acnt, korean: "\uCCB4\uACB0\uC694\uCCAD", listKey: "cntr" },
+  realizedPlByDate: { apiId: "ka10072", path: PATHS.acnt, korean: "\uC77C\uC790\uBCC4\uC885\uBAA9\uBCC4\uC2E4\uD604\uC190\uC775\uC694\uCCAD_\uC77C\uC790", listKey: "dt_stk_div_rlzt_pl" },
+  realizedPlByPeriod: { apiId: "ka10073", path: PATHS.acnt, korean: "\uC77C\uC790\uBCC4\uC885\uBAA9\uBCC4\uC2E4\uD604\uC190\uC775\uC694\uCCAD_\uAE30\uAC04", listKey: "dt_stk_rlzt_pl" },
+  tradeJournal: { apiId: "ka10170", path: PATHS.acnt, korean: "\uB2F9\uC77C\uB9E4\uB9E4\uC77C\uC9C0\uC694\uCCAD", listKey: "tdy_trde_diary" },
+  dailyReturn: { apiId: "kt00016", path: PATHS.acnt, korean: "\uC77C\uBCC4\uACC4\uC88C\uC218\uC775\uB960\uC0C1\uC138\uD604\uD669\uC694\uCCAD" },
+  // ── Order (주문) — WRITE, real money ──────────────────────────────────────
+  buy: { apiId: "kt10000", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uB9E4\uC218\uC8FC\uBB38", isWrite: true },
+  sell: { apiId: "kt10001", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uB9E4\uB3C4\uC8FC\uBB38", isWrite: true },
+  modify: { apiId: "kt10002", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uC815\uC815\uC8FC\uBB38", isWrite: true },
+  cancel: { apiId: "kt10003", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uCDE8\uC18C\uC8FC\uBB38", isWrite: true },
+  creditBuy: { apiId: "kt10006", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uB9E4\uC218\uC8FC\uBB38", isWrite: true },
+  creditSell: { apiId: "kt10007", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uB9E4\uB3C4\uC8FC\uBB38", isWrite: true },
+  creditModify: { apiId: "kt10008", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uC815\uC815\uC8FC\uBB38", isWrite: true },
+  creditCancel: { apiId: "kt10009", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uCDE8\uC18C\uC8FC\uBB38", isWrite: true },
+  // ── Ranking (순위정보) ─────────────────────────────────────────────────────
+  rankFluctuation: { apiId: "ka10027", path: PATHS.rkinfo, korean: "\uC804\uC77C\uB300\uBE44\uB4F1\uB77D\uB960\uC21C\uC704\uC694\uCCAD", listKey: "pred_pre_flu_rt_upper" },
+  rankVolume: { apiId: "ka10030", path: PATHS.rkinfo, korean: "\uB2F9\uC77C\uAC70\uB798\uB7C9\uC0C1\uC704\uC694\uCCAD", listKey: "tdy_trde_qty_upper" },
+  rankTradeAmount: { apiId: "ka10032", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB300\uAE08\uC0C1\uC704\uC694\uCCAD", listKey: "trde_prica_upper" },
+  rankVolumeSurge: { apiId: "ka10023", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB7C9\uAE09\uC99D\uC694\uCCAD", listKey: "trde_qty_sdnin" },
+  rankPrevVolume: { apiId: "ka10031", path: PATHS.rkinfo, korean: "\uC804\uC77C\uAC70\uB798\uB7C9\uC0C1\uC704\uC694\uCCAD", listKey: "pred_trde_qty_upper" },
+  // ── Sector / industry (업종) ───────────────────────────────────────────────
+  sectorPrice: { apiId: "ka20001", path: PATHS.sect, korean: "\uC5C5\uC885\uD604\uC7AC\uAC00\uC694\uCCAD", listKey: "inds_cur_prc_tm" },
+  sectorStocks: { apiId: "ka20002", path: PATHS.sect, korean: "\uC5C5\uC885\uBCC4\uC8FC\uAC00\uC694\uCCAD", listKey: "inds_stkpc" },
+  sectorAllIndex: { apiId: "ka20003", path: PATHS.sect, korean: "\uC804\uC5C5\uC885\uC9C0\uC218\uC694\uCCAD", listKey: "all_inds_idex" },
+  sectorDaily: { apiId: "ka20009", path: PATHS.sect, korean: "\uC5C5\uC885\uD604\uC7AC\uAC00 \uC77C\uBCC4\uC694\uCCAD", listKey: "inds_cur_prc_daly_rept" }
+};
+
+// src/utils/orderbook.ts
+function parseOrderbook(d) {
+  const asks = [];
+  for (let n = 10; n >= 2; n--) {
+    asks.push({
+      level: n,
+      price: unpad(d[`sel_${n}th_pre_bid`]),
+      qty: unpad(d[`sel_${n}th_pre_req`])
+    });
+  }
+  asks.push({ level: 1, price: unpad(d.sel_fpr_bid), qty: unpad(d.sel_fpr_req) });
+  const bids = [];
+  bids.push({ level: 1, price: unpad(d.buy_fpr_bid), qty: unpad(d.buy_fpr_req) });
+  for (let n = 2; n <= 10; n++) {
+    bids.push({
+      level: n,
+      price: unpad(d[`buy_${n}th_pre_bid`]),
+      qty: unpad(d[`buy_${n}th_pre_req`])
+    });
+  }
+  return {
+    baseTime: formatStamp(d.bid_req_base_tm),
+    asks,
+    bids,
+    totalAskQty: unpad(d.tot_sel_req),
+    totalBidQty: unpad(d.tot_buy_req)
+  };
+}
+function renderOrderbook(book, title) {
+  const lines = [];
+  lines.push(`
+  Order Book: ${title}   (${book.baseTime})
+`);
+  lines.push("  \u2500\u2500 Asks \u2500\u2500");
+  for (const a of book.asks) {
+    lines.push(`  ${a.price.padStart(12)}  ${a.qty.padStart(12)}`);
+  }
+  lines.push("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  for (const b of book.bids) {
+    lines.push(`  ${b.price.padStart(12)}  ${b.qty.padStart(12)}`);
+  }
+  lines.push("  \u2500\u2500 Bids \u2500\u2500");
+  lines.push(`
+  Total ask qty: ${book.totalAskQty}   Total bid qty: ${book.totalBidQty}
+`);
+  return lines.join("\n");
+}
+
+// src/commands/market.ts
+function registerMarketCommands(program2) {
+  const market = program2.command("market").description("Market data \u2014 prices, quotes, order book, trades");
+  market.command("price <code>").description("Current price snapshot (ka10007)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.priceTableInfo, { stk_cd: stk });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      const chg = Math.abs(toNumber(data.cur_prc)) - Math.abs(toNumber(data.pred_close_pric));
+      output(
+        {
+          name: data.stk_nm,
+          code: data.stk_cd,
+          price: price(data.cur_prc),
+          change: Number.isNaN(chg) ? "" : `${chg > 0 ? "+" : ""}${chg}`,
+          changeRate: `${unpad(data.flu_rt)}%`,
+          open: price(data.open_pric),
+          high: price(data.high_pric),
+          low: price(data.low_pric),
+          volume: won(data.trde_qty),
+          bestAsk: price(data.sel_1bid),
+          bestBid: price(data.buy_1bid),
+          prevClose: price(data.pred_close_pric)
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("orderbook <code>").alias("book").description("10-level bid/ask order book (ka10004)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.orderbook, { stk_cd: stk });
+      if (getOutputFormat(options) === "json") {
+        output(data, "json");
+        return;
+      }
+      console.log(renderOrderbook(parseOrderbook(data), stk));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("after-hours <code>").description("After-hours single-price quotes (ka10087)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.afterHoursOrderbook, { stk_cd: stk });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          price: unpad(data.ovt_sigpric_cur_prc),
+          change: unpad(data.ovt_sigpric_pred_pre),
+          changeRate: `${unpad(data.ovt_sigpric_flu_rt)}%`,
+          volume: won(data.ovt_sigpric_acc_trde_qty),
+          askTotal: won(data.ovt_sigpric_sel_bid_tot_req),
+          bidTotal: won(data.ovt_sigpric_buy_bid_tot_req),
+          baseTime: formatStamp(data.bid_req_base_tm)
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("daily <code>").description("Daily price history (ka10086)").option("-d, --date <yyyymmdd>", "Base date (most recent day)", todayKst()).option("-t, --type <0|1>", "Display type: 0=quantity, 1=amount", "0").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.dailyPrice, {
+        stk_cd: stk,
+        qry_dt: options.date,
+        indc_tp: options.type
+      });
+      emitList(
+        data,
+        ENDPOINTS.dailyPrice.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          date: formatStamp,
+          open_pric: unpad,
+          high_pric: unpad,
+          low_pric: unpad,
+          close_pric: unpad,
+          flu_rt: unpad,
+          trde_qty: won
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("trades <code>").description("Recent tick-by-tick executions (ka10003)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.stockTrades, { stk_cd: stk });
+      emitList(
+        data,
+        ENDPOINTS.stockTrades.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          tm: formatStamp,
+          cur_prc: unpad,
+          pred_pre: unpad,
+          pre_rt: unpad,
+          cntr_trde_qty: unpad,
+          acc_trde_qty: won
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("strength <code>").description("Trade strength (\uCCB4\uACB0\uAC15\uB3C4) time series (ka10046 / ka10047)").option("--daily", "Daily series instead of intraday").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const ep = options.daily ? ENDPOINTS.strengthByDay : ENDPOINTS.strengthByTime;
+      const { data } = await client.callEndpoint(ep, { stk_cd: stk });
+      emitList(
+        data,
+        ep.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          cntr_tm: formatStamp,
+          dt: formatStamp,
+          cur_prc: unpad,
+          flu_rt: unpad,
+          cntr_str: unpad
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  market.command("inst-foreign <code>").description("Per-stock institution/foreigner trading trend (ka10045)").option("-s, --start <yyyymmdd>", "Start date").option("-e, --end <yyyymmdd>", "End date", todayKst()).option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.instForeignTrend, {
+        stk_cd: stk,
+        strt_dt: options.start ?? options.end,
+        end_dt: options.end,
+        orgn_prsm_unp_tp: "0",
+        for_prsm_unp_tp: "0"
+      });
+      emitList(
+        data,
+        ENDPOINTS.instForeignTrend.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          dt: formatStamp,
+          close_pric: unpad,
+          flu_rt: unpad,
+          orgn_daly_nettrde_qty: unpad,
+          for_daly_nettrde_qty: unpad
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+function emitList(data, listKey, fmt, rowFormatter) {
+  if (fmt === "json") {
+    output(data, "json");
+    return;
+  }
+  const rows = Array.isArray(data[listKey]) ? data[listKey] : [];
+  if (rows.length === 0) {
+    console.log("No data");
+    return;
+  }
+  output(rowFormatter ? rows.map(rowFormatter) : rows, "table");
+}
+
+// src/commands/stock.ts
+function registerStockCommands(program2) {
+  const stock = program2.command("stock").description("Stock information \u2014 fundamentals, search, members");
+  stock.command("info <code>").description("Stock fundamentals snapshot (ka10001)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.stockInfo, { stk_cd: stk });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          name: data.stk_nm,
+          code: data.stk_cd,
+          price: price(data.cur_prc),
+          change: unpad(data.pred_pre),
+          changeRate: `${unpad(data.flu_rt)}%`,
+          open: price(data.open_pric),
+          high: price(data.high_pric),
+          low: price(data.low_pric),
+          upperLimit: price(data.upl_pric),
+          lowerLimit: price(data.lst_pric),
+          volume: won(data.trde_qty),
+          per: data.per,
+          eps: data.eps,
+          roe: data.roe,
+          pbr: data.pbr,
+          bps: data.bps,
+          marketCap: won(data.mac),
+          foreignRate: `${unpad(data.for_exh_rt)}%`,
+          high52w: price(data["250hgst"]),
+          low52w: price(data["250lwst"])
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  stock.command("search <keyword>").description("Search the stock list by name or code (ka10099)").option("-m, --market <0|10>", "Market: 0=KOSPI, 10=KOSDAQ", "0").option("-n, --limit <n>", "Maximum rows to return", "30").option("-o, --output <format>", "Output format (table/json)", "table").action(async (keyword, options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(
+        ENDPOINTS.stockList,
+        { mrkt_tp: options.market },
+        { paginate: true }
+      );
+      const fmt = getOutputFormat(options);
+      const limit = parseIntStrict(options.limit, "limit");
+      const needle = keyword.toLowerCase();
+      const list = Array.isArray(data[ENDPOINTS.stockList.listKey]) ? data[ENDPOINTS.stockList.listKey] : [];
+      const filtered = list.filter(
+        (item) => String(item.name ?? "").toLowerCase().includes(needle) || String(item.code ?? "").startsWith(keyword)
+      ).slice(0, limit);
+      if (filtered.length === 0) {
+        console.log("No matches");
+        return;
+      }
+      if (fmt === "json") {
+        output(filtered, "json");
+        return;
+      }
+      const rows = filtered.map((item) => ({
+        code: item.code,
+        name: item.name,
+        market: item.marketName,
+        sector: item.upName,
+        lastPrice: unpad(item.lastPrice)
+      }));
+      output(rows, "table");
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  stock.command("resolve <code>").description("Resolve a single stock's listing metadata (ka10100)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.stockInfoSingle, { stk_cd: stk });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          code: data.code,
+          name: data.name,
+          market: data.marketName,
+          sector: data.upName,
+          sizeTier: data.upSizeName,
+          listedShares: won(data.listCount),
+          lastPrice: unpad(data.lastPrice),
+          state: data.state,
+          nxtEnable: data.nxtEnable
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  stock.command("members <code>").description("Top 5 buy/sell trading members (ka10002)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.tradingMembers, { stk_cd: stk });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      const rows = [];
+      for (let i = 1; i <= 5; i++) {
+        rows.push({
+          rank: i,
+          sellMember: data["sel_trde_ori_nm_" + i],
+          sellQty: unpad(data["sel_trde_qty_" + i]),
+          buyMember: data["buy_trde_ori_nm_" + i],
+          buyQty: unpad(data["buy_trde_qty_" + i])
+        });
+      }
+      output(rows, "table");
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  stock.command("credit-trend <code>").description("Credit trading trend (\uC2E0\uC6A9\uB9E4\uB9E4\uB3D9\uD5A5) (ka10013)").option("-d, --date <yyyymmdd>", "Base date", todayKst()).option("-t, --type <1|2>", "Query type: 1=\uC735\uC790, 2=\uB300\uC8FC", "1").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.creditTrend, {
+        stk_cd: stk,
+        dt: options.date ?? todayKst(),
+        qry_tp: options.type ?? "1"
+      });
+      emitList(
+        data,
+        ENDPOINTS.creditTrend.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          dt: formatStamp,
+          cur_prc: unpad,
+          trde_qty: won,
+          new: won,
+          rpya: won,
+          remn: won
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/chart.ts
+var CHART_ROW_FORMATTERS = {
+  cntr_tm: formatStamp,
+  dt: formatStamp,
+  open_pric: unpad,
+  high_pric: unpad,
+  low_pric: unpad,
+  cur_prc: unpad,
+  trde_qty: won,
+  acc_trde_qty: won,
+  trde_prica: won,
+  pred_pre: unpad,
+  trde_tern_rt: unpad
+};
+function emitChart(data, ep, fmt, count) {
+  if (fmt === "json") {
+    output(data, "json");
+    return;
+  }
+  const all = Array.isArray(data[ep.listKey]) ? data[ep.listKey] : [];
+  if (all.length === 0) {
+    console.log("No data");
+    return;
+  }
+  output(
+    all.slice(0, count).map((row) => formatFields(row, CHART_ROW_FORMATTERS)),
+    "table"
+  );
+}
+function registerChartCommands(program2) {
+  const chart = program2.command("chart").description("OHLC charts \u2014 tick / minute / daily / weekly / monthly / yearly");
+  async function runIntraday(ep, code, ticScope, options) {
+    const client = createClient();
+    const stk = normalizeStockCode(code);
+    const { data } = await client.callEndpoint(ep, {
+      stk_cd: stk,
+      tic_scope: ticScope,
+      upd_stkpc_tp: options.raw ? "0" : "1"
+    });
+    emitChart(data, ep, getOutputFormat(options), parseIntStrict(options.count, "count"));
+  }
+  async function runPeriod(ep, code, baseDt, options) {
+    const client = createClient();
+    const stk = normalizeStockCode(code);
+    const { data } = await client.callEndpoint(ep, {
+      stk_cd: stk,
+      base_dt: baseDt,
+      upd_stkpc_tp: options.raw ? "0" : "1"
+    });
+    emitChart(data, ep, getOutputFormat(options), parseIntStrict(options.count, "count"));
+  }
+  chart.command("tick <code>").description("Tick chart (ka10079)").option("-s, --scope <n>", "Ticks per candle (1/3/5/10/30)", "1").option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runIntraday(ENDPOINTS.tickChart, code, options.scope, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  chart.command("min <code>").alias("minute").description("Minute chart (ka10080)").option("-i, --interval <n>", "Minutes per candle (1/3/5/10/15/30/45/60)", "1").option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runIntraday(ENDPOINTS.minuteChart, code, options.interval, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  chart.command("day <code>").alias("daily").description("Daily chart (ka10081)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runPeriod(ENDPOINTS.dailyChart, code, options.date, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  chart.command("week <code>").description("Weekly chart (ka10082)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runPeriod(ENDPOINTS.weeklyChart, code, options.date, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  chart.command("month <code>").description("Monthly chart (ka10083)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runPeriod(ENDPOINTS.monthlyChart, code, options.date, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  chart.command("year <code>").description("Yearly chart (ka10094)").option("-d, --date <yyyymmdd>", "Base date (most recent candle)", todayKst()).option("-n, --count <n>", "Number of candles to display", "50").option("--raw", "Unadjusted (\uC218\uC815\uC8FC\uAC00 \uBBF8\uBC18\uC601) prices").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      await runPeriod(ENDPOINTS.yearlyChart, code, options.date, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/account.ts
+var pct = (v) => `${unpad(v)}%`;
+function registerAccountCommands(program2) {
+  const account = program2.command("account").alias("acct").description("Account \u2014 balance, deposit, orders, executions, P/L");
+  const exchangeHint = `Exchange filter (${ACCOUNT_EXCHANGE_TYPES.join("/")})`;
+  account.command("balance").description("Account evaluation balance with holdings (kt00018)").option("-x, --exchange <KRX|NXT|%>", exchangeHint, "KRX").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.balance, {
+        qry_tp: "1",
+        dmst_stex_tp: options.exchange || "KRX"
+      });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          totalPurchase: won(data.tot_pur_amt),
+          totalEval: won(data.tot_evlt_amt),
+          evalPnl: won(data.tot_evlt_pl),
+          profitRate: `${unpad(data.tot_prft_rt)}%`,
+          estDepositAsset: won(data.prsm_dpst_aset_amt)
+        },
+        "table"
+      );
+      emitList(data, ENDPOINTS.balance.listKey, "table", (row) => ({
+        code: row.stk_cd,
+        name: row.stk_nm,
+        qty: won(row.rmnd_qty),
+        avgPrice: won(row.pur_pric),
+        curPrice: won(row.cur_prc),
+        evalAmt: won(row.evlt_amt),
+        pnl: won(row.evltv_prft),
+        pnlRate: pct(row.prft_rt),
+        weight: pct(row.poss_rt)
+      }));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("deposit").description("Deposit detail \u2014 cash, orderable, withdrawable (kt00001)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.deposit, { qry_tp: "3" });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          cash: won(data.entr),
+          orderable: won(data.ord_alow_amt),
+          withdrawable: won(data.pymn_alow_amt),
+          d2Deposit: won(data.d2_entra),
+          substitute: won(data.repl_amt)
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("eval").description("Account evaluation status with holdings (kt00004)").option("-x, --exchange <KRX|NXT|%>", exchangeHint, "KRX").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.evalStatus, {
+        qry_tp: "0",
+        dmst_stex_tp: options.exchange || "KRX"
+      });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          accountName: data.acnt_nm,
+          branch: data.brch_nm,
+          deposit: won(data.entr),
+          totalEstimate: won(data.tot_est_amt),
+          assetEval: won(data.aset_evlt_amt),
+          totalPurchase: won(data.tot_pur_amt)
+        },
+        "table"
+      );
+      emitList(data, ENDPOINTS.evalStatus.listKey, "table", (row) => ({
+        code: row.stk_cd,
+        name: row.stk_nm,
+        qty: won(row.rmnd_qty),
+        avgPrice: won(row.avg_prc),
+        curPrice: won(row.cur_prc),
+        evalAmt: won(row.evlt_amt),
+        pnl: won(row.pl_amt),
+        pnlRate: pct(row.pl_rt)
+      }));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("settled").description("Settled (executed) balance (kt00005)").option("-x, --exchange <KRX|NXT|%>", exchangeHint, "KRX").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.settledBalance, {
+        dmst_stex_tp: options.exchange || "KRX"
+      });
+      emitList(data, "stk_cntr_remn", getOutputFormat(options), (row) => ({
+        code: row.stk_cd,
+        name: row.stk_nm,
+        qty: won(row.cur_qty),
+        avgPrice: won(row.buy_uv),
+        curPrice: won(row.cur_prc),
+        evalAmt: won(row.evlt_amt),
+        pnl: won(row.evltv_prft),
+        pnlRate: pct(row.pl_rt)
+      }));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("open-orders").description("Unfilled (open) orders (ka10075)").option("-c, --code <code>", "Filter by stock code").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const body = options.code ? {
+        all_stk_tp: "0",
+        trde_tp: "0",
+        stk_cd: normalizeStockCode(options.code),
+        stex_tp: "0"
+      } : { all_stk_tp: "1", trde_tp: "0", stk_cd: "", stex_tp: "0" };
+      const { data } = await client.callEndpoint(ENDPOINTS.openOrders, body);
+      emitList(
+        data,
+        "oso",
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          stk_nm: (v) => v,
+          ord_no: (v) => v,
+          ord_qty: won,
+          ord_pric: won,
+          oso_qty: won,
+          cur_prc: unpad,
+          tm: formatStamp
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("executions").description("Filled executions (ka10076)").option("-c, --code <code>", "Filter by stock code").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.executions, {
+        stk_cd: options.code ? normalizeStockCode(options.code) : "",
+        qry_tp: options.code ? "1" : "0",
+        sell_tp: "0",
+        ord_no: "",
+        stex_tp: "0"
+      });
+      emitList(
+        data,
+        "cntr",
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          stk_nm: (v) => v,
+          ord_no: (v) => v,
+          cntr_qty: won,
+          cntr_uv: won,
+          ord_uv: won,
+          cnfm_tm: formatStamp
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("order-detail").description("Detailed order/execution history (kt00007)").option("-d, --date <yyyymmdd>", "Order date", "").option("-c, --code <code>", "Filter by stock code").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.orderDetail, {
+        ord_dt: options.date || "",
+        qry_tp: "1",
+        stk_bond_tp: "0",
+        sell_tp: "0",
+        stk_cd: options.code ? normalizeStockCode(options.code) : "",
+        fr_ord_no: "",
+        dmst_stex_tp: "%"
+      });
+      emitList(data, "acnt_ord_cntr_prps_dtl", getOutputFormat(options));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("pnl <code>").description("Realized profit/loss by date or period (ka10072 / ka10073)").option("-s, --start <yyyymmdd>", "Start date").option("-e, --end <yyyymmdd>", "End date (enables period query, max 3 months)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (code, options) => {
+    try {
+      const client = createClient();
+      const stk = normalizeStockCode(code);
+      const ep = options.end ? ENDPOINTS.realizedPlByPeriod : ENDPOINTS.realizedPlByDate;
+      const body = options.end ? { stk_cd: stk, strt_dt: options.start || options.end, end_dt: options.end } : { stk_cd: stk, strt_dt: options.start || todayKst() };
+      const { data } = await client.callEndpoint(ep, body);
+      emitList(
+        data,
+        ep.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          dt: formatStamp,
+          stk_nm: (v) => v,
+          cntr_qty: won,
+          buy_uv: won,
+          cntr_pric: won,
+          tdy_sel_pl: won,
+          pl_rt: unpad
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("journal").description("Today's trading journal with totals (ka10170)").option("-d, --date <yyyymmdd>", "Base date", "").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.tradeJournal, {
+        base_dt: options.date || "",
+        ottks_tp: "1",
+        ch_crd_tp: "0"
+      });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          totalSell: won(data.tot_sell_amt),
+          totalBuy: won(data.tot_buy_amt),
+          commissionTax: won(data.tot_cmsn_tax),
+          pnl: won(data.tot_pl_amt),
+          profitRate: `${unpad(data.tot_prft_rt)}%`
+        },
+        "table"
+      );
+      emitList(data, "tdy_trde_diary", "table");
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  account.command("returns").description("Daily account return detail over a period (kt00016)").option("-s, --start <yyyymmdd>", "Start date (defaults to first of this month)").option("-e, --end <yyyymmdd>", "End date", todayKst()).option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.dailyReturn, {
+        fr_dt: options.start || `${todayKst().slice(0, 6)}01`,
+        to_dt: options.end || todayKst()
+      });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          investBase: won(data.invt_bsamt),
+          evalProfit: won(data.evltv_prft),
+          profitRate: `${unpad(data.prft_rt)}%`,
+          turnoverRate: `${unpad(data.tern_rt)}%`,
+          totalFrom: won(data.tot_amt_fr),
+          totalTo: won(data.tot_amt_to)
+        },
+        "table"
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/order.ts
+function resolveExchange(value) {
+  const ex = (value ?? "KRX").toUpperCase();
+  if (!ORDER_EXCHANGE_TYPES.includes(ex)) {
+    throw new ActionableError(
+      `Invalid exchange "${value}". Use one of: ${ORDER_EXCHANGE_TYPES.join(", ")}`
+    );
+  }
+  return ex;
+}
+function resolveOrderType(typeOpt, priceOpt) {
+  let trde_tp = typeOpt ?? (priceOpt ? "0" : "3");
+  if (!ORDER_TYPES[trde_tp]) {
+    throw new ActionableError(
+      `Invalid order type "${trde_tp}". Known types: ${Object.entries(ORDER_TYPES).map(([k, v]) => `${k}=${v}`).join(", ")}`
+    );
+  }
+  const isMarket = MARKET_ORDER_TYPES.has(trde_tp);
+  if (isMarket) {
+    if (priceOpt) {
+      throw new ActionableError("Market orders must not specify a price (--price).");
+    }
+    return { trde_tp, ord_uv: "" };
+  }
+  if (!priceOpt) {
+    throw new ActionableError(
+      `Order type ${trde_tp} (${ORDER_TYPES[trde_tp]}) requires --price.`
+    );
+  }
+  return { trde_tp, ord_uv: priceOpt };
+}
+async function confirm(summary, skip) {
+  console.log(summary);
+  if (skip) return true;
+  const answer = await prompt("Proceed? (y/N): ");
+  return /^y(es)?$/i.test(answer.trim());
+}
+async function submit(def, body, outputFmt) {
+  const client = createClient();
+  const { data } = await client.callEndpoint(def, body);
+  output(
+    {
+      orderNo: data.ord_no,
+      exchange: data.dmst_stex_tp,
+      message: data.return_msg
+    },
+    getOutputFormat(outputFmt)
+  );
+}
+function registerOrderCommands(program2) {
+  const order = program2.command("order").description('Place / modify / cancel orders (REAL money on the "real" environment)');
+  order.command("buy <code> <qty>").description("Place a buy order").option("-p, --price <won>", "Limit price; omit for a market order").option("-t, --type <code>", "Order type code (trde_tp); default 0=limit / 3=market").option("--cond-price <won>", "Trigger price for conditional/stop types (e.g. type 28)").option("-x, --exchange <KRX|NXT|SOR>", "Exchange routing", "KRX").option("--credit", "Use a credit (margin) order").option("-y, --yes", "Skip the confirmation prompt").option("-o, --output <format>", "Output format (table/json)", "table").action((code, qty, options) => placeOrder("buy", code, qty, options).catch(handleError));
+  order.command("sell <code> <qty>").description("Place a sell order").option("-p, --price <won>", "Limit price; omit for a market order").option("-t, --type <code>", "Order type code (trde_tp); default 0=limit / 3=market").option("--cond-price <won>", "Trigger price for conditional/stop types (e.g. type 28)").option("-x, --exchange <KRX|NXT|SOR>", "Exchange routing", "KRX").option("--credit", "Use a credit (margin) order").option("--credit-deal <code>", "Credit deal type (\uC2E0\uC6A9\uAC70\uB798\uAD6C\uBD84): 33=\uC735\uC790, 99=\uC735\uC790\uD569", "33").option("--loan-date <yyyymmdd>", "Credit loan date (required for some credit sells)").option("-y, --yes", "Skip the confirmation prompt").option("-o, --output <format>", "Output format (table/json)", "table").action((code, qty, options) => placeOrder("sell", code, qty, options).catch(handleError));
+  order.command("modify <orderNo> <code> <qty> <price>").description("Modify a resting order (new qty + price)").option("--cond-price <won>", "New trigger price for conditional/stop orders").option("-x, --exchange <KRX|NXT|SOR>", "Exchange routing (must match original)", "KRX").option("--credit", "Modify a credit order").option("-y, --yes", "Skip the confirmation prompt").option("-o, --output <format>", "Output format (table/json)", "table").action(async (orderNo, code, qty, price2, options) => {
+    try {
+      const stk = normalizeStockCode(code);
+      parseIntStrict(qty, "qty");
+      parseIntStrict(price2, "price");
+      const exchange = resolveExchange(options.exchange);
+      const def = options.credit ? ENDPOINTS.creditModify : ENDPOINTS.modify;
+      const body = {
+        dmst_stex_tp: exchange,
+        orig_ord_no: orderNo,
+        stk_cd: stk,
+        mdfy_qty: qty,
+        mdfy_uv: price2,
+        mdfy_cond_uv: options.condPrice ?? ""
+      };
+      const ok = await confirm(
+        `
+MODIFY ${options.credit ? "(credit) " : ""}order ${orderNo} ${stk} \u2192 qty ${qty} @ ${price2} [${exchange}] on ${getEffectiveConfig().env.toUpperCase()}`,
+        options.yes
+      );
+      if (!ok) {
+        console.log("Cancelled.");
+        return;
+      }
+      await submit(def, body, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  order.command("cancel <orderNo> <code>").description("Cancel a resting order").option("-q, --qty <qty>", "Quantity to cancel; 0 = all remaining", "0").option("-x, --exchange <KRX|NXT|SOR>", "Exchange routing (must match original)", "KRX").option("--credit", "Cancel a credit order").option("-y, --yes", "Skip the confirmation prompt").option("-o, --output <format>", "Output format (table/json)", "table").action(async (orderNo, code, options) => {
+    try {
+      const stk = normalizeStockCode(code);
+      parseIntStrict(options.qty, "qty");
+      const exchange = resolveExchange(options.exchange);
+      const def = options.credit ? ENDPOINTS.creditCancel : ENDPOINTS.cancel;
+      const body = {
+        dmst_stex_tp: exchange,
+        orig_ord_no: orderNo,
+        stk_cd: stk,
+        cncl_qty: options.qty
+      };
+      const qtyLabel = options.qty === "0" ? "ALL remaining" : options.qty;
+      const ok = await confirm(
+        `
+CANCEL ${options.credit ? "(credit) " : ""}order ${orderNo} ${stk} \u2192 ${qtyLabel} [${exchange}] on ${getEffectiveConfig().env.toUpperCase()}`,
+        options.yes
+      );
+      if (!ok) {
+        console.log("Cancelled.");
+        return;
+      }
+      await submit(def, body, options);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+async function placeOrder(side, code, qty, options) {
+  const stk = normalizeStockCode(code);
+  parseIntStrict(qty, "qty");
+  const exchange = resolveExchange(options.exchange);
+  const { trde_tp, ord_uv } = resolveOrderType(options.type, options.price);
+  const credit = Boolean(options.credit);
+  const def = credit ? side === "buy" ? ENDPOINTS.creditBuy : ENDPOINTS.creditSell : side === "buy" ? ENDPOINTS.buy : ENDPOINTS.sell;
+  const cond_uv = options.condPrice ?? "";
+  if (trde_tp === "28" && !cond_uv) {
+    throw new ActionableError("Stop-limit orders (type 28) require --cond-price <trigger>.");
+  }
+  const body = {
+    dmst_stex_tp: exchange,
+    stk_cd: stk,
+    ord_qty: qty,
+    ord_uv,
+    trde_tp,
+    cond_uv
+  };
+  if (credit && side === "sell") {
+    body.crd_deal_tp = options.creditDeal ?? "33";
+    if (options.loanDate) body.crd_loan_dt = options.loanDate;
+  }
+  const priceLabel = MARKET_ORDER_TYPES.has(trde_tp) ? "MARKET" : `@ ${ord_uv}`;
+  const env = getEffectiveConfig().env;
+  const summary = `
+${side.toUpperCase()} ${credit ? "(credit) " : ""}${stk}  qty ${qty}  ${priceLabel}  type ${trde_tp}(${ORDER_TYPES[trde_tp]})  [${exchange}]  on ${env.toUpperCase()}` + (env === "real" ? "  \u26A0 REAL MONEY" : "");
+  const ok = await confirm(summary, options.yes);
+  if (!ok) {
+    console.log("Cancelled.");
+    return;
+  }
+  await submit(def, body, options);
+}
+
+// src/commands/ranking.ts
+function formatRankRow(row) {
+  return formatFields(row, {
+    stk_cd: (v) => v,
+    stk_nm: (v) => v,
+    cur_prc: unpad,
+    flu_rt: unpad,
+    pred_pre: unpad,
+    trde_qty: won,
+    now_trde_qty: won,
+    trde_prica: won,
+    trde_amt: won,
+    sdnin_rt: unpad
+  });
+}
+function registerRankingCommands(program2) {
+  const ranking = program2.command("ranking").alias("rank").description("Ranking lists \u2014 gainers, volume, value");
+  ranking.command("fluctuation").alias("gainers").description("Price change rate ranking (ka10027)").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "3").option("-s, --sort <1-5>", "Sort: 1=\uC0C1\uC2B9\uB960, 2=\uC0C1\uC2B9\uD3ED, 3=\uD558\uB77D\uB960, 4=\uD558\uB77D\uD3ED, 5=\uBCF4\uD569", "1").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankFluctuation, {
+        mrkt_tp: options.market,
+        sort_tp: options.sort || "1",
+        trde_qty_cnd: "0000",
+        stk_cnd: "0",
+        crd_cnd: "0",
+        updown_incls: "1",
+        pric_cnd: "0",
+        trde_prica_cnd: "0",
+        stex_tp: options.exchange
+      });
+      emitList(data, ENDPOINTS.rankFluctuation.listKey, getOutputFormat(options), formatRankRow);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  ranking.command("volume").description("Today volume ranking (ka10030)").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "3").option("-s, --sort <1-3>", "Sort: 1=\uAC70\uB798\uB7C9, 2=\uAC70\uB798\uD68C\uC804\uC728, 3=\uAC70\uB798\uB300\uAE08", "1").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankVolume, {
+        mrkt_tp: options.market,
+        sort_tp: options.sort || "1",
+        mang_stk_incls: "0",
+        crd_tp: "0",
+        trde_qty_tp: "0",
+        pric_tp: "0",
+        trde_prica_tp: "0",
+        mrkt_open_tp: "0",
+        stex_tp: options.exchange
+      });
+      emitList(data, ENDPOINTS.rankVolume.listKey, getOutputFormat(options), formatRankRow);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  ranking.command("amount").alias("value").description("Trade value (\uAC70\uB798\uB300\uAE08) ranking (ka10032)").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "3").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankTradeAmount, {
+        mrkt_tp: options.market,
+        mang_stk_incls: "1",
+        stex_tp: options.exchange
+      });
+      emitList(data, ENDPOINTS.rankTradeAmount.listKey, getOutputFormat(options), formatRankRow);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  ranking.command("surge").description("Volume surge (\uAC70\uB798\uB7C9\uAE09\uC99D) ranking (ka10023)").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "3").option("-s, --sort <1-4>", "Sort type", "1").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankVolumeSurge, {
+        mrkt_tp: options.market,
+        sort_tp: options.sort || "1",
+        tm_tp: "2",
+        trde_qty_tp: "5",
+        tm: "",
+        stk_cnd: "0",
+        pric_tp: "0",
+        stex_tp: options.exchange
+      });
+      emitList(data, ENDPOINTS.rankVolumeSurge.listKey, getOutputFormat(options), formatRankRow);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  ranking.command("prev-volume").description("Previous-day volume ranking (ka10031)").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "3").option("--query <1|2>", "Query type", "1").option("--from <n>", "Rank start", "0").option("--to <n>", "Rank end", "100").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankPrevVolume, {
+        mrkt_tp: options.market,
+        qry_tp: options.query || "1",
+        rank_strt: options.from || "0",
+        rank_end: options.to || "100",
+        stex_tp: options.exchange
+      });
+      emitList(data, ENDPOINTS.rankPrevVolume.listKey, getOutputFormat(options), formatRankRow);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/sector.ts
+function registerSectorCommands(program2) {
+  const sector = program2.command("sector").alias("industry").description("Sector / industry indices");
+  const withSharedOptions = (cmd) => cmd.option("-m, --market <0|1|2>", "Market: 0=KOSPI, 1=KOSDAQ, 2=KOSPI200", "0").option("-c, --code <inds_cd>", "Industry code (001=\uC885\uD569KOSPI, 101=\uC885\uD569KOSDAQ)", "001").option("-o, --output <format>", "Output format (table/json)", "table");
+  withSharedOptions(sector.command("price").description("Sector index snapshot (ka20001)")).action(
+    async (options) => {
+      try {
+        const client = createClient();
+        const { data } = await client.callEndpoint(ENDPOINTS.sectorPrice, {
+          mrkt_tp: options.market || "0",
+          inds_cd: options.code || "001"
+        });
+        const fmt = getOutputFormat(options);
+        if (fmt === "json") {
+          output(data, "json");
+          return;
+        }
+        output(
+          {
+            price: unpad(data.cur_prc),
+            change: unpad(data.pred_pre),
+            changeRate: `${unpad(data.flu_rt)}%`,
+            open: unpad(data.open_pric),
+            high: unpad(data.high_pric),
+            low: unpad(data.low_pric),
+            volume: won(data.trde_qty),
+            rising: data.rising,
+            falling: data.fall
+          },
+          "table"
+        );
+        emitList(
+          data,
+          ENDPOINTS.sectorPrice.listKey,
+          "table",
+          (row) => formatFields(row, {
+            tm_n: formatStamp,
+            cur_prc_n: unpad,
+            trde_qty_n: won
+          })
+        );
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  withSharedOptions(
+    sector.command("stocks").description("Stock prices within a sector (ka20002)")
+  ).action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.sectorStocks, {
+        mrkt_tp: options.market || "0",
+        inds_cd: options.code || "001",
+        stex_tp: "1"
+      });
+      emitList(
+        data,
+        ENDPOINTS.sectorStocks.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          stk_cd: (v) => v,
+          stk_nm: (v) => v,
+          cur_prc: unpad,
+          flu_rt: unpad,
+          now_trde_qty: won,
+          open_pric: unpad,
+          high_pric: unpad,
+          low_pric: unpad
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  withSharedOptions(
+    sector.command("all").description("All sector indices (ka20003)")
+  ).action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.sectorAllIndex, {
+        inds_cd: options.code || "001"
+      });
+      emitList(
+        data,
+        ENDPOINTS.sectorAllIndex.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          stk_cd: (v) => v,
+          stk_nm: (v) => v,
+          cur_prc: unpad,
+          flu_rt: unpad,
+          trde_qty: won,
+          trde_prica: won
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  withSharedOptions(
+    sector.command("daily").description("Sector index daily history (ka20009)")
+  ).action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.sectorDaily, {
+        mrkt_tp: options.market || "0",
+        inds_cd: options.code || "001"
+      });
+      const fmt = getOutputFormat(options);
+      if (fmt === "json") {
+        output(data, "json");
+        return;
+      }
+      output(
+        {
+          price: unpad(data.cur_prc),
+          changeRate: `${unpad(data.flu_rt)}%`,
+          open: unpad(data.open_pric),
+          high: unpad(data.high_pric),
+          low: unpad(data.low_pric)
+        },
+        "table"
+      );
+      emitList(
+        data,
+        ENDPOINTS.sectorDaily.listKey,
+        "table",
+        (row) => formatFields(row, {
+          dt_n: formatStamp,
+          cur_prc_n: unpad,
+          flu_rt_n: unpad,
+          acc_trde_qty_n: won
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  withSharedOptions(
+    sector.command("codes").description("Valid industry codes per market (ka10101)")
+  ).action(async (options) => {
+    try {
+      const client = createClient();
+      const { data } = await client.callEndpoint(
+        ENDPOINTS.sectorCodeList,
+        { mrkt_tp: options.market || "0" },
+        { paginate: true }
+      );
+      emitList(
+        data,
+        ENDPOINTS.sectorCodeList.listKey,
+        getOutputFormat(options),
+        (row) => formatFields(row, {
+          marketCode: (v) => v,
+          code: (v) => v,
+          name: (v) => v,
+          group: (v) => v
+        })
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("kiwoom-cli").description("CLI for Kiwoom Securities (\uD0A4\uC6C0\uC99D\uAD8C) \u2014 quotes, charts, account, and orders").version("0.1.0");
+program.exitOverride((err) => {
+  if (err.code === "commander.helpDisplayed" || err.code === "commander.version") {
+    process.exit(0);
+  }
+  process.exit(1);
+});
+registerConfigCommands(program);
+registerAuthCommands(program);
+registerStockCommands(program);
+registerMarketCommands(program);
+registerChartCommands(program);
+registerAccountCommands(program);
+registerOrderCommands(program);
+registerRankingCommands(program);
+registerSectorCommands(program);
+program.parseAsync(process.argv).catch(() => {
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map