@kodocagent/cli 0.4.0 → 0.4.2

package/dist/index.js

@@ -9739,9 +9739,9 @@ var require_load = __commonJS({
 var require_lib3 = __commonJS({
   "../../node_modules/.pnpm/jszip@3.10.1/node_modules/jszip/lib/index.js"(exports, module) {
     "use strict";
-    function JSZip3() {
-      if (!(this instanceof JSZip3)) {
-        return new JSZip3();
+    function JSZip5() {
+      if (!(this instanceof JSZip5)) {
+        return new JSZip5();
       }
       if (arguments.length) {
         throw new Error("The constructor with parameters has been removed in JSZip 3.0, please check the upgrade guide.");
@@ -9750,7 +9750,7 @@ var require_lib3 = __commonJS({
       this.comment = null;
       this.root = "";
       this.clone = function() {
-        var newObj = new JSZip3();
+        var newObj = new JSZip5();
         for (var i in this) {
           if (typeof this[i] !== "function") {
             newObj[i] = this[i];
@@ -9759,16 +9759,16 @@ var require_lib3 = __commonJS({
         return newObj;
       };
     }
-    JSZip3.prototype = require_object();
-    JSZip3.prototype.loadAsync = require_load();
-    JSZip3.support = require_support();
-    JSZip3.defaults = require_defaults();
-    JSZip3.version = "3.10.1";
-    JSZip3.loadAsync = function(content, options) {
-      return new JSZip3().loadAsync(content, options);
+    JSZip5.prototype = require_object();
+    JSZip5.prototype.loadAsync = require_load();
+    JSZip5.support = require_support();
+    JSZip5.defaults = require_defaults();
+    JSZip5.version = "3.10.1";
+    JSZip5.loadAsync = function(content, options) {
+      return new JSZip5().loadAsync(content, options);
     };
-    JSZip3.external = require_external();
-    module.exports = JSZip3;
+    JSZip5.external = require_external();
+    module.exports = JSZip5;
   }
 });
 
@@ -10775,7 +10775,12 @@ var ToolRegistry = class {
               return `\uC0AC\uC6A9\uC790\uAC00 \uBCC0\uACBD\uC744 \uAC70\uC808\uD558\uC5EC \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4${reasonPart}. \uAC19\uC740 \uC218\uC815\uC548\uC744 \uC790\uB3D9\uC73C\uB85C \uB2E4\uC2DC \uC81C\uC548\uD558\uC9C0 \uB9D0\uACE0, \uC0AC\uC6A9\uC790\uC758 \uB2E4\uC74C \uC9C0\uC2DC\uB97C \uAE30\uB2E4\uB9AC\uC138\uC694.`;
             }
             try {
-              return await commit();
+              const commitMsg = await commit();
+              if (proposal.warnings && proposal.warnings.length > 0) {
+                return `${commitMsg}
+[\uACBD\uACE0] ${proposal.warnings.join("\n[\uACBD\uACE0] ")}`;
+              }
+              return commitMsg;
             } catch (err) {
               const msg = err instanceof Error ? err.message : String(err);
               return `\uC800\uC7A5 \uC624\uB958: ${msg}`;
@@ -10803,6 +10808,7 @@ import { copyFile, mkdir as mkdir3, readdir as readdir2, readFile as readFile3,
 import { basename as basename2, dirname as dirname22, extname, join as join22 } from "path";
 var import_jszip = __toESM(require_lib3(), 1);
 var import_jszip2 = __toESM(require_lib3(), 1);
+var import_jszip3 = __toESM(require_lib3(), 1);
 import { createTwoFilesPatch } from "diff";
 import { readFile as readFile22 } from "fs/promises";
 import { blocksToMarkdown, compare } from "@clazic/kordoc";
@@ -10833,26 +10839,35 @@ import {
 } from "docx";
 import { readFile as readFile6 } from "fs/promises";
 import { extname as extname6 } from "path";
-import { extractFormFields, markdownToHwpx as markdownToHwpx2, parse as parse2 } from "@clazic/kordoc";
+import { parse as parse2 } from "@clazic/kordoc";
 import { z as z6 } from "zod";
 import { readFile as readFile7 } from "fs/promises";
 import { extname as extname7 } from "path";
-import ExcelJS from "exceljs";
+import { extractFormFields, markdownToHwpx as markdownToHwpx2, parse as parse3 } from "@clazic/kordoc";
+var import_jszip4 = __toESM(require_lib3(), 1);
 import { z as z7 } from "zod";
-import { readFile as readFile8, stat as stat3 } from "fs/promises";
+import { readFile as readFile8 } from "fs/promises";
 import { extname as extname8 } from "path";
-import { parse as parse3 } from "@clazic/kordoc";
+import ExcelJS from "exceljs";
 import { z as z8 } from "zod";
-import { readFile as fsReadFile, stat as stat4 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
+import { extname as extname9 } from "path";
+import { parse as parse4 } from "@clazic/kordoc";
 import { z as z9 } from "zod";
+import { readFile as readFile10, stat as stat3 } from "fs/promises";
+import { extname as extname10 } from "path";
+import { parse as parse5 } from "@clazic/kordoc";
+import { z as z10 } from "zod";
+import { readFile as fsReadFile, stat as stat4 } from "fs/promises";
+import { z as z11 } from "zod";
 import { stat as stat5 } from "fs/promises";
-import { extname as extname9 } from "path";
+import { extname as extname11 } from "path";
 import { markdownToHwpx as markdownToHwpx3 } from "@clazic/kordoc";
-import { z as z10 } from "zod";
+import { z as z12 } from "zod";
 import { stat as stat6 } from "fs/promises";
-import { extname as extname10 } from "path";
+import { extname as extname12 } from "path";
 import ExcelJS2 from "exceljs";
-import { z as z11 } from "zod";
+import { z as z13 } from "zod";
 async function resolveSafePath(cwd, p) {
   const normalizedCwd = normalize(cwd).normalize("NFC");
   const normalizedP = p.normalize("NFC");
@@ -11236,7 +11251,7 @@ function applyFormObjectEdits(xml, edits) {
       };
       continue;
     }
-    const openTag = xml.slice(pos, openTagEnd + 1);
+    const _openTag = xml.slice(pos, openTagEnd + 1);
     const closeTag = `</${xmlTag}>`;
     const closeIdx = xml.indexOf(closeTag, openTagEnd);
     if (closeIdx < 0) {
@@ -11433,7 +11448,7 @@ function replaceAttrInOpenTag(xml, tagStart, tagEnd, attr, newValue) {
     text: newValue
   };
 }
-function replaceEditText(xml, pos, elementContent, newText) {
+function replaceEditText(_xml, pos, elementContent, newText) {
   const escaped = escapeXml(newText);
   const selfCloseRe = /<hp:text\s*\/>/;
   const scm = selfCloseRe.exec(elementContent);
@@ -11837,39 +11852,22 @@ var listFilesTool = {
     return lines.join("\n") + truncateNotice;
   }
 };
-var coordinateCellEditItemSchema = z4.object({
-  tableIndex: z4.number().int().nonnegative().describe(
-    "0-based \uD45C \uC778\uB371\uC2A4. read_document\uB85C \uC77D\uC740 kordoc \uBE14\uB85D \uC21C\uC11C\uC640 \uB3D9\uC77C (\uC911\uCCA9 \uD45C\uB294 \uBCC4\uB3C4 \uCE74\uC6B4\uD305 \uC548 \uD568)"
-  ),
-  row: z4.number().int().nonnegative().describe("\uC140\uC758 rowAddr (0-based, <hp:cellAddr rowAddr=..> \uAC12)"),
-  col: z4.number().int().nonnegative().describe("\uC140\uC758 colAddr (0-based, <hp:cellAddr colAddr=..> \uAC12)"),
-  newText: z4.string().describe("\uC140\uC5D0 \uC4F8 \uC0C8 \uD14D\uC2A4\uD2B8"),
-  expectedText: z4.string().optional().describe(
-    "\uD604\uC7AC \uC140 \uD14D\uC2A4\uD2B8 (\uC548\uC804 \uAC80\uC99D\uC6A9). \uC81C\uACF5 \uC2DC \uD604\uC7AC \uC140 \uD14D\uC2A4\uD2B8\uC640 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC218\uC815\uD558\uC9C0 \uC54A\uC74C. \uC798\uBABB\uB41C \uC140 \uC218\uC815\uC744 \uBC29\uC9C0\uD558\uB824\uBA74 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uD558\uC138\uC694."
-  ),
-  // label 필드 없음 — 좌표 모드 전용
-  label: z4.undefined().optional()
-});
-var labelCellEditItemSchema = z4.object({
-  label: z4.string().describe(
-    "\uB808\uC774\uBE14 \uC140\uC758 \uD14D\uC2A4\uD2B8 (\uD2B8\uB9BC \uBE44\uAD50). \uC774 \uC140\uC758 \uC778\uC811 \uBC29\uD5A5(direction)\uC5D0 \uC788\uB294 \uC140\uC5D0 newText\uB97C \uAE30\uB85D\uD568."
-  ),
-  direction: z4.enum(["right", "below"]).optional().default("right").describe(
-    "\uB808\uC774\uBE14 \uAE30\uC900 \uB300\uC0C1 \uC140 \uBC29\uD5A5. right(\uAE30\uBCF8): \uC624\uB978\uCABD \uC140, below: \uC544\uB798 \uC140. \uBCD1\uD569 \uC140\uC740 span\uC744 \uACE0\uB824\uD558\uC5EC \uB300\uC0C1 \uC140 \uC8FC\uC18C\uB97C \uACC4\uC0B0\uD569\uB2C8\uB2E4."
-  ),
+var cellEditItemSchema = z4.object({
   tableIndex: z4.number().int().nonnegative().optional().describe(
-    "\uD0D0\uC0C9\uC744 \uC81C\uD55C\uD560 \uD45C \uC778\uB371\uC2A4 (0-based). \uC0DD\uB7B5\uD558\uBA74 \uBB38\uC11C \uB0B4 \uBAA8\uB4E0 \uCD5C\uC0C1\uC704 \uD45C\uC5D0\uC11C \uD0D0\uC0C9. \uB808\uC774\uBE14\uC774 \uC911\uBCF5\uB420 \uACBD\uC6B0 tableIndex\uB85C \uBC94\uC704\uB97C \uC881\uD788\uC138\uC694."
+    "\uC88C\uD45C \uBAA8\uB4DC: 0-based \uD45C \uC778\uB371\uC2A4(read_document\uC758 kordoc \uBE14\uB85D \uC21C\uC11C, \uC911\uCCA9\uD45C \uC81C\uC678). \uB808\uC774\uBE14 \uBAA8\uB4DC\uC5D0\uC120 \uD0D0\uC0C9 \uBC94\uC704 \uC81C\uD55C\uC6A9(\uC120\uD0DD)."
+  ),
+  row: z4.number().int().nonnegative().optional().describe("\uC88C\uD45C \uBAA8\uB4DC: \uC140\uC758 rowAddr (0-based)"),
+  col: z4.number().int().nonnegative().optional().describe("\uC88C\uD45C \uBAA8\uB4DC: \uC140\uC758 colAddr (0-based)"),
+  label: z4.string().optional().describe(
+    "\uB808\uC774\uBE14 \uBAA8\uB4DC: \uAE30\uC900 \uC140 \uD14D\uC2A4\uD2B8(\uD2B8\uB9BC \uBE44\uAD50). \uC774 \uC140\uC758 direction \uBC29\uD5A5 \uC778\uC811 \uC140\uC5D0 newText\uB97C \uAE30\uB85D. \uC88C\uD45C \uBAA8\uB4DC\uBA74 \uC0DD\uB7B5."
   ),
+  direction: z4.enum(["right", "below"]).optional().describe("\uB808\uC774\uBE14 \uBAA8\uB4DC \uBC29\uD5A5. \uAE30\uBCF8 right(\uC624\uB978\uCABD \uC140), below(\uC544\uB798 \uC140). \uBCD1\uD569 span \uACE0\uB824."),
   newText: z4.string().describe("\uC140\uC5D0 \uC4F8 \uC0C8 \uD14D\uC2A4\uD2B8"),
   expectedText: z4.string().optional().describe(
-    "\uD604\uC7AC \uC140 \uD14D\uC2A4\uD2B8 (\uC548\uC804 \uAC80\uC99D\uC6A9). \uC81C\uACF5 \uC2DC \uD604\uC7AC \uC140 \uD14D\uC2A4\uD2B8\uC640 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC218\uC815\uD558\uC9C0 \uC54A\uC74C. \uC798\uBABB\uB41C \uC140 \uC218\uC815\uC744 \uBC29\uC9C0\uD558\uB824\uBA74 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uD558\uC138\uC694."
-  ),
-  // row/col 필드 없음 — 레이블 모드 전용
-  row: z4.undefined().optional(),
-  col: z4.undefined().optional()
-});
-var cellEditItemSchema = z4.union([coordinateCellEditItemSchema, labelCellEditItemSchema]).describe(
-  "\uD3B8\uC9D1 \uD56D\uBAA9: \uC88C\uD45C \uBAA8\uB4DC(tableIndex+row+col) \uB610\uB294 \uB808\uC774\uBE14 \uBAA8\uB4DC(label+direction) \uC911 \uD558\uB098 \uC0AC\uC6A9. \uB450 \uBAA8\uB4DC\uB97C \uB3D9\uC2DC\uC5D0 \uC9C0\uC815\uD558\uAC70\uB098 \uB458 \uB2E4 \uC0DD\uB7B5\uD558\uBA74 \uC720\uD6A8\uC131 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD569\uB2C8\uB2E4."
+    "\uD604\uC7AC \uC140 \uD14D\uC2A4\uD2B8(\uC548\uC804 \uAC80\uC99D\uC6A9). \uBD88\uC77C\uCE58 \uC2DC \uC218\uC815\uD558\uC9C0 \uC54A\uC74C. \uC798\uBABB\uB41C \uC140 \uC218\uC815 \uBC29\uC9C0\uB97C \uC704\uD574 \uAD8C\uC7A5."
+  )
+}).describe(
+  "\uD3B8\uC9D1 \uD56D\uBAA9. \uC88C\uD45C \uBAA8\uB4DC(tableIndex+row+col) \uB610\uB294 \uB808\uC774\uBE14 \uBAA8\uB4DC(label[+direction]) \uC911 \uD558\uB098\uB97C \uC0AC\uC6A9\uD558\uC138\uC694. \uB458 \uB2E4 \uC9C0\uC815\uD558\uAC70\uB098 \uB458 \uB2E4 \uC0DD\uB7B5\uD558\uBA74 \uC624\uB958\uC785\uB2C8\uB2E4."
 );
 var proposeCellEditSchema = z4.object({
   path: z4.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
@@ -12337,7 +12335,11 @@ var proposeCellEditTool = {
     for (let i = 0; i < input.edits.length; i++) {
       const e = input.edits[i];
       if (!e) continue;
-      if ("label" in e && e.label !== void 0) {
+      if (e.label !== void 0 && (e.row !== void 0 || e.col !== void 0)) {
+        resolveErrors.push(
+          `\uD3B8\uC9D1 #${i + 1}: label\uACFC row/col\uC744 \uB3D9\uC2DC\uC5D0 \uC9C0\uC815\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC88C\uD45C \uBAA8\uB4DC(tableIndex+row+col) \uB610\uB294 \uB808\uC774\uBE14 \uBAA8\uB4DC(label) \uC911 \uD558\uB098\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.`
+        );
+      } else if (e.label !== void 0) {
         const direction = e.direction ?? "right";
         const resolved = resolveLabelAcrossSections(e.label, direction, e.tableIndex);
         if ("error" in resolved) {
@@ -12352,15 +12354,18 @@ var proposeCellEditTool = {
             label: e.label
           });
         }
-      } else {
-        const coord = e;
+      } else if (e.tableIndex !== void 0 && e.row !== void 0 && e.col !== void 0) {
         resolvedEdits.push({
-          tableIndex: coord.tableIndex,
-          row: coord.row,
-          col: coord.col,
-          newText: coord.newText,
-          expectedText: coord.expectedText
+          tableIndex: e.tableIndex,
+          row: e.row,
+          col: e.col,
+          newText: e.newText,
+          expectedText: e.expectedText
         });
+      } else {
+        resolveErrors.push(
+          `\uD3B8\uC9D1 #${i + 1}: \uC88C\uD45C \uBAA8\uB4DC(tableIndex+row+col) \uB610\uB294 \uB808\uC774\uBE14 \uBAA8\uB4DC(label) \uC911 \uD558\uB098\uB97C \uC644\uC804\uD788 \uC9C0\uC815\uD558\uC138\uC694. read_document\uB85C \uD45C \uB0B4\uC6A9\uC744 \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`
+        );
       }
     }
     if (resolveErrors.length > 0) {
@@ -12631,11 +12636,245 @@ ${diff}`;
     };
   }
 };
-var proposeFormFillSchema = z6.object({
-  path: z6.string().describe("\uC591\uC2DD \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  fields: z6.record(z6.string(), z6.string()).describe("\uCC44\uC6B8 \uD544\uB4DC \uB9E4\uD551: { \uB77C\uBCA8: \uAC12 }. read_document\uB85C \uBA3C\uC800 \uD544\uB4DC \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uC138\uC694"),
+var proposeFindReplaceSchema = z6.object({
+  path: z6.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  find: z6.string().min(1).describe("\uCC3E\uC744 \uD14D\uC2A4\uD2B8"),
+  replace: z6.string().describe("\uBC14\uAFC0 \uD14D\uC2A4\uD2B8"),
+  caseSensitive: z6.boolean().optional().default(false).describe("\uB300\uC18C\uBB38\uC790 \uAD6C\uBD84 (\uAE30\uBCF8\uAC12: false)"),
+  all: z6.boolean().optional().default(true).describe("\uBAA8\uB4E0 \uD56D\uBAA9\uC744 \uAD50\uCCB4\uD560\uC9C0 \uC5EC\uBD80 (\uAE30\uBCF8\uAC12: true). false\uC774\uBA74 \uCCAB \uBC88\uC9F8 \uB9E4\uCE58\uB9CC \uAD50\uCCB4"),
   summary: z6.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
+function escapeXml3(text3) {
+  return text3.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function replaceInSectionXml(xml, find, replace, caseSensitive, replaceAll, alreadyReplaced) {
+  if (!replaceAll && alreadyReplaced > 0) {
+    return { xml, count: 0 };
+  }
+  const escapedFind = escapeXml3(find);
+  const escapedReplace = escapeXml3(replace);
+  if (escapedFind.length === 0) {
+    return { xml, count: 0 };
+  }
+  const normFind = caseSensitive ? escapedFind : escapedFind.toLowerCase();
+  const normReplace = escapedReplace;
+  let totalCount = 0;
+  let result = xml;
+  const tNodeRe = /<hp:t>([\s\S]*?)<\/hp:t>/g;
+  let offset = 0;
+  let m = tNodeRe.exec(xml);
+  while (m !== null) {
+    const content = m[1];
+    const nodeResult = replaceInContent(
+      content,
+      normFind,
+      normReplace,
+      caseSensitive,
+      replaceAll,
+      alreadyReplaced + totalCount
+    );
+    if (nodeResult.count > 0) {
+      const openTagLen = "<hp:t>".length;
+      const contentStart = m.index + offset + openTagLen;
+      const contentEnd = contentStart + content.length;
+      result = result.substring(0, contentStart) + nodeResult.text + result.substring(contentEnd);
+      offset += nodeResult.text.length - content.length;
+      totalCount += nodeResult.count;
+      if (!replaceAll && alreadyReplaced + totalCount >= 1) {
+        break;
+      }
+    }
+    m = tNodeRe.exec(xml);
+  }
+  return { xml: result, count: totalCount };
+}
+function replaceInContent(content, normFind, escapedReplace, caseSensitive, replaceAll, alreadyReplaced) {
+  const searchIn = caseSensitive ? content : content.toLowerCase();
+  const findLen = normFind.length;
+  if (findLen === 0) return { text: content, count: 0 };
+  let result = "";
+  let pos = 0;
+  let count = 0;
+  while (pos <= content.length) {
+    if (!replaceAll && alreadyReplaced + count >= 1) {
+      result += content.substring(pos);
+      break;
+    }
+    const idx = searchIn.indexOf(normFind, pos);
+    if (idx === -1) {
+      result += content.substring(pos);
+      break;
+    }
+    result += content.substring(pos, idx) + escapedReplace;
+    pos = idx + findLen;
+    count++;
+  }
+  return { text: result, count };
+}
+function countOccurrences(str, sub) {
+  if (sub.length === 0) return 0;
+  let count = 0;
+  let pos = 0;
+  while (true) {
+    const idx = str.indexOf(sub, pos);
+    if (idx === -1) break;
+    count++;
+    pos = idx + sub.length;
+  }
+  return count;
+}
+async function applyFindReplaceToHwpx(hwpxBuffer, find, replace, caseSensitive, replaceAll) {
+  const zip = await import_jszip3.default.loadAsync(hwpxBuffer);
+  const sectionFiles = Object.keys(zip.files).filter((name) => /^Contents\/section\d+\.xml$/.test(name)).sort();
+  const sectionXmls = [];
+  for (const sf of sectionFiles) {
+    const entry = zip.file(sf);
+    const xml = entry ? await entry.async("string") : "";
+    sectionXmls.push(xml);
+  }
+  let totalCount = 0;
+  const newSectionXmls = [];
+  for (let si = 0; si < sectionFiles.length; si++) {
+    const srcXml = sectionXmls[si] ?? "";
+    const { xml: newXml, count } = replaceInSectionXml(
+      srcXml,
+      find,
+      replace,
+      caseSensitive,
+      replaceAll,
+      totalCount
+    );
+    newSectionXmls.push(newXml);
+    totalCount += count;
+    if (!replaceAll && totalCount >= 1) {
+      for (let j = si + 1; j < sectionFiles.length; j++) {
+        newSectionXmls.push(sectionXmls[j] ?? "");
+      }
+      break;
+    }
+  }
+  if (totalCount === 0) {
+    return { buffer: hwpxBuffer, count: 0 };
+  }
+  const out = new import_jszip3.default();
+  const mimetypeEntry = zip.file("mimetype");
+  if (mimetypeEntry) {
+    out.file("mimetype", await mimetypeEntry.async("uint8array"), { compression: "STORE" });
+  }
+  for (const [name, entry] of Object.entries(zip.files)) {
+    if (name === "mimetype" || entry.dir) continue;
+    const sectionIdx = sectionFiles.indexOf(name);
+    if (sectionIdx >= 0) {
+      out.file(name, newSectionXmls[sectionIdx] ?? "");
+    } else {
+      out.file(name, await entry.async("uint8array"));
+    }
+  }
+  const buf = await out.generateAsync({ type: "nodebuffer", compression: "DEFLATE" });
+  return {
+    buffer: new Uint8Array(buf),
+    count: totalCount
+  };
+}
+var proposeFindReplaceTool = {
+  name: "propose_find_replace",
+  description: "HWPX \uBB38\uC11C \uC804\uCCB4\uC5D0\uC11C \uD14D\uC2A4\uD2B8\uB97C \uCC3E\uC544 \uBC14\uAFC9\uB2C8\uB2E4. \uBCF8\uBB38\xB7\uD45C\xB7\uBA38\uB9AC\uB9D0\xB7\uAF2C\uB9AC\uB9D0 \uB4F1 \uBAA8\uB4E0 \uC139\uC158\uC744 \uB300\uC0C1\uC73C\uB85C \uBB38\uC11C XML\uC744 \uC9C1\uC811 \uD328\uCE58\uD569\uB2C8\uB2E4(rhwp \uC5D4\uC9C4 \uBBF8\uC0AC\uC6A9). \uC774\uBBF8\uC9C0\xB7\uD45C\xB7\uB808\uC774\uC544\uC6C3 \uB4F1 \uBB38\uC11C \uAD6C\uC870\uB97C \uC644\uC804\uD788 \uBCF4\uC874\uD569\uB2C8\uB2E4. .hwpx \uC804\uC6A9\uC785\uB2C8\uB2E4. .hwp(\uAD6C\uD615 OLE \uBC14\uC774\uB108\uB9AC)\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC73C\uBA70, \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C '\uB2E4\uB978 \uC774\uB984\uC73C\uB85C \uC800\uC7A5 \u2192 .hwpx'\uB85C \uC800\uC7A5\uD55C \uD6C4 \uC0AC\uC6A9\uD558\uC138\uC694. all:true(\uAE30\uBCF8\uAC12)\uC774\uBA74 \uBAA8\uB4E0 \uD56D\uBAA9\uC744 \uAD50\uCCB4\uD558\uACE0, all:false\uC774\uBA74 \uCCAB \uBC88\uC9F8 \uB9E4\uCE58\uB9CC \uAD50\uCCB4\uD569\uB2C8\uB2E4. \uD14D\uC2A4\uD2B8\uAC00 \uC5EC\uB7EC \uC11C\uC2DD \uB7F0\uC5D0 \uB098\uB258\uC5B4 \uC788\uC73C\uBA74 \uACBD\uACC4\uB97C \uAC00\uB85C\uC9C0\uB974\uB294 \uD328\uD134\uC740 \uAD50\uCCB4\uB418\uC9C0 \uC54A\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4(\uC11C\uC2DD\uC774 \uB098\uB25C \uD14D\uC2A4\uD2B8). \uCC3E\uC744 \uD14D\uC2A4\uD2B8\uAC00 \uC5C6\uC73C\uBA74 \uD30C\uC77C\uC744 \uC218\uC815\uD558\uC9C0 \uC54A\uACE0 \uC624\uB958\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4. \uBCC0\uACBD \uC0AC\uD56D\uC740 diff \uBBF8\uB9AC\uBCF4\uAE30\uC640 \uD568\uAED8 \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC744 \uBC1B\uC740 \uD6C4\uC5D0\uB9CC \uC800\uC7A5\uB429\uB2C8\uB2E4.",
+  inputSchema: proposeFindReplaceSchema,
+  requiresApproval: true,
+  propose: async ({
+    input,
+    ctx
+  }) => {
+    const safePath = await resolveSafePath(ctx.cwd, input.path);
+    const ext = extname6(safePath).toLowerCase();
+    if (ext === ".hwp") {
+      return "\uC624\uB958: propose_find_replace\uB294 .hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. .hwp(\uAD6C\uD615 OLE \uBC14\uC774\uB108\uB9AC)\uB294 XML \uC9C1\uC811 \uD3B8\uC9D1\uC774 \uBD88\uAC00\uD569\uB2C8\uB2E4. \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C '\uB2E4\uB978 \uC774\uB984\uC73C\uB85C \uC800\uC7A5 \u2192 .hwpx'\uB85C \uC800\uC7A5\uD55C \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.";
+    }
+    if (ext !== ".hwpx") {
+      return `\uC624\uB958: propose_find_replace\uB294 .hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C \uD655\uC7A5\uC790: ${ext}. .hwpx \uD30C\uC77C\uC744 \uC9C0\uC815\uD558\uC138\uC694.`;
+    }
+    let originalBuf;
+    try {
+      originalBuf = await readFile6(safePath);
+    } catch {
+      return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}. \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.`;
+    }
+    if (originalBuf[0] !== 80 || originalBuf[1] !== 75) {
+      return "\uC624\uB958: \uD30C\uC77C\uC774 \uC720\uD6A8\uD55C .hwpx(ZIP) \uD3EC\uB9F7\uC774 \uC544\uB2D9\uB2C8\uB2E4. \uD30C\uC77C\uC774 \uC190\uC0C1\uB418\uC5C8\uAC70\uB098 \uAD6C\uD615 .hwp(OLE \uBC14\uC774\uB108\uB9AC) \uD3EC\uB9F7\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C .hwpx\uB85C \uC800\uC7A5 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.";
+    }
+    const originalBytes = new Uint8Array(
+      originalBuf.buffer,
+      originalBuf.byteOffset,
+      originalBuf.byteLength
+    );
+    let newBytes;
+    let replacedCount;
+    try {
+      const result = await applyFindReplaceToHwpx(
+        originalBytes,
+        input.find,
+        input.replace,
+        input.caseSensitive ?? false,
+        input.all ?? true
+      );
+      newBytes = result.buffer;
+      replacedCount = result.count;
+    } catch (e) {
+      return `\uC624\uB958: \uCE58\uD658 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. ${String(e)}`;
+    }
+    if (replacedCount === 0) {
+      const caseNote = input.caseSensitive ? " (\uB300\uC18C\uBB38\uC790 \uAD6C\uBD84)" : "";
+      return `\uC624\uB958: \uCC3E\uC744 \uD14D\uC2A4\uD2B8\uB97C \uBB38\uC11C\uC5D0\uC11C \uBC1C\uACAC\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: "${input.find}"${caseNote}. read_document\uB85C \uBB38\uC11C \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uACE0 \uC815\uD655\uD55C \uD14D\uC2A4\uD2B8\uB97C \uC9C0\uC815\uD558\uC138\uC694.`;
+    }
+    const warnings = [];
+    try {
+      const exportedResult = await parse2(newBytes.buffer);
+      if (exportedResult.success) {
+        const exportedMd = exportedResult.markdown;
+        const normAfter = input.caseSensitive ?? false ? exportedMd : exportedMd.toLowerCase();
+        const normFind = input.caseSensitive ?? false ? input.find : input.find.toLowerCase();
+        const normReplace = input.caseSensitive ?? false ? input.replace : input.replace.toLowerCase();
+        if (!normReplace.includes(normFind)) {
+          const remaining = countOccurrences(normAfter, normFind);
+          if (remaining > 0) {
+            warnings.push(
+              `\uC77C\uBD80 "${input.find}"(${remaining}\uACF3)\uC774 \uAD50\uCCB4\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uD14D\uC2A4\uD2B8\uAC00 \uC5EC\uB7EC \uC11C\uC2DD \uB7F0\uC5D0 \uB098\uB258\uC5B4 \uC788\uC5B4 \uACBD\uACC4\uB97C \uAC00\uB85C\uC9C0\uB974\uB294 \uD328\uD134\uC740 \uAD50\uCCB4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(\uC11C\uC2DD\uC774 \uB098\uB25C \uD14D\uC2A4\uD2B8). \uC774\uBBF8 \uAD50\uCCB4\uB41C ${replacedCount}\uACF3\uC740 \uC815\uC0C1 \uBC18\uC601\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`
+            );
+          }
+        }
+      }
+    } catch {
+    }
+    const { outputPath, willConvertFormat } = resolveOutputPath(safePath);
+    const allLabel = input.all ?? true ? `${replacedCount}\uACF3` : "\uCCAB \uBC88\uC9F8 1\uACF3";
+    const diff = `\uCC3E\uAE30: "${input.find}" \u2192 \uBC14\uAFB8\uAE30: "${input.replace}" (${allLabel} \uAD50\uCCB4\uB428)`;
+    const stagedPath = await stageFile(ctx.sessionId, outputPath, newBytes);
+    const proposalId = crypto.randomUUID();
+    return {
+      proposal: {
+        id: proposalId,
+        kind: "find-replace",
+        targetPath: outputPath,
+        stagedPath,
+        summary: input.summary,
+        diff,
+        warnings,
+        willConvertFormat
+      },
+      commit: async () => {
+        const backupPath = await backupFile(safePath);
+        await commitStaged(stagedPath, outputPath);
+        const backupInfo = backupPath ? ` (\uBC31\uC5C5: ${backupPath})` : "";
+        return `\uC800\uC7A5 \uC644\uB8CC: ${outputPath}${backupInfo}`;
+      }
+    };
+  }
+};
+var proposeFormFillSchema = z7.object({
+  path: z7.string().describe("\uC591\uC2DD \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  fields: z7.record(z7.string(), z7.string()).describe("\uCC44\uC6B8 \uD544\uB4DC \uB9E4\uD551: { \uB77C\uBCA8: \uAC12 }. read_document\uB85C \uBA3C\uC800 \uD544\uB4DC \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uC138\uC694"),
+  summary: z7.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+});
 var proposeFormFillTool = {
   name: "propose_form_fill",
   description: "HWPX/HWP \uC591\uC2DD \uBB38\uC11C\uC758 \uD544\uB4DC\uB97C \uCC44\uC6C1\uB2C8\uB2E4. \uBC18\uB4DC\uC2DC read_document\uB85C \uD604\uC7AC \uD544\uB4DC \uBAA9\uB85D\uC744 \uBA3C\uC800 \uD655\uC778\uD55C \uD6C4 \uC0AC\uC6A9\uD558\uC138\uC694. \uBCC0\uACBD \uC0AC\uD56D\uC740 diff \uBBF8\uB9AC\uBCF4\uAE30\uC640 \uD568\uAED8 \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC744 \uBC1B\uC740 \uD6C4\uC5D0\uB9CC \uC800\uC7A5\uB429\uB2C8\uB2E4.",
@@ -12646,17 +12885,17 @@ var proposeFormFillTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname6(safePath).toLowerCase();
+    const ext = extname7(safePath).toLowerCase();
     if (ext !== ".hwpx" && ext !== ".hwp") {
       return `\uC624\uB958: propose_form_fill\uC740 .hwp/.hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C: ${ext}. .docx \uD30C\uC77C\uC740 propose_edit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.`;
     }
     let originalBuffer;
     try {
-      originalBuffer = await readFile6(safePath);
+      originalBuffer = await readFile7(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}. \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.`;
     }
-    const parseResult = await parse2(originalBuffer.buffer);
+    const parseResult = await parse3(originalBuffer.buffer);
     if (!parseResult.success) {
       const msg = kordocErrorMessage(
         parseResult.code,
@@ -12720,16 +12959,16 @@ var proposeFormFillTool = {
     };
   }
 };
-var proposeSheetEditSchema = z7.object({
-  path: z7.string().describe("\uC218\uC815\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  updates: z7.array(
-    z7.object({
-      sheet: z7.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
-      cell: z7.string().describe("\uC140 \uC8FC\uC18C (\uC608: A1, B3)"),
-      value: z7.union([z7.string(), z7.number()]).describe("\uC0C8 \uAC12")
+var proposeSheetEditSchema = z8.object({
+  path: z8.string().describe("\uC218\uC815\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  updates: z8.array(
+    z8.object({
+      sheet: z8.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
+      cell: z8.string().describe("\uC140 \uC8FC\uC18C (\uC608: A1, B3)"),
+      value: z8.union([z8.string(), z8.number()]).describe("\uC0C8 \uAC12")
     })
   ).min(1).describe("\uC218\uC815\uD560 \uC140 \uBAA9\uB85D. read_document\uB85C \uC6D0\uBCF8 \uC2DC\uD2B8 \uAD6C\uC870\uB97C \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694"),
-  summary: z7.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+  summary: z8.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 var proposeSheetEditTool = {
   name: "propose_sheet_edit",
@@ -12741,13 +12980,13 @@ var proposeSheetEditTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname7(safePath).toLowerCase();
+    const ext = extname8(safePath).toLowerCase();
     if (ext !== ".xlsx" && ext !== ".xls") {
       return `\uC624\uB958: propose_sheet_edit\uC740 .xlsx/.xls \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C: ${ext}.`;
     }
     let originalBuffer;
     try {
-      originalBuffer = await readFile7(safePath);
+      originalBuffer = await readFile8(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}. \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.`;
     }
@@ -12807,6 +13046,881 @@ var proposeSheetEditTool = {
     };
   }
 };
+function detectStructuralLoss(beforeBlocks, afterBlocks) {
+  const LABELS = {
+    paragraph: "\uB2E8\uB77D",
+    table: "\uD45C",
+    heading: "\uC81C\uBAA9",
+    list: "\uBAA9\uB85D",
+    image: "\uC774\uBBF8\uC9C0",
+    separator: "\uAD6C\uBD84\uC120"
+  };
+  function histogram(blocks) {
+    const h = {};
+    for (const b of blocks) {
+      h[b.type] = (h[b.type] ?? 0) + 1;
+    }
+    return h;
+  }
+  const beforeH = histogram(beforeBlocks);
+  const afterH = histogram(afterBlocks);
+  const dropParts = [];
+  for (const [type, beforeCount] of Object.entries(beforeH)) {
+    const afterCount = afterH[type] ?? 0;
+    if (afterCount < beforeCount) {
+      const label = LABELS[type] ?? type;
+      dropParts.push(`${label} ${beforeCount}\u2192${afterCount}`);
+    }
+  }
+  if (dropParts.length > 0) {
+    return { lost: true, detail: dropParts.join(", ") };
+  }
+  return { lost: false, detail: "" };
+}
+var insertRowOpSchema = z9.object({
+  type: z9.literal("insertRow"),
+  row: z9.number().int().nonnegative().describe("\uAE30\uC900 \uD589 \uC778\uB371\uC2A4 (0-based)"),
+  position: z9.enum(["above", "below"]).describe("\uC0BD\uC785 \uC704\uCE58: above=row \uC704\uC5D0, below=row \uC544\uB798\uC5D0")
+});
+var deleteRowOpSchema = z9.object({
+  type: z9.literal("deleteRow"),
+  row: z9.number().int().nonnegative().describe("\uC0AD\uC81C\uD560 \uD589 \uC778\uB371\uC2A4 (0-based)")
+});
+var insertColumnOpSchema = z9.object({
+  type: z9.literal("insertColumn"),
+  col: z9.number().int().nonnegative().describe("\uAE30\uC900 \uC5F4 \uC778\uB371\uC2A4 (0-based)"),
+  position: z9.enum(["left", "right"]).describe("\uC0BD\uC785 \uC704\uCE58: left=col \uC67C\uCABD\uC5D0, right=col \uC624\uB978\uCABD\uC5D0")
+});
+var deleteColumnOpSchema = z9.object({
+  type: z9.literal("deleteColumn"),
+  col: z9.number().int().nonnegative().describe("\uC0AD\uC81C\uD560 \uC5F4 \uC778\uB371\uC2A4 (0-based)")
+});
+var mergeCellsOpSchema = z9.object({
+  type: z9.literal("mergeCells"),
+  startRow: z9.number().int().nonnegative().describe("\uBCD1\uD569 \uC2DC\uC791 \uD589 (0-based)"),
+  startCol: z9.number().int().nonnegative().describe("\uBCD1\uD569 \uC2DC\uC791 \uC5F4 (0-based)"),
+  endRow: z9.number().int().nonnegative().describe("\uBCD1\uD569 \uB05D \uD589 (0-based, \uD3EC\uD568)"),
+  endCol: z9.number().int().nonnegative().describe("\uBCD1\uD569 \uB05D \uC5F4 (0-based, \uD3EC\uD568)")
+});
+var operationSchema = z9.discriminatedUnion("type", [
+  insertRowOpSchema,
+  deleteRowOpSchema,
+  insertColumnOpSchema,
+  deleteColumnOpSchema,
+  mergeCellsOpSchema
+]).describe("\uD45C \uAD6C\uC870 \uC5F0\uC0B0. \uB098\uC911 \uC5F0\uC0B0\uC758 row/col \uC778\uB371\uC2A4\uB294 \uC55E \uC5F0\uC0B0 \uC801\uC6A9 \uD6C4 \uC0C1\uD0DC\uB97C \uAE30\uC900\uC73C\uB85C \uD55C\uB2E4.");
+var proposeTableStructureSchema = z9.object({
+  path: z9.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  anchor: z9.string().min(1).describe(
+    "\uB300\uC0C1 \uD45C\uB97C \uC2DD\uBCC4\uD558\uB294 \uC575\uCEE4 \uD14D\uC2A4\uD2B8. \uD45C \uC548\uC5D0\uB9CC \uC788\uB294 \uB3C5\uD2B9\uD55C \uC140 \uD14D\uC2A4\uD2B8\uB97C \uC9C0\uC815\uD558\uC138\uC694. (\uBD80\uBD84 \uC77C\uCE58, \uACF5\uBC31 \uD2B8\uB9BC) \u2014 read_document\uB85C \uD655\uC778 \uD6C4 \uC0AC\uC6A9 \uAD8C\uC7A5."
+  ),
+  operations: z9.array(operationSchema).min(1).describe(
+    "\uC801\uC6A9\uD560 \uD45C \uAD6C\uC870 \uC5F0\uC0B0 \uBAA9\uB85D (\uC21C\uC11C\uB300\uB85C \uC2E4\uD589). \uAC01 \uC5F0\uC0B0\uC740 \uC774\uC804 \uC5F0\uC0B0\uC774 \uC801\uC6A9\uB41C \uD6C4\uC758 \uD45C \uC0C1\uD0DC \uAE30\uC900\uC73C\uB85C row/col\uC744 \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4."
+  ),
+  summary: z9.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+});
+function tokenizeHwpxXml2(xml) {
+  const tokens = [];
+  const re = /<hp:tbl[\s>]|<\/hp:tbl>|<hp:tr[\s>]|<\/hp:tr>|<hp:tc[\s>]|<\/hp:tc>|<hp:t\/>|<hp:t>|<\/hp:t>|<hp:cellAddr[^/>]*|<hp:cellSpan[^/>]*|<hp:cellSz[^/>]*/g;
+  let m = re.exec(xml);
+  while (m !== null) {
+    const raw = m[0];
+    const pos = m.index;
+    if (raw.startsWith("<hp:tbl")) {
+      tokens.push({ kind: "tbl_open", pos, end: pos + raw.length });
+    } else if (raw === "</hp:tbl>") {
+      tokens.push({ kind: "tbl_close", pos, end: pos + raw.length });
+    } else if (raw.startsWith("<hp:tr")) {
+      tokens.push({ kind: "tr_open", pos, end: pos + raw.length });
+    } else if (raw === "</hp:tr>") {
+      tokens.push({ kind: "tr_close", pos, end: pos + raw.length });
+    } else if (raw.startsWith("<hp:tc")) {
+      tokens.push({ kind: "tc_open", pos, end: pos + raw.length });
+    } else if (raw === "</hp:tc>") {
+      tokens.push({ kind: "tc_close", pos, end: pos + raw.length });
+    } else if (raw === "<hp:t/>") {
+      tokens.push({ kind: "t_empty", pos, end: pos + raw.length });
+    } else if (raw === "<hp:t>") {
+      tokens.push({ kind: "t_open", pos, end: pos + raw.length });
+    } else if (raw === "</hp:t>") {
+      tokens.push({ kind: "t_close", pos, end: pos + raw.length });
+    } else if (raw.startsWith("<hp:cellAddr")) {
+      const colM = raw.match(/colAddr="(\d+)"/);
+      const rowM = raw.match(/rowAddr="(\d+)"/);
+      if (colM && rowM) {
+        const selfClose = xml.indexOf("/>", pos);
+        const end = selfClose >= 0 ? selfClose + 2 : pos + raw.length;
+        tokens.push({
+          kind: "cell_addr",
+          pos,
+          end,
+          colAddr: Number(colM[1]),
+          rowAddr: Number(rowM[1])
+        });
+      }
+    } else if (raw.startsWith("<hp:cellSpan")) {
+      const colM = raw.match(/colSpan="(\d+)"/);
+      const rowM = raw.match(/rowSpan="(\d+)"/);
+      const selfClose = xml.indexOf("/>", pos);
+      const end = selfClose >= 0 ? selfClose + 2 : pos + raw.length;
+      tokens.push({
+        kind: "cell_span",
+        pos,
+        end,
+        colSpan: colM ? Number(colM[1]) : 1,
+        rowSpan: rowM ? Number(rowM[1]) : 1
+      });
+    } else if (raw.startsWith("<hp:cellSz")) {
+      const selfClose = xml.indexOf("/>", pos);
+      const end = selfClose >= 0 ? selfClose + 2 : pos + raw.length;
+      tokens.push({ kind: "cell_sz", pos, end });
+    }
+    m = re.exec(xml);
+  }
+  return tokens;
+}
+function findAllTopLevelTableRanges(tokens) {
+  const ranges = [];
+  let depth = 0;
+  let topCount = 0;
+  let startPos = -1;
+  for (const tok of tokens) {
+    if (tok.kind === "tbl_open") {
+      if (depth === 0) {
+        startPos = tok.pos;
+      }
+      depth++;
+    } else if (tok.kind === "tbl_close") {
+      depth--;
+      if (depth === 0 && startPos >= 0) {
+        ranges.push({ start: startPos, end: tok.end, index: topCount });
+        topCount++;
+        startPos = -1;
+      }
+    }
+  }
+  return ranges;
+}
+function collectTableText(xml, tokens, tblStart, tblEnd) {
+  const parts = [];
+  const tblTokens = tokens.filter((t) => t.pos >= tblStart && t.pos < tblEnd);
+  for (const tok of tblTokens) {
+    if (tok.kind === "t_open") {
+      const closePos = xml.indexOf("</hp:t>", tok.end);
+      if (closePos >= 0 && closePos < tblEnd) {
+        const raw = xml.substring(tok.end, closePos);
+        parts.push(raw.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">"));
+      }
+    }
+  }
+  return parts.join("");
+}
+function parseTableRows(_xml, tokens, tblStart, tblEnd) {
+  const tblTokens = tokens.filter((t) => t.pos > tblStart && t.pos < tblEnd);
+  const rows = [];
+  const trStack = [];
+  const tcStack = [];
+  let innerTblDepth = 0;
+  let currentRowCells = [];
+  for (const tok of tblTokens) {
+    if (tok.kind === "tbl_open") {
+      innerTblDepth++;
+    } else if (tok.kind === "tbl_close") {
+      innerTblDepth--;
+    } else if (innerTblDepth > 0) {
+    } else if (tok.kind === "tr_open") {
+      trStack.push({ pos: tok.pos });
+      currentRowCells = [];
+    } else if (tok.kind === "tr_close") {
+      const trEntry = trStack.pop();
+      if (trEntry !== void 0) {
+        rows.push({ trStart: trEntry.pos, trEnd: tok.end, cells: currentRowCells });
+        currentRowCells = [];
+      }
+    } else if (tok.kind === "tc_open") {
+      tcStack.push({ pos: tok.pos });
+    } else if (tok.kind === "tc_close") {
+      const tcEntry = tcStack.pop();
+      if (tcEntry !== void 0) {
+        const tcTokens = tblTokens.filter(
+          (t) => t.pos >= tcEntry.pos && t.pos < tok.end && innerTblDepth === 0
+        );
+        let colAddr = -1;
+        let rowAddr = -1;
+        let colSpan = 1;
+        let rowSpan = 1;
+        for (const t of tcTokens) {
+          if (t.kind === "cell_addr" && t.colAddr !== void 0 && t.rowAddr !== void 0) {
+            colAddr = t.colAddr;
+            rowAddr = t.rowAddr;
+          } else if (t.kind === "cell_span" && t.colSpan !== void 0 && t.rowSpan !== void 0) {
+            colSpan = t.colSpan;
+            rowSpan = t.rowSpan;
+          }
+        }
+        if (colAddr >= 0 && rowAddr >= 0) {
+          currentRowCells.push({
+            colAddr,
+            rowAddr,
+            colSpan,
+            rowSpan,
+            tcStart: tcEntry.pos,
+            tcEnd: tok.end
+          });
+        }
+      }
+    }
+  }
+  return rows;
+}
+function parseTblDimensions(xml, tblStart) {
+  const tagEnd = xml.indexOf(">", tblStart);
+  const tagStr = xml.substring(tblStart, tagEnd + 1);
+  const rowM = tagStr.match(/rowCnt="(\d+)"/);
+  const colM = tagStr.match(/colCnt="(\d+)"/);
+  return {
+    rowCnt: rowM ? Number(rowM[1]) : 0,
+    colCnt: colM ? Number(colM[1]) : 0
+  };
+}
+function updateTblAttr(tblBlock, attr, newVal) {
+  return tblBlock.replace(new RegExp(`(${attr}=")\\d+(")`), `$1${newVal}$2`);
+}
+function clearCellText(tcXml) {
+  let first = true;
+  return tcXml.replace(/<hp:t>([\s\S]*?)<\/hp:t>/g, (_match, _content) => {
+    if (first) {
+      first = false;
+      return "<hp:t/>";
+    }
+    return "<hp:t/>";
+  });
+}
+function setCellRowAddr(tcXml, newRow) {
+  return tcXml.replace(/(rowAddr=")(\d+)(")/, `$1${newRow}$3`);
+}
+function setCellColAddr(tcXml, newCol) {
+  return tcXml.replace(/(colAddr=")(\d+)(")/, `$1${newCol}$3`);
+}
+function resetCellSpan(tcXml) {
+  return tcXml.replace(/(colSpan=")(\d+)(")/, `$11$3`).replace(/(rowSpan=")(\d+)(")/, `$11$3`);
+}
+function setCellSpan(tcXml, colSpan, rowSpan) {
+  return tcXml.replace(/(colSpan=")(\d+)(")/, `$1${colSpan}$3`).replace(/(rowSpan=")(\d+)(")/, `$1${rowSpan}$3`);
+}
+function insertRowInTbl(tblXml, row, below) {
+  const tokens = tokenizeHwpxXml2(tblXml);
+  const tblStart = 0;
+  const tblEnd = tblXml.length;
+  const rows = parseTableRows(tblXml, tokens, tblStart, tblEnd);
+  const dims = parseTblDimensions(tblXml, tblStart);
+  if (rows.length === 0) {
+    return { ok: false, error: "\uD45C\uC5D0 \uD589\uC774 \uC5C6\uC5B4 \uC0BD\uC785\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4." };
+  }
+  const targetRow = rows.find((r) => r.cells.some((c) => c.rowAddr === row));
+  if (!targetRow) {
+    return {
+      ok: false,
+      error: `\uD589 ${row}\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uD45C\uC5D0 rowAddr ${row}\uC778 \uC140\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`
+    };
+  }
+  const newRowAddr = below ? row + 1 : row;
+  for (const r of rows) {
+    for (const c of r.cells) {
+      if (c.rowSpan > 1) {
+        const spanEnd = c.rowAddr + c.rowSpan - 1;
+        if (c.rowAddr < newRowAddr && newRowAddr <= spanEnd) {
+          return {
+            ok: false,
+            error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC758 rowSpan=${c.rowSpan}\uC774 \uC0BD\uC785 \uC704\uCE58 \uD589 ${newRowAddr}\uC744 \uAC00\uB85C\uC9C0\uB985\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+          };
+        }
+      }
+    }
+  }
+  const trOffset = targetRow.trStart;
+  let modifiedTr = tblXml.substring(targetRow.trStart, targetRow.trEnd);
+  const sortedCells = [...targetRow.cells].sort((a, b) => b.tcStart - a.tcStart);
+  for (const cell of sortedCells) {
+    const tcLocalStart = cell.tcStart - trOffset;
+    const tcLocalEnd = cell.tcEnd - trOffset;
+    let tcXml = modifiedTr.substring(tcLocalStart, tcLocalEnd);
+    tcXml = setCellRowAddr(tcXml, newRowAddr);
+    tcXml = resetCellSpan(tcXml);
+    tcXml = clearCellText(tcXml);
+    modifiedTr = modifiedTr.substring(0, tcLocalStart) + tcXml + modifiedTr.substring(tcLocalEnd);
+  }
+  let result = tblXml;
+  const allTokens = tokenizeHwpxXml2(result);
+  const addrPatches = [];
+  for (const tok of allTokens) {
+    if (tok.kind === "cell_addr" && tok.rowAddr !== void 0 && tok.rowAddr >= newRowAddr) {
+      addrPatches.push({ pos: tok.pos, end: tok.end, newAddr: tok.rowAddr + 1 });
+    }
+  }
+  addrPatches.sort((a, b) => b.pos - a.pos);
+  for (const p of addrPatches) {
+    const oldTag = result.substring(p.pos, p.end);
+    const newTag = oldTag.replace(/(rowAddr=")(\d+)(")/, `$1${p.newAddr}$3`);
+    result = result.substring(0, p.pos) + newTag + result.substring(p.end);
+  }
+  const resultTokens = tokenizeHwpxXml2(result);
+  const resultRows = parseTableRows(result, resultTokens, 0, result.length);
+  let insertAfterPos;
+  let insertBeforePos;
+  if (below) {
+    const refRow = resultRows.find((r) => r.cells.some((c) => c.rowAddr === row));
+    if (!refRow) {
+      return { ok: false, error: "\uC0BD\uC785 \uAE30\uC900 \uD589\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uB0B4\uBD80 \uC624\uB958)." };
+    }
+    insertAfterPos = refRow.trEnd;
+  } else {
+    const refRow = resultRows.find((r) => r.cells.some((c) => c.rowAddr === row + 1));
+    if (!refRow) {
+      const firstRow = resultRows[0];
+      if (!firstRow) {
+        return { ok: false, error: "\uC0BD\uC785 \uC704\uCE58\uB97C \uACB0\uC815\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uB0B4\uBD80 \uC624\uB958)." };
+      }
+      insertBeforePos = firstRow.trStart;
+    } else {
+      insertBeforePos = refRow.trStart;
+    }
+    insertAfterPos = -1;
+  }
+  if (below) {
+    result = result.substring(0, insertAfterPos) + modifiedTr + result.substring(insertAfterPos);
+  } else {
+    result = result.substring(0, insertBeforePos) + modifiedTr + result.substring(insertBeforePos);
+  }
+  result = updateTblAttr(result, "rowCnt", dims.rowCnt + 1);
+  return { ok: true, xml: result };
+}
+function deleteRowInTbl(tblXml, row) {
+  const tokens = tokenizeHwpxXml2(tblXml);
+  const rows = parseTableRows(tblXml, tokens, 0, tblXml.length);
+  const dims = parseTblDimensions(tblXml, 0);
+  if (rows.length === 0) {
+    return { ok: false, error: "\uD45C\uC5D0 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." };
+  }
+  const targetRow = rows.find((r) => r.cells.some((c) => c.rowAddr === row));
+  if (!targetRow) {
+    return {
+      ok: false,
+      error: `\uD589 ${row}\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uD45C\uC5D0 rowAddr ${row}\uC778 \uC140\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`
+    };
+  }
+  for (const cell of targetRow.cells) {
+    if (cell.rowSpan > 1) {
+      return {
+        ok: false,
+        error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uD589 ${row}\uC758 \uC140 (\uC5F4 ${cell.colAddr})\uC5D0 rowSpan=${cell.rowSpan} \uBCD1\uD569\uC774 \uC788\uC2B5\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+      };
+    }
+  }
+  for (const r of rows) {
+    if (r.trStart === targetRow.trStart) continue;
+    for (const c of r.cells) {
+      if (c.rowSpan > 1) {
+        const spanEnd = c.rowAddr + c.rowSpan - 1;
+        if (c.rowAddr < row && row <= spanEnd) {
+          return {
+            ok: false,
+            error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uB2E4\uB978 \uD589 \uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC758 rowSpan=${c.rowSpan}\uC774 \uC0AD\uC81C\uD560 \uD589 ${row}\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+          };
+        }
+      }
+    }
+  }
+  let result = tblXml;
+  result = result.substring(0, targetRow.trStart) + result.substring(targetRow.trEnd);
+  const afterTokens = tokenizeHwpxXml2(result);
+  const addrPatches = [];
+  for (const tok of afterTokens) {
+    if (tok.kind === "cell_addr" && tok.rowAddr !== void 0 && tok.rowAddr > row) {
+      addrPatches.push({ pos: tok.pos, end: tok.end, newAddr: tok.rowAddr - 1 });
+    }
+  }
+  addrPatches.sort((a, b) => b.pos - a.pos);
+  for (const p of addrPatches) {
+    const oldTag = result.substring(p.pos, p.end);
+    const newTag = oldTag.replace(/(rowAddr=")(\d+)(")/, `$1${p.newAddr}$3`);
+    result = result.substring(0, p.pos) + newTag + result.substring(p.end);
+  }
+  result = updateTblAttr(result, "rowCnt", dims.rowCnt - 1);
+  return { ok: true, xml: result };
+}
+function insertColumnInTbl(tblXml, col, right) {
+  const tokens = tokenizeHwpxXml2(tblXml);
+  const rows = parseTableRows(tblXml, tokens, 0, tblXml.length);
+  const dims = parseTblDimensions(tblXml, 0);
+  if (rows.length === 0) {
+    return { ok: false, error: "\uD45C\uC5D0 \uD589\uC774 \uC5C6\uC5B4 \uC5F4\uC744 \uC0BD\uC785\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4." };
+  }
+  const newColAddr = right ? col + 1 : col;
+  for (const r of rows) {
+    for (const c of r.cells) {
+      if (c.colSpan > 1) {
+        const spanEnd = c.colAddr + c.colSpan - 1;
+        if (c.colAddr < newColAddr && newColAddr <= spanEnd) {
+          return {
+            ok: false,
+            error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC758 colSpan=${c.colSpan}\uC774 \uC0BD\uC785 \uC704\uCE58 \uC5F4 ${newColAddr}\uC744 \uAC00\uB85C\uC9C0\uB985\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+          };
+        }
+      }
+    }
+  }
+  let result = tblXml;
+  const allTokens = tokenizeHwpxXml2(result);
+  const addrPatches = [];
+  for (const tok of allTokens) {
+    if (tok.kind === "cell_addr" && tok.colAddr !== void 0 && tok.colAddr >= newColAddr) {
+      addrPatches.push({ pos: tok.pos, end: tok.end, newAddr: tok.colAddr + 1 });
+    }
+  }
+  addrPatches.sort((a, b) => b.pos - a.pos);
+  for (const p of addrPatches) {
+    const oldTag = result.substring(p.pos, p.end);
+    const newTag = oldTag.replace(/(colAddr=")(\d+)(")/, `$1${p.newAddr}$3`);
+    result = result.substring(0, p.pos) + newTag + result.substring(p.end);
+  }
+  const resultTokens2 = tokenizeHwpxXml2(result);
+  const resultRows = parseTableRows(result, resultTokens2, 0, result.length);
+  const sortedRows = [...resultRows].sort((a, b) => b.trStart - a.trStart);
+  for (const r of sortedRows) {
+    const refRowAddr = r.cells[0]?.rowAddr ?? 0;
+    const cloneSourceCell = r.cells.find((c) => c.colAddr === col + 1);
+    const anyCell = cloneSourceCell ?? r.cells[0];
+    if (!anyCell) continue;
+    let newTcXml = result.substring(anyCell.tcStart, anyCell.tcEnd);
+    newTcXml = setCellColAddr(newTcXml, newColAddr);
+    newTcXml = setCellRowAddr(newTcXml, refRowAddr);
+    newTcXml = resetCellSpan(newTcXml);
+    newTcXml = clearCellText(newTcXml);
+    const refCell = r.cells.find((c) => c.colAddr === col + 1);
+    let insertPos;
+    if (refCell) {
+      insertPos = refCell.tcStart;
+    } else {
+      const lastCell = r.cells[r.cells.length - 1];
+      insertPos = lastCell ? lastCell.tcEnd : r.trEnd - "</hp:tr>".length;
+    }
+    result = result.substring(0, insertPos) + newTcXml + result.substring(insertPos);
+  }
+  result = updateTblAttr(result, "colCnt", dims.colCnt + 1);
+  return { ok: true, xml: result };
+}
+function deleteColumnInTbl(tblXml, col) {
+  const tokens = tokenizeHwpxXml2(tblXml);
+  const rows = parseTableRows(tblXml, tokens, 0, tblXml.length);
+  const dims = parseTblDimensions(tblXml, 0);
+  if (rows.length === 0) {
+    return { ok: false, error: "\uD45C\uC5D0 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." };
+  }
+  for (const r of rows) {
+    const cell = r.cells.find((c) => c.colAddr === col);
+    if (cell && cell.colSpan > 1) {
+      return {
+        ok: false,
+        error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC5F4 ${col}\uC758 \uC140 (\uD589 ${cell.rowAddr})\uC5D0 colSpan=${cell.colSpan} \uBCD1\uD569\uC774 \uC788\uC2B5\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+      };
+    }
+    for (const c of r.cells) {
+      if (c.colAddr !== col && c.colSpan > 1) {
+        const spanEnd = c.colAddr + c.colSpan - 1;
+        if (c.colAddr < col && col <= spanEnd) {
+          return {
+            ok: false,
+            error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC758 colSpan=${c.colSpan}\uC774 \uC0AD\uC81C\uD560 \uC5F4 ${col}\uC744 \uD3EC\uD568\uD569\uB2C8\uB2E4). \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+          };
+        }
+      }
+    }
+  }
+  let result = tblXml;
+  const sortedRows = [...rows].sort((a, b) => b.trStart - a.trStart);
+  for (const r of sortedRows) {
+    const cell = r.cells.find((c) => c.colAddr === col);
+    if (cell) {
+      result = result.substring(0, cell.tcStart) + result.substring(cell.tcEnd);
+    }
+  }
+  const afterTokens = tokenizeHwpxXml2(result);
+  const addrPatches = [];
+  for (const tok of afterTokens) {
+    if (tok.kind === "cell_addr" && tok.colAddr !== void 0 && tok.colAddr > col) {
+      addrPatches.push({ pos: tok.pos, end: tok.end, newAddr: tok.colAddr - 1 });
+    }
+  }
+  addrPatches.sort((a, b) => b.pos - a.pos);
+  for (const p of addrPatches) {
+    const oldTag = result.substring(p.pos, p.end);
+    const newTag = oldTag.replace(/(colAddr=")(\d+)(")/, `$1${p.newAddr}$3`);
+    result = result.substring(0, p.pos) + newTag + result.substring(p.end);
+  }
+  result = updateTblAttr(result, "colCnt", dims.colCnt - 1);
+  return { ok: true, xml: result };
+}
+function mergeCellsInTbl(tblXml, startRow, startCol, endRow, endCol) {
+  if (startRow === endRow && startCol === endCol) {
+    return { ok: false, error: "\uBCD1\uD569 \uBC94\uC704\uAC00 \uB2E8\uC77C \uC140\uC785\uB2C8\uB2E4. \uCD5C\uC18C 2\uAC1C \uC774\uC0C1\uC758 \uC140\uC744 \uC9C0\uC815\uD558\uC138\uC694." };
+  }
+  if (startRow > endRow || startCol > endCol) {
+    return { ok: false, error: "\uBCD1\uD569 \uBC94\uC704\uAC00 \uC798\uBABB\uB418\uC5C8\uC2B5\uB2C8\uB2E4 (start > end)." };
+  }
+  const tokens = tokenizeHwpxXml2(tblXml);
+  const rows = parseTableRows(tblXml, tokens, 0, tblXml.length);
+  const rangeCells = [];
+  for (const r of rows) {
+    for (const c of r.cells) {
+      if (c.rowAddr >= startRow && c.rowAddr <= endRow && c.colAddr >= startCol && c.colAddr <= endCol) {
+        rangeCells.push(c);
+      }
+    }
+  }
+  if (rangeCells.length === 0) {
+    return {
+      ok: false,
+      error: `\uBCD1\uD569 \uBC94\uC704 (${startRow},${startCol})~(${endRow},${endCol})\uC5D0 \uC140\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`
+    };
+  }
+  for (const c of rangeCells) {
+    if (c.colSpan > 1 || c.rowSpan > 1) {
+      return {
+        ok: false,
+        error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC774 \uC774\uBBF8 colSpan=${c.colSpan}, rowSpan=${c.rowSpan}\uC73C\uB85C \uBCD1\uD569\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4). \uAE30\uC874 \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+      };
+    }
+  }
+  for (const r of rows) {
+    for (const c of r.cells) {
+      if (c.colSpan <= 1 && c.rowSpan <= 1) continue;
+      const inRange = c.rowAddr >= startRow && c.rowAddr <= endRow && c.colAddr >= startCol && c.colAddr <= endCol;
+      if (inRange) continue;
+      const colEnd = c.colAddr + c.colSpan - 1;
+      const rowEnd = c.rowAddr + c.rowSpan - 1;
+      if (c.colAddr <= endCol && colEnd >= startCol && c.rowAddr <= endRow && rowEnd >= startRow) {
+        return {
+          ok: false,
+          error: `\uC774 \uD45C\uC758 \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uACB9\uCCD0 \uC548\uC804\uD558\uAC8C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC140 (\uD589 ${c.rowAddr}, \uC5F4 ${c.colAddr})\uC758 span\uC774 \uBCD1\uD569 \uBC94\uC704\uC640 \uACB9\uCE69\uB2C8\uB2E4). \uAE30\uC874 \uBCD1\uD569\uC744 \uD574\uC81C\uD55C \uD6C4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+        };
+      }
+    }
+  }
+  const colSpan = endCol - startCol + 1;
+  const rowSpan = endRow - startRow + 1;
+  const topLeftCell = rangeCells.find((c) => c.rowAddr === startRow && c.colAddr === startCol);
+  if (!topLeftCell) {
+    return {
+      ok: false,
+      error: `\uBCD1\uD569 \uBC94\uC704\uC758 \uC88C\uC0C1\uB2E8 \uC140 (\uD589 ${startRow}, \uC5F4 ${startCol})\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`
+    };
+  }
+  const cellsToRemove = rangeCells.filter(
+    (c) => !(c.rowAddr === startRow && c.colAddr === startCol)
+  );
+  let result = tblXml;
+  const sortedRemove = [...cellsToRemove].sort((a, b) => b.tcStart - a.tcStart);
+  for (const c of sortedRemove) {
+    result = result.substring(0, c.tcStart) + result.substring(c.tcEnd);
+  }
+  const afterTokens = tokenizeHwpxXml2(result);
+  const afterRows = parseTableRows(result, afterTokens, 0, result.length);
+  const afterTopLeft = afterRows.flatMap((r) => r.cells).find((c) => c.rowAddr === startRow && c.colAddr === startCol);
+  if (!afterTopLeft) {
+    return { ok: false, error: "\uBCD1\uD569 \uD6C4 \uC88C\uC0C1\uB2E8 \uC140\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uB0B4\uBD80 \uC624\uB958)." };
+  }
+  let tcXml = result.substring(afterTopLeft.tcStart, afterTopLeft.tcEnd);
+  tcXml = setCellSpan(tcXml, colSpan, rowSpan);
+  result = result.substring(0, afterTopLeft.tcStart) + tcXml + result.substring(afterTopLeft.tcEnd);
+  return { ok: true, xml: result };
+}
+function findTableByAnchorInXml(xml, anchor) {
+  const tokens = tokenizeHwpxXml2(xml);
+  const allRanges = findAllTopLevelTableRanges(tokens);
+  const trimmedAnchor = anchor.trim();
+  const matched = [];
+  for (const r of allRanges) {
+    const text3 = collectTableText(xml, tokens, r.start, r.end);
+    if (text3.includes(trimmedAnchor)) {
+      matched.push(r);
+    }
+  }
+  if (matched.length === 0) {
+    return {
+      error: `anchor\uB97C \uD3EC\uD568\uD55C \uD45C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: "${anchor}". read_document\uB85C \uD45C \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uACE0 \uD45C \uC548\uC5D0 \uC788\uB294 \uB3C5\uD2B9\uD55C \uD14D\uC2A4\uD2B8\uB97C anchor\uB85C \uC9C0\uC815\uD558\uC138\uC694.`
+    };
+  }
+  if (matched.length > 1) {
+    return {
+      error: `anchor "${anchor}"\uC774(\uAC00) ${matched.length}\uAC1C\uC758 \uD45C\uC5D0\uC11C \uBC1C\uACAC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uB354 \uAD6C\uCCB4\uC801\uC778 anchor \uD14D\uC2A4\uD2B8\uB97C \uC0AC\uC6A9\uD558\uC5EC \uD45C\uB97C \uD55C \uAC1C\uB9CC \uC120\uD0DD\uD560 \uC218 \uC788\uB3C4\uB85D \uD558\uC138\uC694.`
+    };
+  }
+  return { range: matched[0], sectionXml: xml };
+}
+function computeExpectedDelta(ops) {
+  let rowDelta = 0;
+  let colDelta = 0;
+  for (const op of ops) {
+    if (op.type === "mergeCells") return null;
+    if (op.type === "insertRow") rowDelta++;
+    else if (op.type === "deleteRow") rowDelta--;
+    else if (op.type === "insertColumn") colDelta++;
+    else if (op.type === "deleteColumn") colDelta--;
+  }
+  return { rowDelta, colDelta };
+}
+function getTblDims(tblXml) {
+  return parseTblDimensions(tblXml, 0);
+}
+async function applyOpsToHwpx(hwpxBuffer, anchor, operations) {
+  const zip = await import_jszip4.default.loadAsync(hwpxBuffer);
+  const sectionFiles = Object.keys(zip.files).filter((name) => /^Contents\/section\d+\.xml$/.test(name)).sort();
+  let targetSectionIdx = -1;
+  let targetRange = null;
+  const sectionXmls = [];
+  for (let si = 0; si < sectionFiles.length; si++) {
+    const entry = zip.file(sectionFiles[si] ?? "");
+    const xml = entry ? await entry.async("string") : "";
+    sectionXmls.push(xml);
+    if (targetSectionIdx === -1) {
+      const found = findTableByAnchorInXml(xml, anchor);
+      if ("range" in found) {
+        targetSectionIdx = si;
+        targetRange = found.range;
+      } else if (found.error.includes("\uC774(\uAC00)") && found.error.includes("\uAC1C\uC758 \uD45C\uC5D0\uC11C")) {
+        return { ok: false, error: `\uC624\uB958: ${found.error}` };
+      }
+    }
+  }
+  for (let si = sectionXmls.length; si < sectionFiles.length; si++) {
+    const entry = zip.file(sectionFiles[si] ?? "");
+    const xml = entry ? await entry.async("string") : "";
+    sectionXmls.push(xml);
+  }
+  if (targetSectionIdx === -1 || targetRange === null) {
+    return {
+      ok: false,
+      error: `\uC624\uB958: anchor\uB97C \uD3EC\uD568\uD55C \uD45C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: "${anchor}". read_document\uB85C \uD45C \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uACE0 \uD45C \uC548\uC5D0 \uC788\uB294 \uB3C5\uD2B9\uD55C \uD14D\uC2A4\uD2B8\uB97C anchor\uB85C \uC9C0\uC815\uD558\uC138\uC694.`
+    };
+  }
+  const sectionXml = sectionXmls[targetSectionIdx] ?? "";
+  let tblBlock = sectionXml.substring(targetRange.start, targetRange.end);
+  const beforeDims = getTblDims(tblBlock);
+  for (let i = 0; i < operations.length; i++) {
+    const op = operations[i];
+    if (!op) continue;
+    let opResult;
+    if (op.type === "insertRow") {
+      opResult = insertRowInTbl(tblBlock, op.row, op.position === "below");
+    } else if (op.type === "deleteRow") {
+      opResult = deleteRowInTbl(tblBlock, op.row);
+    } else if (op.type === "insertColumn") {
+      opResult = insertColumnInTbl(tblBlock, op.col, op.position === "right");
+    } else if (op.type === "deleteColumn") {
+      opResult = deleteColumnInTbl(tblBlock, op.col);
+    } else {
+      opResult = mergeCellsInTbl(tblBlock, op.startRow, op.startCol, op.endRow, op.endCol);
+    }
+    if (!opResult.ok) {
+      return {
+        ok: false,
+        error: `\uC624\uB958: \uC5F0\uC0B0 #${i + 1} (${op.type}) \uC2E4\uD328. \uD30C\uC77C\uC744 \uBCC0\uACBD\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC6D0\uC778: ${opResult.error}`
+      };
+    }
+    tblBlock = opResult.xml;
+  }
+  const afterDims = getTblDims(tblBlock);
+  const newSectionXml = sectionXml.substring(0, targetRange.start) + tblBlock + sectionXml.substring(targetRange.end);
+  sectionXmls[targetSectionIdx] = newSectionXml;
+  const out = new import_jszip4.default();
+  const mimetypeEntry = zip.file("mimetype");
+  if (mimetypeEntry) {
+    out.file("mimetype", await mimetypeEntry.async("uint8array"), { compression: "STORE" });
+  }
+  for (const [name, entry] of Object.entries(zip.files)) {
+    if (name === "mimetype" || entry.dir) continue;
+    const sectionIdx = sectionFiles.indexOf(name);
+    if (sectionIdx >= 0) {
+      out.file(name, sectionXmls[sectionIdx] ?? "");
+    } else {
+      out.file(name, await entry.async("uint8array"));
+    }
+  }
+  const buf = await out.generateAsync({ type: "nodebuffer", compression: "DEFLATE" });
+  return {
+    ok: true,
+    buffer: new Uint8Array(buf),
+    beforeDims,
+    afterDims,
+    anchorTableIndex: targetRange.index
+  };
+}
+async function verifyOutputDims(newBytes, anchor, expectedRowCnt, expectedColCnt) {
+  const zip = await import_jszip4.default.loadAsync(newBytes);
+  const sectionFiles = Object.keys(zip.files).filter((name) => /^Contents\/section\d+\.xml$/.test(name)).sort();
+  for (const sf of sectionFiles) {
+    const entry = zip.file(sf);
+    const xml = entry ? await entry.async("string") : "";
+    const tokens = tokenizeHwpxXml2(xml);
+    const allRanges = findAllTopLevelTableRanges(tokens);
+    const trimmedAnchor = anchor.trim();
+    for (const r of allRanges) {
+      const text3 = collectTableText(xml, tokens, r.start, r.end);
+      if (text3.includes(trimmedAnchor)) {
+        const tblBlock = xml.substring(r.start, r.end);
+        const dims = getTblDims(tblBlock);
+        if (dims.rowCnt !== expectedRowCnt || dims.colCnt !== expectedColCnt) {
+          return {
+            ok: false,
+            error: `\uC790\uAE30\uAC80\uC99D \uC2E4\uD328 \u2014 \uC608\uC0C1 \uCE58\uC218 (${expectedRowCnt}\uD589 \xD7 ${expectedColCnt}\uC5F4)\uC640 \uC2E4\uC81C \uCE58\uC218 (${dims.rowCnt}\uD589 \xD7 ${dims.colCnt}\uC5F4)\uAC00 \uB2E4\uB985\uB2C8\uB2E4.`
+          };
+        }
+        return { ok: true };
+      }
+    }
+  }
+  return { ok: true };
+}
+var proposeTableStructureTool = {
+  name: "propose_table_structure",
+  description: "HWPX \uBB38\uC11C\uC5D0\uC11C anchor \uD14D\uC2A4\uD2B8\uB85C \uC2DD\uBCC4\uB41C \uD45C\uC758 \uAD6C\uC870(\uD589/\uC5F4/\uC140 \uBCD1\uD569)\uB97C \uC218\uC815\uD569\uB2C8\uB2E4. ZIP XML \uC9C1\uC811 \uD328\uCE58 \uBC29\uC2DD\uC73C\uB85C \uB3D9\uC791\uD569\uB2C8\uB2E4(rhwp \uBBF8\uC0AC\uC6A9). \uC774\uBBF8\uC9C0\xB7\uC911\uCCA9\uD45C \uB4F1 \uBCF5\uC7A1\uD55C \uBB38\uC11C\uB3C4 \uAD6C\uC870 \uC190\uC2E4 \uC5C6\uC774 \uC548\uC804\uD558\uAC8C \uD3B8\uC9D1 \uAC00\uB2A5\uD569\uB2C8\uB2E4. anchor\uB294 \uB300\uC0C1 \uD45C \uC548\uC5D0\uB9CC \uC788\uB294 \uB3C5\uD2B9\uD55C \uC140 \uD14D\uC2A4\uD2B8\uB97C \uC9C0\uC815\uD558\uC138\uC694 \u2014 \uBA3C\uC800 read_document\uB85C \uBB38\uC11C\uB97C \uC77D\uC5B4 \uD45C \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uC138\uC694. \uC5F0\uC0B0\uC740 \uC9C0\uC815\uB41C \uC21C\uC11C\uB300\uB85C \uC801\uC6A9\uB418\uBA70, \uB098\uC911 \uC5F0\uC0B0\uC758 row/col \uC778\uB371\uC2A4\uB294 \uC55E \uC5F0\uC0B0 \uC801\uC6A9 \uD6C4\uC758 \uD45C \uC0C1\uD0DC\uB97C \uAE30\uC900\uC73C\uB85C \uD569\uB2C8\uB2E4. .hwpx \uC804\uC6A9\uC785\uB2C8\uB2E4 (.hwp\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC73C\uBA70, Hancom\uC5D0\uC11C .hwpx\uB85C \uC800\uC7A5 \uD6C4 \uC0AC\uC6A9\uD558\uC138\uC694). \uAE30\uC874 \uBCD1\uD569 \uC140\uACFC \uAD50\uCC28\uD558\uB294 \uC5F0\uC0B0\uC740 \uC548\uC804\uC744 \uC704\uD574 \uAC70\uBD80\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uBCC0\uACBD \uC0AC\uD56D\uC740 \uC790\uAE30\uAC80\uC99D \uAC8C\uC774\uD2B8\uB97C \uD1B5\uACFC\uD55C \uD6C4 \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC744 \uBC1B\uC544\uC57C\uB9CC \uC800\uC7A5\uB429\uB2C8\uB2E4.",
+  inputSchema: proposeTableStructureSchema,
+  requiresApproval: true,
+  propose: async ({
+    input,
+    ctx
+  }) => {
+    const safePath = await resolveSafePath(ctx.cwd, input.path);
+    const ext = extname9(safePath).toLowerCase();
+    if (ext === ".hwp") {
+      return "\uC624\uB958: propose_table_structure\uB294 .hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. .hwp(\uAD6C\uD615 OLE \uBC14\uC774\uB108\uB9AC)\uB294 XML \uC9C1\uC811 \uD3B8\uC9D1\uC774 \uBD88\uAC00\uD569\uB2C8\uB2E4. \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C '\uB2E4\uB978 \uC774\uB984\uC73C\uB85C \uC800\uC7A5 \u2192 .hwpx'\uB85C \uC800\uC7A5\uD55C \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.";
+    }
+    if (ext !== ".hwpx") {
+      return `\uC624\uB958: propose_table_structure\uB294 .hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C \uD655\uC7A5\uC790: ${ext}. .hwpx \uD30C\uC77C\uC744 \uC9C0\uC815\uD558\uC138\uC694.`;
+    }
+    let originalBuf;
+    try {
+      originalBuf = await readFile9(safePath);
+    } catch {
+      return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}. \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.`;
+    }
+    if (originalBuf[0] !== 80 || originalBuf[1] !== 75) {
+      return "\uC624\uB958: \uD30C\uC77C\uC774 \uC720\uD6A8\uD55C .hwpx(ZIP) \uD3EC\uB9F7\uC774 \uC544\uB2D9\uB2C8\uB2E4. \uD30C\uC77C\uC774 \uC190\uC0C1\uB418\uC5C8\uAC70\uB098 \uAD6C\uD615 .hwp(OLE \uBC14\uC774\uB108\uB9AC) \uD3EC\uB9F7\uC785\uB2C8\uB2E4. \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C .hwpx\uB85C \uC800\uC7A5 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.";
+    }
+    const originalBytes = new Uint8Array(
+      originalBuf.buffer,
+      originalBuf.byteOffset,
+      originalBuf.byteLength
+    );
+    let originalBlocks = null;
+    try {
+      const origResult = await parse4(originalBuf.buffer);
+      if (origResult.success) {
+        originalBlocks = origResult.blocks;
+      }
+    } catch {
+    }
+    let applyResult;
+    try {
+      applyResult = await applyOpsToHwpx(originalBytes, input.anchor, input.operations);
+    } catch (e) {
+      return `\uC624\uB958: \uD45C \uAD6C\uC870 \uD3B8\uC9D1 \uC911 \uC608\uC678\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. ${String(e)}`;
+    }
+    if (!applyResult.ok) {
+      return applyResult.error;
+    }
+    const { buffer: newBytes, beforeDims, afterDims } = applyResult;
+    const warnings = [];
+    let exportedMd = "";
+    let kordocOk = false;
+    let exportedBlocks = null;
+    try {
+      const exportedResult = await parse4(newBytes.buffer);
+      if (exportedResult.success) {
+        exportedMd = exportedResult.markdown;
+        exportedBlocks = exportedResult.blocks;
+        kordocOk = true;
+      }
+    } catch {
+    }
+    if (!kordocOk) {
+      return `\uC624\uB958: \uB0B4\uBCF4\uB0B8 \uBB38\uC11C\uB97C kordoc\uC73C\uB85C \uC7AC\uD30C\uC2F1\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uAC00 \uC190\uC0C1\uB418\uC5C8\uC744 \uC218 \uC788\uC73C\uBBC0\uB85C \uD30C\uC77C\uC744 \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`;
+    }
+    if (originalBlocks !== null && exportedBlocks !== null) {
+      const lossResult = detectStructuralLoss(originalBlocks, exportedBlocks);
+      if (lossResult.lost) {
+        return `\uC624\uB958: XML \uD3B8\uC9D1 \uD6C4 \uAD6C\uC870 \uC190\uC2E4\uC774 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4(${lossResult.detail}). XML \uD328\uCE58\uC5D0 \uBC84\uADF8\uAC00 \uC788\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uD30C\uC77C\uC744 \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`;
+      }
+    }
+    const hasDeleteOp = input.operations.some(
+      (op) => op.type === "deleteRow" || op.type === "deleteColumn"
+    );
+    const anchorInExported = exportedMd.includes(input.anchor.trim());
+    if (!anchorInExported) {
+      if (!hasDeleteOp) {
+        return `\uC624\uB958: \uC790\uAE30\uAC80\uC99D \uC2E4\uD328 \u2014 \uB0B4\uBCF4\uB0B8 \uBB38\uC11C\uC5D0\uC11C anchor "${input.anchor}"\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uD45C \uAD6C\uC870\uAC00 \uC190\uC0C1\uB418\uC5C8\uC744 \uC218 \uC788\uC73C\uBBC0\uB85C \uD30C\uC77C\uC744 \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`;
+      }
+      warnings.push(
+        `\uC790\uAE30\uAC80\uC99D: \uB0B4\uBCF4\uB0B8 \uBB38\uC11C\uC5D0\uC11C anchor "${input.anchor}"\uAC00 \uBCF4\uC774\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC0AD\uC81C \uC5F0\uC0B0\uC73C\uB85C anchor\uAC00 \uD3EC\uD568\uB41C \uD589/\uC5F4\uC774 \uC81C\uAC70\uB418\uC5C8\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uACB0\uACFC\uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC138\uC694.`
+      );
+    }
+    const delta = computeExpectedDelta(input.operations);
+    if (delta !== null) {
+      const expectedRowCnt = beforeDims.rowCnt + delta.rowDelta;
+      const expectedColCnt = beforeDims.colCnt + delta.colDelta;
+      if (afterDims.rowCnt !== expectedRowCnt || afterDims.colCnt !== expectedColCnt) {
+        return `\uC624\uB958: \uC790\uAE30\uAC80\uC99D \uC2E4\uD328 \u2014 \uC608\uC0C1 \uCE58\uC218 (${expectedRowCnt}\uD589 \xD7 ${expectedColCnt}\uC5F4)\uC640 \uC2E4\uC81C \uCE58\uC218 (${afterDims.rowCnt}\uD589 \xD7 ${afterDims.colCnt}\uC5F4)\uAC00 \uB2E4\uB985\uB2C8\uB2E4. \uD30C\uC77C\uC744 \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`;
+      }
+      if (anchorInExported) {
+        const dimVerify = await verifyOutputDims(
+          newBytes,
+          input.anchor,
+          expectedRowCnt,
+          expectedColCnt
+        );
+        if (!dimVerify.ok) {
+          return `\uC624\uB958: ${dimVerify.error} \uD30C\uC77C\uC744 \uC800\uC7A5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`;
+        }
+      }
+    }
+    const { outputPath, willConvertFormat } = resolveOutputPath(safePath);
+    const opDescriptions = input.operations.map((op, i) => {
+      if (op.type === "insertRow")
+        return `  ${i + 1}. \uD589 ${op.row} ${op.position === "below" ? "\uC544\uB798" : "\uC704"}\uC5D0 \uD589 \uC0BD\uC785`;
+      if (op.type === "deleteRow") return `  ${i + 1}. \uD589 ${op.row} \uC0AD\uC81C`;
+      if (op.type === "insertColumn")
+        return `  ${i + 1}. \uC5F4 ${op.col} ${op.position === "right" ? "\uC624\uB978\uCABD" : "\uC67C\uCABD"}\uC5D0 \uC5F4 \uC0BD\uC785`;
+      if (op.type === "deleteColumn") return `  ${i + 1}. \uC5F4 ${op.col} \uC0AD\uC81C`;
+      return `  ${i + 1}. (${op.startRow},${op.startCol})~(${op.endRow},${op.endCol}) \uC140 \uBCD1\uD569`;
+    });
+    const diff = `anchor: "${input.anchor}" (\uD45C \uC778\uB371\uC2A4 ${applyResult.anchorTableIndex})
+\uC774\uC804: ${beforeDims.rowCnt}\uD589 \xD7 ${beforeDims.colCnt}\uC5F4
+\uC774\uD6C4: ${afterDims.rowCnt}\uD589 \xD7 ${afterDims.colCnt}\uC5F4
+\uC5F0\uC0B0 (${input.operations.length}\uAC1C):
+${opDescriptions.join("\n")}`;
+    const stagedPath = await stageFile(ctx.sessionId, outputPath, newBytes);
+    const proposalId = crypto.randomUUID();
+    return {
+      proposal: {
+        id: proposalId,
+        kind: "table-structure",
+        targetPath: outputPath,
+        stagedPath,
+        summary: input.summary,
+        diff,
+        warnings,
+        willConvertFormat
+      },
+      commit: async () => {
+        const backupPath = await backupFile(safePath);
+        await commitStaged(stagedPath, outputPath);
+        const backupInfo = backupPath ? ` (\uBC31\uC5C5: ${backupPath})` : "";
+        return `\uC800\uC7A5 \uC644\uB8CC: ${outputPath}${backupInfo}`;
+      }
+    };
+  }
+};
 var MAX_MARKDOWN_LENGTH2 = 8e4;
 var MAX_FILE_SIZE_BYTES = 100 * 1024 * 1024;
 var PLAIN_TEXT_EXTS = /* @__PURE__ */ new Set([".md", ".markdown", ".txt", ".text"]);
@@ -12883,11 +13997,11 @@ function searchExcerpts(markdown, query) {
   }
   return result;
 }
-var readDocumentSchema = z8.object({
-  path: z8.string().describe("\uC77D\uC744 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  pages: z8.string().optional().describe('\uC77D\uC744 \uD398\uC774\uC9C0 \uBC94\uC704 (\uC608: "1-3", "1,3,5") \u2014 \uBBF8\uC9C0\uC815 \uC2DC \uC804\uCCB4'),
-  outline: z8.boolean().optional().describe("\uD5E4\uB529(\uC81C\uBAA9) \uAD6C\uC870\uB9CC \uBC18\uD658\uD574 \uBB38\uC11C \uAC1C\uC694 \uD30C\uC545 (\uB300\uD615 \uBB38\uC11C \uD0D0\uC0C9\uC6A9)"),
-  search: z8.string().optional().describe("\uD0A4\uC6CC\uB4DC\uAC00 \uD3EC\uD568\uB41C \uBD80\uBD84\uACFC \uC8FC\uBCC0 \uB9E5\uB77D\uB9CC \uBC18\uD658 (\uB300\uD615 \uBB38\uC11C\uC5D0\uC11C \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uC77D\uAE30)")
+var readDocumentSchema = z10.object({
+  path: z10.string().describe("\uC77D\uC744 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  pages: z10.string().optional().describe('\uC77D\uC744 \uD398\uC774\uC9C0 \uBC94\uC704 (\uC608: "1-3", "1,3,5") \u2014 \uBBF8\uC9C0\uC815 \uC2DC \uC804\uCCB4'),
+  outline: z10.boolean().optional().describe("\uD5E4\uB529(\uC81C\uBAA9) \uAD6C\uC870\uB9CC \uBC18\uD658\uD574 \uBB38\uC11C \uAC1C\uC694 \uD30C\uC545 (\uB300\uD615 \uBB38\uC11C \uD0D0\uC0C9\uC6A9)"),
+  search: z10.string().optional().describe("\uD0A4\uC6CC\uB4DC\uAC00 \uD3EC\uD568\uB41C \uBD80\uBD84\uACFC \uC8FC\uBCC0 \uB9E5\uB77D\uB9CC \uBC18\uD658 (\uB300\uD615 \uBB38\uC11C\uC5D0\uC11C \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uC77D\uAE30)")
 });
 function applyReadMode(body, outline, search) {
   if (outline === true) {
@@ -12916,11 +14030,11 @@ var readDocumentTool = {
       const msg = e instanceof Error ? e.message : String(e);
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${msg}`;
     }
-    const ext = extname8(safePath).toLowerCase();
+    const ext = extname10(safePath).toLowerCase();
     if (PLAIN_TEXT_EXTS.has(ext)) {
       let raw;
       try {
-        raw = await readFile8(safePath, "utf-8");
+        raw = await readFile10(safePath, "utf-8");
       } catch (e) {
         const msg = e instanceof Error ? e.message : String(e);
         return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${msg}`;
@@ -12944,7 +14058,7 @@ var readDocumentTool = {
 \u26A0\uFE0F \uB0B4\uC6A9\uC774 \uB108\uBB34 \uAE38\uC5B4 \uC57D 80,000\uC790\uC5D0\uC11C \uC798\uB838\uC2B5\uB2C8\uB2E4. (\uD3C9\uBB38 \uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC774\uB77C \uD398\uC774\uC9C0 \uB2E8\uC704 \uBD84\uD560 \uC77D\uAE30\uB294 \uC9C0\uC6D0\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4)` : "";
       return `${meta2}${body2}${truncationNotice2}`;
     }
-    const result = await parse3(safePath, input.pages ? { pages: input.pages } : void 0);
+    const result = await parse5(safePath, input.pages ? { pages: input.pages } : void 0);
     if (!result.success) {
       const msg = kordocErrorMessage(result.code, `\uBB38\uC11C\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${result.error}`);
       return `\uC624\uB958: ${msg}`;
@@ -13020,8 +14134,8 @@ var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".csv",
   ".log"
 ]);
-var readFileSchema = z9.object({
-  path: z9.string().describe("\uC77D\uC744 \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)")
+var readFileSchema = z11.object({
+  path: z11.string().describe("\uC77D\uC744 \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)")
 });
 var readFileTool = {
   name: "read_file",
@@ -13045,8 +14159,8 @@ var readFileTool = {
     if (info.size > MAX_SIZE) {
       return `\uC624\uB958: \uD30C\uC77C\uC774 \uB108\uBB34 \uD07D\uB2C8\uB2E4 (${Math.round(info.size / 1024)}KB). \uCD5C\uB300 256KB\uAE4C\uC9C0 \uC77D\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`;
     }
-    const { extname: extname11 } = await import("path");
-    const ext = extname11(safePath).toLowerCase();
+    const { extname: extname13 } = await import("path");
+    const ext = extname13(safePath).toLowerCase();
     if (!TEXT_EXTENSIONS.has(ext) && ext !== "") {
       return `\uC624\uB958: '${ext}' \uD615\uC2DD\uC740 \uD14D\uC2A4\uD2B8 \uD30C\uC77C\uB85C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C \uD30C\uC77C\uC774\uB77C\uBA74 read_document \uD234\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.`;
     }
@@ -13061,9 +14175,9 @@ var readFileTool = {
   }
 };
 var MAX_PREVIEW_CHARS = 1e4;
-var writeNewDocumentSchema = z10.object({
-  path: z10.string().describe("\uC0DD\uC131\uD560 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  markdown: z10.string().describe("\uC0C8 \uBB38\uC11C \uB0B4\uC6A9 (\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD)")
+var writeNewDocumentSchema = z12.object({
+  path: z12.string().describe("\uC0DD\uC131\uD560 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  markdown: z12.string().describe("\uC0C8 \uBB38\uC11C \uB0B4\uC6A9 (\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD)")
 });
 var writeNewDocumentTool = {
   name: "write_new_document",
@@ -13075,7 +14189,7 @@ var writeNewDocumentTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname9(safePath).toLowerCase();
+    const ext = extname11(safePath).toLowerCase();
     try {
       await stat5(safePath);
       return `\uC624\uB958: \uD30C\uC77C\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${input.path}. \uAE30\uC874 \uD30C\uC77C\uC744 \uC218\uC815\uD558\uB824\uBA74 propose_edit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.`;
@@ -13125,12 +14239,12 @@ ${preview}`,
     };
   }
 };
-var writeNewSpreadsheetSchema = z11.object({
-  path: z11.string().describe("\uC0DD\uC131\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  sheets: z11.array(
-    z11.object({
-      name: z11.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
-      rows: z11.array(z11.array(z11.string())).describe("\uD589 \uB370\uC774\uD130 \uBC30\uC5F4 (\uAC01 \uD589\uC740 \uC140 \uAC12 \uBC30\uC5F4)")
+var writeNewSpreadsheetSchema = z13.object({
+  path: z13.string().describe("\uC0DD\uC131\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  sheets: z13.array(
+    z13.object({
+      name: z13.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
+      rows: z13.array(z13.array(z13.string())).describe("\uD589 \uB370\uC774\uD130 \uBC30\uC5F4 (\uAC01 \uD589\uC740 \uC140 \uAC12 \uBC30\uC5F4)")
     })
   ).min(1).describe("\uC0DD\uC131\uD560 \uC2DC\uD2B8 \uBAA9\uB85D")
 });
@@ -13144,7 +14258,7 @@ var writeNewSpreadsheetTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname10(safePath).toLowerCase();
+    const ext = extname12(safePath).toLowerCase();
     if (ext !== ".xlsx") {
       return `\uC624\uB958: write_new_spreadsheet\uC740 .xlsx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. \uD604\uC7AC \uD655\uC7A5\uC790: ${ext}.`;
     }
@@ -13206,7 +14320,9 @@ function createDocTools(_ctx) {
     proposeEditTool,
     proposeFormFillTool,
     proposeCellEditTool,
+    proposeFindReplaceTool,
     proposeSheetEditTool,
+    proposeTableStructureTool,
     listFormObjectsTool,
     proposeFormObjectTool,
     writeNewDocumentTool,
@@ -14014,10 +15130,10 @@ async function runOnboarding() {
 
 // src/update.ts
 import { spawn } from "child_process";
-import { mkdir as mkdir4, readFile as readFile9, writeFile as writeFile3 } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile11, writeFile as writeFile3 } from "fs/promises";
 import { dirname as dirname3 } from "path";
 function compareSemver(a, b) {
-  const parse4 = (v) => {
+  const parse6 = (v) => {
     const clean = v.replace(/^v/, "").split("-")[0] ?? "";
     const parts = clean.split(".").map((p) => {
       const n = parseInt(p, 10);
@@ -14025,8 +15141,8 @@ function compareSemver(a, b) {
     });
     return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
   };
-  const [aMaj, aMin, aPat] = parse4(a);
-  const [bMaj, bMin, bPat] = parse4(b);
+  const [aMaj, aMin, aPat] = parse6(a);
+  const [bMaj, bMin, bPat] = parse6(b);
   if (aMaj !== bMaj) return aMaj < bMaj ? -1 : 1;
   if (aMin !== bMin) return aMin < bMin ? -1 : 1;
   if (aPat !== bPat) return aPat < bPat ? -1 : 1;
@@ -14035,7 +15151,7 @@ function compareSemver(a, b) {
 var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 async function readCache(cachePath) {
   try {
-    const raw = await readFile9(cachePath, "utf-8");
+    const raw = await readFile11(cachePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed !== null && typeof parsed === "object" && "checkedAt" in parsed && "latest" in parsed && typeof parsed.checkedAt === "string" && typeof parsed.latest === "string") {
       return parsed;