@levnikolaevich/hex-line-mcp 1.3.5 → 1.3.6

package/dist/server.mjs

@@ -249,6 +249,7 @@ function listDirectory(dirPath, opts = {}) {
   return { text: lines.join("\n"), total };
 }
 var MAX_OUTPUT_CHARS = 8e4;
+var MAX_DIFF_CHARS = 3e4;
 function readText(filePath) {
   return readFileSync(filePath, "utf-8").replace(/\r\n/g, "\n");
 }
@@ -1036,125 +1037,131 @@ function editFile(filePath, edits, opts = {}) {
     autoRebased = true;
     return null;
   };
-  for (const e of sorted) {
-    if (e.set_line) {
-      const { tag, line } = parseRef(e.set_line.anchor);
-      const idx = locateOrConflict({ tag, line });
-      if (typeof idx === "string") return idx;
-      const conflict = ensureRevisionContext(idx + 1, idx + 1, idx);
-      if (conflict) return conflict;
-      const txt = e.set_line.new_text;
-      if (!txt && txt !== 0) {
-        lines.splice(idx, 1);
-      } else {
-        const origLine = [lines[idx]];
-        const raw = String(txt).split("\n");
-        const newLines = opts.restoreIndent ? restoreIndent(origLine, raw) : raw;
-        lines.splice(idx, 1, ...newLines);
-      }
-      continue;
-    }
-    if (e.insert_after) {
-      const { tag, line } = parseRef(e.insert_after.anchor);
-      const idx = locateOrConflict({ tag, line });
-      if (typeof idx === "string") return idx;
-      const conflict = ensureRevisionContext(idx + 1, idx + 1, idx);
-      if (conflict) return conflict;
-      let insertLines = e.insert_after.text.split("\n");
-      if (opts.restoreIndent) insertLines = restoreIndent([lines[idx]], insertLines);
-      lines.splice(idx + 1, 0, ...insertLines);
-      continue;
-    }
-    if (e.replace_lines) {
-      const s = parseRef(e.replace_lines.start_anchor);
-      const en = parseRef(e.replace_lines.end_anchor);
-      const si = locateOrConflict(s);
-      if (typeof si === "string") return si;
-      const ei = locateOrConflict(en);
-      if (typeof ei === "string") return ei;
-      const actualStart = si + 1;
-      const actualEnd = ei + 1;
-      const rc = e.replace_lines.range_checksum;
-      if (!rc) throw new Error("range_checksum required for replace_lines. Read the range first via read_file, then pass its checksum.");
-      if (staleRevision && conflictPolicy === "conservative") {
-        const conflict = ensureRevisionContext(actualStart, actualEnd, si);
+  for (let _ei = 0; _ei < sorted.length; _ei++) {
+    const e = sorted[_ei];
+    try {
+      if (e.set_line) {
+        const { tag, line } = parseRef(e.set_line.anchor);
+        const idx = locateOrConflict({ tag, line });
+        if (typeof idx === "string") return idx;
+        const conflict = ensureRevisionContext(idx + 1, idx + 1, idx);
         if (conflict) return conflict;
-        const baseCheck = hasBaseSnapshot ? verifyChecksumAgainstSnapshot(baseSnapshot, rc) : null;
-        if (!baseCheck?.ok) {
-          return conflictIfNeeded(
-            "stale_checksum",
-            si,
-            baseCheck?.actual || null,
-            baseCheck?.actual ? `Provided checksum ${rc} does not match base revision ${opts.baseRevision}.` : `Checksum range from ${rc} is outside the available base revision.`
-          );
+        const txt = e.set_line.new_text;
+        if (!txt && txt !== 0) {
+          lines.splice(idx, 1);
+        } else {
+          const origLine = [lines[idx]];
+          const raw = String(txt).split("\n");
+          const newLines = opts.restoreIndent ? restoreIndent(origLine, raw) : raw;
+          lines.splice(idx, 1, ...newLines);
         }
-      } else {
-        const { start: csStart, end: csEnd, hex: csHex } = parseChecksum(rc);
-        if (csStart > actualStart || csEnd < actualEnd) {
-          const snip = buildErrorSnippet(origLines, actualStart - 1);
-          throw new Error(
-            `CHECKSUM_RANGE_GAP: range ${csStart}-${csEnd} does not cover edit range ${actualStart}-${actualEnd}.
+        continue;
+      }
+      if (e.insert_after) {
+        const { tag, line } = parseRef(e.insert_after.anchor);
+        const idx = locateOrConflict({ tag, line });
+        if (typeof idx === "string") return idx;
+        const conflict = ensureRevisionContext(idx + 1, idx + 1, idx);
+        if (conflict) return conflict;
+        let insertLines = e.insert_after.text.split("\n");
+        if (opts.restoreIndent) insertLines = restoreIndent([lines[idx]], insertLines);
+        lines.splice(idx + 1, 0, ...insertLines);
+        continue;
+      }
+      if (e.replace_lines) {
+        const s = parseRef(e.replace_lines.start_anchor);
+        const en = parseRef(e.replace_lines.end_anchor);
+        const si = locateOrConflict(s);
+        if (typeof si === "string") return si;
+        const ei = locateOrConflict(en);
+        if (typeof ei === "string") return ei;
+        const actualStart = si + 1;
+        const actualEnd = ei + 1;
+        const rc = e.replace_lines.range_checksum;
+        if (!rc) throw new Error("range_checksum required for replace_lines. Read the range first via read_file, then pass its checksum. The checksum range must cover start-to-end anchors (inclusive).");
+        if (staleRevision && conflictPolicy === "conservative") {
+          const conflict = ensureRevisionContext(actualStart, actualEnd, si);
+          if (conflict) return conflict;
+          const baseCheck = hasBaseSnapshot ? verifyChecksumAgainstSnapshot(baseSnapshot, rc) : null;
+          if (!baseCheck?.ok) {
+            return conflictIfNeeded(
+              "stale_checksum",
+              si,
+              baseCheck?.actual || null,
+              baseCheck?.actual ? `Provided checksum ${rc} does not match base revision ${opts.baseRevision}.` : `Checksum range from ${rc} is outside the available base revision.`
+            );
+          }
+        } else {
+          const { start: csStart, end: csEnd, hex: csHex } = parseChecksum(rc);
+          if (csStart > actualStart || csEnd < actualEnd) {
+            const snip = buildErrorSnippet(origLines, actualStart - 1);
+            throw new Error(
+              `CHECKSUM_RANGE_GAP: checksum covers lines ${csStart}-${csEnd} but edit spans ${actualStart}-${actualEnd} (inclusive). Checksum range must fully contain the anchor range.
 
 Current content (lines ${snip.start}-${snip.end}):
 ${snip.text}
 
 Tip: Use updated hashes above for retry.`
-          );
-        }
-        const actual = buildRangeChecksum(currentSnapshot, csStart, csEnd);
-        const actualHex = actual?.split(":")[1];
-        if (!actual || csHex !== actualHex) {
-          const details = `CHECKSUM_MISMATCH: expected ${rc}, got ${actual}. File changed \u2014 re-read lines ${csStart}-${csEnd}.`;
-          if (conflictPolicy === "conservative") {
-            return conflictIfNeeded("stale_checksum", csStart - 1, actual, details);
+            );
           }
-          const snip = buildErrorSnippet(origLines, csStart - 1);
-          throw new Error(
-            `${details}
+          const actual = buildRangeChecksum(currentSnapshot, csStart, csEnd);
+          const actualHex = actual?.split(":")[1];
+          if (!actual || csHex !== actualHex) {
+            const details = `CHECKSUM_MISMATCH: expected ${rc}, got ${actual}. Content at lines ${csStart}-${csEnd} differs from when you read it \u2014 re-read before editing.`;
+            if (conflictPolicy === "conservative") {
+              return conflictIfNeeded("stale_checksum", csStart - 1, actual, details);
+            }
+            const snip = buildErrorSnippet(origLines, csStart - 1);
+            throw new Error(
+              `${details}
 
 Current content (lines ${snip.start}-${snip.end}):
 ${snip.text}
 
 Retry with fresh checksum ${actual}, or use set_line with hashes above.`
-          );
+            );
+          }
         }
+        const txt = e.replace_lines.new_text;
+        if (!txt && txt !== 0) {
+          lines.splice(si, ei - si + 1);
+        } else {
+          const origRange = lines.slice(si, ei + 1);
+          let newLines = String(txt).split("\n");
+          if (opts.restoreIndent) newLines = restoreIndent(origRange, newLines);
+          lines.splice(si, ei - si + 1, ...newLines);
+        }
+        continue;
       }
-      const txt = e.replace_lines.new_text;
-      if (!txt && txt !== 0) {
-        lines.splice(si, ei - si + 1);
-      } else {
-        const origRange = lines.slice(si, ei + 1);
-        let newLines = String(txt).split("\n");
-        if (opts.restoreIndent) newLines = restoreIndent(origRange, newLines);
-        lines.splice(si, ei - si + 1, ...newLines);
-      }
-      continue;
-    }
-    if (e.replace_between) {
-      const boundaryMode = e.replace_between.boundary_mode || "inclusive";
-      if (boundaryMode !== "inclusive" && boundaryMode !== "exclusive") {
-        throw new Error(`BAD_INPUT: replace_between boundary_mode must be inclusive or exclusive, got ${boundaryMode}`);
-      }
-      const s = parseRef(e.replace_between.start_anchor);
-      const en = parseRef(e.replace_between.end_anchor);
-      const si = locateOrConflict(s);
-      if (typeof si === "string") return si;
-      const ei = locateOrConflict(en);
-      if (typeof ei === "string") return ei;
-      if (si > ei) {
-        throw new Error(`BAD_INPUT: replace_between start anchor resolves after end anchor (${si + 1} > ${ei + 1})`);
+      if (e.replace_between) {
+        const boundaryMode = e.replace_between.boundary_mode || "inclusive";
+        if (boundaryMode !== "inclusive" && boundaryMode !== "exclusive") {
+          throw new Error(`BAD_INPUT: replace_between boundary_mode must be inclusive or exclusive, got ${boundaryMode}`);
+        }
+        const s = parseRef(e.replace_between.start_anchor);
+        const en = parseRef(e.replace_between.end_anchor);
+        const si = locateOrConflict(s);
+        if (typeof si === "string") return si;
+        const ei = locateOrConflict(en);
+        if (typeof ei === "string") return ei;
+        if (si > ei) {
+          throw new Error(`BAD_INPUT: replace_between start anchor resolves after end anchor (${si + 1} > ${ei + 1})`);
+        }
+        const targetRange = targetRangeForReplaceBetween(si, ei, boundaryMode);
+        const conflict = ensureRevisionContext(targetRange.start, targetRange.end, si);
+        if (conflict) return conflict;
+        const txt = e.replace_between.new_text;
+        let newLines = String(txt ?? "").split("\n");
+        const sliceStart = boundaryMode === "exclusive" ? si + 1 : si;
+        const removeCount = boundaryMode === "exclusive" ? Math.max(0, ei - si - 1) : ei - si + 1;
+        const origRange = lines.slice(sliceStart, sliceStart + removeCount);
+        if (opts.restoreIndent && origRange.length > 0) newLines = restoreIndent(origRange, newLines);
+        if (txt === "" || txt === null) newLines = [];
+        lines.splice(sliceStart, removeCount, ...newLines);
       }
-      const targetRange = targetRangeForReplaceBetween(si, ei, boundaryMode);
-      const conflict = ensureRevisionContext(targetRange.start, targetRange.end, si);
-      if (conflict) return conflict;
-      const txt = e.replace_between.new_text;
-      let newLines = String(txt ?? "").split("\n");
-      const sliceStart = boundaryMode === "exclusive" ? si + 1 : si;
-      const removeCount = boundaryMode === "exclusive" ? Math.max(0, ei - si - 1) : ei - si + 1;
-      const origRange = lines.slice(sliceStart, sliceStart + removeCount);
-      if (opts.restoreIndent && origRange.length > 0) newLines = restoreIndent(origRange, newLines);
-      if (txt === "" || txt === null) newLines = [];
-      lines.splice(sliceStart, removeCount, ...newLines);
+    } catch (editErr) {
+      if (sorted.length > 1) editErr.message = `Edit ${_ei + 1}/${sorted.length}: ${editErr.message}`;
+      throw editErr;
     }
   }
   let content = lines.join("\n");
@@ -1163,10 +1170,23 @@ Retry with fresh checksum ${actual}, or use set_line with hashes above.`
   if (original === content) {
     throw new Error("NOOP_EDIT: File already contains the desired content. No changes needed.");
   }
-  let diff = simpleDiff(origLines, content.split("\n"));
-  if (diff && diff.length > 8e4) {
-    diff = diff.slice(0, 8e4) + `
-... (diff truncated, ${diff.length} chars total)`;
+  const fullDiff = simpleDiff(origLines, content.split("\n"));
+  let displayDiff = fullDiff;
+  if (displayDiff && displayDiff.length > MAX_DIFF_CHARS) {
+    displayDiff = displayDiff.slice(0, MAX_DIFF_CHARS) + `
+... (diff truncated, ${displayDiff.length} chars total)`;
+  }
+  const newLinesAll = content.split("\n");
+  let minLine = Infinity, maxLine = 0;
+  if (fullDiff) {
+    for (const dl of fullDiff.split("\n")) {
+      const m = dl.match(/^[+-](\d+)\|/);
+      if (m) {
+        const n = +m[1];
+        if (n < minLine) minLine = n;
+        if (n > maxLine) maxLine = n;
+      }
+    }
   }
   if (opts.dryRun) {
     let msg2 = `status: ${autoRebased ? "AUTO_REBASED" : "OK"}
@@ -1175,11 +1195,11 @@ file: ${currentSnapshot.fileChecksum}
 Dry run: ${filePath} would change (${content.split("\n").length} lines)`;
     if (staleRevision && hasBaseSnapshot) msg2 += `
 changed_ranges: ${describeChangedRanges(changedRanges)}`;
-    if (diff) msg2 += `
+    if (displayDiff) msg2 += `
 
 Diff:
 \`\`\`diff
-${diff}
+${displayDiff}
 \`\`\``;
     return msg2;
   }
@@ -1195,78 +1215,55 @@ changed_ranges: ${describeChangedRanges(changedRanges)}`;
   }
   msg += `
 Updated ${filePath} (${content.split("\n").length} lines)`;
-  if (diff) msg += `
+  if (fullDiff && minLine <= maxLine) {
+    const ctxStart = Math.max(0, minLine - 6);
+    const ctxEnd = Math.min(newLinesAll.length, maxLine + 5);
+    const ctxLines = [];
+    const ctxHashes = [];
+    for (let i = ctxStart; i < ctxEnd; i++) {
+      const h = fnv1a(newLinesAll[i]);
+      ctxHashes.push(h);
+      ctxLines.push(`${lineTag(h)}.${i + 1}	${newLinesAll[i]}`);
+    }
+    const ctxCs = rangeChecksum(ctxHashes, ctxStart + 1, ctxEnd);
+    msg += `
 
-Diff:
-\`\`\`diff
-${diff}
-\`\`\``;
+Post-edit (lines ${ctxStart + 1}-${ctxEnd}):
+${ctxLines.join("\n")}
+checksum: ${ctxCs}`;
+  }
   try {
     const db = getGraphDB(real);
     const relFile = db ? getRelativePath(real) : null;
-    if (db && relFile && diff) {
-      const diffLinesOut = diff.split("\n");
-      let minLine = Infinity, maxLine = 0;
-      for (const dl of diffLinesOut) {
-        const m = dl.match(/^[+-](\d+)\|/);
-        if (m) {
-          const n = +m[1];
-          if (n < minLine) minLine = n;
-          if (n > maxLine) maxLine = n;
-        }
-      }
-      if (minLine <= maxLine) {
-        const affected = callImpact(db, relFile, minLine, maxLine);
-        if (affected.length > 0) {
-          const list = affected.map((a) => `${a.name} (${a.file}:${a.line})`).join(", ");
-          msg += `
+    if (db && relFile && fullDiff && minLine <= maxLine) {
+      const affected = callImpact(db, relFile, minLine, maxLine);
+      if (affected.length > 0) {
+        const list = affected.map((a) => `${a.name} (${a.file}:${a.line})`).join(", ");
+        msg += `
 
 \u26A0 Call impact: ${affected.length} callers in other files
   ${list}`;
-        }
       }
     }
   } catch {
   }
-  const newLinesAll = content.split("\n");
-  if (diff) {
-    const diffArr = diff.split("\n");
-    let minLine = Infinity, maxLine = 0;
-    for (const dl of diffArr) {
-      const m = dl.match(/^[+-](\d+)\|/);
-      if (m) {
-        const n = +m[1];
-        if (n < minLine) minLine = n;
-        if (n > maxLine) maxLine = n;
-      }
-    }
-    if (minLine <= maxLine) {
-      const ctxStart = Math.max(0, minLine - 6);
-      const ctxEnd = Math.min(newLinesAll.length, maxLine + 5);
-      const ctxLines = [];
-      const ctxHashes = [];
-      for (let i = ctxStart; i < ctxEnd; i++) {
-        const h = fnv1a(newLinesAll[i]);
-        ctxHashes.push(h);
-        ctxLines.push(`${lineTag(h)}.${i + 1}	${newLinesAll[i]}`);
-      }
-      const ctxCs = rangeChecksum(ctxHashes, ctxStart + 1, ctxEnd);
-      msg += `
+  if (displayDiff) msg += `
 
-Post-edit (lines ${ctxStart + 1}-${ctxEnd}):
-${ctxLines.join("\n")}
-checksum: ${ctxCs}`;
-    }
-  }
+Diff:
+\`\`\`diff
+${displayDiff}
+\`\`\``;
   return msg;
 }
 
 // lib/search.mjs
 import { spawn } from "node:child_process";
-import { resolve as resolve2 } from "node:path";
+import { resolve as resolve2, isAbsolute as isAbsolute2 } from "node:path";
+import { existsSync as existsSync3 } from "node:fs";
 var rgBin = "rg";
 try {
   rgBin = (await import("@vscode/ripgrep")).rgPath;
+  if (isAbsolute2(rgBin) && !existsSync3(rgBin)) rgBin = "rg";
 } catch {
 }
 var DEFAULT_LIMIT2 = 100;
@@ -1292,7 +1289,13 @@ function spawnRg(args) {
       stderrBuf += chunk.toString("utf-8");
     });
     child.on("error", (err) => {
-      reject(new Error(`rg spawn error: ${err.message}`));
+      if (err.code === "ENOENT") {
+        reject(new Error(
+          `ripgrep not available. Reinstall dependencies so @vscode/ripgrep can provide its binary, or install system rg and add it to PATH. Attempted binary: "${rgBin}".`
+        ));
+      } else {
+        reject(new Error(`rg spawn error: ${err.message}`));
+      }
     });
     child.on("close", (code) => {
       resolve_({ stdout, code, stderr: stderrBuf, killed });
@@ -1694,7 +1697,7 @@ file: ${current.fileChecksum}`;
 }
 
 // lib/tree.mjs
-import { readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync6, existsSync as existsSync3 } from "node:fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync6, existsSync as existsSync4 } from "node:fs";
 import { resolve as resolve4, basename, join as join4, relative as relative2 } from "node:path";
 import ignore from "ignore";
 var SKIP_DIRS = /* @__PURE__ */ new Set([
@@ -1713,7 +1716,7 @@ function globToRegex(pat) {
 }
 function loadGitignore(rootDir) {
   const gi = join4(rootDir, ".gitignore");
-  if (!existsSync3(gi)) return null;
+  if (!existsSync4(gi)) return null;
   try {
     const content = readFileSync3(gi, "utf-8");
     return ignore().add(content);
@@ -1730,7 +1733,7 @@ function findByPattern(dirPath, opts) {
   const filterType = opts.type || "all";
   const maxDepth = opts.max_depth ?? 20;
   const abs = resolve4(normalizePath(dirPath));
-  if (!existsSync3(abs)) throw new Error(`DIRECTORY_NOT_FOUND: ${abs}`);
+  if (!existsSync4(abs)) throw new Error(`DIRECTORY_NOT_FOUND: ${abs}`);
   if (!statSync6(abs).isDirectory()) throw new Error(`Not a directory: ${abs}`);
   const ig = opts.gitignore ?? true ? loadGitignore(abs) : null;
   const matches = [];
@@ -1771,7 +1774,7 @@ function directoryTree(dirPath, opts = {}) {
   const compact = opts.format === "compact";
   const maxDepth = compact ? 1 : opts.max_depth ?? 3;
   const abs = resolve4(normalizePath(dirPath));
-  if (!existsSync3(abs)) throw new Error(`DIRECTORY_NOT_FOUND: ${abs}. Check path or use directory_tree on parent directory.`);
+  if (!existsSync4(abs)) throw new Error(`DIRECTORY_NOT_FOUND: ${abs}. Check path or use directory_tree on parent directory.`);
   const rootStat = statSync6(abs);
   if (!rootStat.isDirectory()) throw new Error(`Not a directory: ${abs}`);
   const ig = opts.gitignore ?? true ? loadGitignore(abs) : null;
@@ -1868,7 +1871,7 @@ ${lines.join("\n")}`;
 
 // lib/info.mjs
 import { statSync as statSync7, openSync as openSync2, readSync as readSync2, closeSync as closeSync2 } from "node:fs";
-import { resolve as resolve5, isAbsolute as isAbsolute2, extname as extname2, basename as basename2 } from "node:path";
+import { resolve as resolve5, isAbsolute as isAbsolute3, extname as extname2, basename as basename2 } from "node:path";
 var MAX_LINE_COUNT_SIZE = 10 * 1024 * 1024;
 var EXT_NAMES = {
   ".ts": "TypeScript source",
@@ -1937,7 +1940,7 @@ function detectBinary(filePath, size) {
 function fileInfo(filePath) {
   if (!filePath) throw new Error("Empty file path");
   const normalized = normalizePath(filePath);
-  const abs = isAbsolute2(normalized) ? normalized : resolve5(process.cwd(), normalized);
+  const abs = isAbsolute3(normalized) ? normalized : resolve5(process.cwd(), normalized);
   const stat = statSync7(abs);
   if (!stat.isFile()) throw new Error(`Not a regular file: ${abs}`);
   const size = stat.size;
@@ -1961,7 +1964,7 @@ function fileInfo(filePath) {
 }
 
 // lib/setup.mjs
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, existsSync as existsSync4, mkdirSync } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, existsSync as existsSync5, mkdirSync } from "node:fs";
 import { resolve as resolve6, dirname as dirname3 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
@@ -1989,7 +1992,7 @@ var CLAUDE_HOOKS = {
   }
 };
 function readJson(filePath) {
-  if (!existsSync4(filePath)) return null;
+  if (!existsSync5(filePath)) return null;
   return JSON.parse(readFileSync4(filePath, "utf-8"));
 }
 function writeJson(filePath, data) {
@@ -2358,12 +2361,33 @@ ${results.join("\n\n")}` : header;
 }
 
 // server.mjs
-var version = true ? "1.3.5" : (await null).createRequire(import.meta.url)("./package.json").version;
+var version = true ? "1.3.6" : (await null).createRequire(import.meta.url)("./package.json").version;
 var { server, StdioServerTransport } = await createServerRuntime({
   name: "hex-line-mcp",
   version,
   installDir: "mcp/hex-line-mcp"
 });
+var replacementPairsSchema = z2.array(
+  z2.object({ old: z2.string().min(1), new: z2.string() })
+).min(1);
+function coerceEdit(e) {
+  if (!e || typeof e !== "object" || Array.isArray(e)) return e;
+  if (e.set_line || e.replace_lines || e.insert_after || e.replace_between || e.replace) return e;
+  if (e.anchor && !e.start_anchor && !e.end_anchor && !e.boundary_mode && !e.range_checksum) {
+    const raw = e.new_text ?? e.updated_lines ?? e.content ?? e.line;
+    if (raw !== void 0) {
+      const text = Array.isArray(raw) ? raw.join("\n") : raw;
+      return { set_line: { anchor: e.anchor, new_text: text } };
+    }
+  }
+  if (e.start_anchor && e.end_anchor && e.boundary_mode && e.new_text !== void 0) {
+    return { replace_between: { start_anchor: e.start_anchor, end_anchor: e.end_anchor, new_text: e.new_text, boundary_mode: e.boundary_mode } };
+  }
+  if (e.start_anchor && e.end_anchor && e.new_text !== void 0) {
+    return { replace_lines: { start_anchor: e.start_anchor, end_anchor: e.end_anchor, new_text: e.new_text, ...e.range_checksum ? { range_checksum: e.range_checksum } : {} } };
+  }
+  return e;
+}
 server.registerTool("read_file", {
   title: "Read File",
   description: "Read a file with hash-annotated lines, range checksums, and current revision. Use offset/limit for targeted reads; use outline first for large code files.",
@@ -2402,8 +2426,8 @@ server.registerTool("edit_file", {
   description: "Apply revision-aware partial edits to one file. Prefer one batched call per file. Supports set_line, replace_lines, insert_after, and replace_between. For text rename/refactor use bulk_replace.",
   inputSchema: z2.object({
     path: z2.string().describe("File to edit"),
-    edits: z2.string().describe(
-      'JSON array. Examples:\n{"set_line":{"anchor":"ab.12","new_text":"new"}} \u2014 replace line\n{"replace_lines":{"start_anchor":"ab.10","end_anchor":"cd.15","new_text":"...","range_checksum":"10-15:a1b2c3d4"}} \u2014 range\n{"replace_between":{"start_anchor":"ab.10","end_anchor":"cd.40","new_text":"...","boundary_mode":"inclusive"}} \u2014 block rewrite\n{"insert_after":{"anchor":"ab.20","text":"inserted"}} \u2014 insert below. For text rename use bulk_replace tool.'
+    edits: z2.union([z2.string(), z2.array(z2.any())]).describe(
+      'JSON array. Types: set_line, replace_lines, insert_after, replace_between.\n[{"set_line":{"anchor":"ab.12","new_text":"x"}}]\n[{"replace_lines":{"start_anchor":"ab.10","end_anchor":"cd.15","new_text":"x","range_checksum":"10-15:a1b2"}}]\n[{"replace_between":{"start_anchor":"ab.10","end_anchor":"cd.40","new_text":"x","boundary_mode":"inclusive"}}]\n[{"insert_after":{"anchor":"ab.20","text":"x"}}]'
     ),
     dry_run: flexBool().describe("Preview changes without writing"),
     restore_indent: flexBool().describe("Auto-fix indentation to match anchor (default: false)"),
@@ -2414,12 +2438,18 @@ server.registerTool("edit_file", {
 }, async (rawParams) => {
   const { path: p, edits: json, dry_run, restore_indent, base_revision, conflict_policy } = coerceParams(rawParams);
   try {
-    const parsed = JSON.parse(json);
+    let parsed;
+    try {
+      parsed = typeof json === "string" ? JSON.parse(json) : json;
+    } catch {
+      throw new Error('edits: invalid JSON. Expected: [{"set_line":{"anchor":"xx.N","new_text":"..."}}]');
+    }
     if (!Array.isArray(parsed) || !parsed.length) throw new Error("Edits: non-empty JSON array required");
+    const normalized = parsed.map(coerceEdit);
     return {
       content: [{
         type: "text",
-        text: editFile(p, parsed, {
+        text: editFile(p, normalized, {
           dryRun: dry_run,
           restoreIndent: restore_indent,
           baseRevision: base_revision,
@@ -2452,7 +2482,7 @@ server.registerTool("write_file", {
 });
 server.registerTool("grep_search", {
   title: "Search Files",
-  description: "Search file contents with ripgrep. Returns hash-annotated matches with per-group checksums for direct editing. Output modes: content (default, edit-ready hashes+checksums), files (paths only), count (match counts). For single-line edits: grep -> set_line directly. For range edits: use checksum from grep output. ALWAYS prefer over shell grep/rg/findstr.",
+  description: "Search file contents with ripgrep. Returns hash-annotated matches with checksums. Modes: content (default), files, count. Use checksums with set_line/replace_lines. Prefer over shell grep/rg.",
   inputSchema: z2.object({
     pattern: z2.string().describe("Search pattern (regex by default, literal if literal:true)"),
     path: z2.string().optional().describe("Search dir/file (default: cwd)"),
@@ -2513,7 +2543,7 @@ server.registerTool("grep_search", {
 });
 server.registerTool("outline", {
   title: "File Outline",
-  description: "AST-based structural outline: functions, classes, interfaces with line ranges. 10-20 lines instead of 500 \u2014 95% token reduction. Use before reading large code files. NOT for .md/.json/.yaml \u2014 use read_file.",
+  description: "AST-based structural outline: functions, classes, interfaces with line ranges. Use before reading large code files. Not for .md/.json/.yaml.",
   inputSchema: z2.object({
     path: z2.string().describe("Source file path")
   }),
@@ -2548,7 +2578,7 @@ server.registerTool("verify", {
 });
 server.registerTool("directory_tree", {
   title: "Directory Tree",
-  description: "Compact directory tree with root .gitignore support (path-based rules, negation). Supports pattern glob to find files/dirs by name (like find -name). Use to understand repo structure or find specific files/dirs. Skips node_modules, .git, dist by default.",
+  description: "Directory tree with .gitignore support. Pattern glob to find files/dirs by name. Skips node_modules, .git, dist.",
   inputSchema: z2.object({
     path: z2.string().describe("Directory path"),
     pattern: z2.string().optional().describe('Glob filter on names (e.g. "*-mcp", "*.mjs"). Returns flat match list instead of tree'),
@@ -2583,7 +2613,7 @@ server.registerTool("get_file_info", {
 });
 server.registerTool("setup_hooks", {
   title: "Setup Hooks",
-  description: "Install or uninstall hex-line hooks in CLI agent settings. install: writes hooks to ~/.claude/settings.json, removes old per-project hooks. uninstall: removes hex-line hooks from global settings. Idempotent: re-running produces no changes if already in desired state.",
+  description: "Install or uninstall hex-line hooks in CLI agent settings. Idempotent.",
   inputSchema: z2.object({
     agent: z2.string().optional().describe('Target agent: "claude", "gemini", "codex", or "all" (default: "all")'),
     action: z2.string().optional().describe('"install" (default) or "uninstall"')
@@ -2599,7 +2629,7 @@ server.registerTool("setup_hooks", {
 });
 server.registerTool("changes", {
   title: "Semantic Diff",
-  description: "Compare file or directory against git ref (default: HEAD). For files: shows added/removed/modified symbols at AST level. For directories: lists changed files with insertions/deletions stats. Use to understand what changed before committing.",
+  description: "Compare file or directory against git ref (default: HEAD). Shows added/removed/modified symbols or file stats.",
   inputSchema: z2.object({
     path: z2.string().describe("File or directory path"),
     compare_against: z2.string().optional().describe('Git ref to compare against (default: "HEAD")')
@@ -2617,7 +2647,7 @@ server.registerTool("bulk_replace", {
   title: "Bulk Replace",
   description: "Search-and-replace across multiple files. Finds files by glob, applies ordered text replacements, returns per-file diffs. Use dry_run:true to preview. For single-file rename, set glob to the filename.",
   inputSchema: z2.object({
-    replacements: z2.string().describe('JSON array of {old, new} pairs: [{"old":"foo","new":"bar"}]'),
+    replacements: z2.union([z2.string(), replacementPairsSchema]).describe('JSON array of {old, new} pairs: [{"old":"foo","new":"bar"}]'),
     glob: z2.string().optional().describe('File glob (default: "**/*.{md,mjs,json,yml,ts,js}")'),
     path: z2.string().optional().describe("Root directory (default: cwd)"),
     dry_run: flexBool().describe("Preview without writing (default: false)"),
@@ -2627,8 +2657,14 @@ server.registerTool("bulk_replace", {
 }, async (rawParams) => {
   try {
     const params = coerceParams(rawParams);
-    const replacements = JSON.parse(params.replacements);
-    if (!Array.isArray(replacements) || !replacements.length) throw new Error("replacements: non-empty JSON array of {old, new} required");
+    const raw = params.replacements;
+    let replacementsInput;
+    try {
+      replacementsInput = typeof raw === "string" ? JSON.parse(raw) : raw;
+    } catch {
+      throw new Error('replacements: invalid JSON. Expected: [{"old":"text","new":"replacement"}]');
+    }
+    const replacements = replacementPairsSchema.parse(replacementsInput);
     const result = bulkReplace(
       params.path || process.cwd(),
       params.glob || "**/*.{md,mjs,json,yml,ts,js}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levnikolaevich/hex-line-mcp",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "mcpName": "io.github.levnikolaevich/hex-line-mcp",
   "type": "module",
   "description": "Hash-verified file editing MCP + token efficiency hook for AI coding agents. 11 tools: read, edit, write, grep, outline, verify, directory_tree, file_info, setup_hooks, changes, bulk_replace.",