krx-cli 1.3.0 → 1.5.0

package/dist/cli.js

@@ -12,9 +12,6 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
 var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
@@ -1202,8 +1199,8 @@ var require_command = __commonJS({
   "node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/command.js"(exports) {
     var EventEmitter = __require("node:events").EventEmitter;
     var childProcess = __require("node:child_process");
-    var path3 = __require("node:path");
-    var fs3 = __require("node:fs");
+    var path6 = __require("node:path");
+    var fs6 = __require("node:fs");
     var process3 = __require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -2197,7 +2194,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs3.existsSync(executableFile)) return;
+        if (fs6.existsSync(executableFile)) return;
         const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
         const executableMissing = `'${executableFile}' does not exist
  - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
@@ -2215,11 +2212,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path3.resolve(baseDir, baseName);
-          if (fs3.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path3.extname(baseName))) return void 0;
+          const localBin = path6.resolve(baseDir, baseName);
+          if (fs6.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path6.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs3.existsSync(`${localBin}${ext}`)
+            (ext) => fs6.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -2231,21 +2228,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs3.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs6.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path3.resolve(
-            path3.dirname(resolvedScriptPath),
+          executableDir = path6.resolve(
+            path6.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path3.basename(
+            const legacyName = path6.basename(
               this._scriptPath,
-              path3.extname(this._scriptPath)
+              path6.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2256,7 +2253,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path3.extname(executableFile));
+        launchWithNode = sourceExt.includes(path6.extname(executableFile));
         let proc;
         if (process3.platform !== "win32") {
           if (launchWithNode) {
@@ -3171,7 +3168,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path3.basename(filename, path3.extname(filename));
+        this._name = path6.basename(filename, path6.extname(filename));
         return this;
       }
       /**
@@ -3185,9 +3182,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path4) {
-        if (path4 === void 0) return this._executableDir;
-        this._executableDir = path4;
+      executableDir(path7) {
+        if (path7 === void 0) return this._executableDir;
+        this._executableDir = path7;
         return this;
       }
       /**
@@ -3465,72 +3462,6 @@ var require_commander = __commonJS({
   }
 });
 
-// src/client/rate-limit.ts
-var rate_limit_exports = {};
-__export(rate_limit_exports, {
-  checkRateLimit: () => checkRateLimit,
-  getRateLimitStatus: () => getRateLimitStatus,
-  incrementCallCount: () => incrementCallCount
-});
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as os from "node: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;
-  }
-});
-
 // node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
 var {
@@ -3549,9 +3480,9 @@ var {
 } = import_index.default;
 
 // src/client/auth.ts
-import * as fs2 from "node:fs";
-import * as path2 from "node:path";
-import * as os2 from "node:os";
+import * as fs3 from "node:fs";
+import * as path3 from "node:path";
+import * as os3 from "node:os";
 
 // src/client/response-fields.ts
 var INDEX_COMMON_FIELDS = [
@@ -3942,13 +3873,13 @@ var CATEGORIES = [
     probeEndpoint: "/svc/apis/esg/esg_index_info"
   }
 ];
-function ep(path3, description, descriptionKo, category) {
+function ep(path6, description, descriptionKo, category) {
   return {
-    path: path3,
+    path: path6,
     description,
     descriptionKo,
     category,
-    responseFields: RESPONSE_FIELDS[path3] ?? []
+    responseFields: RESPONSE_FIELDS[path6] ?? []
   };
 }
 var ENDPOINTS = [
@@ -4137,11 +4068,251 @@ var ENDPOINTS = [
   ep("/svc/apis/esg/esg_index_info", "ESG index info", "ESG \uC9C0\uC218 \uC815\uBCF4", "esg")
 ];
 
+// src/cache/store.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import * as crypto from "node:crypto";
+
+// src/utils/date.ts
+function formatDateToYYYYMMDD(date5) {
+  const yyyy = date5.getFullYear().toString();
+  const mm = (date5.getMonth() + 1).toString().padStart(2, "0");
+  const dd = date5.getDate().toString().padStart(2, "0");
+  return `${yyyy}${mm}${dd}`;
+}
+function isWeekend(date5) {
+  const day = date5.getDay();
+  return day === 0 || day === 6;
+}
+var KST_OFFSET_MS = 9 * 60 * 60 * 1e3;
+function getRecentTradingDate() {
+  const nowKst = new Date(Date.now() + KST_OFFSET_MS);
+  const day = nowKst.getUTCDay();
+  const daysBack = day === 0 ? 2 : day === 6 ? 1 : day === 1 ? 3 : 1;
+  const targetKst = new Date(nowKst.getTime() - daysBack * 24 * 60 * 60 * 1e3);
+  const yyyy = targetKst.getUTCFullYear().toString();
+  const mm = (targetKst.getUTCMonth() + 1).toString().padStart(2, "0");
+  const dd = targetKst.getUTCDate().toString().padStart(2, "0");
+  return `${yyyy}${mm}${dd}`;
+}
+function parseYYYYMMDD(str) {
+  const year = parseInt(str.substring(0, 4));
+  const month = parseInt(str.substring(4, 6)) - 1;
+  const day = parseInt(str.substring(6, 8));
+  return new Date(year, month, day);
+}
+function getTradingDays(from, to) {
+  const fromDate = parseYYYYMMDD(from);
+  const toDate = parseYYYYMMDD(to);
+  const days = [];
+  let current = new Date(fromDate);
+  while (current <= toDate) {
+    if (!isWeekend(current)) {
+      days.push(formatDateToYYYYMMDD(current));
+    }
+    current = new Date(current.getTime() + 24 * 60 * 60 * 1e3);
+  }
+  return days;
+}
+
+// src/cache/store.ts
+var CACHE_DIR = path.join(os.homedir(), ".krx-cli", "cache");
+var DATE_FORMAT = /^\d{8}$/;
+function isValidCacheDate(date5) {
+  return DATE_FORMAT.test(date5);
+}
+function getCacheKey(endpoint, params) {
+  const sortedEntries = Object.entries(params).sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  const raw = `${endpoint}:${JSON.stringify(sortedEntries)}`;
+  return crypto.createHash("sha256").update(raw).digest("hex").slice(0, 16);
+}
+function getCachePath(date5, key) {
+  return path.join(CACHE_DIR, date5, `${key}.json`);
+}
+function isToday(dateStr) {
+  const today2 = formatDateToYYYYMMDD(/* @__PURE__ */ new Date());
+  return dateStr === today2;
+}
+function getCached(endpoint, params) {
+  const date5 = params["basDd"];
+  if (!date5 || !isValidCacheDate(date5) || isToday(date5)) {
+    return null;
+  }
+  const key = getCacheKey(endpoint, params);
+  const cachePath = getCachePath(date5, key);
+  try {
+    const raw = fs.readFileSync(cachePath, "utf-8");
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("ENOENT")) {
+      return null;
+    }
+    process.stderr.write(`[krx-cli] cache read failed: ${String(err)}
+`);
+    return null;
+  }
+}
+function setCached(endpoint, params, data) {
+  const date5 = params["basDd"];
+  if (!date5 || !isValidCacheDate(date5) || isToday(date5)) {
+    return;
+  }
+  const key = getCacheKey(endpoint, params);
+  const cachePath = getCachePath(date5, key);
+  const dir = path.dirname(cachePath);
+  try {
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(cachePath, JSON.stringify(data), "utf-8");
+  } catch (err) {
+    process.stderr.write(`[krx-cli] cache write failed: ${String(err)}
+`);
+  }
+}
+function clearCache() {
+  let files = 0;
+  let directories = 0;
+  try {
+    if (!fs.existsSync(CACHE_DIR)) {
+      return { files, directories };
+    }
+    const dateDirs = fs.readdirSync(CACHE_DIR);
+    for (const dateDir of dateDirs) {
+      const dirPath = path.join(CACHE_DIR, dateDir);
+      const stat = fs.statSync(dirPath);
+      if (stat.isDirectory()) {
+        const cacheFiles = fs.readdirSync(dirPath);
+        files += cacheFiles.length;
+        fs.rmSync(dirPath, { recursive: true, force: true });
+        directories += 1;
+      }
+    }
+  } catch (err) {
+    process.stderr.write(`[krx-cli] cache clear failed: ${String(err)}
+`);
+  }
+  return { files, directories };
+}
+function getCacheStatus() {
+  let totalFiles = 0;
+  let totalSize = 0;
+  let dates = 0;
+  try {
+    if (!fs.existsSync(CACHE_DIR)) {
+      return { totalFiles, totalSize, dates };
+    }
+    const dateDirs = fs.readdirSync(CACHE_DIR);
+    for (const dateDir of dateDirs) {
+      const dirPath = path.join(CACHE_DIR, dateDir);
+      const stat = fs.statSync(dirPath);
+      if (stat.isDirectory()) {
+        dates += 1;
+        const cacheFiles = fs.readdirSync(dirPath);
+        for (const file2 of cacheFiles) {
+          const fileStat = fs.statSync(path.join(dirPath, file2));
+          totalFiles += 1;
+          totalSize += fileStat.size;
+        }
+      }
+    }
+  } catch (err) {
+    process.stderr.write(`[krx-cli] cache status failed: ${String(err)}
+`);
+  }
+  return { totalFiles, totalSize, dates };
+}
+
+// src/client/rate-limit.ts
+import * as fs2 from "node:fs";
+import * as path2 from "node:path";
+import * as os2 from "node:os";
+var CONFIG_DIR = path2.join(os2.homedir(), ".krx-cli");
+var RATE_FILE = path2.join(CONFIG_DIR, "rate-limit.json");
+var DAILY_LIMIT = 1e4;
+var WARNING_THRESHOLD = 0.8;
+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 = fs2.readFileSync(RATE_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { date: today(), count: 0 };
+  }
+}
+function writeRateData(data) {
+  fs2.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs2.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 };
+}
+
+// src/client/retry.ts
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_BASE_DELAY = 1e3;
+function isNetworkError(error48) {
+  if (error48 instanceof TypeError) {
+    return true;
+  }
+  if (error48 instanceof Error) {
+    const msg = error48.message.toLowerCase();
+    return msg.includes("econnrefused") || msg.includes("econnreset") || msg.includes("etimedout") || msg.includes("network");
+  }
+  return false;
+}
+function delay(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+async function withRetry(fn, options) {
+  const maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const baseDelay = options?.baseDelay ?? DEFAULT_BASE_DELAY;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (!isNetworkError(err) || attempt === maxRetries) {
+        throw err;
+      }
+      const waitMs = baseDelay * Math.pow(2, attempt);
+      await delay(waitMs);
+    }
+  }
+  throw lastError;
+}
+
 // 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();
+  const useCache = options.cache !== false;
+  if (useCache) {
+    const cached2 = getCached(options.endpoint, options.params);
+    if (cached2) {
+      return { success: true, data: cached2 };
+    }
+  }
+  const rateStatus = checkRateLimit();
   if (!rateStatus.allowed) {
     return {
       success: false,
@@ -4157,15 +4328,18 @@ async function krxFetch(options) {
     );
   }
   const url2 = `${BASE_URL}${options.endpoint}`;
-  const response = await fetch(url2, {
-    method: "POST",
-    headers: {
-      AUTH_KEY: options.apiKey,
-      "Content-Type": "application/json; charset=utf-8"
-    },
-    body: JSON.stringify(options.params)
-  });
-  incrementCallCount2();
+  const response = await withRetry(
+    () => fetch(url2, {
+      method: "POST",
+      headers: {
+        AUTH_KEY: options.apiKey,
+        "Content-Type": "application/json; charset=utf-8"
+      },
+      body: JSON.stringify(options.params)
+    }),
+    { maxRetries: options.retries ?? 3 }
+  );
+  incrementCallCount();
   if (!response.ok) {
     let errorMsg = `HTTP ${response.status}: ${response.statusText}`;
     let errorCode;
@@ -4193,6 +4367,9 @@ async function krxFetch(options) {
       error: "Unexpected response format: missing OutBlock_1"
     };
   }
+  if (useCache) {
+    setCached(options.endpoint, options.params, outBlock);
+  }
   return {
     success: true,
     data: outBlock
@@ -4200,19 +4377,19 @@ async function krxFetch(options) {
 }
 
 // src/client/auth.ts
-var CONFIG_DIR2 = path2.join(os2.homedir(), ".krx-cli");
-var CONFIG_FILE = path2.join(CONFIG_DIR2, "config.json");
+var CONFIG_DIR2 = path3.join(os3.homedir(), ".krx-cli");
+var CONFIG_FILE = path3.join(CONFIG_DIR2, "config.json");
 function readConfig() {
   try {
-    const raw = fs2.readFileSync(CONFIG_FILE, "utf-8");
+    const raw = fs3.readFileSync(CONFIG_FILE, "utf-8");
     return JSON.parse(raw);
   } catch {
     return {};
   }
 }
 function writeConfig(config2) {
-  fs2.mkdirSync(CONFIG_DIR2, { recursive: true });
-  fs2.writeFileSync(CONFIG_FILE, JSON.stringify(config2, null, 2), "utf-8");
+  fs3.mkdirSync(CONFIG_DIR2, { recursive: true });
+  fs3.writeFileSync(CONFIG_FILE, JSON.stringify(config2, null, 2), "utf-8");
 }
 function getApiKey() {
   return process.env["KRX_API_KEY"] ?? readConfig().apiKey;
@@ -4221,16 +4398,6 @@ function saveApiKey(apiKey) {
   const config2 = readConfig();
   writeConfig({ ...config2, 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) {
@@ -4282,6 +4449,8 @@ function formatOutput(data, format, fields) {
       return filtered.map((row) => JSON.stringify(row)).join("\n");
     case "table":
       return formatTable(filtered);
+    case "csv":
+      return formatCsv(filtered);
   }
 }
 function filterFields(data, fields) {
@@ -4311,6 +4480,23 @@ function formatTable(data) {
   );
   return [header, separator, ...rows].join("\n");
 }
+function escapeCsvField(value) {
+  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
+function formatCsv(data) {
+  if (data.length === 0) return "";
+  const firstRow = data[0];
+  if (!firstRow) return "";
+  const keys = Object.keys(firstRow);
+  const header = keys.join(",");
+  const rows = data.map(
+    (row) => keys.map((k) => escapeCsvField(String(row[k] ?? ""))).join(",")
+  );
+  return [header, ...rows].join("\n");
+}
 function writeOutput(output) {
   process.stdout.write(output + "\n");
 }
@@ -5153,10 +5339,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path3) {
-  if (!path3)
+function getElementAtPath(obj, path6) {
+  if (!path6)
     return obj;
-  return path3.reduce((acc, key) => acc?.[key], obj);
+  return path6.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -5539,11 +5725,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path3, issues) {
+function prefixIssues(path6, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path3);
+    iss.path.unshift(path6);
     return iss;
   });
 }
@@ -5726,7 +5912,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path3 = []) => {
+  const processError = (error49, path6 = []) => {
     var _a2, _b;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -5736,7 +5922,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path3, ...issue2.path];
+        const fullpath = [...path6, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -5768,8 +5954,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path3) {
+  const path6 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path6) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -17746,13 +17932,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path3 = ref.slice(1).split("/").filter(Boolean);
-  if (path3.length === 0) {
+  const path6 = ref.slice(1).split("/").filter(Boolean);
+  if (path6.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path3[0] === defsKey) {
-    const key = path3[1];
+  if (path6[0] === defsKey) {
+    const key = path6[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -18170,6 +18356,17 @@ var dateSchema = external_exports.string().regex(DATE_PATTERN, "Date must be YYY
   { message: "Invalid date. Must be a valid date from 2010 onwards." }
 );
 var marketSchema = external_exports.enum(["kospi", "kosdaq", "konex", "krx"]);
+var CONTROL_CHAR_PATTERN = /[\x00-\x1f\x7f]/;
+var PATH_TRAVERSAL_PATTERN = /\.\.[/\\]/;
+function validateNoInjection(input) {
+  if (CONTROL_CHAR_PATTERN.test(input)) {
+    return "Input contains control characters";
+  }
+  if (PATH_TRAVERSAL_PATTERN.test(input)) {
+    return "Input contains path traversal";
+  }
+  return null;
+}
 function validateDate(value) {
   const result = dateSchema.safeParse(value);
   if (!result.success) {
@@ -18187,6 +18384,92 @@ function validateMarket(value) {
   return result.data;
 }
 
+// src/cli/command-helper.ts
+import * as fs4 from "node:fs";
+import * as path4 from "node:path";
+
+// src/client/range-fetch.ts
+var DEFAULT_CONCURRENCY = 5;
+async function fetchWithConcurrency(tasks, concurrency) {
+  const slots = new Array(tasks.length);
+  let index = 0;
+  async function runNext() {
+    while (index < tasks.length) {
+      const currentIndex = index;
+      index += 1;
+      const task = tasks[currentIndex];
+      if (task) {
+        const result = await task();
+        slots[currentIndex] = Promise.resolve(result);
+      }
+    }
+  }
+  const workers = Array.from(
+    { length: Math.min(concurrency, tasks.length) },
+    () => runNext()
+  );
+  await Promise.all(workers);
+  return Promise.all(slots);
+}
+async function fetchDateRange(options) {
+  const { endpoint, from, to, apiKey, cache, extraParams } = options;
+  const concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
+  if (from > to) {
+    return {
+      success: false,
+      data: [],
+      error: `'from' date (${from}) must not be after 'to' date (${to})`,
+      fetchedDays: 0,
+      failedDays: 0
+    };
+  }
+  const tradingDays = getTradingDays(from, to);
+  if (tradingDays.length === 0) {
+    return { success: true, data: [], fetchedDays: 0, failedDays: 0 };
+  }
+  const tasks = tradingDays.map((day) => async () => {
+    const params = {
+      basDd: day,
+      ...extraParams
+    };
+    return krxFetch({
+      endpoint,
+      params,
+      apiKey,
+      cache
+    });
+  });
+  const results = await fetchWithConcurrency(tasks, concurrency);
+  const failedDays = results.filter((r) => !r.success).length;
+  const mergedData = results.filter((r) => r.success).flatMap((r) => [...r.data]);
+  if (mergedData.length === 0 && failedDays > 0) {
+    return {
+      success: false,
+      data: [],
+      error: `All ${failedDays} trading day(s) failed to fetch`,
+      fetchedDays: 0,
+      failedDays
+    };
+  }
+  return {
+    success: true,
+    data: mergedData,
+    fetchedDays: tradingDays.length - failedDays,
+    failedDays
+  };
+}
+
+// src/cli/exit-codes.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
+};
+
 // 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;
@@ -18194,209 +18477,368 @@ function handleKrxError(result) {
   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(program3) {
-  const index = program3.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 date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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/utils/krx-number.ts
+function parseKrxNumber(value) {
+  const cleaned = value.replace(/,/g, "");
+  const num = parseFloat(cleaned);
+  return isNaN(num) ? 0 : num;
+}
+function isKrxNumericString(value) {
+  return /^-?[\d,]+\.?\d*$/.test(value.trim());
 }
 
-// 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(program3) {
-  const stock = program3.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) => {
+// src/utils/filter.ts
+var OPERATOR_PATTERN = /^(\S+)\s+(>=|<=|==|!=|>|<)\s+(.+)$/;
+function parseFilterExpression(expression) {
+  const trimmed = expression.trim().replace(/\s+/g, " ");
+  const match = OPERATOR_PATTERN.exec(trimmed);
+  if (!match || !match[1] || !match[2] || !match[3]) {
+    return null;
+  }
+  return {
+    field: match[1],
+    operator: match[2],
+    value: match[3].trim()
+  };
+}
+function compareValues(fieldValue, operator, filterValue) {
+  const isNumeric = isKrxNumericString(fieldValue) && isKrxNumericString(filterValue);
+  if (isNumeric) {
+    const a = parseKrxNumber(fieldValue);
+    const b = parseKrxNumber(filterValue);
+    switch (operator) {
+      case ">":
+        return a > b;
+      case "<":
+        return a < b;
+      case ">=":
+        return a >= b;
+      case "<=":
+        return a <= b;
+      case "==":
+        return a === b;
+      case "!=":
+        return a !== b;
+    }
+  }
+  switch (operator) {
+    case "==":
+      return fieldValue === filterValue;
+    case "!=":
+      return fieldValue !== filterValue;
+    case ">":
+      return fieldValue > filterValue;
+    case "<":
+      return fieldValue < filterValue;
+    case ">=":
+      return fieldValue >= filterValue;
+    case "<=":
+      return fieldValue <= filterValue;
+    default: {
+      const _exhaustive = operator;
+      void _exhaustive;
+      return false;
+    }
+  }
+}
+function filterData(data, expression) {
+  const parsed = parseFilterExpression(expression);
+  if (!parsed) {
+    return data;
+  }
+  return data.filter((row) => {
+    const fieldValue = row[parsed.field];
+    if (fieldValue === void 0 || fieldValue === null) {
+      return false;
+    }
+    return compareValues(String(fieldValue), parsed.operator, parsed.value);
+  });
+}
+
+// src/utils/data-pipeline.ts
+function sortData(data, field, direction = "desc") {
+  const sorted = [...data].sort((a, b) => {
+    const aVal = String(a[field] ?? "");
+    const bVal = String(b[field] ?? "");
+    if (isKrxNumericString(aVal) && isKrxNumericString(bVal)) {
+      return parseKrxNumber(aVal) - parseKrxNumber(bVal);
+    }
+    return aVal.localeCompare(bVal, "ko");
+  });
+  return direction === "desc" ? sorted.reverse() : sorted;
+}
+function limitData(data, limit) {
+  return data.slice(0, limit);
+}
+function applyPipeline(data, options) {
+  let result = data;
+  if (options.filter) {
+    result = filterData(result, options.filter);
+  }
+  if (options.sort) {
+    result = sortData(result, options.sort, options.direction ?? "desc");
+  }
+  if (options.limit && options.limit > 0) {
+    result = limitData(result, options.limit);
+  }
+  return result;
+}
+
+// src/cli/command-helper.ts
+async function executeCommand(options) {
+  const { endpoint, params, program: program3, noDataMessage } = options;
+  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 = program3.opts();
+  const finalParams = parentOpts.code ? { ...params, isuCd: parentOpts.code } : params;
+  if (parentOpts.dryRun) {
+    writeOutput(
+      JSON.stringify(
+        {
+          method: "POST",
+          endpoint,
+          params: finalParams,
+          headers: { AUTH_KEY: "***" }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const fromDate = parentOpts.from;
+  const toDate = parentOpts.to;
+  if (fromDate && !toDate || !fromDate && toDate) {
+    writeError("Both --from and --to must be provided together");
+    process.exit(EXIT_CODES.USAGE_ERROR);
+  }
+  if (fromDate) {
     try {
-      const date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        process.exit(EXIT_CODES.NO_DATA);
-      }
-      const format = detectOutputFormat(parentOpts.output);
-      const fields = parentOpts.fields?.split(",");
-      writeOutput(
-        formatOutput(
-          result.data,
-          format,
-          fields
-        )
+      validateDate(fromDate);
+    } catch (err) {
+      writeError(
+        `Invalid --from date: ${err instanceof Error ? err.message : String(err)}`
       );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+  }
+  if (toDate) {
+    try {
+      validateDate(toDate);
     } catch (err) {
-      writeError(err instanceof Error ? err.message : String(err));
+      writeError(
+        `Invalid --to date: ${err instanceof Error ? err.message : String(err)}`
+      );
       process.exit(EXIT_CODES.USAGE_ERROR);
     }
+  }
+  const isDateRange = fromDate && toDate;
+  let data;
+  if (isDateRange) {
+    const restParams = Object.fromEntries(
+      Object.entries(finalParams).filter(([k]) => k !== "basDd")
+    );
+    const rangeResult = await fetchDateRange({
+      endpoint,
+      from: fromDate,
+      to: toDate,
+      apiKey,
+      cache: parentOpts.cache,
+      extraParams: restParams
+    });
+    if (!rangeResult.success) {
+      writeError(rangeResult.error ?? "Date range fetch failed");
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+    if (rangeResult.failedDays > 0) {
+      writeError(`Warning: ${rangeResult.failedDays} day(s) failed to fetch`);
+    }
+    data = rangeResult.data;
+  } else {
+    const result = await krxFetch({
+      endpoint,
+      params: finalParams,
+      apiKey,
+      cache: parentOpts.cache,
+      retries: parentOpts.retries
+    });
+    if (!result.success) {
+      handleKrxError(result);
+    }
+    data = result.data;
+  }
+  if (data.length === 0) {
+    writeError(noDataMessage ?? "No data");
+    process.exit(EXIT_CODES.NO_DATA);
+  }
+  data = applyPipeline(data, {
+    filter: parentOpts.filter,
+    sort: parentOpts.sort,
+    direction: parentOpts.asc ? "asc" : "desc",
+    limit: parentOpts.limit
   });
-  stock.command("info").description("List stock base information").option("--market <market>", "market: kospi, kosdaq, konex", "kospi").action(async (opts) => {
+  if (data.length === 0) {
+    writeError(
+      parentOpts.filter ? `No results matched filter: ${parentOpts.filter}` : noDataMessage ?? "No data"
+    );
+    process.exit(EXIT_CODES.NO_DATA);
+  }
+  const format = detectOutputFormat(parentOpts.output);
+  const fields = parentOpts.fields?.split(",");
+  const output = formatOutput(data, format, fields);
+  const savePath = parentOpts.save;
+  if (savePath) {
     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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: {},
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
+      const dir = path4.dirname(savePath);
+      fs4.mkdirSync(dir, { recursive: true });
+      fs4.writeFileSync(savePath, output + "\n", "utf-8");
+      writeOutput(JSON.stringify({ saved: savePath, records: data.length }));
+    } catch (err) {
+      writeError(
+        `Failed to save file: ${err instanceof Error ? err.message : String(err)}`
+      );
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+  } else {
+    writeOutput(output);
+  }
+}
+function resolveEndpoint(endpoints, key, label) {
+  const endpoint = endpoints[key.toLowerCase()];
+  if (!endpoint) {
+    writeError(
+      `Invalid ${label}: ${key}. Must be one of: ${Object.keys(endpoints).join(", ")}`
+    );
+    process.exit(EXIT_CODES.USAGE_ERROR);
+  }
+  return endpoint;
+}
+
+// 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(program3) {
+  const index = program3.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) => {
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(MARKET_ENDPOINTS, opts.market, "market");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
+  });
+}
+
+// src/client/search.ts
+var BASE_INFO_ENDPOINTS = [
+  { endpoint: "/svc/apis/sto/stk_isu_base_info", market: "KOSPI" },
+  { endpoint: "/svc/apis/sto/ksq_isu_base_info", market: "KOSDAQ" }
+];
+async function searchStock(apiKey, query) {
+  const basDd = getRecentTradingDate();
+  const lowerQuery = query.toLowerCase();
+  const results = await Promise.all(
+    BASE_INFO_ENDPOINTS.map(async ({ endpoint, market }) => {
       const result = await krxFetch({
         endpoint,
-        params: {},
+        params: { basDd },
         apiKey
       });
       if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError("No data");
-        process.exit(EXIT_CODES.NO_DATA);
+        return [];
       }
-      const format = detectOutputFormat(parentOpts.output);
-      const fields = parentOpts.fields?.split(",");
-      writeOutput(
-        formatOutput(
-          result.data,
-          format,
-          fields
-        )
+      return result.data.filter((row) => {
+        const name = row["ISU_NM"] ?? "";
+        const shortName = row["ISU_ABBRV"] ?? "";
+        return name.toLowerCase().includes(lowerQuery) || shortName.toLowerCase().includes(lowerQuery);
+      }).map((row) => ({
+        ISU_CD: row["ISU_CD"] ?? "",
+        ISU_SRT_CD: row["ISU_SRT_CD"] ?? "",
+        ISU_NM: row["ISU_NM"] ?? row["ISU_ABBRV"] ?? "",
+        MKT_NM: market
+      }));
+    })
+  );
+  return results.flat();
+}
+
+// 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(program3) {
+  const stock = program3.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) => {
+    const date5 = validateDate(opts.date);
+    validateMarket(opts.market);
+    const endpoint = resolveEndpoint(
+      TRADING_ENDPOINTS,
+      opts.market,
+      "market"
+    );
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
+  });
+  stock.command("info").description("List stock base information").option("--market <market>", "market: kospi, kosdaq, konex", "kospi").action(async (opts) => {
+    validateMarket(opts.market);
+    const endpoint = resolveEndpoint(INFO_ENDPOINTS, opts.market, "market");
+    await executeCommand({
+      endpoint,
+      params: {},
+      program: program3
+    });
+  });
+  stock.command("search <query>").description("Search stocks by name").action(async (query) => {
+    validateNoInjection(query);
+    const apiKey = getApiKey();
+    if (!apiKey) {
+      writeError(
+        "No API key configured. Use 'krx auth set <key>' or set KRX_API_KEY env var."
       );
-    } catch (err) {
-      writeError(err instanceof Error ? err.message : String(err));
-      process.exit(EXIT_CODES.USAGE_ERROR);
+      process.exit(EXIT_CODES.AUTH_FAILURE);
     }
+    const results = await searchStock(apiKey, query);
+    if (results.length === 0) {
+      writeError(`No stocks found matching "${query}"`);
+      process.exit(EXIT_CODES.NO_DATA);
+    }
+    const parentOpts = program3.opts();
+    const format = detectOutputFormat(parentOpts.output);
+    const fields = parentOpts.fields?.split(",");
+    writeOutput(
+      formatOutput(
+        results,
+        format,
+        fields
+      )
+    );
   });
 }
 
@@ -18409,64 +18851,14 @@ var TYPE_ENDPOINTS = {
 function registerEtpCommand(program3) {
   const etp = program3.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 date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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);
-    }
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(TYPE_ENDPOINTS, opts.type, "type");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
   });
 }
 
@@ -18479,64 +18871,14 @@ var MARKET_ENDPOINTS2 = {
 function registerBondCommand(program3) {
   const bond = program3.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 date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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);
-    }
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(MARKET_ENDPOINTS2, opts.market, "market");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
   });
 }
 
@@ -18556,64 +18898,14 @@ function registerDerivativeCommand(program3) {
     "type: futures, futures-kospi, futures-kosdaq, options, options-kospi, options-kosdaq",
     "futures"
   ).action(async (opts) => {
-    try {
-      const date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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);
-    }
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(TYPE_ENDPOINTS2, opts.type, "type");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
   });
 }
 
@@ -18626,64 +18918,14 @@ var TYPE_ENDPOINTS3 = {
 function registerCommodityCommand(program3) {
   const commodity = program3.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 date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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);
-    }
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(TYPE_ENDPOINTS3, opts.type, "type");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
   });
 }
 
@@ -18696,64 +18938,14 @@ var TYPE_ENDPOINTS4 = {
 function registerEsgCommand(program3) {
   const esg = program3.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 date5 = 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 = program3.opts();
-      if (parentOpts.dryRun) {
-        writeOutput(
-          JSON.stringify(
-            {
-              method: "POST",
-              endpoint,
-              params: { basDd: date5 },
-              headers: { AUTH_KEY: "***" }
-            },
-            null,
-            2
-          )
-        );
-        return;
-      }
-      const result = await krxFetch({
-        endpoint,
-        params: { basDd: date5 },
-        apiKey
-      });
-      if (!result.success) {
-        handleKrxError(result);
-      }
-      if (result.data.length === 0) {
-        writeError(`No data for date ${date5}`);
-        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);
-    }
+    const date5 = validateDate(opts.date);
+    const endpoint = resolveEndpoint(TYPE_ENDPOINTS4, opts.type, "type");
+    await executeCommand({
+      endpoint,
+      params: { basDd: date5 },
+      program: program3,
+      noDataMessage: `No data for date ${date5}`
+    });
   });
 }
 
@@ -18805,20 +18997,402 @@ function registerSchemaCommand(program3) {
   });
 }
 
+// src/cli/commands/cache.ts
+function registerCacheCommand(program3) {
+  const cache = program3.command("cache").description("Manage API response cache");
+  cache.command("status").description("Show cache status").action(() => {
+    const status = getCacheStatus();
+    writeOutput(
+      JSON.stringify(
+        {
+          dates: status.dates,
+          files: status.totalFiles,
+          sizeBytes: status.totalSize,
+          sizeMB: Math.round(status.totalSize / 1024 / 1024 * 100) / 100
+        },
+        null,
+        2
+      )
+    );
+  });
+  cache.command("clear").description("Clear all cached data").action(() => {
+    const result = clearCache();
+    writeOutput(
+      JSON.stringify(
+        {
+          cleared: true,
+          files: result.files,
+          directories: result.directories
+        },
+        null,
+        2
+      )
+    );
+  });
+}
+
+// src/client/market-summary.ts
+var KOSPI_INDEX_ENDPOINT = "/svc/apis/idx/kospi_dd_trd";
+var KOSDAQ_INDEX_ENDPOINT = "/svc/apis/idx/kosdaq_dd_trd";
+var KOSPI_STOCK_ENDPOINT = "/svc/apis/sto/stk_bydd_trd";
+var KOSDAQ_STOCK_ENDPOINT = "/svc/apis/sto/ksq_bydd_trd";
+var TOP_N = 5;
+function computeStockStats(stocks) {
+  return stocks.reduce(
+    (acc, stock) => {
+      const rate = parseKrxNumber(stock["FLUC_RT"] ?? "0");
+      return {
+        advancing: acc.advancing + (rate > 0 ? 1 : 0),
+        declining: acc.declining + (rate < 0 ? 1 : 0),
+        unchanged: acc.unchanged + (rate === 0 ? 1 : 0),
+        totalVolume: acc.totalVolume + parseKrxNumber(stock["ACC_TRDVOL"] ?? "0"),
+        totalValue: acc.totalValue + parseKrxNumber(stock["ACC_TRDVAL"] ?? "0")
+      };
+    },
+    {
+      advancing: 0,
+      declining: 0,
+      unchanged: 0,
+      totalVolume: 0,
+      totalValue: 0
+    }
+  );
+}
+function computeTopMovers(stocks) {
+  const sorted = [...stocks].sort((a, b) => {
+    const rateA = parseKrxNumber(a["FLUC_RT"] ?? "0");
+    const rateB = parseKrxNumber(b["FLUC_RT"] ?? "0");
+    return rateB - rateA;
+  });
+  const topGainers = sorted.slice(0, TOP_N);
+  const topLosers = sorted.slice(-TOP_N).reverse();
+  return { topGainers, topLosers };
+}
+function safeFetch(...args) {
+  return krxFetch(...args).catch(
+    (err) => ({
+      success: false,
+      data: [],
+      error: err instanceof Error ? err.message : "Network error"
+    })
+  );
+}
+async function fetchMarketSummary(options) {
+  const { apiKey, date: date5, cache } = options;
+  const params = { basDd: date5 };
+  const [kospiIdx, kosdaqIdx, kospiStk, kosdaqStk] = await Promise.all([
+    safeFetch({ endpoint: KOSPI_INDEX_ENDPOINT, params, apiKey, cache }),
+    safeFetch({ endpoint: KOSDAQ_INDEX_ENDPOINT, params, apiKey, cache }),
+    safeFetch({ endpoint: KOSPI_STOCK_ENDPOINT, params, apiKey, cache }),
+    safeFetch({ endpoint: KOSDAQ_STOCK_ENDPOINT, params, apiKey, cache })
+  ]);
+  const allFailed = !kospiIdx.success && !kosdaqIdx.success && !kospiStk.success && !kosdaqStk.success;
+  if (allFailed) {
+    return {
+      success: false,
+      error: "All market data fetches failed"
+    };
+  }
+  const kospiIndexData = kospiIdx.success ? kospiIdx.data : [];
+  const kosdaqIndexData = kosdaqIdx.success ? kosdaqIdx.data : [];
+  const kospiStockData = kospiStk.success ? kospiStk.data : [];
+  const kosdaqStockData = kosdaqStk.success ? kosdaqStk.data : [];
+  const allStocks = [...kospiStockData, ...kosdaqStockData];
+  const stockStats = computeStockStats(allStocks);
+  const { topGainers, topLosers } = computeTopMovers(allStocks);
+  return {
+    success: true,
+    data: {
+      date: date5,
+      kospiIndex: kospiIndexData,
+      kosdaqIndex: kosdaqIndexData,
+      stockStats,
+      topGainers,
+      topLosers
+    }
+  };
+}
+
+// src/cli/commands/market.ts
+function registerMarketCommand(program3) {
+  const market = program3.command("market").description("Market overview commands");
+  market.command("summary").description("Market summary: indices, top movers, volume").option("-d, --date <date>", "trading date (YYYYMMDD)").action(async (opts) => {
+    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 date5 = opts.date ?? getRecentTradingDate();
+    try {
+      validateDate(date5);
+    } catch (err) {
+      writeError(
+        `Invalid date: ${err instanceof Error ? err.message : String(err)}`
+      );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    const parentOpts = program3.opts();
+    const result = await fetchMarketSummary({
+      apiKey,
+      date: date5,
+      cache: parentOpts.cache
+    });
+    if (!result.success) {
+      writeError(result.error ?? "Failed to fetch market summary");
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+    writeOutput(JSON.stringify(result.data, null, 2));
+  });
+}
+
+// src/watchlist/store.ts
+import * as fs5 from "node:fs";
+import * as path5 from "node:path";
+import * as os4 from "node:os";
+function getWatchlistPath() {
+  return path5.join(os4.homedir(), ".krx-cli", "watchlist.json");
+}
+function getWatchlist() {
+  const filePath = getWatchlistPath();
+  if (!fs5.existsSync(filePath)) {
+    return [];
+  }
+  try {
+    const raw = fs5.readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch (err) {
+    process.stderr.write(`[krx-cli] watchlist read failed: ${String(err)}
+`);
+    return [];
+  }
+}
+function saveWatchlist(entries) {
+  const filePath = getWatchlistPath();
+  const dir = path5.dirname(filePath);
+  try {
+    fs5.mkdirSync(dir, { recursive: true });
+    fs5.writeFileSync(filePath, JSON.stringify(entries, null, 2), "utf-8");
+    return true;
+  } catch (err) {
+    process.stderr.write(`[krx-cli] watchlist write failed: ${String(err)}
+`);
+    return false;
+  }
+}
+function addToWatchlist(entry) {
+  const current = getWatchlist();
+  const isDuplicate = current.some((e) => e.isuCd === entry.isuCd);
+  if (isDuplicate) {
+    return { added: false, reason: "duplicate" };
+  }
+  const saved = saveWatchlist([...current, entry]);
+  return saved ? { added: true } : { added: false, reason: "write_error" };
+}
+function removeFromWatchlist(nameOrCode) {
+  const current = getWatchlist();
+  const filtered = current.filter(
+    (e) => e.isuCd !== nameOrCode && e.name !== nameOrCode
+  );
+  if (filtered.length === current.length) {
+    return { removed: false, reason: "not_found" };
+  }
+  const saved = saveWatchlist(filtered);
+  return saved ? { removed: true } : { removed: false, reason: "write_error" };
+}
+
+// src/cli/commands/watchlist.ts
+var STOCK_ENDPOINTS = {
+  KOSPI: "/svc/apis/sto/stk_bydd_trd",
+  KOSDAQ: "/svc/apis/sto/ksq_bydd_trd"
+};
+function registerWatchlistCommand(program3) {
+  const watchlist = program3.command("watchlist").description("Manage watchlist: add, remove, list, show");
+  watchlist.command("add <name>").description("Add stock to watchlist by name (searches first)").action(async (name) => {
+    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 injectionError = validateNoInjection(name);
+    if (injectionError) {
+      writeError(`Invalid input: ${injectionError}`);
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    let results;
+    try {
+      results = await searchStock(apiKey, name);
+    } catch (err) {
+      writeError(
+        `Search failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+    if (results.length === 0) {
+      writeError(`No stock found matching '${name}'`);
+      process.exit(EXIT_CODES.NO_DATA);
+    }
+    if (results.length > 1) {
+      writeOutput(
+        JSON.stringify(
+          {
+            message: `Multiple matches found for '${name}'. Please be more specific.`,
+            matches: results
+          },
+          null,
+          2
+        )
+      );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    const stock = results[0];
+    const result = addToWatchlist({
+      isuCd: stock.ISU_CD,
+      isuSrtCd: stock.ISU_SRT_CD,
+      name: stock.ISU_NM,
+      market: stock.MKT_NM
+    });
+    if (!result.added) {
+      const message = result.reason === "write_error" ? "Failed to save watchlist" : `'${stock.ISU_NM}' is already in watchlist`;
+      writeError(message);
+      if (result.reason === "write_error") {
+        process.exit(EXIT_CODES.GENERAL_ERROR);
+      }
+      return;
+    }
+    writeOutput(
+      JSON.stringify({
+        message: `Added '${stock.ISU_NM}' (${stock.ISU_CD}) to watchlist`,
+        entry: {
+          isuCd: stock.ISU_CD,
+          isuSrtCd: stock.ISU_SRT_CD,
+          name: stock.ISU_NM,
+          market: stock.MKT_NM
+        }
+      })
+    );
+  });
+  watchlist.command("remove <name>").description("Remove stock from watchlist by name or code").action((name) => {
+    const injectionError = validateNoInjection(name);
+    if (injectionError) {
+      writeError(`Invalid input: ${injectionError}`);
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    const result = removeFromWatchlist(name);
+    if (!result.removed) {
+      const message = result.reason === "write_error" ? "Failed to save watchlist" : `'${name}' not found in watchlist`;
+      writeError(message);
+      process.exit(
+        result.reason === "write_error" ? EXIT_CODES.GENERAL_ERROR : EXIT_CODES.NO_DATA
+      );
+    }
+    writeOutput(
+      JSON.stringify({ message: `Removed '${name}' from watchlist` })
+    );
+  });
+  watchlist.command("list").description("List all stocks in watchlist").action(() => {
+    const entries = getWatchlist();
+    if (entries.length === 0) {
+      writeOutput(
+        JSON.stringify({ message: "Watchlist is empty", entries: [] })
+      );
+      return;
+    }
+    writeOutput(JSON.stringify(entries, null, 2));
+  });
+  watchlist.command("show").description("Show current prices for watchlist stocks").option("-d, --date <date>", "trading date (YYYYMMDD)").action(async (opts) => {
+    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 entries = getWatchlist();
+    if (entries.length === 0) {
+      writeOutput(
+        JSON.stringify({ message: "Watchlist is empty", entries: [] })
+      );
+      return;
+    }
+    const date5 = opts.date ?? getRecentTradingDate();
+    try {
+      validateDate(date5);
+    } catch (err) {
+      writeError(
+        `Invalid date: ${err instanceof Error ? err.message : String(err)}`
+      );
+      process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    const parentOpts = program3.opts();
+    const isuCds = new Set(entries.map((e) => e.isuCd));
+    const errors = [];
+    const [kospiResult, kosdaqResult] = await Promise.all([
+      krxFetch({
+        endpoint: STOCK_ENDPOINTS.KOSPI,
+        params: { basDd: date5 },
+        apiKey,
+        cache: parentOpts.cache
+      }).catch((err) => {
+        errors.push(
+          `KOSPI: ${err instanceof Error ? err.message : String(err)}`
+        );
+        return {
+          success: false,
+          data: []
+        };
+      }),
+      krxFetch({
+        endpoint: STOCK_ENDPOINTS.KOSDAQ,
+        params: { basDd: date5 },
+        apiKey,
+        cache: parentOpts.cache
+      }).catch((err) => {
+        errors.push(
+          `KOSDAQ: ${err instanceof Error ? err.message : String(err)}`
+        );
+        return {
+          success: false,
+          data: []
+        };
+      })
+    ]);
+    if (!kospiResult.success && !kosdaqResult.success) {
+      writeError(`All market data fetches failed: ${errors.join("; ")}`);
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+    const allStocks = [
+      ...kospiResult.success ? kospiResult.data : [],
+      ...kosdaqResult.success ? kosdaqResult.data : []
+    ];
+    const watchlistData = allStocks.filter(
+      (s) => isuCds.has(s["ISU_CD"] ?? "")
+    );
+    const output = { date: date5, stocks: watchlistData };
+    if (errors.length > 0) {
+      output["warnings"] = errors;
+    }
+    writeOutput(JSON.stringify(output, null, 2));
+  });
+}
+
 // src/cli/commands/version.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
+import { dirname as dirname4, resolve } from "node:path";
 function getLocalVersion() {
   const __filename = fileURLToPath(import.meta.url);
-  const __dirname = dirname(__filename);
+  const __dirname = dirname4(__filename);
   const candidates = [
     resolve(__dirname, "..", "package.json"),
     resolve(__dirname, "..", "..", "..", "package.json")
   ];
   for (const candidate of candidates) {
     try {
-      const raw = readFileSync3(candidate, "utf-8");
+      const raw = readFileSync5(candidate, "utf-8");
       const pkg = JSON.parse(raw);
       return pkg.version;
     } catch {
@@ -18900,17 +19474,12 @@ function registerUpdateCommand(program3) {
 }
 
 // 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 program2 = new Command();
-program2.name("krx").description("Agent-native CLI for KRX (Korea Exchange) Open API").version(getVersion()).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");
+program2.name("krx").description("Agent-native CLI for KRX (Korea Exchange) Open API").version(getVersion()).option("-o, --output <format>", "output format: json, table, ndjson, csv").option("-f, --fields <fields>", "comma-separated fields to include").option("--dry-run", "show request without calling API").option("-v, --verbose", "verbose output to stderr").option("--code <isuCd>", "filter by stock code (ISU_CD)").option("--sort <field>", "sort results by field name").option("--asc", "sort ascending (default: descending)").option("--limit <n>", "limit number of results", parseInt).option("--no-cache", "bypass cache and fetch fresh data").option("--from <date>", "start date for range query (YYYYMMDD)").option("--to <date>", "end date for range query (YYYYMMDD)").option("--filter <expression>", 'filter results (e.g. "FLUC_RT > 5")').option("--save <path>", "save output to file instead of stdout").option(
+  "--retries <n>",
+  "max retries on network error (default: 3)",
+  parseInt
+);
 registerAuthCommand(program2);
 registerIndexCommand(program2);
 registerStockCommand(program2);
@@ -18920,6 +19489,9 @@ registerDerivativeCommand(program2);
 registerCommodityCommand(program2);
 registerEsgCommand(program2);
 registerSchemaCommand(program2);
+registerCacheCommand(program2);
+registerMarketCommand(program2);
+registerWatchlistCommand(program2);
 registerVersionCommand(program2);
 registerUpdateCommand(program2);
 program2.exitOverride();