krx-cli 0.1.0

package/dist/cli.js

@@ -0,0 +1,1269 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/client/rate-limit.ts
+var rate_limit_exports = {};
+__export(rate_limit_exports, {
+  checkRateLimit: () => checkRateLimit,
+  getRateLimitStatus: () => getRateLimitStatus,
+  incrementCallCount: () => incrementCallCount
+});
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+function today() {
+  const now = /* @__PURE__ */ new Date();
+  const yyyy = now.getFullYear().toString();
+  const mm = (now.getMonth() + 1).toString().padStart(2, "0");
+  const dd = now.getDate().toString().padStart(2, "0");
+  return `${yyyy}${mm}${dd}`;
+}
+function readRateData() {
+  try {
+    const raw = fs.readFileSync(RATE_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { date: today(), count: 0 };
+  }
+}
+function writeRateData(data) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(RATE_FILE, JSON.stringify(data, null, 2), "utf-8");
+}
+function incrementCallCount() {
+  const data = readRateData();
+  const currentDate = today();
+  const newData = data.date === currentDate ? { date: currentDate, count: data.count + 1 } : { date: currentDate, count: 1 };
+  writeRateData(newData);
+  return { count: newData.count, limit: DAILY_LIMIT };
+}
+function checkRateLimit() {
+  const data = readRateData();
+  const currentDate = today();
+  const count = data.date === currentDate ? data.count : 0;
+  const allowed = count < DAILY_LIMIT;
+  const warning = count >= DAILY_LIMIT * WARNING_THRESHOLD;
+  return { allowed, count, limit: DAILY_LIMIT, warning };
+}
+function getRateLimitStatus() {
+  const data = readRateData();
+  const currentDate = today();
+  const count = data.date === currentDate ? data.count : 0;
+  return {
+    date: currentDate,
+    count,
+    limit: DAILY_LIMIT,
+    remaining: DAILY_LIMIT - count
+  };
+}
+var CONFIG_DIR, RATE_FILE, DAILY_LIMIT, WARNING_THRESHOLD;
+var init_rate_limit = __esm({
+  "src/client/rate-limit.ts"() {
+    "use strict";
+    CONFIG_DIR = path.join(os.homedir(), ".krx-cli");
+    RATE_FILE = path.join(CONFIG_DIR, "rate-limit.json");
+    DAILY_LIMIT = 1e4;
+    WARNING_THRESHOLD = 0.8;
+  }
+});
+
+// src/cli/index.ts
+import { Command } from "commander";
+
+// src/client/auth.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+
+// src/client/endpoints.ts
+var CATEGORIES = [
+  {
+    id: "index",
+    code: "idx",
+    name: "Index",
+    nameKo: "\uC9C0\uC218",
+    probeEndpoint: "/svc/apis/idx/kospi_dd_trd"
+  },
+  {
+    id: "stock",
+    code: "sto",
+    name: "Stock",
+    nameKo: "\uC8FC\uC2DD",
+    probeEndpoint: "/svc/apis/sto/stk_bydd_trd"
+  },
+  {
+    id: "etp",
+    code: "etp",
+    name: "ETP",
+    nameKo: "\uC99D\uAD8C\uC0C1\uD488",
+    probeEndpoint: "/svc/apis/etp/etf_bydd_trd"
+  },
+  {
+    id: "bond",
+    code: "bon",
+    name: "Bond",
+    nameKo: "\uCC44\uAD8C",
+    probeEndpoint: "/svc/apis/bon/bnd_bydd_trd"
+  },
+  {
+    id: "derivative",
+    code: "drv",
+    name: "Derivative",
+    nameKo: "\uD30C\uC0DD\uC0C1\uD488",
+    probeEndpoint: "/svc/apis/drv/fut_bydd_trd"
+  },
+  {
+    id: "commodity",
+    code: "gen",
+    name: "Commodity",
+    nameKo: "\uC77C\uBC18\uC0C1\uD488",
+    probeEndpoint: "/svc/apis/gen/gold_bydd_trd"
+  },
+  {
+    id: "esg",
+    code: "esg",
+    name: "ESG",
+    nameKo: "ESG",
+    probeEndpoint: "/svc/apis/esg/esg_index_info"
+  }
+];
+var ENDPOINTS = [
+  // Index (idx)
+  {
+    path: "/svc/apis/idx/krx_dd_trd",
+    description: "KRX series index daily trading",
+    descriptionKo: "KRX \uC2DC\uB9AC\uC988 \uC9C0\uC218 \uC77C\uBCC4\uC2DC\uC138",
+    category: "index"
+  },
+  {
+    path: "/svc/apis/idx/kospi_dd_trd",
+    description: "KOSPI series index daily trading",
+    descriptionKo: "KOSPI \uC2DC\uB9AC\uC988 \uC9C0\uC218 \uC77C\uBCC4\uC2DC\uC138",
+    category: "index"
+  },
+  {
+    path: "/svc/apis/idx/kosdaq_dd_trd",
+    description: "KOSDAQ series index daily trading",
+    descriptionKo: "KOSDAQ \uC2DC\uB9AC\uC988 \uC9C0\uC218 \uC77C\uBCC4\uC2DC\uC138",
+    category: "index"
+  },
+  {
+    path: "/svc/apis/idx/bon_dd_trd",
+    description: "Bond index daily trading",
+    descriptionKo: "\uCC44\uAD8C\uC9C0\uC218 \uC77C\uBCC4\uC2DC\uC138",
+    category: "index"
+  },
+  {
+    path: "/svc/apis/idx/drvprod_dd_trd",
+    description: "Derivatives index daily trading",
+    descriptionKo: "\uD30C\uC0DD\uC0C1\uD488\uC9C0\uC218 \uC77C\uBCC4\uC2DC\uC138",
+    category: "index"
+  },
+  // Stock (sto)
+  {
+    path: "/svc/apis/sto/stk_bydd_trd",
+    description: "KOSPI stock daily trading",
+    descriptionKo: "\uC720\uAC00\uC99D\uAD8C(KOSPI) \uC8FC\uC2DD \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/ksq_bydd_trd",
+    description: "KOSDAQ stock daily trading",
+    descriptionKo: "\uCF54\uC2A4\uB2E5(KOSDAQ) \uC8FC\uC2DD \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/knx_bydd_trd",
+    description: "KONEX stock daily trading",
+    descriptionKo: "\uCF54\uB125\uC2A4(KONEX) \uC8FC\uC2DD \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/sw_bydd_trd",
+    description: "Subscription warrant daily trading",
+    descriptionKo: "\uC2E0\uC8FC\uC778\uC218\uAD8C\uC99D\uAD8C \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/sr_bydd_trd",
+    description: "Subscription right daily trading",
+    descriptionKo: "\uC2E0\uC8FC\uC778\uC218\uAD8C\uC99D\uC11C \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/stk_isu_base_info",
+    description: "KOSPI stock base info",
+    descriptionKo: "\uC720\uAC00\uC99D\uAD8C \uC885\uBAA9 \uAE30\uBCF8\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/ksq_isu_base_info",
+    description: "KOSDAQ stock base info",
+    descriptionKo: "\uCF54\uC2A4\uB2E5 \uC885\uBAA9 \uAE30\uBCF8\uC815\uBCF4",
+    category: "stock"
+  },
+  {
+    path: "/svc/apis/sto/knx_isu_base_info",
+    description: "KONEX stock base info",
+    descriptionKo: "\uCF54\uB125\uC2A4 \uC885\uBAA9 \uAE30\uBCF8\uC815\uBCF4",
+    category: "stock"
+  },
+  // ETP
+  {
+    path: "/svc/apis/etp/etf_bydd_trd",
+    description: "ETF daily trading",
+    descriptionKo: "ETF \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "etp"
+  },
+  {
+    path: "/svc/apis/etp/etn_bydd_trd",
+    description: "ETN daily trading",
+    descriptionKo: "ETN \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "etp"
+  },
+  {
+    path: "/svc/apis/etp/elw_bydd_trd",
+    description: "ELW daily trading",
+    descriptionKo: "ELW \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "etp"
+  },
+  // Bond (bon)
+  {
+    path: "/svc/apis/bon/kts_bydd_trd",
+    description: "KTS government bond daily trading",
+    descriptionKo: "\uAD6D\uCC44\uC804\uBB38\uC720\uD1B5\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "bond"
+  },
+  {
+    path: "/svc/apis/bon/bnd_bydd_trd",
+    description: "General bond daily trading",
+    descriptionKo: "\uC77C\uBC18\uCC44\uAD8C\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "bond"
+  },
+  {
+    path: "/svc/apis/bon/smb_bydd_trd",
+    description: "Small bond daily trading",
+    descriptionKo: "\uC18C\uC561\uCC44\uAD8C\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "bond"
+  },
+  // Derivatives (drv)
+  {
+    path: "/svc/apis/drv/fut_bydd_trd",
+    description: "Futures daily trading",
+    descriptionKo: "\uC120\uBB3C \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  {
+    path: "/svc/apis/drv/eqsfu_stk_bydd_trd",
+    description: "KOSPI stock futures daily trading",
+    descriptionKo: "\uC720\uAC00\uC99D\uAD8C \uC8FC\uC2DD\uC120\uBB3C \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  {
+    path: "/svc/apis/drv/eqkfu_ksq_bydd_trd",
+    description: "KOSDAQ stock futures daily trading",
+    descriptionKo: "\uCF54\uC2A4\uB2E5 \uC8FC\uC2DD\uC120\uBB3C \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  {
+    path: "/svc/apis/drv/opt_bydd_trd",
+    description: "Options daily trading",
+    descriptionKo: "\uC635\uC158 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  {
+    path: "/svc/apis/drv/eqsop_bydd_trd",
+    description: "KOSPI stock options daily trading",
+    descriptionKo: "\uC720\uAC00\uC99D\uAD8C \uC8FC\uC2DD\uC635\uC158 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  {
+    path: "/svc/apis/drv/eqkop_bydd_trd",
+    description: "KOSDAQ stock options daily trading",
+    descriptionKo: "\uCF54\uC2A4\uB2E5 \uC8FC\uC2DD\uC635\uC158 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "derivative"
+  },
+  // Commodities (gen)
+  {
+    path: "/svc/apis/gen/oil_bydd_trd",
+    description: "Oil market daily trading",
+    descriptionKo: "\uC11D\uC720\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "commodity"
+  },
+  {
+    path: "/svc/apis/gen/gold_bydd_trd",
+    description: "Gold market daily trading",
+    descriptionKo: "\uAE08\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "commodity"
+  },
+  {
+    path: "/svc/apis/gen/ets_bydd_trd",
+    description: "Emission trading daily",
+    descriptionKo: "\uBC30\uCD9C\uAD8C\uC2DC\uC7A5 \uC77C\uBCC4\uB9E4\uB9E4\uC815\uBCF4",
+    category: "commodity"
+  },
+  // ESG
+  {
+    path: "/svc/apis/esg/sri_bond_info",
+    description: "SRI bond info",
+    descriptionKo: "\uC0AC\uD68C\uCC45\uC784\uD22C\uC790\uCC44\uAD8C \uC885\uBAA9\uC815\uBCF4",
+    category: "esg"
+  },
+  {
+    path: "/svc/apis/esg/esg_etp_info",
+    description: "ESG ETP info",
+    descriptionKo: "ESG \uC99D\uAD8C\uC0C1\uD488 \uC815\uBCF4",
+    category: "esg"
+  },
+  {
+    path: "/svc/apis/esg/esg_index_info",
+    description: "ESG index info",
+    descriptionKo: "ESG \uC9C0\uC218 \uC815\uBCF4",
+    category: "esg"
+  }
+];
+
+// src/client/client.ts
+var BASE_URL = "https://data-dbg.krx.co.kr";
+async function krxFetch(options) {
+  const { checkRateLimit: checkRateLimit2, incrementCallCount: incrementCallCount2 } = await Promise.resolve().then(() => (init_rate_limit(), rate_limit_exports));
+  const rateStatus = checkRateLimit2();
+  if (!rateStatus.allowed) {
+    return {
+      success: false,
+      data: [],
+      error: `Daily rate limit exceeded (${rateStatus.count}/${rateStatus.limit})`,
+      errorCode: "RATE_LIMIT"
+    };
+  }
+  if (rateStatus.warning) {
+    process.stderr.write(
+      `Warning: ${rateStatus.count}/${rateStatus.limit} API calls used today
+`
+    );
+  }
+  const url = `${BASE_URL}${options.endpoint}`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      AUTH_KEY: options.apiKey,
+      "Content-Type": "application/json; charset=utf-8"
+    },
+    body: JSON.stringify(options.params)
+  });
+  incrementCallCount2();
+  if (!response.ok) {
+    let errorMsg = `HTTP ${response.status}: ${response.statusText}`;
+    let errorCode;
+    try {
+      const errorBody = await response.json();
+      if (errorBody.respMsg) {
+        errorMsg = errorBody.respMsg;
+      }
+      errorCode = errorBody.respCode;
+    } catch {
+    }
+    return {
+      success: false,
+      data: [],
+      error: errorMsg,
+      errorCode
+    };
+  }
+  const body = await response.json();
+  const outBlock = body["OutBlock_1"];
+  if (!Array.isArray(outBlock)) {
+    return {
+      success: false,
+      data: [],
+      error: "Unexpected response format: missing OutBlock_1"
+    };
+  }
+  return {
+    success: true,
+    data: outBlock
+  };
+}
+
+// src/client/auth.ts
+var CONFIG_DIR2 = path2.join(os2.homedir(), ".krx-cli");
+var CONFIG_FILE = path2.join(CONFIG_DIR2, "config.json");
+function readConfig() {
+  try {
+    const raw = fs2.readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function writeConfig(config) {
+  fs2.mkdirSync(CONFIG_DIR2, { recursive: true });
+  fs2.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+function getApiKey() {
+  return process.env["KRX_API_KEY"] ?? readConfig().apiKey;
+}
+function saveApiKey(apiKey) {
+  const config = readConfig();
+  writeConfig({ ...config, apiKey });
+}
+function getRecentTradingDate() {
+  const now = /* @__PURE__ */ new Date();
+  const day = now.getDay();
+  const daysBack = day === 0 ? 2 : day === 6 ? 1 : day === 1 ? 3 : 1;
+  const target = new Date(now.getTime() - daysBack * 24 * 60 * 60 * 1e3);
+  const yyyy = target.getFullYear().toString();
+  const mm = (target.getMonth() + 1).toString().padStart(2, "0");
+  const dd = target.getDate().toString().padStart(2, "0");
+  return `${yyyy}${mm}${dd}`;
+}
+async function checkCategoryApproval(apiKey, categoryId) {
+  const category = CATEGORIES.find((c) => c.id === categoryId);
+  if (!category) {
+    return { approved: false, checkedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  }
+  const basDd = getRecentTradingDate();
+  try {
+    const result = await krxFetch({
+      endpoint: category.probeEndpoint,
+      params: { basDd },
+      apiKey
+    });
+    const status = {
+      approved: result.success,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      ...result.error ? { error: result.error } : {}
+    };
+    const config = readConfig();
+    const serviceStatus = { ...config.serviceStatus, [categoryId]: status };
+    writeConfig({ ...config, serviceStatus });
+    return status;
+  } catch {
+    return { approved: false, checkedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  }
+}
+async function checkAllCategories(apiKey) {
+  const results = await Promise.all(
+    CATEGORIES.map(async (cat) => {
+      const status = await checkCategoryApproval(apiKey, cat.id);
+      return [cat.id, status];
+    })
+  );
+  return Object.fromEntries(results);
+}
+
+// src/output/formatter.ts
+function detectOutputFormat(explicit) {
+  if (explicit) {
+    return explicit;
+  }
+  return process.stdout.isTTY ? "table" : "json";
+}
+function formatOutput(data, format, fields) {
+  const filtered = fields ? filterFields(data, fields) : data;
+  switch (format) {
+    case "json":
+      return JSON.stringify(filtered, null, 2);
+    case "ndjson":
+      return filtered.map((row) => JSON.stringify(row)).join("\n");
+    case "table":
+      return formatTable(filtered);
+  }
+}
+function filterFields(data, fields) {
+  return data.map((row) => {
+    const filtered = {};
+    for (const field of fields) {
+      if (field in row) {
+        filtered[field] = row[field];
+      }
+    }
+    return filtered;
+  });
+}
+function formatTable(data) {
+  if (data.length === 0) return "(no data)";
+  const firstRow = data[0];
+  if (!firstRow) return "(no data)";
+  const keys = Object.keys(firstRow);
+  const widths = keys.map((key) => {
+    const values = data.map((row) => String(row[key] ?? ""));
+    return Math.max(key.length, ...values.map((v) => v.length));
+  });
+  const header = keys.map((k, i) => k.padEnd(widths[i] ?? 0)).join("  ");
+  const separator = widths.map((w) => "-".repeat(w)).join("  ");
+  const rows = data.map(
+    (row) => keys.map((k, i) => String(row[k] ?? "").padEnd(widths[i] ?? 0)).join("  ")
+  );
+  return [header, separator, ...rows].join("\n");
+}
+function writeOutput(output) {
+  process.stdout.write(output + "\n");
+}
+function writeError(message) {
+  process.stderr.write(`Error: ${message}
+`);
+}
+
+// src/cli/commands/auth.ts
+function registerAuthCommand(program2) {
+  const auth = program2.command("auth").description("Manage API key and service approvals");
+  auth.command("set <api-key>").description("Save KRX API key").action((apiKey) => {
+    saveApiKey(apiKey);
+    writeOutput(JSON.stringify({ success: true, message: "API key saved" }));
+  });
+  auth.command("status").description("Check API key and service approval status").action(async () => {
+    const apiKey = getApiKey();
+    if (!apiKey) {
+      writeError(
+        "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+      );
+      process.exit(EXIT_CODES.AUTH_FAILURE);
+    }
+    writeError("Checking service approvals...");
+    const statuses = await checkAllCategories(apiKey);
+    const format = detectOutputFormat(
+      program2.parent?.opts().output ?? program2.opts().output
+    );
+    const result = {
+      api_key_set: true,
+      services: statuses
+    };
+    if (format === "json" || format === "ndjson") {
+      writeOutput(JSON.stringify(result, null, 2));
+    } else {
+      const rows = CATEGORIES.map((cat) => {
+        const status = statuses[cat.id];
+        return {
+          category: cat.id,
+          name: cat.nameKo,
+          approved: status?.approved ? "YES" : "NO",
+          checked_at: status?.checkedAt ?? "-"
+        };
+      });
+      writeOutput(
+        formatOutput(
+          rows,
+          "table"
+        )
+      );
+    }
+  });
+  auth.command("check <category>").description("Check approval for a specific category").action(async (category) => {
+    const apiKey = getApiKey();
+    if (!apiKey) {
+      writeError(
+        "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+      );
+      process.exit(EXIT_CODES.AUTH_FAILURE);
+    }
+    const validCategories = CATEGORIES.map((c) => c.id);
+    if (!validCategories.includes(category)) {
+      writeError(
+        `Invalid category: ${category}. Must be one of: ${validCategories.join(", ")}`
+      );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    const status = await checkCategoryApproval(
+      apiKey,
+      category
+    );
+    writeOutput(JSON.stringify({ category, ...status }, null, 2));
+  });
+}
+
+// src/validator/index.ts
+import { z } from "zod/v4";
+var DATE_PATTERN = /^\d{8}$/;
+var dateSchema = z.string().regex(DATE_PATTERN, "Date must be YYYYMMDD format (8 digits)").refine(
+  (val) => {
+    const year = parseInt(val.slice(0, 4), 10);
+    const month = parseInt(val.slice(4, 6), 10);
+    const day = parseInt(val.slice(6, 8), 10);
+    if (year < 2010 || year > 2100) return false;
+    if (month < 1 || month > 12) return false;
+    if (day < 1 || day > 31) return false;
+    const date = new Date(year, month - 1, day);
+    return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day;
+  },
+  { message: "Invalid date. Must be a valid date from 2010 onwards." }
+);
+var marketSchema = z.enum(["kospi", "kosdaq", "konex", "krx"]);
+function validateDate(value) {
+  const result = dateSchema.safeParse(value);
+  if (!result.success) {
+    throw new Error(result.error.issues[0]?.message ?? "Invalid date");
+  }
+  return result.data;
+}
+function validateMarket(value) {
+  const result = marketSchema.safeParse(value.toLowerCase());
+  if (!result.success) {
+    throw new Error(
+      `Invalid market: ${value}. Must be one of: kospi, kosdaq, konex, krx`
+    );
+  }
+  return result.data;
+}
+
+// src/cli/error-handler.ts
+function handleKrxError(result) {
+  const exitCode = result.errorCode === "RATE_LIMIT" ? EXIT_CODES.RATE_LIMIT : result.errorCode === "401" ? EXIT_CODES.SERVICE_NOT_APPROVED : EXIT_CODES.GENERAL_ERROR;
+  writeError(result.error ?? "Unknown error");
+  process.exit(exitCode);
+}
+
+// src/cli/commands/index-cmd.ts
+var MARKET_ENDPOINTS = {
+  kospi: "/svc/apis/idx/kospi_dd_trd",
+  kosdaq: "/svc/apis/idx/kosdaq_dd_trd",
+  krx: "/svc/apis/idx/krx_dd_trd",
+  bond: "/svc/apis/idx/bon_dd_trd",
+  derivative: "/svc/apis/idx/drvprod_dd_trd"
+};
+function registerIndexCommand(program2) {
+  const index = program2.command("index").description("Query KRX index data");
+  index.command("list").description("List index daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option(
+    "--market <market>",
+    "market: kospi, kosdaq, krx, bond, derivative",
+    "kospi"
+  ).action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const market = opts.market.toLowerCase();
+      const endpoint = MARKET_ENDPOINTS[market];
+      if (!endpoint) {
+        writeError(
+          `Invalid market: ${market}. Must be one of: ${Object.keys(MARKET_ENDPOINTS).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/stock.ts
+var TRADING_ENDPOINTS = {
+  kospi: "/svc/apis/sto/stk_bydd_trd",
+  kosdaq: "/svc/apis/sto/ksq_bydd_trd",
+  konex: "/svc/apis/sto/knx_bydd_trd"
+};
+var INFO_ENDPOINTS = {
+  kospi: "/svc/apis/sto/stk_isu_base_info",
+  kosdaq: "/svc/apis/sto/ksq_isu_base_info",
+  konex: "/svc/apis/sto/knx_isu_base_info"
+};
+function registerStockCommand(program2) {
+  const stock = program2.command("stock").description("Query KRX stock data");
+  stock.command("list").description("List stock daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option("--market <market>", "market: kospi, kosdaq, konex", "kospi").action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const market = validateMarket(opts.market);
+      const endpoint = TRADING_ENDPOINTS[market];
+      if (!endpoint) {
+        writeError(`Invalid market for stock list: ${market}`);
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+  stock.command("info").description("List stock base information").option("--market <market>", "market: kospi, kosdaq, konex", "kospi").action(async (opts) => {
+    try {
+      const market = validateMarket(opts.market);
+      const endpoint = INFO_ENDPOINTS[market];
+      if (!endpoint) {
+        writeError(`Invalid market for stock info: ${market}`);
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: {},
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: {},
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError("No data");
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/etp.ts
+var TYPE_ENDPOINTS = {
+  etf: "/svc/apis/etp/etf_bydd_trd",
+  etn: "/svc/apis/etp/etn_bydd_trd",
+  elw: "/svc/apis/etp/elw_bydd_trd"
+};
+function registerEtpCommand(program2) {
+  const etp = program2.command("etp").description("Query KRX ETP data (ETF/ETN/ELW)");
+  etp.command("list").description("List ETP daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option("--type <type>", "type: etf, etn, elw", "etf").action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const type = opts.type.toLowerCase();
+      const endpoint = TYPE_ENDPOINTS[type];
+      if (!endpoint) {
+        writeError(
+          `Invalid type: ${type}. Must be one of: ${Object.keys(TYPE_ENDPOINTS).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/bond.ts
+var MARKET_ENDPOINTS2 = {
+  kts: "/svc/apis/bon/kts_bydd_trd",
+  general: "/svc/apis/bon/bnd_bydd_trd",
+  small: "/svc/apis/bon/smb_bydd_trd"
+};
+function registerBondCommand(program2) {
+  const bond = program2.command("bond").description("Query KRX bond data");
+  bond.command("list").description("List bond daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option("--market <market>", "market: kts, general, small", "general").action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const market = opts.market.toLowerCase();
+      const endpoint = MARKET_ENDPOINTS2[market];
+      if (!endpoint) {
+        writeError(
+          `Invalid market: ${market}. Must be one of: ${Object.keys(MARKET_ENDPOINTS2).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/derivative.ts
+var TYPE_ENDPOINTS2 = {
+  futures: "/svc/apis/drv/fut_bydd_trd",
+  "futures-kospi": "/svc/apis/drv/eqsfu_stk_bydd_trd",
+  "futures-kosdaq": "/svc/apis/drv/eqkfu_ksq_bydd_trd",
+  options: "/svc/apis/drv/opt_bydd_trd",
+  "options-kospi": "/svc/apis/drv/eqsop_bydd_trd",
+  "options-kosdaq": "/svc/apis/drv/eqkop_bydd_trd"
+};
+function registerDerivativeCommand(program2) {
+  const derivative = program2.command("derivative").description("Query KRX derivative data");
+  derivative.command("list").description("List derivative daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option(
+    "--type <type>",
+    "type: futures, futures-kospi, futures-kosdaq, options, options-kospi, options-kosdaq",
+    "futures"
+  ).action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const type = opts.type.toLowerCase();
+      const endpoint = TYPE_ENDPOINTS2[type];
+      if (!endpoint) {
+        writeError(
+          `Invalid type: ${type}. Must be one of: ${Object.keys(TYPE_ENDPOINTS2).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/commodity.ts
+var TYPE_ENDPOINTS3 = {
+  oil: "/svc/apis/gen/oil_bydd_trd",
+  gold: "/svc/apis/gen/gold_bydd_trd",
+  emission: "/svc/apis/gen/ets_bydd_trd"
+};
+function registerCommodityCommand(program2) {
+  const commodity = program2.command("commodity").description("Query KRX commodity data (oil/gold/emission)");
+  commodity.command("list").description("List commodity daily trading data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option("--type <type>", "type: oil, gold, emission", "gold").action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const type = opts.type.toLowerCase();
+      const endpoint = TYPE_ENDPOINTS3[type];
+      if (!endpoint) {
+        writeError(
+          `Invalid type: ${type}. Must be one of: ${Object.keys(TYPE_ENDPOINTS3).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/esg.ts
+var TYPE_ENDPOINTS4 = {
+  "sri-bond": "/svc/apis/esg/sri_bond_info",
+  etp: "/svc/apis/esg/esg_etp_info",
+  index: "/svc/apis/esg/esg_index_info"
+};
+function registerEsgCommand(program2) {
+  const esg = program2.command("esg").description("Query KRX ESG data");
+  esg.command("list").description("List ESG data").requiredOption("--date <date>", "trading date (YYYYMMDD)").option("--type <type>", "type: sri-bond, etp, index", "index").action(async (opts) => {
+    try {
+      const date = validateDate(opts.date);
+      const type = opts.type.toLowerCase();
+      const endpoint = TYPE_ENDPOINTS4[type];
+      if (!endpoint) {
+        writeError(
+          `Invalid type: ${type}. Must be one of: ${Object.keys(TYPE_ENDPOINTS4).join(", ")}`
+        );
+        process.exit(EXIT_CODES.USAGE_ERROR);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        writeError(
+          "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
+        );
+        process.exit(EXIT_CODES.AUTH_FAILURE);
+      }
+      const parentOpts = program2.opts();
+      if (parentOpts.dryRun) {
+        writeOutput(
+          JSON.stringify(
+            {
+              method: "POST",
+              endpoint,
+              params: { basDd: date },
+              headers: { AUTH_KEY: "***" }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const result = await krxFetch({
+        endpoint,
+        params: { basDd: date },
+        apiKey
+      });
+      if (!result.success) {
+        handleKrxError(result);
+      }
+      if (result.data.length === 0) {
+        writeError(`No data for date ${date}`);
+        process.exit(EXIT_CODES.NO_DATA);
+      }
+      const format = detectOutputFormat(parentOpts.output);
+      const fields = parentOpts.fields?.split(",");
+      writeOutput(
+        formatOutput(
+          result.data,
+          format,
+          fields
+        )
+      );
+    } catch (err) {
+      writeError(err instanceof Error ? err.message : String(err));
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  });
+}
+
+// src/cli/commands/schema.ts
+var COMMON_PARAMS = [
+  {
+    name: "basDd",
+    type: "string",
+    required: true,
+    description: "Trading date in YYYYMMDD format"
+  }
+];
+function buildCommandName(endpoint) {
+  const parts = endpoint.replace("/svc/apis/", "").split("/");
+  const categoryCode = parts[0];
+  const apiName = parts[1];
+  const category = CATEGORIES.find((c) => c.code === categoryCode);
+  return `${category?.id ?? categoryCode}.${apiName}`;
+}
+function getAllSchemas() {
+  return ENDPOINTS.map((ep) => ({
+    command: buildCommandName(ep.path),
+    endpoint: ep.path,
+    description: ep.description,
+    descriptionKo: ep.descriptionKo,
+    category: ep.category,
+    params: [...COMMON_PARAMS]
+  }));
+}
+function registerSchemaCommand(program2) {
+  program2.command("schema [command]").description("Show API schema for agent introspection").option("--all", "show all schemas").action((command, opts) => {
+    if (opts.all || !command) {
+      const schemas2 = getAllSchemas();
+      writeOutput(JSON.stringify(schemas2, null, 2));
+      return;
+    }
+    const schemas = getAllSchemas();
+    const match = schemas.find(
+      (s) => s.command === command || s.command.toLowerCase() === command.toLowerCase()
+    );
+    if (!match) {
+      writeError(
+        `Unknown command: ${command}. Use 'krx schema --all' to list all.`
+      );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    writeOutput(JSON.stringify(match, null, 2));
+  });
+}
+
+// src/cli/index.ts
+var EXIT_CODES = {
+  SUCCESS: 0,
+  GENERAL_ERROR: 1,
+  USAGE_ERROR: 2,
+  NO_DATA: 3,
+  AUTH_FAILURE: 4,
+  RATE_LIMIT: 5,
+  SERVICE_NOT_APPROVED: 6
+};
+var program = new Command();
+program.name("krx").description("Agent-native CLI for KRX (Korea Exchange) Open API").version("0.1.0").option("-o, --output <format>", "output format: json, table, ndjson").option("-f, --fields <fields>", "comma-separated fields to include").option("--dry-run", "show request without calling API").option("-v, --verbose", "verbose output to stderr");
+registerAuthCommand(program);
+registerIndexCommand(program);
+registerStockCommand(program);
+registerEtpCommand(program);
+registerBondCommand(program);
+registerDerivativeCommand(program);
+registerCommodityCommand(program);
+registerEsgCommand(program);
+registerSchemaCommand(program);
+program.exitOverride();
+try {
+  await program.parseAsync(process.argv);
+} catch (err) {
+  if (err instanceof Error && "exitCode" in err) {
+    const exitCode = err.exitCode;
+    process.exit(exitCode);
+  }
+  writeError(err instanceof Error ? err.message : String(err));
+  process.exit(EXIT_CODES.GENERAL_ERROR);
+}
+export {
+  EXIT_CODES
+};
+//# sourceMappingURL=cli.js.map