kordoc 4.2.9 → 4.3.0

package/dist/mcp.js

@@ -14,10 +14,14 @@ import {
   SIZE_KEYS,
   SIZE_PT_RANGE,
   buildGongmunOptions
-} from "./chunk-5RPYBC2Q.js";
+} from "./chunk-6GBLFQMA.js";
 import {
+  BUILTIN_TEMPLATES,
   PRESET_ALIAS,
   compare,
+  detectFormat,
+  detectOle2Format,
+  detectZipFormat,
   extractFormFields,
   extractHwp5MetadataOnly,
   extractHwpxMetadataOnly,
@@ -30,36 +34,35 @@ import {
   parse,
   patchHwp,
   patchHwpx,
+  readBuiltinTemplate,
+  resolveBuiltinTemplate,
   unknownFontWarnings
-} from "./chunk-G3DMDTZI.js";
-import "./chunk-7FCNOKOR.js";
-import "./chunk-LM7C6HI2.js";
-import {
-  detectFormat,
-  detectZipFormat
-} from "./chunk-TCJRGFYY.js";
+} from "./chunk-DRZUJ2RK.js";
+import "./chunk-W34QSJFF.js";
+import "./chunk-ZSL6MQVE.js";
 import "./chunk-MOL7MDBG.js";
-import "./chunk-XU4VWOKL.js";
-import "./chunk-DZIXKL7E.js";
-import "./chunk-KTPZYXN2.js";
+import "./chunk-NMWXBJ5B.js";
+import "./chunk-O5EK52TG.js";
+import "./chunk-SPKBIFSK.js";
 import {
   blocksToMarkdown
-} from "./chunk-MHMVFI2N.js";
-import "./chunk-WTT2KJOM.js";
-import "./chunk-NIISBGSR.js";
+} from "./chunk-GSMPTZC7.js";
+import "./chunk-VXMLENCV.js";
+import "./chunk-EFVAY5VE.js";
 import {
   KordocError,
   VERSION,
   classifyError,
   sanitizeError,
   toArrayBuffer
-} from "./chunk-3TSTZGCJ.js";
+} from "./chunk-DRQUAYNT.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { readFileSync, writeFileSync, realpathSync, openSync, readSync, closeSync, statSync, mkdirSync, existsSync } from "fs";
+import { realpathSync, openSync, readSync, closeSync, existsSync } from "fs";
+import { readFile, writeFile, mkdir, stat } from "fs/promises";
 import { pathToFileURL } from "url";
 import { resolve, isAbsolute, extname, dirname, basename } from "path";
 var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".hwp", ".hwpx", ".hml", ".pdf", ".xls", ".xlsx", ".docx"]);
