dart-fss-cli 0.4.1

package/dist/chunk-4JOKJUHX.js

@@ -0,0 +1,1715 @@
+// src/cli.ts
+import { Command } from "commander";
+
+// src/config.ts
+import { homedir } from "os";
+import { join as join2 } from "path";
+
+// src/env.ts
+import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
+var loaded = false;
+function loadEnv() {
+  if (loaded) return;
+  loaded = true;
+  const candidates = [
+    process.cwd(),
+    resolve(process.cwd(), ".."),
+    resolve(import.meta.dirname, "..")
+  ];
+  for (const base of candidates) {
+    const envPath = join(base, ".env");
+    if (existsSync(envPath)) {
+      const content = readFileSync(envPath, "utf-8");
+      for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx === -1) continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const val = trimmed.slice(eqIdx + 1).trim();
+        if (!process.env[key]) {
+          process.env[key] = val;
+        }
+      }
+      break;
+    }
+  }
+}
+
+// src/config.ts
+loadEnv();
+var DART_BASE_URL = "https://opendart.fss.or.kr/api/";
+var CACHE_DIR = join2(homedir(), ".dart-fss");
+var CORP_CODE_CACHE_PATH = join2(CACHE_DIR, "corp-codes.json");
+var CORP_CODE_CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function getApiKey(optionKey) {
+  const key = optionKey || process.env.DART_API_KEY;
+  if (!key) {
+    throw new Error("Set the DART_API_KEY environment variable or use the --api-key option. Get a key at https://opendart.fss.or.kr");
+  }
+  return key;
+}
+
+// src/errors.ts
+var DART_STATUS_MESSAGES = {
+  "000": "OK",
+  "010": "Unregistered API key",
+  "011": "Disabled API key",
+  "012": "IP not allowed",
+  "013": "No data found",
+  "014": "File not found",
+  "020": "Request limit exceeded",
+  "021": "Max company count exceeded (limit: 100)",
+  "100": "Invalid field value",
+  "101": "Unauthorized access",
+  "800": "System maintenance",
+  "900": "Undefined error",
+  "901": "Personal data retention period expired"
+};
+var DartApiError = class extends Error {
+  constructor(statusCode, dartMessage) {
+    const description = DART_STATUS_MESSAGES[statusCode] || "Unknown error";
+    super(`DART API error [${statusCode}]: ${description} \u2014 ${dartMessage}`);
+    this.statusCode = statusCode;
+    this.dartMessage = dartMessage;
+    this.name = "DartApiError";
+  }
+  statusCode;
+  dartMessage;
+  toJSON() {
+    return {
+      error: true,
+      code: this.statusCode,
+      description: DART_STATUS_MESSAGES[this.statusCode] || "Unknown error",
+      message: this.dartMessage
+    };
+  }
+};
+function formatErrorJson(err) {
+  if (err instanceof DartApiError) {
+    return JSON.stringify(err.toJSON());
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  return JSON.stringify({ error: true, code: "CLI_ERROR", message });
+}
+function checkDartStatus(data) {
+  if (data.status && data.status !== "000") {
+    throw new DartApiError(data.status, data.message || "");
+  }
+}
+
+// src/client.ts
+function buildUrl(path) {
+  const cleanPath = path.replace(/^\//, "");
+  return new URL(cleanPath, DART_BASE_URL);
+}
+async function dartFetch(opts) {
+  const url = buildUrl(opts.path);
+  url.searchParams.set("crtfc_key", opts.apiKey);
+  if (opts.params) {
+    for (const [k, v] of Object.entries(opts.params)) {
+      if (v !== void 0 && v !== "") {
+        url.searchParams.set(k, v);
+      }
+    }
+  }
+  const res = await fetch(url.toString());
+  if (!res.ok) {
+    throw new Error(`HTTP ${res.status}: ${res.statusText} \u2014 ${url.pathname}`);
+  }
+  const contentType = res.headers.get("content-type") || "";
+  if (contentType.includes("application/json")) {
+    const data = await res.json();
+    checkDartStatus(data);
+    return data;
+  }
+  throw new Error(`Unexpected content-type: ${contentType}. Binary endpoints should use dartFetchBinary().`);
+}
+async function dartFetchBinary(opts) {
+  const url = buildUrl(opts.path);
+  url.searchParams.set("crtfc_key", opts.apiKey);
+  if (opts.params) {
+    for (const [k, v] of Object.entries(opts.params)) {
+      if (v !== void 0 && v !== "") {
+        url.searchParams.set(k, v);
+      }
+    }
+  }
+  const res = await fetch(url.toString());
+  if (!res.ok) {
+    throw new Error(`HTTP ${res.status}: ${res.statusText} \u2014 ${url.pathname}`);
+  }
+  const buf = await res.arrayBuffer();
+  const header = new Uint8Array(buf.slice(0, 4));
+  const isZip = header[0] === 80 && header[1] === 75 && header[2] === 3 && header[3] === 4;
+  if (!isZip) {
+    const text = new TextDecoder().decode(buf);
+    try {
+      const data = JSON.parse(text);
+      checkDartStatus(data);
+    } catch {
+    }
+    throw new Error(`DART API error: expected ZIP file but got: ${text.slice(0, 200)}`);
+  }
+  return buf;
+}
+
+// src/corp-code.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync, statSync } from "fs";
+import { inflateRawSync } from "zlib";
+import { XMLParser } from "fast-xml-parser";
+function isNonKoreanName(name) {
+  return !/[\uAC00-\uD7AF]/.test(name);
+}
+function ensureCacheDir() {
+  if (!existsSync2(CACHE_DIR)) {
+    mkdirSync(CACHE_DIR, { recursive: true });
+  }
+}
+function isCacheValid() {
+  if (!existsSync2(CORP_CODE_CACHE_PATH)) return false;
+  const stat = statSync(CORP_CODE_CACHE_PATH);
+  return Date.now() - stat.mtimeMs < CORP_CODE_CACHE_MAX_AGE_MS;
+}
+function extractXmlFromZip(zipBuffer) {
+  const buf = Buffer.from(zipBuffer);
+  const sig = buf.indexOf(Buffer.from([80, 75, 3, 4]));
+  if (sig === -1) throw new Error("Invalid ZIP: no local file header found");
+  let compressedSize = buf.readUInt32LE(sig + 18);
+  const fileNameLength = buf.readUInt16LE(sig + 26);
+  const extraFieldLength = buf.readUInt16LE(sig + 28);
+  const compressionMethod = buf.readUInt16LE(sig + 8);
+  const dataStart = sig + 30 + fileNameLength + extraFieldLength;
+  if (compressedSize === 0) {
+    const centralDirSig = buf.indexOf(Buffer.from([80, 75, 1, 2]), dataStart);
+    if (centralDirSig !== -1) {
+      compressedSize = centralDirSig - dataStart;
+    } else {
+      compressedSize = buf.length - dataStart;
+    }
+  }
+  const compressedData = buf.subarray(dataStart, dataStart + compressedSize);
+  if (compressionMethod === 0) {
+    return compressedData.toString("utf-8");
+  } else if (compressionMethod === 8) {
+    const decompressed = inflateRawSync(compressedData);
+    return decompressed.toString("utf-8");
+  } else {
+    throw new Error(`Unsupported ZIP compression method: ${compressionMethod}`);
+  }
+}
+function parseCorpCodeXml(xml) {
+  const parser = new XMLParser({
+    ignoreAttributes: false,
+    isArray: (name) => name === "list"
+  });
+  const parsed = parser.parse(xml);
+  const items = parsed?.result?.list || [];
+  return items.map((item) => ({
+    corp_code: String(item.corp_code || "").padStart(8, "0"),
+    corp_name: String(item.corp_name || ""),
+    stock_code: String(item.stock_code || ""),
+    modify_date: String(item.modify_date || "")
+  }));
+}
+async function refreshCorpCodeCache(apiKey) {
+  console.error("Refreshing corp_code cache... (downloading ZIP)");
+  const zipData = await dartFetchBinary({ apiKey, path: "/corpCode.xml" });
+  console.error(`ZIP downloaded (${(zipData.byteLength / 1024 / 1024).toFixed(1)} MB)`);
+  const xml = extractXmlFromZip(zipData);
+  const entries = parseCorpCodeXml(xml);
+  const needsEnrichment = entries.filter(
+    (e) => e.stock_code && e.stock_code.trim() !== "" && isNonKoreanName(e.corp_name)
+  );
+  if (needsEnrichment.length > 0) {
+    console.error(`Enriching ${needsEnrichment.length} listed companies with Korean names...`);
+    for (const entry of needsEnrichment) {
+      try {
+        const data = await dartFetch({ apiKey, path: "/company.json", params: { corp_code: entry.corp_code } });
+        entry.korean_name = String(data.corp_name || "");
+        entry.stock_name = String(data.stock_name || "");
+      } catch {
+      }
+    }
+    console.error("Enrichment complete.");
+  }
+  ensureCacheDir();
+  writeFileSync(CORP_CODE_CACHE_PATH, JSON.stringify(entries), "utf-8");
+  console.error(`Cache saved: ${entries.length} corporations`);
+  return entries;
+}
+async function getCorpCodes(apiKey) {
+  if (isCacheValid()) {
+    const data = readFileSync2(CORP_CODE_CACHE_PATH, "utf-8");
+    return JSON.parse(data);
+  }
+  return refreshCorpCodeCache(apiKey);
+}
+async function resolveCorpCode(nameOrCode, apiKey) {
+  if (/^\d{8}$/.test(nameOrCode)) return nameOrCode;
+  const entries = await getCorpCodes(apiKey);
+  const term = nameOrCode.trim();
+  const exact = entries.find(
+    (e) => e.corp_name === term || e.stock_code === term || e.korean_name === term || e.stock_name === term
+  );
+  if (exact) return exact.corp_code;
+  const partial = entries.filter(
+    (e) => e.corp_name.includes(term) || e.korean_name && e.korean_name.includes(term)
+  );
+  if (partial.length === 1) return partial[0].corp_code;
+  if (partial.length > 1) {
+    const listed = partial.filter((e) => e.stock_code && e.stock_code.length > 0);
+    if (listed.length === 1) return listed[0].corp_code;
+    const displayName = (e) => e.korean_name || e.corp_name;
+    const matches = partial.slice(0, 10).map((e) => `${e.corp_code} \u2014 ${displayName(e)} (${e.stock_code || "unlisted"})`);
+    throw new Error(`Multiple matches for "${term}": ${matches.join(", ")}${partial.length > 10 ? ` ... and ${partial.length - 10} more` : ""}`);
+  }
+  throw new Error(`No corporation found for "${term}".`);
+}
+async function lookupCorpCode(term, apiKey) {
+  const entries = await getCorpCodes(apiKey);
+  return entries.filter(
+    (e) => e.corp_name.includes(term) || e.corp_code === term || e.stock_code === term || e.korean_name && e.korean_name.includes(term) || e.stock_name && e.stock_name.includes(term)
+  );
+}
+
+// src/json-params.ts
+function parseJsonParams(jsonStr) {
+  try {
+    return JSON.parse(jsonStr);
+  } catch {
+    throw new Error("Invalid JSON in --json parameter");
+  }
+}
+
+// src/output.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+function pickFields(data, fields) {
+  if (Array.isArray(data)) {
+    return data.map((item) => pickFields(item, fields));
+  }
+  if (data !== null && typeof data === "object") {
+    const record = data;
+    if (Array.isArray(record.list)) {
+      return { ...record, list: record.list.map((item) => pickFields(item, fields)) };
+    }
+    const result = {};
+    for (const f of fields) {
+      if (f in record) {
+        result[f] = record[f];
+      }
+    }
+    return result;
+  }
+  return data;
+}
+function formatOutput(data, opts) {
+  let out = data;
+  if (opts.fields) {
+    const fields = opts.fields.split(",").map((f) => f.trim());
+    out = pickFields(data, fields);
+  }
+  if (opts.pretty) {
+    return JSON.stringify(out, null, 2);
+  }
+  return JSON.stringify(out);
+}
+function writeDryRun(path, params, opts) {
+  const cleanPath = path.replace(/^\//, "");
+  const url = new URL(cleanPath, DART_BASE_URL);
+  for (const [k, v] of Object.entries(params)) {
+    url.searchParams.set(k, v);
+  }
+  const info = {
+    endpoint: cleanPath,
+    method: "GET",
+    url: url.toString(),
+    params
+  };
+  const text = JSON.stringify(info, null, 2);
+  console.log(text);
+}
+function writeOutput(data, opts) {
+  const text = formatOutput(data, opts);
+  if (opts.output) {
+    writeFileSync2(opts.output, text, "utf-8");
+    console.error(`Saved to ${opts.output}`);
+  } else {
+    console.log(text);
+  }
+}
+
+// src/registry.ts
+var REGISTRY = [
+  {
+    path: "list.json",
+    cliName: "list",
+    summary: "\uACF5\uC2DC \uAC80\uC0C9",
+    pattern: "special",
+    group: "disclosure",
+    tag: "\uACF5\uC2DC\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "corp_code",
+        "description": "\uACE0\uC720\uBC88\uD638 (8\uC790\uB9AC). \uBBF8\uC785\uB825 \uC2DC \uC804\uCCB4 \uAC80\uC0C9",
+        "required": false
+      },
+      {
+        "name": "bgn_de",
+        "description": "\uC2DC\uC791\uC77C (YYYYMMDD). \uAE30\uBCF8\uAC12\uC740 end_de\uC640 \uB3D9\uC77C",
+        "required": false
+      },
+      {
+        "name": "end_de",
+        "description": "\uC885\uB8CC\uC77C (YYYYMMDD). \uAE30\uBCF8\uAC12\uC740 \uB2F9\uC77C",
+        "required": false
+      },
+      {
+        "name": "last_reprt_at",
+        "description": "\uCD5C\uC885\uBCF4\uACE0\uC11C\uB9CC \uAC80\uC0C9 \uC5EC\uBD80. \uAE30\uBCF8\uAC12 N",
+        "required": false,
+        "enum": [
+          "Y",
+          "N"
+        ]
+      },
+      {
+        "name": "pblntf_ty",
+        "description": "\uACF5\uC2DC\uC720\uD615:",
+        "required": false,
+        "enum": [
+          "A",
+          "B",
+          "C",
+          "D",
+          "E",
+          "F",
+          "G",
+          "H",
+          "I",
+          "J"
+        ]
+      },
+      {
+        "name": "pblntf_detail_ty",
+        "description": "\uACF5\uC2DC\uC0C1\uC138\uC720\uD615 \uCF54\uB4DC (4\uC790\uB9AC)",
+        "required": false
+      },
+      {
+        "name": "corp_cls",
+        "description": "\uBC95\uC778\uAD6C\uBD84: Y(\uC720\uAC00), K(\uCF54\uC2A4\uB2E5), N(\uCF54\uB125\uC2A4), E(\uAE30\uD0C0)",
+        "required": false,
+        "enum": [
+          "Y",
+          "K",
+          "N",
+          "E"
+        ]
+      },
+      {
+        "name": "sort",
+        "description": "\uC815\uB82C\uAE30\uC900: date(\uC811\uC218\uC77C), crp(\uD68C\uC0AC\uBA85), rpt(\uBCF4\uACE0\uC11C\uBA85). \uAE30\uBCF8\uAC12 date",
+        "required": false,
+        "enum": [
+          "date",
+          "crp",
+          "rpt"
+        ]
+      },
+      {
+        "name": "sort_mth",
+        "description": "\uC815\uB82C\uBC29\uC2DD: asc(\uC624\uB984\uCC28\uC21C), desc(\uB0B4\uB9BC\uCC28\uC21C). \uAE30\uBCF8\uAC12 desc",
+        "required": false,
+        "enum": [
+          "asc",
+          "desc"
+        ]
+      },
+      {
+        "name": "page_no",
+        "description": "\uD398\uC774\uC9C0 \uBC88\uD638 (1~n). \uAE30\uBCF8\uAC12 1",
+        "required": false
+      },
+      {
+        "name": "page_count",
+        "description": "\uD398\uC774\uC9C0\uB2F9 \uAC74\uC218 (1~100). \uAE30\uBCF8\uAC12 10",
+        "required": false
+      }
+    ]
+  },
+  {
+    path: "company.json",
+    cliName: "company",
+    summary: "\uAE30\uC5C5 \uAC1C\uD669",
+    pattern: "corpOnly",
+    group: "disclosure",
+    tag: "\uACF5\uC2DC\uC815\uBCF4"
+  },
+  {
+    path: "document.xml",
+    cliName: "document",
+    summary: "\uACF5\uC2DC\uC11C\uB958 \uC6D0\uBCF8\uD30C\uC77C",
+    pattern: "special",
+    group: "disclosure",
+    tag: "\uACF5\uC2DC\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "rcept_no",
+        "description": "\uC811\uC218\uBC88\uD638 (14\uC790\uB9AC)",
+        "required": true
+      }
+    ]
+  },
+  {
+    path: "corpCode.xml",
+    cliName: "corp-code",
+    summary: "\uACE0\uC720\uBC88\uD638 \uC804\uCCB4 \uBAA9\uB85D",
+    pattern: "special",
+    group: "disclosure",
+    tag: "\uACF5\uC2DC\uC815\uBCF4"
+  },
+  {
+    path: "irdsSttus.json",
+    cliName: "capital-change",
+    summary: "\uC99D\uC790(\uAC10\uC790) \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "alotMatter.json",
+    cliName: "dividend",
+    summary: "\uBC30\uB2F9\uC5D0 \uAD00\uD55C \uC0AC\uD56D",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tesstkAcqsDspsSttus.json",
+    cliName: "treasury-stock",
+    summary: "\uC790\uAE30\uC8FC\uC2DD \uCDE8\uB4DD \uBC0F \uCC98\uBD84 \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "stockTotqySttus.json",
+    cliName: "stock-total",
+    summary: "\uC8FC\uC2DD\uC758 \uCD1D\uC218 \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "hyslrSttus.json",
+    cliName: "shareholder",
+    summary: "\uCD5C\uB300\uC8FC\uC8FC \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "hyslrChgSttus.json",
+    cliName: "shareholder-change",
+    summary: "\uCD5C\uB300\uC8FC\uC8FC \uBCC0\uB3D9\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "mrhlSttus.json",
+    cliName: "minority-shareholder",
+    summary: "\uC18C\uC561\uC8FC\uC8FC \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "exctvSttus.json",
+    cliName: "executive",
+    summary: "\uC784\uC6D0 \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "empSttus.json",
+    cliName: "employee",
+    summary: "\uC9C1\uC6D0 \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "hmvAuditIndvdlBySttus.json",
+    cliName: "exec-pay-individual",
+    summary: "\uC774\uC0AC\xB7\uAC10\uC0AC\uC758 \uAC1C\uC778\uBCC4 \uBCF4\uC218\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "hmvAuditAllSttus.json",
+    cliName: "exec-pay-total",
+    summary: "\uC774\uC0AC\xB7\uAC10\uC0AC \uC804\uCCB4\uC758 \uBCF4\uC218\uD604\uD669 (\uBCF4\uC218\uC9C0\uAE09\uAE08\uC561 - \uC774\uC0AC\xB7\uAC10\uC0AC \uC804\uCCB4)",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "indvdlByPay.json",
+    cliName: "top-pay",
+    summary: "\uAC1C\uC778\uBCC4 \uBCF4\uC218\uC9C0\uAE09 \uAE08\uC561 (5\uC5B5\uC774\uC0C1 \uC0C1\uC7045\uC778)",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "unrstExctvMendngSttus.json",
+    cliName: "unregistered-exec-pay",
+    summary: "\uBBF8\uB4F1\uAE30\uC784\uC6D0 \uBCF4\uC218\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "drctrAdtAllMendngSttusGmtsckConfmAmount.json",
+    cliName: "director-pay-approved",
+    summary: "\uC774\uC0AC\xB7\uAC10\uC0AC \uC804\uCCB4\uC758 \uBCF4\uC218\uD604\uD669 (\uC8FC\uC8FC\uCD1D\uD68C \uC2B9\uC778\uAE08\uC561)",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "drctrAdtAllMendngSttusMendngPymntamtTyCl.json",
+    cliName: "director-pay-type",
+    summary: "\uC774\uC0AC\xB7\uAC10\uC0AC \uC804\uCCB4\uC758 \uBCF4\uC218\uD604\uD669 (\uBCF4\uC218\uC9C0\uAE09\uAE08\uC561 - \uC720\uD615\uBCC4)",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "detScritsIsuAcmslt.json",
+    cliName: "debt-securities",
+    summary: "\uCC44\uBB34\uC99D\uAD8C \uBC1C\uD589\uC2E4\uC801",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "entrprsBilScritsNrdmpBlce.json",
+    cliName: "commercial-paper",
+    summary: "\uAE30\uC5C5\uC5B4\uC74C\uC99D\uAD8C \uBBF8\uC0C1\uD658 \uC794\uC561",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "srtpdPsndbtNrdmpBlce.json",
+    cliName: "short-term-bond",
+    summary: "\uB2E8\uAE30\uC0AC\uCC44 \uBBF8\uC0C1\uD658 \uC794\uC561",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cprndNrdmpBlce.json",
+    cliName: "contingent-bond",
+    summary: "\uD68C\uC0AC\uCC44 \uBBF8\uC0C1\uD658 \uC794\uC561",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "newCaplScritsNrdmpBlce.json",
+    cliName: "new-capital-securities",
+    summary: "\uC2E0\uC885\uC790\uBCF8\uC99D\uAD8C \uBBF8\uC0C1\uD658 \uC794\uC561",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cndlCaplScritsNrdmpBlce.json",
+    cliName: "conditional-capital-securities",
+    summary: "\uC870\uAC74\uBD80 \uC790\uBCF8\uC99D\uAD8C \uBBF8\uC0C1\uD658 \uC794\uC561",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "accnutAdtorNmNdAdtOpinion.json",
+    cliName: "auditor-opinion",
+    summary: "\uD68C\uACC4\uAC10\uC0AC\uC778\uC758 \uBA85\uCE6D \uBC0F \uAC10\uC0AC\uC758\uACAC",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "adtServcCnclsSttus.json",
+    cliName: "audit-service",
+    summary: "\uAC10\uC0AC\uC6A9\uC5ED\uCCB4\uACB0\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "accnutAdtorNonAdtServcCnclsSttus.json",
+    cliName: "non-audit-service",
+    summary: "\uD68C\uACC4\uAC10\uC0AC\uC778\uACFC\uC758 \uBE44\uAC10\uC0AC\uC6A9\uC5ED \uACC4\uC57D\uCCB4\uACB0 \uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "outcmpnyDrctrNdChangeSttus.json",
+    cliName: "outside-director",
+    summary: "\uC0AC\uC678\uC774\uC0AC \uBC0F \uADF8 \uBCC0\uB3D9\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "otrCprInvstmntSttus.json",
+    cliName: "other-corp-investment",
+    summary: "\uD0C0\uBC95\uC778 \uCD9C\uC790\uD604\uD669",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "pssrpCptalUseDtls.json",
+    cliName: "public-fund-usage",
+    summary: "\uACF5\uBAA8\uC790\uAE08\uC758 \uC0AC\uC6A9\uB0B4\uC5ED",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "prvsrpCptalUseDtls.json",
+    cliName: "private-fund-usage",
+    summary: "\uC0AC\uBAA8\uC790\uAE08\uC758 \uC0AC\uC6A9\uB0B4\uC5ED",
+    pattern: "periodic",
+    group: "report",
+    tag: "\uC815\uAE30\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "fnlttSinglAcnt.json",
+    cliName: "single-account",
+    summary: "\uB2E8\uC77C\uD68C\uC0AC \uC8FC\uC694\uACC4\uC815",
+    pattern: "periodic",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4"
+  },
+  {
+    path: "fnlttMultiAcnt.json",
+    cliName: "multi-account",
+    summary: "\uB2E4\uC911\uD68C\uC0AC \uC8FC\uC694\uACC4\uC815",
+    pattern: "special",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "corp_code",
+        "description": "\uACE0\uC720\uBC88\uD638 (\uC27C\uD45C \uAD6C\uBD84, \uCD5C\uB300 100\uAC1C)",
+        "required": true
+      }
+    ]
+  },
+  {
+    path: "fnlttSinglAcntAll.json",
+    cliName: "full-statement",
+    summary: "\uB2E8\uC77C\uD68C\uC0AC \uC804\uCCB4 \uC7AC\uBB34\uC81C\uD45C",
+    pattern: "periodic",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "fs_div",
+        "description": "\uAC1C\uBCC4/\uC5F0\uACB0 \uAD6C\uBD84: OFS(\uC7AC\uBB34\uC81C\uD45C), CFS(\uC5F0\uACB0\uC7AC\uBB34\uC81C\uD45C)",
+        "required": true,
+        "enum": [
+          "OFS",
+          "CFS"
+        ]
+      }
+    ]
+  },
+  {
+    path: "fnlttSinglIndx.json",
+    cliName: "single-index",
+    summary: "\uB2E8\uC77C\uD68C\uC0AC \uC8FC\uC694 \uC7AC\uBB34\uC9C0\uD45C",
+    pattern: "periodic",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4"
+  },
+  {
+    path: "fnlttCmpnyIndx.json",
+    cliName: "multi-index",
+    summary: "\uB2E4\uC911\uD68C\uC0AC \uC8FC\uC694 \uC7AC\uBB34\uC9C0\uD45C",
+    pattern: "special",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "corp_code",
+        "description": "\uACE0\uC720\uBC88\uD638 (\uC27C\uD45C \uAD6C\uBD84, \uCD5C\uB300 100\uAC1C)",
+        "required": true
+      }
+    ]
+  },
+  {
+    path: "fnlttXbrl.xml",
+    cliName: "xbrl",
+    summary: "XBRL \uC7AC\uBB34\uC81C\uD45C \uC6D0\uBCF8\uD30C\uC77C",
+    pattern: "special",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "rcept_no",
+        "description": "\uC811\uC218\uBC88\uD638 (14\uC790\uB9AC)",
+        "required": true
+      }
+    ]
+  },
+  {
+    path: "xbrlTaxonomy.json",
+    cliName: "taxonomy",
+    summary: "XBRL \uD0DD\uC0AC\uB178\uBBF8 \uC7AC\uBB34\uC81C\uD45C \uC591\uC2DD",
+    pattern: "special",
+    group: "financial",
+    tag: "\uC7AC\uBB34\uC815\uBCF4",
+    extraParams: [
+      {
+        "name": "sj_div",
+        "description": "\uC7AC\uBB34\uC81C\uD45C\uAD6C\uBD84:",
+        "required": true,
+        "enum": [
+          "BS1",
+          "BS2",
+          "BS3",
+          "BS4",
+          "IS1",
+          "IS2",
+          "IS3",
+          "IS4",
+          "CIS1",
+          "CIS2",
+          "CF1",
+          "CF2",
+          "SCE"
+        ]
+      }
+    ]
+  },
+  {
+    path: "majorstock.json",
+    cliName: "major-stock",
+    summary: "\uB300\uB7C9\uBCF4\uC720 \uC0C1\uD669\uBCF4\uACE0",
+    pattern: "corpOnly",
+    group: "equity",
+    tag: "\uC9C0\uBD84\uACF5\uC2DC"
+  },
+  {
+    path: "elestock.json",
+    cliName: "executive-stock",
+    summary: "\uC784\uC6D0\xB7\uC8FC\uC694\uC8FC\uC8FC \uC18C\uC720\uBCF4\uACE0",
+    pattern: "corpOnly",
+    group: "equity",
+    tag: "\uC9C0\uBD84\uACF5\uC2DC"
+  },
+  {
+    path: "astInhtrfEtcPtbkOpt.json",
+    cliName: "asset-transfer",
+    summary: "\uC790\uC0B0\uC591\uC218\uB3C4(\uAE30\uD0C0), \uD48B\uBC31\uC635\uC158",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "dfOcr.json",
+    cliName: "default",
+    summary: "\uBD80\uB3C4\uBC1C\uC0DD",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bsnSp.json",
+    cliName: "business-suspension",
+    summary: "\uC601\uC5C5\uC815\uC9C0",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "ctrcvsBgrq.json",
+    cliName: "rehabilitation",
+    summary: "\uD68C\uC0DD\uC808\uCC28 \uAC1C\uC2DC\uC2E0\uCCAD",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "dsRsOcr.json",
+    cliName: "dissolution",
+    summary: "\uD574\uC0B0\uC0AC\uC720 \uBC1C\uC0DD",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "piicDecsn.json",
+    cliName: "paid-increase",
+    summary: "\uC720\uC0C1\uC99D\uC790 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "fricDecsn.json",
+    cliName: "free-increase",
+    summary: "\uBB34\uC0C1\uC99D\uC790 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "pifricDecsn.json",
+    cliName: "paid-free-increase",
+    summary: "\uC720\uBB34\uC0C1\uC99D\uC790 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "crDecsn.json",
+    cliName: "capital-reduction",
+    summary: "\uAC10\uC790 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bnkMngtPcbg.json",
+    cliName: "creditor-mgmt-start",
+    summary: "\uCC44\uAD8C\uC740\uD589 \uB4F1\uC758 \uAD00\uB9AC\uC808\uCC28 \uAC1C\uC2DC",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "lwstLg.json",
+    cliName: "lawsuit",
+    summary: "\uC18C\uC1A1 \uB4F1\uC758 \uC81C\uAE30",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "ovLstDecsn.json",
+    cliName: "overseas-listing-decision",
+    summary: "\uD574\uC678 \uC99D\uAD8C\uC2DC\uC7A5 \uC8FC\uAD8C\uB4F1 \uC0C1\uC7A5 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "ovDlstDecsn.json",
+    cliName: "overseas-delisting-decision",
+    summary: "\uD574\uC678 \uC99D\uAD8C\uC2DC\uC7A5 \uC8FC\uAD8C\uB4F1 \uC0C1\uC7A5\uD3D0\uC9C0 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "ovLst.json",
+    cliName: "overseas-listing",
+    summary: "\uD574\uC678 \uC99D\uAD8C\uC2DC\uC7A5 \uC8FC\uAD8C\uB4F1 \uC0C1\uC7A5",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "ovDlst.json",
+    cliName: "overseas-delisting",
+    summary: "\uD574\uC678 \uC99D\uAD8C\uC2DC\uC7A5 \uC8FC\uAD8C\uB4F1 \uC0C1\uC7A5\uD3D0\uC9C0",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cvbdIsDecsn.json",
+    cliName: "convertible-bond",
+    summary: "\uC804\uD658\uC0AC\uCC44\uAD8C \uBC1C\uD589\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bdwtIsDecsn.json",
+    cliName: "bond-with-warrant",
+    summary: "\uC2E0\uC8FC\uC778\uC218\uAD8C\uBD80\uC0AC\uCC44\uAD8C \uBC1C\uD589\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "exbdIsDecsn.json",
+    cliName: "exchangeable-bond",
+    summary: "\uAD50\uD658\uC0AC\uCC44\uAD8C \uBC1C\uD589\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bnkMngtPcsp.json",
+    cliName: "creditor-mgmt-stop",
+    summary: "\uCC44\uAD8C\uC740\uD589 \uB4F1\uC758 \uAD00\uB9AC\uC808\uCC28 \uC911\uB2E8",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "wdCocobdIsDecsn.json",
+    cliName: "contingent-convertible",
+    summary: "\uC0C1\uAC01\uD615 \uC870\uAC74\uBD80\uC790\uBCF8\uC99D\uAD8C \uBC1C\uD589\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tsstkAqDecsn.json",
+    cliName: "treasury-acquire",
+    summary: "\uC790\uAE30\uC8FC\uC2DD \uCDE8\uB4DD \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tsstkDpDecsn.json",
+    cliName: "treasury-dispose",
+    summary: "\uC790\uAE30\uC8FC\uC2DD \uCC98\uBD84 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tsstkAqTrctrCnsDecsn.json",
+    cliName: "treasury-trust-start",
+    summary: "\uC790\uAE30\uC8FC\uC2DD\uCDE8\uB4DD \uC2E0\uD0C1\uACC4\uC57D \uCCB4\uACB0 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tsstkAqTrctrCcDecsn.json",
+    cliName: "treasury-trust-end",
+    summary: "\uC790\uAE30\uC8FC\uC2DD\uCDE8\uB4DD \uC2E0\uD0C1\uACC4\uC57D \uD574\uC9C0 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bsnInhDecsn.json",
+    cliName: "business-acquire",
+    summary: "\uC601\uC5C5\uC591\uC218 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "bsnTrfDecsn.json",
+    cliName: "business-transfer",
+    summary: "\uC601\uC5C5\uC591\uB3C4 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tgastInhDecsn.json",
+    cliName: "tangible-asset-acquire",
+    summary: "\uC720\uD615\uC790\uC0B0 \uC591\uC218 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "tgastTrfDecsn.json",
+    cliName: "tangible-asset-transfer",
+    summary: "\uC720\uD615\uC790\uC0B0 \uC591\uB3C4 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "otcprStkInvscrInhDecsn.json",
+    cliName: "other-stock-acquire",
+    summary: "\uD0C0\uBC95\uC778 \uC8FC\uC2DD \uBC0F \uCD9C\uC790\uC99D\uAD8C \uC591\uC218\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "otcprStkInvscrTrfDecsn.json",
+    cliName: "other-stock-transfer",
+    summary: "\uD0C0\uBC95\uC778 \uC8FC\uC2DD \uBC0F \uCD9C\uC790\uC99D\uAD8C \uC591\uB3C4\uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "stkrtbdInhDecsn.json",
+    cliName: "stock-bond-acquire",
+    summary: "\uC8FC\uAD8C \uAD00\uB828 \uC0AC\uCC44\uAD8C \uC591\uC218 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "stkrtbdTrfDecsn.json",
+    cliName: "stock-bond-transfer",
+    summary: "\uC8FC\uAD8C \uAD00\uB828 \uC0AC\uCC44\uAD8C \uC591\uB3C4 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cmpMgDecsn.json",
+    cliName: "merger-decision",
+    summary: "\uD68C\uC0AC\uD569\uBCD1 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cmpDvDecsn.json",
+    cliName: "split-decision",
+    summary: "\uD68C\uC0AC\uBD84\uD560 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "cmpDvmgDecsn.json",
+    cliName: "split-merger-decision",
+    summary: "\uD68C\uC0AC\uBD84\uD560\uD569\uBCD1 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "stkExtrDecsn.json",
+    cliName: "stock-exchange-decision",
+    summary: "\uC8FC\uC2DD\uAD50\uD658\xB7\uC774\uC804 \uACB0\uC815",
+    pattern: "dateRange",
+    group: "major",
+    tag: "\uC8FC\uC694\uC0AC\uD56D\uBCF4\uACE0\uC11C"
+  },
+  {
+    path: "estkRs.json",
+    cliName: "equity-securities",
+    summary: "\uC9C0\uBD84\uC99D\uAD8C",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  },
+  {
+    path: "bdRs.json",
+    cliName: "debt-registration",
+    summary: "\uCC44\uBB34\uC99D\uAD8C",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  },
+  {
+    path: "stkdpRs.json",
+    cliName: "depository-receipt",
+    summary: "\uC99D\uAD8C\uC608\uD0C1\uC99D\uAD8C",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  },
+  {
+    path: "mgRs.json",
+    cliName: "merger-registration",
+    summary: "\uD569\uBCD1",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  },
+  {
+    path: "extrRs.json",
+    cliName: "exchange-registration",
+    summary: "\uC8FC\uC2DD\uC758\uD3EC\uAD04\uC801\uAD50\uD658\xB7\uC774\uC804",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  },
+  {
+    path: "dvRs.json",
+    cliName: "split-registration",
+    summary: "\uBD84\uD560",
+    pattern: "dateRange",
+    group: "securities",
+    tag: "\uC99D\uAD8C\uC2E0\uACE0\uC11C"
+  }
+];
+var REGISTRY_BY_CLI_NAME = /* @__PURE__ */ new Map();
+var REGISTRY_BY_GROUP = /* @__PURE__ */ new Map();
+for (const entry of REGISTRY) {
+  REGISTRY_BY_CLI_NAME.set(entry.cliName, entry);
+  const group = REGISTRY_BY_GROUP.get(entry.group) || [];
+  group.push(entry);
+  REGISTRY_BY_GROUP.set(entry.group, group);
+}
+
+// src/commands/disclosure.ts
+function getGlobalOpts(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerDisclosureCommands(program) {
+  const group = program.command("disclosure").description(
+    'DS001: Disclosure info \u2014 search filings, company overview, original documents, corp codes.\nUse "disclosure list" to search filings by company/date/type.\nUse "disclosure company" to get company profile (CEO, address, industry code).'
+  );
+  group.command("list").description(
+    "Search DART disclosure filings. Returns paginated results with report name, filing date, receipt number.\nWithout --corp, searches ALL companies (date range limited to 3 months).\nWith --corp, searches specific company with no date limit.\nDisclosure types: A=Regular, B=Major events, C=Issuance, D=Equity, E=Other, F=Audit, G=Fund, H=ABS, I=Exchange, J=FTC"
+  ).option("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').option("--from <YYYYMMDD>", "Start date in YYYYMMDD format (e.g. 20240101)").option("--to <YYYYMMDD>", "End date in YYYYMMDD format (e.g. 20241231)").option("--type <code>", "Disclosure type: A=Regular, B=Major events, C=Issuance, D=Equity, E=Other, F=Audit, G=Fund, H=ABS, I=Exchange, J=FTC").option("--corp-cls <cls>", "Corp class filter: Y=KOSPI, K=KOSDAQ, N=KONEX, E=Other").option("--page <n>", "Page number, starting from 1 (default: 1)", "1").option("--count <n>", "Items per page, 1-100 (default: 10)", "10").action(async (opts) => {
+    const globalOpts = getGlobalOpts(group);
+    const apiKey = getApiKey(globalOpts.apiKey);
+    if (globalOpts.json) {
+      const params2 = parseJsonParams(globalOpts.json);
+      const data2 = await dartFetch({ apiKey, path: "/list.json", params: params2 });
+      writeOutput(data2, globalOpts);
+      return;
+    }
+    const params = {};
+    if (opts.corp) params.corp_code = await resolveCorpCode(opts.corp, apiKey);
+    if (opts.from) params.bgn_de = opts.from;
+    if (opts.to) params.end_de = opts.to;
+    if (opts.type) params.pblntf_ty = opts.type;
+    if (opts.corpCls) params.corp_cls = opts.corpCls;
+    params.page_no = opts.page;
+    params.page_count = opts.count;
+    if (globalOpts.dryRun) {
+      writeDryRun("/list.json", params, globalOpts);
+      return;
+    }
+    const data = await dartFetch({ apiKey, path: "/list.json", params });
+    writeOutput(data, globalOpts);
+  });
+  group.command("company").description(
+    'Get company profile from DART. Returns corp name, CEO, address, stock code, industry code, incorporation date, fiscal month.\nAccepts company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code.'
+  ).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').action(async (opts) => {
+    const globalOpts = getGlobalOpts(group);
+    const apiKey = getApiKey(globalOpts.apiKey);
+    if (globalOpts.json) {
+      const params2 = parseJsonParams(globalOpts.json);
+      const data2 = await dartFetch({ apiKey, path: "/company.json", params: params2 });
+      writeOutput(data2, globalOpts);
+      return;
+    }
+    const corpCode = await resolveCorpCode(opts.corp, apiKey);
+    const params = { corp_code: corpCode };
+    if (globalOpts.dryRun) {
+      writeDryRun("/company.json", params, globalOpts);
+      return;
+    }
+    const data = await dartFetch({ apiKey, path: "/company.json", params });
+    writeOutput(data, globalOpts);
+  });
+  const ds001Endpoints = REGISTRY_BY_GROUP.get("disclosure") || [];
+  for (const ep of ds001Endpoints) {
+    if (["list", "company", "document", "corp-code"].includes(ep.cliName)) continue;
+    if (ep.pattern === "corpOnly") {
+      group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", "Company name or corp_code").action(async (opts) => {
+        const globalOpts = getGlobalOpts(group);
+        const apiKey = getApiKey(globalOpts.apiKey);
+        if (globalOpts.json) {
+          const params2 = parseJsonParams(globalOpts.json);
+          const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+          writeOutput(data2, globalOpts);
+          return;
+        }
+        const corpCode = await resolveCorpCode(opts.corp, apiKey);
+        const params = { corp_code: corpCode };
+        if (globalOpts.dryRun) {
+          writeDryRun(`/${ep.path}`, params, globalOpts);
+          return;
+        }
+        const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+        writeOutput(data, globalOpts);
+      });
+    }
+  }
+}
+function registerLookupCommand(program) {
+  program.command("lookup <term>").description(
+    "Look up corp_code by company name. Use this to find the 8-digit corp_code needed by other commands.\nSearches by exact and partial match. If multiple matches, lists all with stock codes."
+  ).action(async (term) => {
+    const globalOpts = program.opts();
+    const apiKey = getApiKey(globalOpts.apiKey);
+    const results = await lookupCorpCode(term, apiKey);
+    if (results.length === 0) {
+      throw new Error(`No corporation found for "${term}".`);
+    }
+    writeOutput(results, globalOpts);
+  });
+}
+function registerCorpCacheCommand(program) {
+  const cache = program.command("corp-cache").description("Manage the local corp_code cache (~/.dart-fss/corp-codes.json). Auto-refreshes every 7 days.");
+  cache.command("refresh").description("Force refresh corp_code cache").action(async () => {
+    const globalOpts = program.opts();
+    const apiKey = getApiKey(globalOpts.apiKey);
+    const entries = await refreshCorpCodeCache(apiKey);
+    console.error(`Refreshed: ${entries.length} corporations`);
+  });
+}
+
+// src/types.ts
+var REPRT_CODE_MAP = {
+  "q1": "11013",
+  "half": "11012",
+  "q3": "11014",
+  "annual": "11011"
+};
+var IDX_CL_CODE_MAP = {
+  "profitability": "M210000",
+  "stability": "M220000",
+  "growth": "M230000",
+  "activity": "M240000"
+};
+
+// src/commands/periodic-report.ts
+function getGlobalOpts2(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerPeriodicReportCommands(program) {
+  const group = program.command("report").description(
+    "DS002: Periodic report key information \u2014 28 APIs extracting data from annual/quarterly reports.\nCovers: capital changes, dividends, treasury stock, shareholders, executives, employees,\ncompensation, debt securities, audit info, outside directors, investments, fund usage.\nData available from 2015 onward."
+  );
+  const endpoints = (REGISTRY_BY_GROUP.get("report") || []).filter(
+    (ep) => ep.pattern === "periodic"
+  );
+  for (const ep of endpoints) {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--year <YYYY>", "Business year in YYYY format (e.g. 2024). Data from 2015 onward").requiredOption("--quarter <q1|half|q3|annual>", "Report quarter: q1 (Q1), half (semi-annual), q3 (Q3), annual (full year)").action(async (opts) => {
+      const globalOpts = getGlobalOpts2(group);
+      const apiKey = getApiKey(globalOpts.apiKey);
+      if (globalOpts.json) {
+        const params2 = parseJsonParams(globalOpts.json);
+        const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+        writeOutput(data2, globalOpts);
+        return;
+      }
+      const corpCode = await resolveCorpCode(opts.corp, apiKey);
+      const reprtCode = REPRT_CODE_MAP[opts.quarter];
+      if (!reprtCode) {
+        throw new Error(`Invalid quarter: ${opts.quarter} (must be one of: q1, half, q3, annual)`);
+      }
+      const params = { corp_code: corpCode, bsns_year: opts.year, reprt_code: reprtCode };
+      if (globalOpts.dryRun) {
+        writeDryRun(`/${ep.path}`, params, globalOpts);
+        return;
+      }
+      const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+      writeOutput(data, globalOpts);
+    });
+  }
+}
+
+// src/commands/financial.ts
+function getGlobalOpts3(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerFinancialCommands(program) {
+  const group = program.command("financial").description(
+    "DS003: Financial data \u2014 statements, indices, and XBRL for listed companies (KOSPI/KOSDAQ).\nIncludes key accounts (assets, liabilities, revenue), full financial statements,\nfinancial indices (profitability, stability, growth, activity), and XBRL taxonomy."
+  );
+  const endpoints = REGISTRY_BY_GROUP.get("financial") || [];
+  for (const ep of endpoints) {
+    const cmd = group.command(ep.cliName).description(ep.summary);
+    if (ep.pattern === "periodic") {
+      cmd.requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--year <YYYY>", "Business year in YYYY format (e.g. 2024). Data from 2015 onward").requiredOption("--quarter <q1|half|q3|annual>", "Report quarter: q1 (Q1), half (semi-annual), q3 (Q3), annual (full year)");
+      const needsIdxClCode = ep.cliName === "single-index";
+      if (needsIdxClCode) {
+        cmd.requiredOption("--idx-cl-code <code>", "Index classification: profitability (M210000), stability (M220000), growth (M230000), activity (M240000). Accepts aliases or raw codes");
+      }
+      if (ep.extraParams) {
+        for (const p of ep.extraParams) {
+          const flag = `--${p.name.replace(/_/g, "-")} <value>`;
+          if (p.required) {
+            cmd.requiredOption(flag, p.description);
+          } else {
+            cmd.option(flag, p.description);
+          }
+        }
+      }
+      cmd.action(async (opts) => {
+        const globalOpts = getGlobalOpts3(group);
+        const apiKey = getApiKey(globalOpts.apiKey);
+        if (globalOpts.json) {
+          const params2 = parseJsonParams(globalOpts.json);
+          const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+          writeOutput(data2, globalOpts);
+          return;
+        }
+        const corpCode = await resolveCorpCode(opts.corp, apiKey);
+        const reprtCode = REPRT_CODE_MAP[opts.quarter];
+        if (!reprtCode) {
+          throw new Error(`Invalid quarter: ${opts.quarter} (must be one of: q1, half, q3, annual)`);
+        }
+        const params = {
+          corp_code: corpCode,
+          bsns_year: opts.year,
+          reprt_code: reprtCode
+        };
+        if (needsIdxClCode && opts.idxClCode) {
+          params.idx_cl_code = IDX_CL_CODE_MAP[opts.idxClCode] || opts.idxClCode;
+        }
+        if (ep.extraParams) {
+          for (const p of ep.extraParams) {
+            const optKey = p.name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+            if (opts[optKey]) {
+              params[p.name] = opts[optKey];
+            }
+          }
+        }
+        if (globalOpts.dryRun) {
+          writeDryRun(`/${ep.path}`, params, globalOpts);
+          return;
+        }
+        const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+        writeOutput(data, globalOpts);
+      });
+    } else if (ep.cliName === "multi-account" || ep.cliName === "multi-index") {
+      cmd.requiredOption("--corp <codes>", 'Corp codes, comma-separated, max 100 (e.g. "00126380,00258801")').requiredOption("--year <YYYY>", "Business year in YYYY format (e.g. 2024). Data from 2015 onward").requiredOption("--quarter <q1|half|q3|annual>", "Report quarter: q1 (Q1), half (semi-annual), q3 (Q3), annual (full year)");
+      if (ep.cliName === "multi-index") {
+        cmd.requiredOption("--idx-cl-code <code>", "Index classification: profitability (M210000), stability (M220000), growth (M230000), activity (M240000). Accepts aliases or raw codes");
+      }
+      cmd.action(async (opts) => {
+        const globalOpts = getGlobalOpts3(group);
+        const apiKey = getApiKey(globalOpts.apiKey);
+        if (globalOpts.json) {
+          const params2 = parseJsonParams(globalOpts.json);
+          const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+          writeOutput(data2, globalOpts);
+          return;
+        }
+        const reprtCode = REPRT_CODE_MAP[opts.quarter];
+        if (!reprtCode) {
+          throw new Error(`Invalid quarter: ${opts.quarter} (must be one of: q1, half, q3, annual)`);
+        }
+        const params = {
+          corp_code: opts.corp,
+          bsns_year: opts.year,
+          reprt_code: reprtCode
+        };
+        if (opts.idxClCode) {
+          params.idx_cl_code = IDX_CL_CODE_MAP[opts.idxClCode] || opts.idxClCode;
+        }
+        if (globalOpts.dryRun) {
+          writeDryRun(`/${ep.path}`, params, globalOpts);
+          return;
+        }
+        const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+        writeOutput(data, globalOpts);
+      });
+    } else if (ep.cliName === "taxonomy") {
+      cmd.requiredOption("--sj-div <code>", "Statement type code: BS1=Balance sheet, IS1=Income statement, CIS1=Comprehensive income, CF1/CF2=Cash flow, SCE=Equity changes").action(async (opts) => {
+        const globalOpts = getGlobalOpts3(group);
+        const apiKey = getApiKey(globalOpts.apiKey);
+        if (globalOpts.json) {
+          const params2 = parseJsonParams(globalOpts.json);
+          const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+          writeOutput(data2, globalOpts);
+          return;
+        }
+        const params = { sj_div: opts.sjDiv };
+        if (globalOpts.dryRun) {
+          writeDryRun(`/${ep.path}`, params, globalOpts);
+          return;
+        }
+        const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+        writeOutput(data, globalOpts);
+      });
+    }
+  }
+}
+
+// src/commands/equity-disclosure.ts
+function getGlobalOpts4(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerEquityDisclosureCommands(program) {
+  const group = program.command("equity").description(
+    'DS004: Equity disclosure \u2014 major shareholding reports and executive/major shareholder ownership.\nUse "equity major-stock" for large shareholding (5%+ ownership) status reports.\nUse "equity executive-stock" for executive and major shareholder ownership reports.'
+  );
+  const endpoints = (REGISTRY_BY_GROUP.get("equity") || []).filter(
+    (ep) => ep.pattern === "corpOnly"
+  );
+  for (const ep of endpoints) {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", "Company name or corp_code").action(async (opts) => {
+      const globalOpts = getGlobalOpts4(group);
+      const apiKey = getApiKey(globalOpts.apiKey);
+      if (globalOpts.json) {
+        const params2 = parseJsonParams(globalOpts.json);
+        const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+        writeOutput(data2, globalOpts);
+        return;
+      }
+      const corpCode = await resolveCorpCode(opts.corp, apiKey);
+      const params = { corp_code: corpCode };
+      if (globalOpts.dryRun) {
+        writeDryRun(`/${ep.path}`, params, globalOpts);
+        return;
+      }
+      const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+      writeOutput(data, globalOpts);
+    });
+  }
+}
+
+// src/commands/major-report.ts
+function getGlobalOpts5(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerMajorReportCommands(program) {
+  const group = program.command("major").description(
+    "DS005: Major event reports \u2014 36 APIs for significant corporate events.\nCovers: capital increases/reductions, bond issuances (convertible, exchangeable, warrant),\ntreasury stock, M&A (mergers, splits, business/asset transfers), lawsuits,\noverseas listings, defaults, business suspension, rehabilitation.\nData available from 2015 onward. Requires date range."
+  );
+  const endpoints = (REGISTRY_BY_GROUP.get("major") || []).filter(
+    (ep) => ep.pattern === "dateRange"
+  );
+  for (const ep of endpoints) {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").action(async (opts) => {
+      const globalOpts = getGlobalOpts5(group);
+      const apiKey = getApiKey(globalOpts.apiKey);
+      if (globalOpts.json) {
+        const params2 = parseJsonParams(globalOpts.json);
+        const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+        writeOutput(data2, globalOpts);
+        return;
+      }
+      const corpCode = await resolveCorpCode(opts.corp, apiKey);
+      const params = { corp_code: corpCode, bgn_de: opts.from, end_de: opts.to };
+      if (globalOpts.dryRun) {
+        writeDryRun(`/${ep.path}`, params, globalOpts);
+        return;
+      }
+      const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+      writeOutput(data, globalOpts);
+    });
+  }
+}
+
+// src/commands/securities-filing.ts
+function getGlobalOpts6(cmd) {
+  return cmd.optsWithGlobals();
+}
+function registerSecuritiesFilingCommands(program) {
+  const group = program.command("securities").description(
+    "DS006: Securities registration statements \u2014 6 APIs for securities filings.\nCovers: equity securities, debt securities, depository receipts,\nmergers, comprehensive stock exchange/transfer, and splits.\nData available from 2015 onward. Requires date range."
+  );
+  const endpoints = (REGISTRY_BY_GROUP.get("securities") || []).filter(
+    (ep) => ep.pattern === "dateRange"
+  );
+  for (const ep of endpoints) {
+    group.command(ep.cliName).description(ep.summary).requiredOption("--corp <name-or-code>", 'Company name (e.g. "\uC0BC\uC131\uC804\uC790") or 8-digit corp_code').requiredOption("--from <YYYYMMDD>", "Start date in YYYYMMDD format (filing date). Data from 2015 onward").requiredOption("--to <YYYYMMDD>", "End date in YYYYMMDD format (filing date)").action(async (opts) => {
+      const globalOpts = getGlobalOpts6(group);
+      const apiKey = getApiKey(globalOpts.apiKey);
+      if (globalOpts.json) {
+        const params2 = parseJsonParams(globalOpts.json);
+        const data2 = await dartFetch({ apiKey, path: `/${ep.path}`, params: params2 });
+        writeOutput(data2, globalOpts);
+        return;
+      }
+      const corpCode = await resolveCorpCode(opts.corp, apiKey);
+      const params = { corp_code: corpCode, bgn_de: opts.from, end_de: opts.to };
+      if (globalOpts.dryRun) {
+        writeDryRun(`/${ep.path}`, params, globalOpts);
+        return;
+      }
+      const data = await dartFetch({ apiKey, path: `/${ep.path}`, params });
+      writeOutput(data, globalOpts);
+    });
+  }
+}
+
+// src/commands/schema.ts
+function getPeriodicParams() {
+  return [
+    {
+      name: "corp_code",
+      type: "STRING(8)",
+      required: true,
+      description: "Company unique code (8 digits)"
+    },
+    {
+      name: "bsns_year",
+      type: "STRING(4)",
+      required: true,
+      description: "Business year (e.g. 2024). Data from 2015 onward"
+    },
+    {
+      name: "reprt_code",
+      type: "STRING(5)",
+      required: true,
+      description: "Report code",
+      enum: { "11013": "Q1", "11012": "Semi-annual", "11014": "Q3", "11011": "Annual" }
+    }
+  ];
+}
+function getDateRangeParams() {
+  return [
+    {
+      name: "corp_code",
+      type: "STRING(8)",
+      required: true,
+      description: "Company unique code (8 digits)"
+    },
+    {
+      name: "bgn_de",
+      type: "STRING(8)",
+      required: true,
+      description: "Start date",
+      format: "YYYYMMDD"
+    },
+    {
+      name: "end_de",
+      type: "STRING(8)",
+      required: true,
+      description: "End date",
+      format: "YYYYMMDD"
+    }
+  ];
+}
+function getCorpOnlyParams() {
+  return [
+    {
+      name: "corp_code",
+      type: "STRING(8)",
+      required: true,
+      description: "Company unique code (8 digits)"
+    }
+  ];
+}
+function extraParamToSchema(p) {
+  const schema = {
+    name: p.name,
+    type: "STRING",
+    required: p.required,
+    description: p.description
+  };
+  if (p.enum) {
+    schema.enum = p.enum;
+  }
+  return schema;
+}
+function buildSchema(ep) {
+  let parameters;
+  switch (ep.pattern) {
+    case "periodic":
+      parameters = getPeriodicParams();
+      break;
+    case "dateRange":
+      parameters = getDateRangeParams();
+      break;
+    case "corpOnly":
+      parameters = getCorpOnlyParams();
+      break;
+    case "special":
+      parameters = [];
+      break;
+  }
+  if (ep.extraParams) {
+    for (const p of ep.extraParams) {
+      if (!parameters.find((existing) => existing.name === p.name)) {
+        parameters.push(extraParamToSchema(p));
+      }
+    }
+  }
+  return {
+    endpoint: ep.cliName,
+    path: `/api/${ep.path}`,
+    group: ep.group,
+    pattern: ep.pattern,
+    description: ep.summary,
+    parameters
+  };
+}
+function registerSchemaCommand(program) {
+  program.command("schema [endpoint]").description(
+    "Dump parameter schema for an endpoint (for AI agent introspection).\nWithout argument, lists all endpoint names grouped by group."
+  ).action((endpoint) => {
+    if (!endpoint) {
+      const output = {};
+      for (const [groupName, eps] of REGISTRY_BY_GROUP) {
+        output[groupName] = eps.map((ep2) => ep2.cliName);
+      }
+      console.log(JSON.stringify(output, null, 2));
+      return;
+    }
+    const ep = REGISTRY_BY_CLI_NAME.get(endpoint);
+    if (!ep) {
+      throw new Error(`Unknown endpoint: "${endpoint}". Run "dart-fss schema" to list all.`);
+    }
+    const schema = buildSchema(ep);
+    console.log(JSON.stringify(schema, null, 2));
+  });
+}
+
+// src/cli.ts
+function createDartProgram() {
+  const program = new Command();
+  program.name("dart-fss").description(
+    'DART Open API CLI \u2014 access Korea Financial Supervisory Service (FSS) electronic disclosure system.\nProvides 83 API endpoints for company filings, financial statements, equity disclosures, and more.\nAuthentication: set DART_API_KEY env var or pass --api-key. Get a key at https://opendart.fss.or.kr\nCompanies are identified by 8-digit corp_code or company name. Use "dart-fss lookup <name>" to find corp_code.\nOutput is JSON by default (compact single-line). Use --pretty for formatted output.\nRate limit: approximately 20,000 requests per day per API key.'
+  ).version("0.4.1").option("--api-key <key>", "DART API key (default: DART_API_KEY env). Get one at https://opendart.fss.or.kr").option("--pretty", "Pretty-print JSON output (default: compact single-line JSON)").option("--output <file>", "Save result to file instead of stdout").option("--json <params>", "Pass raw API parameters as JSON string, bypassing flag parsing").option("--fields <f1,f2,...>", "Comma-separated field names to include in output (reduces response size for agents)").option("--dry-run", "Validate parameters and print the resolved API request without calling the API");
+  registerDisclosureCommands(program);
+  registerPeriodicReportCommands(program);
+  registerFinancialCommands(program);
+  registerEquityDisclosureCommands(program);
+  registerMajorReportCommands(program);
+  registerSecuritiesFilingCommands(program);
+  registerLookupCommand(program);
+  registerCorpCacheCommand(program);
+  registerSchemaCommand(program);
+  program.command("endpoints").description("List all registered API endpoints. Outputs JSON when stdout is not a TTY or --json-output is used.").option("--group <group>", "disclosure, report, financial, equity, major, securities").option("--json-output", "Force JSON output").action((opts) => {
+    let endpoints = REGISTRY;
+    if (opts.group) {
+      endpoints = endpoints.filter((ep) => ep.group === opts.group);
+    }
+    const useJson = opts.jsonOutput || !process.stdout.isTTY;
+    if (useJson) {
+      const data = endpoints.map((ep) => ({
+        name: ep.cliName,
+        group: ep.group,
+        pattern: ep.pattern,
+        description: ep.summary
+      }));
+      console.log(JSON.stringify(data));
+      return;
+    }
+    console.log(`${endpoints.length} endpoints:
+`);
+    const groups = /* @__PURE__ */ new Map();
+    for (const ep of endpoints) {
+      const g = groups.get(ep.group) || [];
+      g.push(ep);
+      groups.set(ep.group, g);
+    }
+    for (const [groupName, eps] of groups) {
+      console.log(`[${groupName}] (${eps.length})`);
+      for (const ep of eps) {
+        console.log(`  ${ep.cliName.padEnd(35)} ${ep.pattern.padEnd(10)} ${ep.summary}`);
+      }
+      console.log();
+    }
+  });
+  return program;
+}
+
+export {
+  formatErrorJson,
+  createDartProgram
+};