@kodocagent/cli 0.4.2 → 0.4.4

package/dist/index.js

@@ -318,7 +318,7 @@ var require_BufferList = __commonJS({
         this.head = this.tail = null;
         this.length = 0;
       };
-      BufferList.prototype.join = function join4(s) {
+      BufferList.prototype.join = function join5(s) {
         if (this.length === 0) return "";
         var p = this.head;
         var ret = "" + p.data;
@@ -9890,7 +9890,8 @@ var DOCUMENT_RULES_SECTION = `## \uBB38\uC11C \uADDC\uCE59
 4. \`.hwp\` \uD30C\uC77C\uC744 \uD3B8\uC9D1\uD55C \uACB0\uACFC\uB294 \`.hwpx\` \uD615\uC2DD\uC73C\uB85C \uC800\uC7A5\uB429\uB2C8\uB2E4. \uC774 \uBCC0\uD658 \uC0AC\uC2E4\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBBF8\uB9AC \uC548\uB0B4\uD558\uC138\uC694.
 5. \uACBD\uB85C\uB294 \uD604\uC7AC \uC791\uC5C5 \uB514\uB809\uD130\uB9AC\uB97C \uAE30\uC900\uC73C\uB85C \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.
 6. \uC0AC\uC6A9\uC790\uAC00 \uC218\uC815\uC548\uC744 \uAC70\uC808\uD558\uBA74 \uAC19\uC740 \uC81C\uC548\uC744 \uC790\uB3D9\uC73C\uB85C \uBC18\uBCF5\uD558\uC9C0 \uB9D0\uACE0, \uC0AC\uC6A9\uC790\uC758 \uB2E4\uC74C \uC9C0\uC2DC\uB97C \uAE30\uB2E4\uB9AC\uC138\uC694.
-7. \uD070 \uBB38\uC11C\uB294 \uBA3C\uC800 \`outline\`\uC73C\uB85C \uAD6C\uC870\uB97C \uD30C\uC545\uD558\uACE0, \`search\`\uB098 \`pages\`\uB85C \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uC77D\uC5B4 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uC544\uB07C\uC138\uC694.`;
+7. \uD070 \uBB38\uC11C\uB294 \uBA3C\uC800 \`outline\`\uC73C\uB85C \uAD6C\uC870\uB97C \uD30C\uC545\uD558\uACE0, \`search\`\uB098 \`pages\`\uB85C \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uC77D\uC5B4 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uC544\uB07C\uC138\uC694.
+8. \uC0AC\uC6A9\uC790\uAC00 \uC9C1\uC804 \uBCC0\uACBD\uC744 \uB418\uB3CC\uB9AC\uAE38 \uC6D0\uD558\uBA74 \`list_backups\`\uB85C \uBC31\uC5C5\uC744 \uD655\uC778\uD558\uACE0 \`restore_backup\`\uC73C\uB85C \uBCF5\uC6D0\uD558\uC138\uC694. \uBCF5\uC6D0\uB3C4 \uC2B9\uC778\uC744 \uAC70\uCE58\uBA70, \uBCF5\uC6D0 \uC804 \uD604\uC7AC \uC0C1\uD0DC\uAC00 \uC790\uB3D9 \uBC31\uC5C5\uB429\uB2C8\uB2E4.`;
 var LAW_RULES_SECTION = `## \uBC95\uB839 \uADDC\uCE59
 
 1. \uBC95\uB839 \uC778\uC6A9 \uD615\uC2DD: \u300C\uBC95\uB839\uBA85\u300D \uC81CN\uC870 \uC81CN\uD56D \uC81CN\uD638
@@ -10009,6 +10010,13 @@ var AgentSession = class {
   opts;
   messages = [];
   openDocuments = [];
+  /** 열람한 문서 경로를 중복 없이 기록한다 (방어적: 비문자열/오류는 무시). */
+  recordOpenDocument(p) {
+    if (typeof p !== "string" || p.trim() === "") return;
+    if (!this.openDocuments.includes(p)) {
+      this.openDocuments.push(p);
+    }
+  }
   /** approval-required 이벤트를 run() 스트림에 전달하기 위한 큐 */
   pendingApprovalEvents = [];
   /**
@@ -10064,6 +10072,18 @@ var AgentSession = class {
               args: part.input,
               callId: part.toolCallId
             };
+            try {
+              const inp = part.input;
+              if (part.toolName === "read_document") {
+                this.recordOpenDocument(inp.path);
+              } else if (part.toolName === "compare_documents") {
+                this.recordOpenDocument(inp.pathA);
+                this.recordOpenDocument(inp.pathB);
+              } else if (part.toolName === "write_new_document") {
+                this.recordOpenDocument(inp.path);
+              }
+            } catch {
+            }
             break;
           }
           case "tool-result": {
@@ -10806,26 +10826,29 @@ import { realpath } from "fs/promises";
 import { basename, dirname as dirname2, isAbsolute, join as join3, normalize, relative, resolve } from "path";
 import { copyFile, mkdir as mkdir3, readdir as readdir2, readFile as readFile3, rename, rm, stat as stat2, writeFile as writeFile2 } from "fs/promises";
 import { basename as basename2, dirname as dirname22, extname, join as join22 } from "path";
+import { createTwoFilesPatch } from "diff";
+import { readdir as readdir22, readFile as readFile22, stat as stat22 } from "fs/promises";
+import { basename as basename3, extname as extname2, join as join32 } 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";
 import { z as z3 } from "zod";
 import { readFile as readFile32 } from "fs/promises";
-import { extname as extname2 } from "path";
+import { blocksToMarkdown, compare } from "@clazic/kordoc";
 import { z as z22 } from "zod";
-import { readdir as readdir22, stat as stat22 } from "fs/promises";
-import { extname as extname3, join as join32, relative as relative2 } from "path";
-import { z as z32 } from "zod";
 import { readFile as readFile4 } from "fs/promises";
-import { extname as extname4 } from "path";
+import { extname as extname3 } from "path";
+import { z as z32 } from "zod";
+import { readdir as readdir3, stat as stat3 } from "fs/promises";
+import { extname as extname4, join as join4, relative as relative2 } from "path";
 import { z as z4 } from "zod";
 import { readFile as readFile5 } from "fs/promises";
 import { extname as extname5 } from "path";
-import { compare as compare2, markdownToHwpx, parse } from "@clazic/kordoc";
 import { z as z5 } from "zod";
+import { readFile as readFile6 } from "fs/promises";
+import { extname as extname6 } from "path";
+import { compare as compare2, markdownToHwpx, parse } from "@clazic/kordoc";
+import { z as z6 } from "zod";
 import {
   Document,
   HeadingLevel,
@@ -10837,37 +10860,37 @@ import {
   TextRun,
   WidthType
 } from "docx";
-import { readFile as readFile6 } from "fs/promises";
-import { extname as extname6 } from "path";
-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 { extractFormFields, markdownToHwpx as markdownToHwpx2, parse as parse3 } from "@clazic/kordoc";
-var import_jszip4 = __toESM(require_lib3(), 1);
+import { parse as parse2 } from "@clazic/kordoc";
 import { z as z7 } from "zod";
 import { readFile as readFile8 } from "fs/promises";
 import { extname as extname8 } 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 z8 } from "zod";
 import { readFile as readFile9 } from "fs/promises";
 import { extname as extname9 } from "path";
-import { parse as parse4 } from "@clazic/kordoc";
+import ExcelJS from "exceljs";
 import { z as z9 } from "zod";
-import { readFile as readFile10, stat as stat3 } from "fs/promises";
+import { readFile as readFile10 } from "fs/promises";
 import { extname as extname10 } from "path";
-import { parse as parse5 } from "@clazic/kordoc";
+import { parse as parse4 } 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 { readFile as readFile11, stat as stat4 } from "fs/promises";
 import { extname as extname11 } from "path";
-import { markdownToHwpx as markdownToHwpx3 } from "@clazic/kordoc";
+import { parse as parse5 } from "@clazic/kordoc";
+import { z as z11 } from "zod";
+import { readFile as fsReadFile, stat as stat5 } from "fs/promises";
 import { z as z12 } from "zod";
 import { stat as stat6 } from "fs/promises";
 import { extname as extname12 } from "path";
-import ExcelJS2 from "exceljs";
+import { markdownToHwpx as markdownToHwpx3 } from "@clazic/kordoc";
 import { z as z13 } from "zod";
+import { stat as stat7 } from "fs/promises";
+import { extname as extname13 } from "path";
+import ExcelJS2 from "exceljs";
+import { z as z14 } from "zod";
 async function resolveSafePath(cwd, p) {
   const normalizedCwd = normalize(cwd).normalize("NFC");
   const normalizedP = p.normalize("NFC");
@@ -10999,16 +11022,227 @@ async function cleanOldBackups(maxAgeDays = 30, baseDir) {
 function resolveOutputPath(targetPath) {
   const ext = extname(targetPath).toLowerCase();
   if (ext === ".hwp") {
-    const outputPath = targetPath.slice(0, -4) + ".hwpx";
-    return { outputPath, willConvertFormat: ".hwp \u2192 .hwpx" };
+    return { outputPath: targetPath.slice(0, -4) + ".hwpx", willConvertFormat: ".hwp \u2192 .hwpx" };
+  }
+  if (ext === ".xls") {
+    return { outputPath: targetPath.slice(0, -4) + ".xlsx", willConvertFormat: ".xls \u2192 .xlsx" };
   }
   return { outputPath: targetPath, willConvertFormat: void 0 };
 }
+function parseBackupFilename(filename) {
+  const m = filename.match(/^(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z)-(.+)$/);
+  if (!m) return null;
+  return { tsToken: m[1], origBasename: m[2] };
+}
+function formatTimestamp(tsToken) {
+  const restored = tsToken.replace(
+    /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z$/,
+    "$1T$2:$3:$4.$5Z"
+  );
+  try {
+    const d = new Date(restored);
+    if (Number.isNaN(d.getTime())) return tsToken;
+    return d.toISOString().replace("T", " ").slice(0, 19);
+  } catch {
+    return tsToken;
+  }
+}
+var MAX_BACKUP_LIST = 50;
+var listBackupsSchema = z3.object({
+  path: z3.string().optional().describe("\uD2B9\uC815 \uD30C\uC77C\uC758 \uBC31\uC5C5\uB9CC \uBCF4\uB824\uBA74 \uADF8 \uD30C\uC77C \uACBD\uB85C (\uBBF8\uC9C0\uC815 \uC2DC \uC804\uCCB4 \uBC31\uC5C5)")
+});
+var listBackupsTool = {
+  name: "list_backups",
+  description: "\uBC31\uC5C5 \uB514\uB809\uD130\uB9AC\uC758 \uBC31\uC5C5 \uBAA9\uB85D\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4. path\uB97C \uC9C0\uC815\uD558\uBA74 \uD574\uB2F9 \uD30C\uC77C\uC758 \uBC31\uC5C5\uB9CC, \uBBF8\uC9C0\uC815 \uC2DC \uC804\uCCB4 \uBC31\uC5C5\uC744 \uD45C\uC2DC\uD569\uB2C8\uB2E4. \uCD5C\uB300 50\uAC74, \uCD5C\uC2E0\uC21C \uC815\uB82C.",
+  inputSchema: listBackupsSchema,
+  requiresApproval: false,
+  execute: async ({
+    input
+  }) => {
+    const backupsDir = KODOC_PATHS.backups;
+    let allEntries;
+    try {
+      allEntries = await readdir22(backupsDir);
+    } catch {
+      return "\uBC31\uC5C5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.";
+    }
+    if (allEntries.length === 0) {
+      return "\uBC31\uC5C5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.";
+    }
+    const parsed = [];
+    for (const filename of allEntries) {
+      const info = parseBackupFilename(filename);
+      if (!info) continue;
+      const fullPath = join32(backupsDir, filename);
+      let mtimeMs = 0;
+      try {
+        const s = await stat22(fullPath);
+        mtimeMs = s.mtimeMs;
+      } catch {
+        mtimeMs = 0;
+      }
+      parsed.push({ filename, fullPath, ...info, mtimeMs });
+    }
+    let filtered = parsed;
+    if (input.path) {
+      const targetBase = basename3(input.path);
+      filtered = parsed.filter((e) => e.origBasename === targetBase);
+    }
+    if (filtered.length === 0) {
+      if (input.path) {
+        return `\uD574\uB2F9 \uD30C\uC77C\uC758 \uBC31\uC5C5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: ${basename3(input.path)}`;
+      }
+      return "\uBC31\uC5C5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.";
+    }
+    filtered.sort((a, b) => {
+      if (b.mtimeMs !== a.mtimeMs) return b.mtimeMs - a.mtimeMs;
+      return b.tsToken.localeCompare(a.tsToken);
+    });
+    const total = filtered.length;
+    const truncated = filtered.length > MAX_BACKUP_LIST;
+    const display = filtered.slice(0, MAX_BACKUP_LIST);
+    const lines = display.map(
+      (e, i) => `${i + 1}. ${e.origBasename}  [${formatTimestamp(e.tsToken)}]  ${e.fullPath}`
+    );
+    const notice = truncated ? `
+(\uCD1D ${total}\uAC74 \uC911 \uCD5C\uC2E0 ${MAX_BACKUP_LIST}\uAC74\uB9CC \uD45C\uC2DC\uB429\uB2C8\uB2E4.)` : "";
+    return lines.join("\n") + notice;
+  }
+};
+var restoreBackupSchema = z3.object({
+  path: z3.string().describe("\uBCF5\uC6D0\uD560 \uB300\uC0C1 \uD30C\uC77C \uACBD\uB85C"),
+  backup: z3.string().optional().describe("\uBCF5\uC6D0\uD560 \uD2B9\uC815 \uBC31\uC5C5 \uD30C\uC77C\uBA85 (list_backups \uACB0\uACFC\uC758 \uD30C\uC77C\uBA85; \uBBF8\uC9C0\uC815 \uC2DC \uAC00\uC7A5 \uCD5C\uADFC \uBC31\uC5C5)"),
+  summary: z3.string().optional().describe("\uBCF5\uC6D0 \uC0AC\uC720/\uC694\uC57D")
+});
+var restoreBackupTool = {
+  name: "restore_backup",
+  description: "\uBC31\uC5C5 \uD30C\uC77C\uB85C \uB300\uC0C1 \uD30C\uC77C\uC744 \uBCF5\uC6D0\uD569\uB2C8\uB2E4. backup\uC744 \uBBF8\uC9C0\uC815 \uC2DC \uAC00\uC7A5 \uCD5C\uADFC \uBC31\uC5C5\uC744 \uC0AC\uC6A9\uD569\uB2C8\uB2E4. \uBCF5\uC6D0 \uC804 \uD604\uC7AC \uD30C\uC77C\uB3C4 \uC790\uB3D9 \uBC31\uC5C5\uB429\uB2C8\uB2E4(\uBCF5\uC6D0\uB3C4 \uB418\uB3CC\uB9B4 \uC218 \uC788\uC74C). \uC0AC\uC6A9\uC790 \uC2B9\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.",
+  inputSchema: restoreBackupSchema,
+  requiresApproval: true,
+  propose: async ({
+    input,
+    ctx
+  }) => {
+    let safePath;
+    try {
+      safePath = await resolveSafePath(ctx.cwd, input.path);
+    } catch (e) {
+      return `\uACBD\uB85C \uC624\uB958: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    const targetBase = basename3(safePath);
+    const backupsDir = KODOC_PATHS.backups;
+    let allEntries;
+    try {
+      allEntries = await readdir22(backupsDir);
+    } catch {
+      return `\uBC31\uC5C5\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${targetBase}. list_backups\uB85C \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBC31\uC5C5\uC744 \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`;
+    }
+    const candidates = [];
+    for (const filename of allEntries) {
+      const info = parseBackupFilename(filename);
+      if (!info) continue;
+      if (info.origBasename !== targetBase) continue;
+      const fullPath = join32(backupsDir, filename);
+      let mtimeMs = 0;
+      try {
+        const s = await stat22(fullPath);
+        mtimeMs = s.mtimeMs;
+      } catch {
+        mtimeMs = 0;
+      }
+      candidates.push({ filename, fullPath, tsToken: info.tsToken, mtimeMs });
+    }
+    if (candidates.length === 0) {
+      return `\uBC31\uC5C5\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${targetBase}. list_backups\uB85C \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBC31\uC5C5\uC744 \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`;
+    }
+    let chosen;
+    if (input.backup) {
+      const found = candidates.find(
+        (c) => c.filename === input.backup || c.fullPath.endsWith(input.backup)
+      );
+      if (!found) {
+        return `\uC9C0\uC815\uD55C \uBC31\uC5C5\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.backup}. list_backups\uB85C \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBC31\uC5C5\uC744 \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`;
+      }
+      chosen = found;
+    } else {
+      candidates.sort(
+        (a, b) => b.mtimeMs !== a.mtimeMs ? b.mtimeMs - a.mtimeMs : b.tsToken.localeCompare(a.tsToken)
+      );
+      chosen = candidates[0];
+    }
+    let backupBytes;
+    try {
+      backupBytes = await readFile22(chosen.fullPath);
+    } catch {
+      return `\uBC31\uC5C5 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${chosen.fullPath}`;
+    }
+    const stagedPath = await stageFile(ctx.sessionId, targetBase, backupBytes);
+    const ext = extname2(targetBase).toLowerCase();
+    const isText = ext === ".md" || ext === ".txt";
+    let diff;
+    if (isText) {
+      let currentText = "";
+      try {
+        currentText = await readFile22(safePath, "utf-8");
+      } catch {
+        currentText = "";
+      }
+      const backupText = backupBytes.toString("utf-8");
+      diff = markdownDiff(currentText, backupText, targetBase);
+    } else {
+      let currentSize = "\uD30C\uC77C \uC5C6\uC74C";
+      try {
+        const s = await stat22(safePath);
+        currentSize = `${s.size} bytes`;
+      } catch {
+        currentSize = "\uD30C\uC77C \uC5C6\uC74C";
+      }
+      const backupSize = `${backupBytes.length} bytes`;
+      diff = [
+        `\uBCF5\uC6D0 \uB300\uC0C1: ${safePath}`,
+        `\uD604\uC7AC \uD30C\uC77C: ${currentSize}`,
+        `\uBC31\uC5C5 \uD30C\uC77C: ${chosen.fullPath}`,
+        `\uBC31\uC5C5 \uC2DC\uAC01: ${formatTimestamp(chosen.tsToken)}`,
+        `\uBC31\uC5C5 \uD06C\uAE30: ${backupSize}`,
+        `\u2192 \uD604\uC7AC \uD30C\uC77C\uC744 \uC704 \uBC31\uC5C5\uC73C\uB85C \uB418\uB3CC\uB9BD\uB2C8\uB2E4.`
+      ].join("\n");
+    }
+    const warnings = [];
+    const autoSelected = !input.backup && candidates.length > 1;
+    if (autoSelected) {
+      warnings.push(
+        `\uBC31\uC5C5\uC744 \uC9C0\uC815\uD558\uC9C0 \uC54A\uC544 \uAC00\uC7A5 \uCD5C\uADFC \uBC31\uC5C5(${formatTimestamp(chosen.tsToken)})\uC744 \uC790\uB3D9\uC73C\uB85C \uC120\uD0DD\uD588\uC2B5\uB2C8\uB2E4. \uB2E4\uB978 \uBC31\uC5C5\uC744 \uC6D0\uD558\uBA74 list_backups\uB85C \uD655\uC778 \uD6C4 backup \uD30C\uB77C\uBBF8\uD130\uB97C \uC9C0\uC815\uD558\uC138\uC694.`
+      );
+    }
+    warnings.push(
+      "\uBCF5\uC6D0\uC744 \uC2E4\uD589\uD558\uBA74 \uD604\uC7AC \uD30C\uC77C\uB3C4 \uBC31\uC5C5\uB41C \uB4A4 \uB36E\uC5B4\uC4F0\uC5EC\uC9D1\uB2C8\uB2E4(\uBCF5\uC6D0 \uC790\uCCB4\uB3C4 \uB418\uB3CC\uB9B4 \uC218 \uC788\uC74C)."
+    );
+    const summary = input.summary ?? `\uBC31\uC5C5\uC73C\uB85C \uB418\uB3CC\uB9AC\uAE30: ${targetBase}`;
+    const chosenBackupPath = chosen.fullPath;
+    return {
+      proposal: {
+        id: crypto.randomUUID(),
+        kind: "restore",
+        targetPath: safePath,
+        stagedPath,
+        summary,
+        diff,
+        warnings
+      },
+      commit: async () => {
+        const safetyBackup = await backupFile(safePath);
+        await commitStaged(stagedPath, safePath);
+        const safetyNote = safetyBackup ? ` (\uBCF5\uC6D0 \uC804 \uD604\uC7AC \uC0C1\uD0DC \uBC31\uC5C5: ${safetyBackup})` : "";
+        return `\uBCF5\uC6D0 \uC644\uB8CC: ${safePath} \u2190 ${chosenBackupPath}${safetyNote}`;
+      }
+    };
+  }
+};
 var MAX_MARKDOWN_LENGTH = 8e4;
 var MAX_BLOCK_TEXT_LENGTH = 200;
-var compareDocumentsSchema = z3.object({
-  pathA: z3.string().describe("\uBE44\uAD50\uD560 \uCCAB \uBC88\uC9F8 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  pathB: z3.string().describe("\uBE44\uAD50\uD560 \uB450 \uBC88\uC9F8 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)")
+var compareDocumentsSchema = z22.object({
+  pathA: z22.string().describe("\uBE44\uAD50\uD560 \uCCAB \uBC88\uC9F8 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  pathB: z22.string().describe("\uBE44\uAD50\uD560 \uB450 \uBC88\uC9F8 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)")
 });
 function bufferToArrayBuffer(buf) {
   return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
@@ -11046,13 +11280,13 @@ var compareDocumentsTool = {
     let bufA;
     let bufB;
     try {
-      bufA = await readFile22(safePathA);
+      bufA = await readFile32(safePathA);
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       return `\uC624\uB958: \uCCAB \uBC88\uC9F8 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (${input.pathA}): ${msg}`;
     }
     try {
-      bufB = await readFile22(safePathB);
+      bufB = await readFile32(safePathB);
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       return `\uC624\uB958: \uB450 \uBC88\uC9F8 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (${input.pathB}): ${msg}`;
@@ -11500,14 +11734,14 @@ function validateHwpxBuffer(ext, buffer) {
   }
   return null;
 }
-var listFormObjectsSchema = z22.object({
-  path: z22.string().describe("\uC77D\uC744 .hwpx \uD30C\uC77C \uACBD\uB85C")
+var listFormObjectsSchema = z32.object({
+  path: z32.string().describe("\uC77D\uC744 .hwpx \uD30C\uC77C \uACBD\uB85C")
 });
-var formEditSetSchema = z22.object({
-  caption: z22.string().optional().describe("PushButton \uCEA1\uC158 \uD14D\uC2A4\uD2B8"),
-  checked: z22.boolean().optional().describe("CheckBox/RadioButton \uCCB4\uD06C \uC0C1\uD0DC (true=CHECKED)"),
-  selected: z22.string().optional().describe("ComboBox \uC120\uD0DD \uAC12 (listItem \uC911 \uD558\uB098\uC5EC\uC57C \uD568)"),
-  text: z22.string().optional().describe("Edit \uD14D\uC2A4\uD2B8 \uB0B4\uC6A9")
+var formEditSetSchema = z32.object({
+  caption: z32.string().optional().describe("PushButton \uCEA1\uC158 \uD14D\uC2A4\uD2B8"),
+  checked: z32.boolean().optional().describe("CheckBox/RadioButton \uCCB4\uD06C \uC0C1\uD0DC (true=CHECKED)"),
+  selected: z32.string().optional().describe("ComboBox \uC120\uD0DD \uAC12 (listItem \uC911 \uD558\uB098\uC5EC\uC57C \uD568)"),
+  text: z32.string().optional().describe("Edit \uD14D\uC2A4\uD2B8 \uB0B4\uC6A9")
 }).refine(
   (v) => {
     const keys = ["caption", "checked", "selected", "text"].filter(
@@ -11517,24 +11751,24 @@ var formEditSetSchema = z22.object({
   },
   { message: "set \uD544\uB4DC\uB294 caption/checked/selected/text \uC911 \uC815\uD655\uD788 \uD558\uB098\uB9CC \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4." }
 );
-var formEditExpectedSchema = z22.object({
-  caption: z22.string().optional(),
-  checked: z22.boolean().optional(),
-  selected: z22.string().optional(),
-  text: z22.string().optional()
+var formEditExpectedSchema = z32.object({
+  caption: z32.string().optional(),
+  checked: z32.boolean().optional(),
+  selected: z32.string().optional(),
+  text: z32.string().optional()
 }).optional();
-var formEditItemSchema = z22.object({
-  name: z22.string().describe("\uC591\uC2DD \uAC1C\uCCB4\uC758 name \uC18D\uC131 \uAC12"),
-  index: z22.number().int().nonnegative().optional().describe("\uB3D9\uC77C name\uC774 \uC5EC\uB7FF\uC778 \uACBD\uC6B0 \uBB38\uC11C \uC804\uCCB4 0-based \uC778\uB371\uC2A4\uB85C \uAD6C\uBD84"),
+var formEditItemSchema = z32.object({
+  name: z32.string().describe("\uC591\uC2DD \uAC1C\uCCB4\uC758 name \uC18D\uC131 \uAC12"),
+  index: z32.number().int().nonnegative().optional().describe("\uB3D9\uC77C name\uC774 \uC5EC\uB7FF\uC778 \uACBD\uC6B0 \uBB38\uC11C \uC804\uCCB4 0-based \uC778\uB371\uC2A4\uB85C \uAD6C\uBD84"),
   set: formEditSetSchema.describe("\uBCC0\uACBD\uD560 \uAC12 (caption/checked/selected/text \uC911 \uD558\uB098)"),
   expected: formEditExpectedSchema.describe(
     "\uD604\uC7AC \uAC12 \uC0AC\uC804 \uAC80\uC99D (\uC548\uC804 \uC635\uC158). \uC2E4\uC81C \uAC12\uC774 \uB2E4\uB974\uBA74 \uC774 \uD3B8\uC9D1\uC744 \uCDE8\uC18C\uD558\uACE0 \uC624\uB958 \uBC18\uD658."
   )
 });
-var proposeFormObjectSchema = z22.object({
-  path: z22.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C"),
-  edits: z22.array(formEditItemSchema).min(1).describe("\uC591\uC2DD \uAC1C\uCCB4 \uD3B8\uC9D1 \uBAA9\uB85D"),
-  summary: z22.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+var proposeFormObjectSchema = z32.object({
+  path: z32.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C"),
+  edits: z32.array(formEditItemSchema).min(1).describe("\uC591\uC2DD \uAC1C\uCCB4 \uD3B8\uC9D1 \uBAA9\uB85D"),
+  summary: z32.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 var listFormObjectsTool = {
   name: "list_form_objects",
@@ -11546,10 +11780,10 @@ var listFormObjectsTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname2(safePath).toLowerCase();
+    const ext = extname3(safePath).toLowerCase();
     let buffer;
     try {
-      buffer = await readFile32(safePath);
+      buffer = await readFile4(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}`;
     }
@@ -11601,10 +11835,10 @@ var proposeFormObjectTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname2(safePath).toLowerCase();
+    const ext = extname3(safePath).toLowerCase();
     let originalBuffer;
     try {
-      originalBuffer = await readFile32(safePath);
+      originalBuffer = await readFile4(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}`;
     }
@@ -11791,14 +12025,14 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
 ]);
 var MAX_DEPTH = 4;
 var MAX_FILES = 500;
-var listFilesSchema = z32.object({
-  dir: z32.string().optional().describe("\uBAA9\uB85D\uC744 \uC870\uD68C\uD560 \uB514\uB809\uD130\uB9AC (\uBBF8\uC9C0\uC815 \uC2DC cwd \uC804\uCCB4)")
+var listFilesSchema = z4.object({
+  dir: z4.string().optional().describe("\uBAA9\uB85D\uC744 \uC870\uD68C\uD560 \uB514\uB809\uD130\uB9AC (\uBBF8\uC9C0\uC815 \uC2DC cwd \uC804\uCCB4)")
 });
 async function collectFiles(dir, cwd, depth, entries) {
   if (depth > MAX_DEPTH || entries.length >= MAX_FILES) return;
   let items;
   try {
-    items = await readdir22(dir);
+    items = await readdir3(dir);
   } catch {
     return;
   }
@@ -11806,15 +12040,15 @@ async function collectFiles(dir, cwd, depth, entries) {
     if (entries.length >= MAX_FILES) break;
     if (item.startsWith(".")) continue;
     if (SKIP_DIRS.has(item)) continue;
-    const fullPath = join32(dir, item);
+    const fullPath = join4(dir, item);
     let info;
     try {
-      info = await stat22(fullPath);
+      info = await stat3(fullPath);
     } catch {
       continue;
     }
     const relPath = relative2(cwd, fullPath);
-    const ext = extname3(item).toLowerCase();
+    const ext = extname4(item).toLowerCase();
     const isDoc = DOC_EXTENSIONS.has(ext);
     if (info.isDirectory()) {
       entries.push({ path: relPath + "/", isDir: true, isDoc: false });
@@ -11852,29 +12086,29 @@ var listFilesTool = {
     return lines.join("\n") + truncateNotice;
   }
 };
-var cellEditItemSchema = z4.object({
-  tableIndex: z4.number().int().nonnegative().optional().describe(
+var cellEditItemSchema = z5.object({
+  tableIndex: z5.number().int().nonnegative().optional().describe(
     "\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(
+  row: z5.number().int().nonnegative().optional().describe("\uC88C\uD45C \uBAA8\uB4DC: \uC140\uC758 rowAddr (0-based)"),
+  col: z5.number().int().nonnegative().optional().describe("\uC88C\uD45C \uBAA8\uB4DC: \uC140\uC758 colAddr (0-based)"),
+  label: z5.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(
+  direction: z5.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: z5.string().describe("\uC140\uC5D0 \uC4F8 \uC0C8 \uD14D\uC2A4\uD2B8"),
+  expectedText: z5.string().optional().describe(
     "\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)"),
-  edits: z4.array(cellEditItemSchema).min(1).describe(
+var proposeCellEditSchema = z5.object({
+  path: z5.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  edits: z5.array(cellEditItemSchema).min(1).describe(
     "\uD3B8\uC9D1 \uBAA9\uB85D. \uAC01 \uD56D\uBAA9\uC740 \uC88C\uD45C \uBAA8\uB4DC(tableIndex+row+col) \uB610\uB294 \uB808\uC774\uBE14 \uBAA8\uB4DC(label+direction) \uC911 \uD558\uB098"
   ),
-  summary: z4.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+  summary: z5.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 function tokenizeHwpxXml(xml) {
   const tokens = [];
@@ -12209,7 +12443,7 @@ var proposeCellEditTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname4(safePath).toLowerCase();
+    const ext = extname5(safePath).toLowerCase();
     if (ext === ".hwp") {
       return "\uC624\uB958: propose_cell_edit\uC740 .hwpx \uD30C\uC77C\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4. .hwp(\uAD6C\uD615 OLE \uBC14\uC774\uB108\uB9AC)\uB294 \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. \uB610\uB294 propose_edit\uC744 \uC0AC\uC6A9\uD560 \uC218 \uC788\uC73C\uB098, \uBCD1\uD569 \uC140\uC774 \uC18C\uC2E4\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.";
     }
@@ -12218,7 +12452,7 @@ var proposeCellEditTool = {
     }
     let originalBuffer;
     try {
-      originalBuffer = await readFile4(safePath);
+      originalBuffer = await readFile5(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}. \uACBD\uB85C\uB97C \uD655\uC778\uD558\uAC70\uB098 read_document\uB85C \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`;
     }
@@ -12547,10 +12781,10 @@ async function markdownToDocx(markdown) {
   });
   return Packer.toBuffer(doc);
 }
-var proposeEditSchema = z5.object({
-  path: z5.string().describe("\uC218\uC815\uD560 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
-  newMarkdown: z5.string().describe("\uC0C8 \uBB38\uC11C \uB0B4\uC6A9 (\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD). read_document\uB85C \uC6D0\uBCF8\uC744 \uBA3C\uC800 \uC77D\uC5B4\uC57C \uD568"),
-  summary: z5.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+var proposeEditSchema = z6.object({
+  path: z6.string().describe("\uC218\uC815\uD560 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  newMarkdown: z6.string().describe("\uC0C8 \uBB38\uC11C \uB0B4\uC6A9 (\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD). read_document\uB85C \uC6D0\uBCF8\uC744 \uBA3C\uC800 \uC77D\uC5B4\uC57C \uD568"),
+  summary: z6.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 var proposeEditTool = {
   name: "propose_edit",
@@ -12562,10 +12796,10 @@ var proposeEditTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname5(safePath).toLowerCase();
+    const ext = extname6(safePath).toLowerCase();
     let originalBuffer;
     try {
-      originalBuffer = await readFile5(safePath);
+      originalBuffer = 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\uAC70\uB098 read_document\uB85C \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694.`;
     }
@@ -12636,17 +12870,48 @@ ${diff}`;
     };
   }
 };
-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)")
+var proposeFindReplaceSchema = z7.object({
+  path: z7.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  find: z7.string().min(1).describe("\uCC3E\uC744 \uD14D\uC2A4\uD2B8"),
+  replace: z7.string().describe("\uBC14\uAFC0 \uD14D\uC2A4\uD2B8"),
+  caseSensitive: z7.boolean().optional().default(false).describe("\uB300\uC18C\uBB38\uC790 \uAD6C\uBD84 (\uAE30\uBCF8\uAC12: false)"),
+  all: z7.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: z7.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
+var MAX_DIFF_SAMPLES = 20;
 function escapeXml3(text3) {
   return text3.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
+function unescapeXml(text3) {
+  return text3.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+function makeChangeSnippet(before, after, ctx = 24) {
+  let p = 0;
+  while (p < before.length && p < after.length && before[p] === after[p]) p++;
+  const maxSuffix = Math.min(before.length - p, after.length - p);
+  let s = 0;
+  while (s < maxSuffix && before[before.length - 1 - s] === after[after.length - 1 - s]) s++;
+  const slice = (str) => {
+    const start = Math.max(0, p - ctx);
+    const end = Math.min(str.length, str.length - s + ctx);
+    return (start > 0 ? "\u2026" : "") + str.slice(start, end) + (end < str.length ? "\u2026" : "");
+  };
+  return { before: slice(before), after: slice(after) };
+}
+function collectChangedSnippets(beforeXml, afterXml, maxSamples) {
+  const re = /<hp:t>([\s\S]*?)<\/hp:t>/g;
+  const beforeNodes = [...beforeXml.matchAll(re)].map((m) => m[1] ?? "");
+  const afterNodes = [...afterXml.matchAll(re)].map((m) => m[1] ?? "");
+  const out = [];
+  const n = Math.min(beforeNodes.length, afterNodes.length);
+  for (let i = 0; i < n && out.length < maxSamples; i++) {
+    if (beforeNodes[i] !== afterNodes[i]) {
+      const snip = makeChangeSnippet(unescapeXml(beforeNodes[i]), unescapeXml(afterNodes[i]));
+      out.push(snip);
+    }
+  }
+  return out;
+}
 function replaceInSectionXml(xml, find, replace, caseSensitive, replaceAll, alreadyReplaced) {
   if (!replaceAll && alreadyReplaced > 0) {
     return { xml, count: 0 };
@@ -12754,7 +13019,19 @@ async function applyFindReplaceToHwpx(hwpxBuffer, find, replace, caseSensitive,
     }
   }
   if (totalCount === 0) {
-    return { buffer: hwpxBuffer, count: 0 };
+    return { buffer: hwpxBuffer, count: 0, samples: [] };
+  }
+  const samples = [];
+  for (let si = 0; si < sectionFiles.length && samples.length < MAX_DIFF_SAMPLES; si++) {
+    const remaining = MAX_DIFF_SAMPLES - samples.length;
+    const snippets = collectChangedSnippets(
+      sectionXmls[si] ?? "",
+      newSectionXmls[si] ?? "",
+      remaining
+    );
+    for (const snip of snippets) {
+      samples.push(snip);
+    }
   }
   const out = new import_jszip3.default();
   const mimetypeEntry = zip.file("mimetype");
@@ -12773,7 +13050,8 @@ async function applyFindReplaceToHwpx(hwpxBuffer, find, replace, caseSensitive,
   const buf = await out.generateAsync({ type: "nodebuffer", compression: "DEFLATE" });
   return {
     buffer: new Uint8Array(buf),
-    count: totalCount
+    count: totalCount,
+    samples
   };
 }
 var proposeFindReplaceTool = {
@@ -12786,7 +13064,7 @@ var proposeFindReplaceTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname6(safePath).toLowerCase();
+    const ext = extname7(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.";
     }
@@ -12795,7 +13073,7 @@ var proposeFindReplaceTool = {
     }
     let originalBuf;
     try {
-      originalBuf = await readFile6(safePath);
+      originalBuf = 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.`;
     }
@@ -12809,6 +13087,7 @@ var proposeFindReplaceTool = {
     );
     let newBytes;
     let replacedCount;
+    let diffSamples;
     try {
       const result = await applyFindReplaceToHwpx(
         originalBytes,
@@ -12819,6 +13098,7 @@ var proposeFindReplaceTool = {
       );
       newBytes = result.buffer;
       replacedCount = result.count;
+      diffSamples = result.samples;
     } catch (e) {
       return `\uC624\uB958: \uCE58\uD658 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. ${String(e)}`;
     }
@@ -12838,7 +13118,7 @@ var proposeFindReplaceTool = {
           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.`
+              `\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. \uB0A8\uC740 ${remaining}\uACF3\uC740 \uD45C \uC548\uC758 \uC140\uC774\uBA74 propose_cell_edit\uC73C\uB85C \uD55C \uACF3\uC529 \uC218\uC815\uD558\uAC70\uB098, \uD55C\uAE00 \uD504\uB85C\uADF8\uB7A8\uC5D0\uC11C \uC9C1\uC811 \uCC3E\uAE30\xB7\uBC14\uAFB8\uAE30\uB85C \uCC98\uB9AC\uD558\uC138\uC694.`
             );
           }
         }
@@ -12847,7 +13127,23 @@ var proposeFindReplaceTool = {
     }
     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)`;
+    let diff;
+    if (diffSamples.length === 0) {
+      diff = `\uCC3E\uAE30: "${input.find}" \u2192 \uBC14\uAFB8\uAE30: "${input.replace}" (${allLabel} \uAD50\uCCB4\uB428)`;
+    } else {
+      const lines = [`${replacedCount}\uACF3 \uAD50\uCCB4: "${input.find}" \u2192 "${input.replace}"`];
+      for (let i = 0; i < diffSamples.length; i++) {
+        const sample = diffSamples[i];
+        lines.push(`  ${i + 1}. - ${sample.before}`);
+        lines.push(`     + ${sample.after}`);
+      }
+      if (replacedCount > diffSamples.length) {
+        lines.push(
+          `  \u2026 \uC678 ${replacedCount - diffSamples.length}\uACF3 (\uBBF8\uB9AC\uBCF4\uAE30\uB294 \uCD5C\uB300 ${MAX_DIFF_SAMPLES}\uACF3)`
+        );
+      }
+      diff = lines.join("\n");
+    }
     const stagedPath = await stageFile(ctx.sessionId, outputPath, newBytes);
     const proposalId = crypto.randomUUID();
     return {
@@ -12870,10 +13166,10 @@ var proposeFindReplaceTool = {
     };
   }
 };
-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 proposeFormFillSchema = z8.object({
+  path: z8.string().describe("\uC591\uC2DD \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  fields: z8.record(z8.string(), z8.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: z8.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 var proposeFormFillTool = {
   name: "propose_form_fill",
@@ -12885,13 +13181,13 @@ var proposeFormFillTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname7(safePath).toLowerCase();
+    const ext = extname8(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 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.`;
     }
@@ -12959,16 +13255,16 @@ var proposeFormFillTool = {
     };
   }
 };
-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")
+var proposeSheetEditSchema = z9.object({
+  path: z9.string().describe("\uC218\uC815\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  updates: z9.array(
+    z9.object({
+      sheet: z9.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
+      cell: z9.string().describe("\uC140 \uC8FC\uC18C (\uC608: A1, B3)"),
+      value: z9.union([z9.string(), z9.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: z8.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
+  summary: z9.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 var proposeSheetEditTool = {
   name: "propose_sheet_edit",
@@ -12980,13 +13276,13 @@ var proposeSheetEditTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname8(safePath).toLowerCase();
+    const ext = extname9(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 readFile8(safePath);
+      originalBuffer = 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.`;
     }
@@ -13025,23 +13321,25 @@ var proposeSheetEditTool = {
       return `\uC624\uB958: \uC6CC\uD06C\uBD81 \uC800\uC7A5 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4: ${msg}`;
     }
     const stagedData = modifiedBuffer;
-    const stagedPath = await stageFile(ctx.sessionId, safePath, stagedData);
+    const { outputPath, willConvertFormat } = resolveOutputPath(safePath);
+    const stagedPath = await stageFile(ctx.sessionId, outputPath, stagedData);
     const proposalId = crypto.randomUUID();
     return {
       proposal: {
         id: proposalId,
         kind: "sheet-edit",
-        targetPath: safePath,
+        targetPath: outputPath,
         stagedPath,
         summary: input.summary,
         diff,
-        warnings: []
+        warnings: [],
+        willConvertFormat
       },
       commit: async () => {
-        const backupPath = await backupFile(safePath);
-        await commitStaged(stagedPath, safePath);
+        const backupPath = await backupFile(outputPath);
+        await commitStaged(stagedPath, outputPath);
         const backupInfo = backupPath ? ` (\uBC31\uC5C5: ${backupPath})` : "";
-        return `\uC800\uC7A5 \uC644\uB8CC: ${safePath}${backupInfo}`;
+        return `\uC800\uC7A5 \uC644\uB8CC: ${outputPath}${backupInfo}`;
       }
     };
   }
@@ -13077,47 +13375,47 @@ function detectStructuralLoss(beforeBlocks, afterBlocks) {
   }
   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 insertRowOpSchema = z10.object({
+  type: z10.literal("insertRow"),
+  row: z10.number().int().nonnegative().describe("\uAE30\uC900 \uD589 \uC778\uB371\uC2A4 (0-based)"),
+  position: z10.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 deleteRowOpSchema = z10.object({
+  type: z10.literal("deleteRow"),
+  row: z10.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 insertColumnOpSchema = z10.object({
+  type: z10.literal("insertColumn"),
+  col: z10.number().int().nonnegative().describe("\uAE30\uC900 \uC5F4 \uC778\uB371\uC2A4 (0-based)"),
+  position: z10.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 deleteColumnOpSchema = z10.object({
+  type: z10.literal("deleteColumn"),
+  col: z10.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 mergeCellsOpSchema = z10.object({
+  type: z10.literal("mergeCells"),
+  startRow: z10.number().int().nonnegative().describe("\uBCD1\uD569 \uC2DC\uC791 \uD589 (0-based)"),
+  startCol: z10.number().int().nonnegative().describe("\uBCD1\uD569 \uC2DC\uC791 \uC5F4 (0-based)"),
+  endRow: z10.number().int().nonnegative().describe("\uBCD1\uD569 \uB05D \uD589 (0-based, \uD3EC\uD568)"),
+  endCol: z10.number().int().nonnegative().describe("\uBCD1\uD569 \uB05D \uC5F4 (0-based, \uD3EC\uD568)")
 });
-var operationSchema = z9.discriminatedUnion("type", [
+var operationSchema = z10.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(
+var proposeTableStructureSchema = z10.object({
+  path: z10.string().describe("\uC218\uC815\uD560 .hwpx \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  anchor: z10.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(
+  operations: z10.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)")
+  summary: z10.string().describe("\uBCC0\uACBD \uC694\uC57D (\uD55C\uAD6D\uC5B4 1-2\uBB38\uC7A5)")
 });
 function tokenizeHwpxXml2(xml) {
   const tokens = [];
@@ -13792,7 +14090,7 @@ var proposeTableStructureTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname9(safePath).toLowerCase();
+    const ext = extname10(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.";
     }
@@ -13801,7 +14099,7 @@ var proposeTableStructureTool = {
     }
     let originalBuf;
     try {
-      originalBuf = await readFile9(safePath);
+      originalBuf = await readFile10(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.`;
     }
@@ -13997,11 +14295,11 @@ function searchExcerpts(markdown, query) {
   }
   return result;
 }
-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)")
+var readDocumentSchema = z11.object({
+  path: z11.string().describe("\uC77D\uC744 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  pages: z11.string().optional().describe('\uC77D\uC744 \uD398\uC774\uC9C0 \uBC94\uC704 (\uC608: "1-3", "1,3,5") \u2014 \uBBF8\uC9C0\uC815 \uC2DC \uC804\uCCB4'),
+  outline: z11.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: z11.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) {
@@ -14023,18 +14321,18 @@ var readDocumentTool = {
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
     try {
-      const fileStat = await stat3(safePath);
+      const fileStat = await stat4(safePath);
       const guardMsg = fileSizeGuardMessage(fileStat.size, MAX_FILE_SIZE_BYTES);
       if (guardMsg !== null) return guardMsg;
     } 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}`;
     }
-    const ext = extname10(safePath).toLowerCase();
+    const ext = extname11(safePath).toLowerCase();
     if (PLAIN_TEXT_EXTS.has(ext)) {
       let raw;
       try {
-        raw = await readFile10(safePath, "utf-8");
+        raw = await readFile11(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}`;
@@ -14134,8 +14432,8 @@ var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".csv",
   ".log"
 ]);
-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 readFileSchema = z12.object({
+  path: z12.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",
@@ -14149,7 +14447,7 @@ var readFileTool = {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
     let info;
     try {
-      info = await stat4(safePath);
+      info = await stat5(safePath);
     } catch {
       return `\uC624\uB958: \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.path}`;
     }
@@ -14159,8 +14457,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: extname13 } = await import("path");
-    const ext = extname13(safePath).toLowerCase();
+    const { extname: extname14 } = await import("path");
+    const ext = extname14(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.`;
     }
@@ -14175,9 +14473,9 @@ var readFileTool = {
   }
 };
 var MAX_PREVIEW_CHARS = 1e4;
-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 writeNewDocumentSchema = z13.object({
+  path: z13.string().describe("\uC0DD\uC131\uD560 \uBB38\uC11C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  markdown: z13.string().describe("\uC0C8 \uBB38\uC11C \uB0B4\uC6A9 (\uB9C8\uD06C\uB2E4\uC6B4 \uD615\uC2DD)")
 });
 var writeNewDocumentTool = {
   name: "write_new_document",
@@ -14189,9 +14487,9 @@ var writeNewDocumentTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname11(safePath).toLowerCase();
+    const ext = extname12(safePath).toLowerCase();
     try {
-      await stat5(safePath);
+      await stat6(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.`;
     } catch {
     }
@@ -14239,12 +14537,12 @@ ${preview}`,
     };
   }
 };
-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)")
+var writeNewSpreadsheetSchema = z14.object({
+  path: z14.string().describe("\uC0DD\uC131\uD560 XLSX \uD30C\uC77C \uACBD\uB85C (cwd \uAE30\uC900 \uC0C1\uB300 \uACBD\uB85C \uB610\uB294 \uC808\uB300 \uACBD\uB85C)"),
+  sheets: z14.array(
+    z14.object({
+      name: z14.string().describe("\uC2DC\uD2B8 \uC774\uB984"),
+      rows: z14.array(z14.array(z14.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")
 });
@@ -14258,12 +14556,12 @@ var writeNewSpreadsheetTool = {
     ctx
   }) => {
     const safePath = await resolveSafePath(ctx.cwd, input.path);
-    const ext = extname12(safePath).toLowerCase();
+    const ext = extname13(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}.`;
     }
     try {
-      await stat6(safePath);
+      await stat7(safePath);
       return `\uC624\uB958: \uD30C\uC77C\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${input.path}. \uAE30\uC874 \uD30C\uC77C \uC140 \uC218\uC815\uC740 propose_sheet_edit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.`;
     } catch {
     }
@@ -14316,6 +14614,7 @@ function createDocTools(_ctx) {
     readDocumentTool,
     compareDocumentsTool,
     listFilesTool,
+    listBackupsTool,
     readFileTool,
     proposeEditTool,
     proposeFormFillTool,
@@ -14326,7 +14625,8 @@ function createDocTools(_ctx) {
     listFormObjectsTool,
     proposeFormObjectTool,
     writeNewDocumentTool,
-    writeNewSpreadsheetTool
+    writeNewSpreadsheetTool,
+    restoreBackupTool
   ];
 }
 
@@ -14415,6 +14715,14 @@ function createCliApprovalHandler() {
 
 // src/chat.ts
 var HELP_TEXT = `
+\uD560 \uC218 \uC788\uB294 \uC77C:
+  \u2022 \uBB38\uC11C \uC77D\uAE30\xB7\uC694\uC57D\xB7\uAC80\uD1A0 \u2014 .hwp/.hwpx/.docx/.xlsx/.pdf (\uC608: "\uC774 \uBCF4\uB3C4\uC790\uB8CC \uC694\uC57D\uD574\uC918")
+  \u2022 \uD45C\xB7\uC591\uC2DD \uC218\uC815 \u2014 \uC140 \uAC12, \uC591\uC2DD \uBE48\uCE78, \uD589\xB7\uC5F4 \uCD94\uAC00/\uC0AD\uC81C (\uC608: "\uC774 \uD45C\uC758 \uAE08\uC561\uC744 30000\uC73C\uB85C \uACE0\uCCD0\uC918")
+  \u2022 \uBB38\uC11C \uC804\uCCB4 \uCC3E\uAE30\xB7\uBC14\uAFB8\uAE30 (\uC608: "'\uAD6D\uBBFC\uC8FC\uAD8C'\uC744 '\uAD6D\uBBFC\uC911\uC2EC'\uC73C\uB85C \uB2E4 \uBC14\uAFD4\uC918")
+  \u2022 \uB418\uB3CC\uB9AC\uAE30 \u2014 \uC9C1\uC804 \uBCC0\uACBD\uC744 \uBC31\uC5C5\uC73C\uB85C \uBCF5\uC6D0 (\uC608: "\uBC29\uAE08 \uC218\uC815 \uB418\uB3CC\uB824\uC918")
+  \u2022 \uD55C\uAD6D \uBC95\uB839 \uAE30\uBC18 \uAC80\uD1A0 (\uC608: "\uC774 \uCDE8\uC5C5\uADDC\uCE59\uC774 \uADFC\uB85C\uAE30\uC900\uBC95\uC5D0 \uB9DE\uB294\uC9C0 \uBD10\uC918")
+  \u203B .hwp\uB294 \uD55C\uAE00\uC5D0\uC11C .hwpx\uB85C \uC800\uC7A5\uD55C \uD6C4 \uC218\uC815\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.
+
 \uC2AC\uB798\uC2DC \uBA85\uB839:
   /model   \u2014 \uD504\uB85C\uBC14\uC774\uB354/\uBAA8\uB378 \uC804\uD658
   /context \u2014 \uD604\uC7AC \uCEE8\uD14D\uC2A4\uD2B8 \uC0AC\uC6A9\uB7C9 \uD45C\uC2DC
@@ -14537,6 +14845,11 @@ async function runChat(opts) {
 
 `)
   );
+  process.stdout.write(
+    chalk2.dim(
+      '\uBB38\uC11C\uB97C \uC77D\uACE0 \uD45C\xB7\uC591\uC2DD \uC218\uC815, \uCC3E\uAE30\xB7\uBC14\uAFB8\uAE30, \uB418\uB3CC\uB9AC\uAE30\uAE4C\uC9C0 \uC790\uC5F0\uC5B4\uB85C \uC694\uCCAD\uD558\uC138\uC694. \uC608: "\uC774 \uD45C\uC758 \uD569\uACC4\uB97C \uB2E4\uC2DC \uACC4\uC0B0\uD574\uC918", "\uBC29\uAE08 \uC218\uC815 \uB418\uB3CC\uB824\uC918". \uC790\uC138\uD788: /help\n'
+    )
+  );
   while (true) {
     let clearActiveSpinner2 = function() {
       if (!sharedActiveInterval) return;
@@ -15130,7 +15443,7 @@ async function runOnboarding() {
 
 // src/update.ts
 import { spawn } from "child_process";
-import { mkdir as mkdir4, readFile as readFile11, writeFile as writeFile3 } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile12, writeFile as writeFile3 } from "fs/promises";
 import { dirname as dirname3 } from "path";
 function compareSemver(a, b) {
   const parse6 = (v) => {
@@ -15151,7 +15464,7 @@ function compareSemver(a, b) {
 var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 async function readCache(cachePath) {
   try {
-    const raw = await readFile11(cachePath, "utf-8");
+    const raw = await readFile12(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;
@@ -15434,7 +15747,9 @@ async function runSingleTurn(prompt) {
   });
   const tools = new ToolRegistry();
   for (const tool2 of createDocTools({ cwd })) {
-    tools.register(tool2);
+    const t = tool2;
+    if (t.requiresApproval) continue;
+    tools.register(t);
   }
   for (const mcpTool of mcpManager.getToolDefinitions()) {
     tools.register(mcpTool);