@@ -124,11 +127,11 @@ function capResponseText(text, maxChars = MAX_RESPONSE_CHARS) {
 \u2026 [\uC751\uB2F5\uC774 ${maxChars.toLocaleString()}\uC790 \uC0C1\uD55C\uC744 \uB118\uC5B4 \uC808\uB2E8\uB428 (\uC804\uCCB4 ${text.length.toLocaleString()}\uC790) \u2014 parse_pages\uB85C \uD398\uC774\uC9C0 \uBC94\uC704\uB97C \uB098\uB220 \uC77D\uC73C\uC138\uC694]`;
 }
 var MAX_METADATA_FILE_SIZE = 50 * 1024 * 1024;
-function readValidatedFile(filePath, maxSize = MAX_FILE_SIZE, allowedExts = ALLOWED_EXTENSIONS) {
+async function readValidatedFile(filePath, maxSize = MAX_FILE_SIZE, allowedExts = ALLOWED_EXTENSIONS) {
   const resolved = safePath(filePath, allowedExts);
   let fileSize;
   try {
-    fileSize = statSync(resolved).size;
+    fileSize = (await stat(resolved)).size;
   } catch (err) {
     throw new KordocError(`\uD30C\uC77C \uC0C1\uD0DC \uC77D\uAE30 \uC2E4\uD328 [${err?.code ?? "UNKNOWN"}]: ${resolved}`);
   }
@@ -137,7 +140,7 @@ function readValidatedFile(filePath, maxSize = MAX_FILE_SIZE, allowedExts = ALLO
   }
   let raw;
   try {
-    raw = readFileSync(resolved);
+    raw = await readFile(resolved);
   } catch (err) {
     throw new KordocError(`\uD30C\uC77C \uC77D\uAE30 \uC2E4\uD328 [${err?.code ?? "UNKNOWN"}]: ${resolved}`);
   }
@@ -162,11 +165,16 @@ server.tool(
   "\uD55C\uAD6D \uBB38\uC11C \uD30C\uC77C(HWP, HWPX, PDF, XLSX, DOCX)\uACFC \uC774\uBBF8\uC9C0(PNG/JPG/WebP)\uB97C \uB9C8\uD06C\uB2E4\uC6B4\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4. \uD30C\uC77C \uACBD\uB85C\uB97C \uC785\uB825\uD558\uBA74 \uD3EC\uB9F7\uC744 \uC790\uB3D9 \uAC10\uC9C0\uD558\uC5EC \uD14D\uC2A4\uD2B8\uB97C \uCD94\uCD9C\uD569\uB2C8\uB2E4. \uC774\uBBF8\uC9C0\uB294 OCR(\uB0B4\uC7A5 PP-OCRv5)\uC774 \uC790\uB3D9 \uC801\uC6A9\uB418\uACE0 \uD45C \uAD18\uC120\uB3C4 \uBCF5\uC6D0\uB429\uB2C8\uB2E4.",
   {
     file_path: z.string().min(1).describe("\uD30C\uC2F1\uD560 \uBB38\uC11C \uD30C\uC77C\uC758 \uC808\uB300 \uACBD\uB85C (HWP, HWPX, PDF, XLSX, DOCX, PNG/JPG/WebP)"),
-    ocr: z.boolean().optional().describe("\uC2A4\uCE94/\uC774\uBBF8\uC9C0 PDF \uD14D\uC2A4\uD2B8 OCR (\uB0B4\uC7A5 PP-OCRv5 korean, \uCCAB \uC0AC\uC6A9 \uC2DC ~18MB \uC790\uB3D9 \uB2E4\uC6B4\uB85C\uB4DC). \uD14D\uC2A4\uD2B8\uCE35\uC774 \uC5C6\uAC70\uB098 \uAE68\uC9C4 \uD398\uC774\uC9C0\uB9CC \uC778\uC2DD\uD558\uACE0 \uC815\uC0C1 \uD398\uC774\uC9C0\uB294 \uADF8\uB300\uB85C \uB461\uB2C8\uB2E4. parse \uACB0\uACFC\uC5D0 NEEDS_OCR \uACBD\uACE0\uAC00 \uC788\uC73C\uBA74 \uC774 \uC635\uC158\uC73C\uB85C \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694")
+    ocr: z.union([z.boolean(), z.literal("force")]).optional().describe('\uC2A4\uCE94/\uC774\uBBF8\uC9C0 PDF \uD14D\uC2A4\uD2B8 OCR (\uB0B4\uC7A5 PP-OCRv5 korean, \uCCAB \uC0AC\uC6A9 \uC2DC ~18MB \uC790\uB3D9 \uB2E4\uC6B4\uB85C\uB4DC). true=\uD14D\uC2A4\uD2B8\uCE35\uC774 \uC5C6\uAC70\uB098 \uAE68\uC9C4 \uD398\uC774\uC9C0\uB9CC \uC778\uC2DD\uD558\uACE0 \uC815\uC0C1 \uD398\uC774\uC9C0\uB294 \uADF8\uB300\uB85C \uB461\uB2C8\uB2E4. "force"=\uD14D\uC2A4\uD2B8\uCE35\uC774 \uC788\uC5B4\uB3C4 \uBB34\uC2DC\uD558\uACE0 \uC804 \uD398\uC774\uC9C0 \uAC15\uC81C \uC7AC\uC778\uC2DD. parse \uACB0\uACFC\uC5D0 NEEDS_OCR \uACBD\uACE0\uAC00 \uC788\uC73C\uBA74 \uC774 \uC635\uC158\uC73C\uB85C \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694'),
+    remove_header_footer: z.boolean().optional().describe("PDF \uBA38\uB9AC\uAE00/\uBC14\uB2E5\uAE00 \uC790\uB3D9 \uC81C\uAC70 (\uAE30\uBCF8 true \u2014 false\uB85C \uB044\uAE30, CLI --no-header-footer \uB300\uC751)"),
+    formula_ocr: z.boolean().optional().describe("PDF \uC218\uC2DD OCR \uD65C\uC131\uD654 (MFD+MFR ONNX, \uCCAB \uC0AC\uC6A9 \uC2DC \uBAA8\uB378 ~155MB \uC790\uB3D9 \uB2E4\uC6B4\uB85C\uB4DC, CLI --formula-ocr \uB300\uC751)"),
+    dedupe_running_headers: z.boolean().optional().describe("HWP5 \uB808\uC774\uC544\uC6C3 \uD45C \uD398\uC774\uC9C0 \uBC18\uBCF5 \uB7EC\uB2DD \uD5E4\uB354 \uC911\uBCF5 \uC81C\uAC70 (\uAE30\uBCF8 off \u2014 \uBD99\uC784\uBCC4 \uC7AC\uBC88\uD638 \uC624\uC0AD\uC81C \uC8FC\uC758, CLI --dedupe-headers \uB300\uC751)"),
+    keep_trailing_empty_cols: z.boolean().optional().describe("\uD45C \uC624\uB978\uCABD \uB05D \uBE48 \uC5F4(\uC11C\uC2DD \uC785\uB825\uB780) \uBCF4\uC874 (#47, \uAE30\uBCF8 off: \uD6C4\uD589 \uBE48 \uC5F4 \uD2B8\uB9BC, CLI --keep-empty-cols \uB300\uC751)"),
+    keep_empty_paragraphs: z.boolean().optional().describe("\uBE48 \uBB38\uB2E8 \uBCF4\uC874 \u2014 \uBCF8\uBB38\uC740 \uBE48 paragraph \uBE14\uB85D, \uD45C \uC140\uC740 \uBE48 \uC904 (#57, \uAE30\uBCF8 off, CLI --keep-empty-paragraphs \uB300\uC751)")
   },
-  async ({ file_path, ocr }) => {
+  async ({ file_path, ocr, remove_header_footer, formula_ocr, dedupe_running_headers, keep_trailing_empty_cols, keep_empty_paragraphs }) => {
     try {
-      const { buffer, resolved } = readValidatedFile(file_path);
+      const { buffer, resolved } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       if (format === "unknown") {
         return {
@@ -174,7 +182,15 @@ server.tool(
           isError: true
         };
       }
-      const result = await parse(buffer, { filePath: resolved, ...ocr ? { ocr: true } : {} });
+      const result = await parse(buffer, {
+        filePath: resolved,
+        ...ocr !== void 0 ? { ocr } : {},
+        ...remove_header_footer !== void 0 ? { removeHeaderFooter: remove_header_footer } : {},
+        ...formula_ocr ? { formulaOcr: true } : {},
+        ...dedupe_running_headers ? { dedupeRunningHeaders: true } : {},
+        ...keep_trailing_empty_cols ? { keepTrailingEmptyCols: true } : {},
+        ...keep_empty_paragraphs ? { keepEmptyParagraphs: true } : {}
+      });
       if (!result.success) {
         return {
           content: [{ type: "text", text: `\uD30C\uC2F1 \uC2E4\uD328 (${result.fileType}): ${result.error}` }],
@@ -218,7 +234,7 @@ ${markdown}`);
 );
 server.tool(
   "detect_format",
-  "\uD30C\uC77C\uC758 \uD3EC\uB9F7\uC744 \uB9E4\uC9C1 \uBC14\uC774\uD2B8\uB85C \uAC10\uC9C0\uD569\uB2C8\uB2E4 (hwpx, hwp, pdf, xlsx, docx, unknown).",
+  "\uD30C\uC77C\uC758 \uD3EC\uB9F7\uC744 \uB9E4\uC9C1 \uBC14\uC774\uD2B8\uB85C \uAC10\uC9C0\uD569\uB2C8\uB2E4 (hwpx, hwp, hwp3, hwpml, pdf, xls, xlsx, docx, unknown).",
   {
     file_path: z.string().min(1).describe("\uAC10\uC9C0\uD560 \uD30C\uC77C\uC758 \uC808\uB300 \uACBD\uB85C")
   },
@@ -227,8 +243,12 @@ server.tool(
       const resolved = safePath(file_path);
       let format = detectFormatFromHeader(resolved);
       if (format === "hwpx") {
-        const { buffer } = readValidatedFile(file_path);
+        const { buffer } = await readValidatedFile(file_path);
         format = await detectZipFormat(buffer);
+      } else if (format === "hwp") {
+        const { buffer } = await readValidatedFile(file_path);
+        const ole2Format = detectOle2Format(buffer);
+        if (ole2Format !== "unknown") format = ole2Format;
       }
       return {
         content: [{ type: "text", text: `${file_path}: ${format}` }]
@@ -257,13 +277,14 @@ server.tool(
           isError: true
         };
       }
-      const { buffer } = readValidatedFile(file_path, MAX_METADATA_FILE_SIZE);
+      const { buffer } = await readValidatedFile(file_path, MAX_METADATA_FILE_SIZE);
       let metadata;
       let effectiveFormat = format;
       if (format === "hwpx") {
-        const { detectZipFormat: detectZipFormat2 } = await import("./detect-FX2ZHKZP.js");
-        const zipFormat = await detectZipFormat2(buffer);
+        const zipFormat = await detectZipFormat(buffer);
         if (zipFormat === "xlsx" || zipFormat === "docx") effectiveFormat = zipFormat;
+      } else if (format === "hwp") {
+        if (detectOle2Format(buffer) === "xls") effectiveFormat = "xls";
       }
       switch (effectiveFormat) {
         case "hwp":
@@ -274,7 +295,7 @@ server.tool(
           break;
         case "pdf":
           try {
-            const { extractPdfMetadataOnly } = await import("./parser-WNFWMBSL.js");
+            const { extractPdfMetadataOnly } = await import("./parser-W3POOYQQ.js");
             metadata = await extractPdfMetadataOnly(buffer);
           } catch {
             metadata = void 0;
@@ -282,12 +303,16 @@ server.tool(
           break;
         case "hwp3":
         case "hwpml":
+        case "xls":
         case "xlsx":
         case "docx": {
           const result = await parse(buffer);
           metadata = result.success ? result.metadata : void 0;
           break;
         }
+        default:
+          metadata = void 0;
+          break;
       }
       return {
         content: [{ type: "text", text: JSON.stringify({ format, ...metadata }, null, 2) }]
@@ -309,7 +334,8 @@ server.tool(
   },
   async ({ file_path, pages }) => {
     try {
-      const { buffer } = readValidatedFile(file_path);
+      const resolved = safePath(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       if (format === "unknown") {
         return {
@@ -317,7 +343,7 @@ server.tool(
           isError: true
         };
       }
-      const result = await parse(buffer, { pages });
+      const result = await parse(buffer, { pages, filePath: resolved });
       if (!result.success) {
         return {
           content: [{ type: "text", text: `\uD30C\uC2F1 \uC2E4\uD328 (${result.fileType}): ${result.error}` }],
@@ -351,7 +377,7 @@ server.tool(
   },
   async ({ file_path, table_index }) => {
     try {
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       if (format === "unknown") {
         return {
@@ -403,8 +429,8 @@ server.tool(
   },
   async ({ file_path_a, file_path_b }) => {
     try {
-      const { buffer: bufA } = readValidatedFile(file_path_a);
-      const { buffer: bufB } = readValidatedFile(file_path_b);
+      const { buffer: bufA } = await readValidatedFile(file_path_a);
+      const { buffer: bufB } = await readValidatedFile(file_path_b);
       const result = await compare(bufA, bufB);
       const { stats, diffs } = result;
       const lines = [
@@ -437,7 +463,7 @@ server.tool(
   },
   async ({ file_path }) => {
     try {
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const result = await parse(buffer, { keepTrailingEmptyCols: true });
       if (!result.success) {
         return {
@@ -467,9 +493,10 @@ function buildFillInputs(fields, formats) {
 }
 server.tool(
   "fill_form",
-  "\uD55C\uAD6D \uC11C\uC2DD \uBB38\uC11C\uC758 \uBE48\uCE78\uC744 \uCC44\uC6CC\uC11C \uC0C8 \uBB38\uC11C\uB85C \uCD9C\uB825\uD569\uB2C8\uB2E4. hwpx-preserve\uB97C \uC0AC\uC6A9\uD558\uBA74 \uC6D0\uBCF8 \uC11C\uC2DD(\uD14C\uB450\uB9AC, \uD3F0\uD2B8, \uBCD1\uD569 \uB4F1)\uC744 100% \uC720\uC9C0\uD569\uB2C8\uB2E4.",
+  "\uD55C\uAD6D \uC11C\uC2DD \uBB38\uC11C\uC758 \uBE48\uCE78\uC744 \uCC44\uC6CC\uC11C \uC0C8 \uBB38\uC11C\uB85C \uCD9C\uB825\uD569\uB2C8\uB2E4. hwpx-preserve\uB97C \uC0AC\uC6A9\uD558\uBA74 \uC6D0\uBCF8 \uC11C\uC2DD(\uD14C\uB450\uB9AC, \uD3F0\uD2B8, \uBCD1\uD569 \uB4F1)\uC744 100% \uC720\uC9C0\uD569\uB2C8\uB2E4. HWPX \uB204\uB984\uD2C0(CLICK_HERE) \uD544\uB4DC\uB294 \uC774\uB984\uC73C\uB85C \uC815\uD655 \uB9E4\uCE6D\uB418\uC5B4 \uC6B0\uC120 \uCC44\uC6CC\uC9D1\uB2C8\uB2E4. file_path \uB300\uC2E0 template\uC73C\uB85C \uB0B4\uC7A5 \uC815\uBD80 \uD45C\uC900 \uAE30\uC548\uBB38 \uC11C\uC2DD\uC744 \uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4 \u2014 gian(\uC77C\uBC18\uAE30\uC548\uBB38, \uBCC4\uC9C0 \uC81C1\uD638\uC11C\uC2DD: \uD589\uC815\uAE30\uAD00\uBA85\xB7\uC218\uC2E0\uC790\xB7\uACBD\uC720\xB7\uC81C\uBAA9\xB7\uBCF8\uBB38\xB7\uBD99\uC784\xB7\uBC1C\uC2E0\uBA85\uC758\xB7\uAE30\uC548\uC790\xB7\uAC80\uD1A0\uC790\xB7\uACB0\uC7AC\uAD8C\uC790 \uB4F1 23\uD544\uB4DC) / gian-simple(\uAC04\uC774\uAE30\uC548\uBB38, \uBCC4\uC9C0 \uC81C2\uD638\uC11C\uC2DD: \uB0B4\uBD80\uACB0\uC7AC\uC6A9 13\uD544\uB4DC).",
   {
-    file_path: z.string().min(1).describe("\uC11C\uC2DD \uD15C\uD50C\uB9BF \uBB38\uC11C\uC758 \uC808\uB300 \uACBD\uB85C (HWP, HWPX, PDF, XLSX, DOCX)"),
+    file_path: z.string().min(1).optional().describe("\uC11C\uC2DD \uD15C\uD50C\uB9BF \uBB38\uC11C\uC758 \uC808\uB300 \uACBD\uB85C (HWP, HWPX, PDF, XLSX, DOCX). template \uC0AC\uC6A9 \uC2DC \uC0DD\uB7B5"),
+    template: z.enum(["gian", "gian-simple", "\uC77C\uBC18\uAE30\uC548\uBB38", "\uAC04\uC774\uAE30\uC548\uBB38"]).optional().describe("\uB0B4\uC7A5 \uC815\uBD80 \uD45C\uC900 \uC11C\uC2DD \uC774\uB984 \u2014 file_path \uB300\uC2E0 \uC0AC\uC6A9. gian=\uC77C\uBC18\uAE30\uC548\uBB38(\uBCC4\uC9C0 \uC81C1\uD638\uC11C\uC2DD), gian-simple=\uAC04\uC774\uAE30\uC548\uBB38(\uBCC4\uC9C0 \uC81C2\uD638\uC11C\uC2DD)"),
     fields: z.record(z.string(), z.string()).describe('\uCC44\uC6B8 \uD544\uB4DC \uB9F5 (\uB77C\uBCA8 \u2192 \uAC12). \uC608: {"\uC131\uBA85": "\uD64D\uAE38\uB3D9", "\uC804\uD654\uBC88\uD638": "010-1234-5678"}'),
     formats: z.record(z.string(), z.string()).optional().describe("\uD544\uB4DC\uBCC4 \uAC12 \uC11C\uC2DD (\uB77C\uBCA8 \u2192 \uD3EC\uB9F7). \uC815\uC900\uAC12 \uD558\uB098\uB85C \uC11C\uC2DD\uB9C8\uB2E4 \uB2E4\uB978 \uBAA8\uC591\uC744 \uCC44\uC6B8 \uB54C: date:yy.mm.dd / phone:hyphen\xB7dot\xB7digits / rrn:hyphen\xB7masked / mask:###-## / \uC790\uC720 \uD328\uD134(yyyy\uB144 m\uC6D4 d\uC77C, ###-####-####)"),
     require_unique: z.boolean().optional().describe("\uD55C \uD0A4\uAC00 \uC11C\uC2DD\uC758 2\uACF3 \uC774\uC0C1\uC5D0 \uB9E4\uCE6D\uB418\uBA74 \uCC44\uC6B0\uC9C0 \uC54A\uACE0 \uAC70\uBD80 \u2014 \uBC18\uBCF5 \uB77C\uBCA8 \uC591\uC2DD\uC5D0\uC11C \uB0A8\uC758 \uBE14\uB85D \uC624\uC5FC \uBC29\uC9C0 (\uBC30\uC5F4 \uAC12\uC740 \uC608\uC678)"),
@@ -477,11 +504,28 @@ server.tool(
     output_format: z.enum(["markdown", "hwpx", "hwpx-preserve"]).default("hwpx-preserve").describe("\uCD9C\uB825 \uD3EC\uB9F7: hwpx-preserve (\uC6D0\uBCF8 \uC2A4\uD0C0\uC77C \uBCF4\uC874, HWPX \uC804\uC6A9), hwpx (\uC0C8 HWPX \uC0DD\uC131), markdown"),
     output_path: z.string().optional().describe("\uCD9C\uB825 \uD30C\uC77C \uC800\uC7A5 \uACBD\uB85C (\uC120\uD0DD). \uC9C0\uC815 \uC2DC \uD30C\uC77C\uB85C \uC800\uC7A5, \uBBF8\uC9C0\uC815 \uC2DC \uD14D\uC2A4\uD2B8\uB85C \uBC18\uD658")
   },
-  async ({ file_path, fields, formats, require_unique, mask_values, output_format, output_path }) => {
+  async ({ file_path, template, fields, formats, require_unique, mask_values, output_format, output_path }) => {
     try {
       const outExts = output_format === "markdown" ? /* @__PURE__ */ new Set([".md", ".markdown", ".txt"]) : /* @__PURE__ */ new Set([".hwpx"]);
       const outPath = output_path ? safeOutputPath(output_path, outExts) : void 0;
-      const { buffer } = readValidatedFile(file_path);
+      let buffer;
+      if (template) {
+        const t = resolveBuiltinTemplate(template);
+        if (!t) {
+          return {
+            content: [{ type: "text", text: `\uC54C \uC218 \uC5C6\uB294 \uB0B4\uC7A5 \uD15C\uD50C\uB9BF: ${template} (\uC0AC\uC6A9 \uAC00\uB2A5: ${BUILTIN_TEMPLATES.map((x) => `${x.id}(${x.aliases[0]})`).join(", ")})` }],
+            isError: true
+          };
+        }
+        buffer = readBuiltinTemplate(t);
+      } else if (file_path) {
+        buffer = (await readValidatedFile(file_path)).buffer;
+      } else {
+        return {
+          content: [{ type: "text", text: "file_path \uB610\uB294 template \uC911 \uD558\uB098\uB97C \uC9C0\uC815\uD574\uC8FC\uC138\uC694" }],
+          isError: true
+        };
+      }
       if (output_format === "hwpx-preserve") {
         const format = detectFormat(buffer);
         let isHwpx = format === "hwpx";
@@ -513,8 +557,8 @@ server.tool(
         ].filter(Boolean).join(" | ");
         const filledList = hwpxResult.filled.map((f) => `  - ${f.label}: ${mask_values ? `[${[...f.value].length}\uC790]` : f.value}`).join("\n");
         if (outPath) {
-          mkdirSync(dirname(outPath), { recursive: true });
-          writeFileSync(outPath, Buffer.from(hwpxResult.buffer));
+          await mkdir(dirname(outPath), { recursive: true });
+          await writeFile(outPath, Buffer.from(hwpxResult.buffer));
           return {
             content: [{ type: "text", text: `[${summary2}]
 
@@ -560,8 +604,8 @@ ${filledList}
       if (output_format === "hwpx") {
         const hwpxBuffer = await markdownToHwpx(markdown);
         if (outPath) {
-          mkdirSync(dirname(outPath), { recursive: true });
-          writeFileSync(outPath, Buffer.from(hwpxBuffer));
+          await mkdir(dirname(outPath), { recursive: true });
+          await writeFile(outPath, Buffer.from(hwpxBuffer));
           return {
             content: [{ type: "text", text: `[${summary}]
 
@@ -577,8 +621,8 @@ ${previewMd}` }]
         };
       }
       if (outPath) {
-        mkdirSync(dirname(outPath), { recursive: true });
-        writeFileSync(outPath, markdown, "utf-8");
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, markdown, "utf-8");
         return {
           content: [{ type: "text", text: `[${summary}]
 
@@ -617,7 +661,7 @@ server.tool(
   async ({ file_path, image_path, anchor, occurrence, size_mm, mode, dx_mm, dy_mm, output_path }) => {
     try {
       const outPath = safeOutputPath(output_path, /* @__PURE__ */ new Set([".hwpx"]));
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       if (format !== "hwpx") {
         return {
@@ -626,12 +670,13 @@ server.tool(
         };
       }
       const imgResolved = safePath(image_path, IMAGE_EXTENSIONS);
-      if (statSync(imgResolved).size > 500 * 1024 * 1024) {
-        return { content: [{ type: "text", text: `\uB3C4\uC7A5 \uC774\uBBF8\uC9C0\uAC00 \uB108\uBB34 \uD07D\uB2C8\uB2E4 (${(statSync(imgResolved).size / 1024 / 1024).toFixed(0)}MB) \u2014 500MB \uC774\uD558\uC5EC\uC57C \uD569\uB2C8\uB2E4.` }], isError: true };
+      const imgSize = (await stat(imgResolved)).size;
+      if (imgSize > 500 * 1024 * 1024) {
+        return { content: [{ type: "text", text: `\uB3C4\uC7A5 \uC774\uBBF8\uC9C0\uAC00 \uB108\uBB34 \uD07D\uB2C8\uB2E4 (${(imgSize / 1024 / 1024).toFixed(0)}MB) \u2014 500MB \uC774\uD558\uC5EC\uC57C \uD569\uB2C8\uB2E4.` }], isError: true };
       }
-      const image = new Uint8Array(readFileSync(imgResolved));
+      const image = new Uint8Array(await readFile(imgResolved));
       const ext = extname(imgResolved).slice(1).toLowerCase();
-      const { placeSealHwpx } = await import("./seal-TM2XCE2R.js");
+      const { placeSealHwpx } = await import("./seal-GTNLVBJX.js");
       const result = await placeSealHwpx(buffer, [{
         anchor,
         occurrence,
@@ -642,8 +687,8 @@ server.tool(
         dxMm: dx_mm,
         dyMm: dy_mm
       }]);
-      mkdirSync(dirname(outPath), { recursive: true });
-      writeFileSync(outPath, Buffer.from(result.buffer));
+      await mkdir(dirname(outPath), { recursive: true });
+      await writeFile(outPath, Buffer.from(result.buffer));
       const p0 = result.placed[0];
       const warnLines = (p0.warnings ?? []).map((w) => `
 \u26A0\uFE0F ${w}`).join("");
@@ -674,7 +719,7 @@ server.tool(
   async ({ file_path, edited_markdown, output_path }) => {
     try {
       const out = safeOutputPath(output_path, /* @__PURE__ */ new Set([".hwpx", ".hwp"]));
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       let isHwpx = format === "hwpx";
       if (isHwpx) {
@@ -695,8 +740,8 @@ server.tool(
           isError: true
         };
       }
-      mkdirSync(dirname(out), { recursive: true });
-      writeFileSync(out, Buffer.from(result.data));
+      await mkdir(dirname(out), { recursive: true });
+      await writeFile(out, Buffer.from(result.data));
       const v = result.verification?.stats;
       const lossless = v ? v.modified === 0 && v.added === 0 && v.removed === 0 : void 0;
       const lines = [
@@ -732,24 +777,24 @@ server.tool(
         return { content: [{ type: "text", text: 'format: "svg"\uB294 output_path(.svg)\uAC00 \uD544\uC218\uC785\uB2C8\uB2E4 \u2014 SVG \uC6D0\uBB38\uC740 \uCEE4\uC11C \uC751\uB2F5\uC5D0 \uC9C1\uC811 \uB2F4\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.' }], isError: true };
       }
       const outPath = output_path ? safeOutputPath(output_path, /* @__PURE__ */ new Set([format === "png" ? ".png" : ".svg"])) : void 0;
-      const { buffer } = readValidatedFile(file_path, MAX_FILE_SIZE, /* @__PURE__ */ new Set([".hwpx"]));
-      const { renderHwpxToSvg } = await import("./render-336CJHAS.js");
+      const { buffer } = await readValidatedFile(file_path, MAX_FILE_SIZE, /* @__PURE__ */ new Set([".hwpx"]));
+      const { renderHwpxToSvg } = await import("./render-6OW6U4L4.js");
       const result = await renderHwpxToSvg(buffer, { highlights, reflow: true, reflowMode: reflow_mode });
       const summary = [
         `\uB80C\uB354 \uC644\uB8CC: ${result.pageCount}\uD398\uC774\uC9C0, ${Math.round(result.width)}x${Math.round(result.height)}pt (\uD14D\uC2A4\uD2B8 ${result.stats.texts}\xB7\uC774\uBBF8\uC9C0 ${result.stats.images}\xB7\uD45C ${result.stats.tables})`,
         ...result.warnings.map((w) => `\u26A0\uFE0F ${w}`)
       ];
       if (format === "svg") {
-        mkdirSync(dirname(outPath), { recursive: true });
-        writeFileSync(outPath, result.svg, "utf-8");
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, result.svg, "utf-8");
         summary.push(`\uC800\uC7A5: ${outPath}`);
         return { content: [{ type: "text", text: summary.join("\n") }] };
       }
-      const { rasterizeSvg } = await import("./rasterize-OG7KXBJS.js");
+      const { rasterizeSvg } = await import("./rasterize-GNJQVURE.js");
       const raster = await rasterizeSvg(result.svg, result.width, result.height);
       if (outPath) {
-        mkdirSync(dirname(outPath), { recursive: true });
-        writeFileSync(outPath, raster.png);
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, raster.png);
         summary.push(`\uC800\uC7A5: ${outPath}`);
       }
       summary.push(`\uC774\uBBF8\uC9C0 ${raster.widthPx}x${raster.heightPx}px \u2014 \uC798\uB9BC\xB7\uACB9\uCE68\xB7\uBE48\uCE78\xB7\uD398\uC774\uC9C0 \uB118\uCE68\uC774 \uBCF4\uC774\uBA74 \uC6D0\uC778 \uD14D\uC2A4\uD2B8\uB97C \uC218\uC815\uD574 \uB2E4\uC2DC \uC0DD\uC131/\uD328\uCE58\uD558\uC138\uC694.`);
@@ -779,7 +824,7 @@ server.tool(
   },
   async ({ file_path, rules, mask_char, output_path, dry_run }) => {
     try {
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const format = detectFormat(buffer);
       const patchable = format === "hwpx" || format === "hwp";
       if (!dry_run && !output_path) {
@@ -790,7 +835,7 @@ server.tool(
       if (!parsed.success) {
         return { content: [{ type: "text", text: `\uD30C\uC2F1 \uC2E4\uD328: ${parsed.error}` }], isError: true };
       }
-      const { redactMarkdown } = await import("./redact-7ILEAUTS.js");
+      const { redactMarkdown } = await import("./redact-W5K3ILQH.js");
       const r = redactMarkdown(parsed.markdown, { rules, maskChar: mask_char });
       const byRule = /* @__PURE__ */ new Map();
       for (const h of r.hits) byRule.set(h.rule, (byRule.get(h.rule) ?? 0) + 1);
@@ -805,8 +850,8 @@ server.tool(
           if (!result.success || !result.data) {
             return { content: [{ type: "text", text: `\uB9C8\uC2A4\uD0B9 \uD328\uCE58 \uC2E4\uD328: ${result.error ?? "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958"}` }], isError: true };
           }
-          mkdirSync(dirname(outPath), { recursive: true });
-          writeFileSync(outPath, Buffer.from(result.data));
+          await mkdir(dirname(outPath), { recursive: true });
+          await writeFile(outPath, Buffer.from(result.data));
           lines.push(`\uC800\uC7A5: ${outPath} (\uC6D0\uBCF8 \uC11C\uC2DD \uBCF4\uC874)`);
           if (result.skipped.length > 0) {
             lines.push(`\u26A0\uFE0F \uBBF8\uC801\uC6A9 ${result.skipped.length}\uAC74 \u2014 \uD574\uB2F9 \uC704\uCE58\uB294 \uC6D0\uBB38\uC774 \uB0A8\uC544 \uC788\uC73C\uB2C8 \uBC18\uB4DC\uC2DC \uC218\uB3D9 \uD655\uC778:`);
@@ -814,8 +859,8 @@ server.tool(
           }
           lines.push("render_document\uB85C \uB9C8\uC2A4\uD0B9 \uACB0\uACFC\uB97C \uB208\uC73C\uB85C \uD655\uC778\uD558\uC138\uC694.");
         } else {
-          mkdirSync(dirname(outPath), { recursive: true });
-          writeFileSync(outPath, r.text, "utf-8");
+          await mkdir(dirname(outPath), { recursive: true });
+          await writeFile(outPath, r.text, "utf-8");
           lines.push(`\uC800\uC7A5: ${outPath} (${format}\uB294 \uC11C\uC2DD \uBCF4\uC874 \uBBF8\uC9C0\uC6D0 \u2014 \uB9C8\uC2A4\uD0B9\uB41C \uB9C8\uD06C\uB2E4\uC6B4)`);
         }
       } else if (!dry_run) {
@@ -838,12 +883,12 @@ server.tool(
   },
   async ({ file_path, granularity, include_table_cells }) => {
     try {
-      const { buffer } = readValidatedFile(file_path);
+      const { buffer } = await readValidatedFile(file_path);
       const parsed = await parse(buffer, { filePath: file_path });
       if (!parsed.success) {
         return { content: [{ type: "text", text: `\uD30C\uC2F1 \uC2E4\uD328: ${parsed.error}` }], isError: true };
       }
-      const { blocksToChunks } = await import("./chunks-VFIMYK36.js");
+      const { blocksToChunks } = await import("./chunks-Q7T4SQGW.js");
       const chunks = blocksToChunks(parsed.blocks, { granularity, includeTableCells: include_table_cells });
       return { content: [{ type: "text", text: capResponseText(JSON.stringify(chunks, null, 2)) }] };
     } catch (err) {
@@ -861,11 +906,11 @@ server.tool(
   async ({ hwpx_path, output_path }) => {
     try {
       const out = safeOutputPath(output_path, PROFILE_EXTENSIONS);
-      const { buffer } = readValidatedFile(hwpx_path);
-      const { hwpxToProfile } = await import("./-ECUCTQTR.js");
+      const { buffer } = await readValidatedFile(hwpx_path);
+      const { hwpxToProfile } = await import("./-DYHT3HWH.js");
       const profile = await hwpxToProfile(buffer);
-      mkdirSync(dirname(out), { recursive: true });
-      writeFileSync(out, JSON.stringify(profile, null, 2));
+      await mkdir(dirname(out), { recursive: true });
+      await writeFile(out, JSON.stringify(profile, null, 2));
       return {
         content: [{ type: "text", text: `\uC11C\uC2DD \uD504\uB85C\uD544 \uCD94\uCD9C \uC644\uB8CC: \uD45C ${profile.tables.length}\uAC1C \u2192 ${out}
 (generate_document\uC758 profile_path\uB85C \uC0AC\uC6A9)` }]
@@ -945,13 +990,13 @@ server.tool(
       }
       let profile;
       if (profile_path) {
-        const { parseFormatProfileJson } = await import("./profile-io-43MF52H6.js");
-        profile = parseFormatProfileJson(readFileSync(safePath(profile_path, PROFILE_EXTENSIONS), "utf-8"));
+        const { parseFormatProfileJson } = await import("./profile-io-72R3B7KO.js");
+        profile = parseFormatProfileJson(await readFile(safePath(profile_path, PROFILE_EXTENSIONS), "utf-8"));
       }
       const out = safeOutputPath(output_path, /* @__PURE__ */ new Set([".hwpx"]));
       const buf = await markdownToHwpx(markdown, gongmun || profile ? { ...gongmun ? { gongmun } : {}, ...profile ? { profile } : {} } : void 0);
-      mkdirSync(dirname(out), { recursive: true });
-      writeFileSync(out, Buffer.from(buf));
+      await mkdir(dirname(out), { recursive: true });
+      await writeFile(out, Buffer.from(buf));
       const mode = gongmun ? `\uACF5\uBB38\uC11C:${gongmun.preset}` : "\uBC94\uC6A9";
       const tableCount = (markdown.match(/^\s*\|.*\|\s*$/gm) || []).length > 0 ? `, \uD45C \uD3EC\uD568` : "";
       const fontWarns = gongmun?.fonts ? unknownFontWarnings(gongmun.fonts) : [];