@levnikolaevich/hex-line-mcp 1.28.0 → 1.29.0

package/README.md

@@ -462,7 +462,7 @@ FNV-1a accumulator over all line hashes in the range (little-endian byte feed).
 <details>
 <summary><b>Does it work without Claude Code?</b></summary>
 
-Yes. hex-line-mcp is a standard MCP server (stdio transport). It works with any MCP-compatible client -- Claude Code, Gemini CLI, Codex CLI, or custom integrations. Hook installation is Claude-specific; Gemini/Codex use MCP Tool Preferences guidance instead.
+Yes. hex-line-mcp is a standard MCP server (stdio transport). It works with any MCP-compatible client -- Claude Code, Codex CLI, or custom integrations. Hook installation is Claude-specific; Codex uses MCP Tool Preferences guidance instead.
 
 </details>
 

package/dist/server.mjs

@@ -1658,17 +1658,78 @@ import { statSync as statSync6, writeFileSync } from "node:fs";
 import { diffLines as diffLines2 } from "diff";
 
 // lib/edit-resolution.mjs
-function normalizeAnchoredEdits(edits) {
-  const anchored = [];
-  for (const edit of edits) {
-    if (edit.set_line || edit.replace_lines || edit.insert_after || edit.replace_between) {
-      anchored.push(edit);
-      continue;
-    }
+function badInput(message) {
+  const err = new Error(`BAD_INPUT: ${message}`);
+  err.code = "BAD_INPUT";
+  err.recovery = "Use canonical edit shapes with required string fields: set_line.anchor/new_text, insert_after.anchor/text, replace_lines.start_anchor/end_anchor/range_checksum/new_text, or replace_between.start_anchor/end_anchor/new_text.";
+  return err;
+}
+function requirePlainObject(value, path) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw badInput(`${path} must be an object`);
+  }
+}
+function requireString(value, path) {
+  if (typeof value !== "string") {
+    throw badInput(`${path} must be a string`);
+  }
+}
+function requireOptionalString(value, path) {
+  if (value !== void 0 && typeof value !== "string") {
+    throw badInput(`${path} must be a string when provided`);
+  }
+}
+function validateEditShape(edit) {
+  requirePlainObject(edit, "edit");
+  const kinds = ["set_line", "replace_lines", "insert_after", "replace_between"].filter((kind2) => edit[kind2] !== void 0);
+  if (kinds.length !== 1) {
     if (edit.replace) {
       throw new Error("REPLACE_REMOVED: replace is no longer supported in edit_file. Use set_line/replace_lines for single edits, bulk_replace tool for rename/refactor.");
     }
-    throw new Error(`BAD_INPUT: unknown edit type: ${JSON.stringify(edit)}`);
+    if (kinds.length === 0) throw badInput(`unknown edit type: ${JSON.stringify(edit)}`);
+    throw badInput(`exactly one edit type is allowed, got ${kinds.join(", ")}`);
+  }
+  const kind = kinds[0];
+  if (kind === "set_line") {
+    requirePlainObject(edit.set_line, "set_line");
+    requireString(edit.set_line.anchor, "set_line.anchor");
+    requireString(edit.set_line.new_text, "set_line.new_text");
+    return;
+  }
+  if (kind === "insert_after") {
+    requirePlainObject(edit.insert_after, "insert_after");
+    requireString(edit.insert_after.anchor, "insert_after.anchor");
+    requireString(edit.insert_after.text, "insert_after.text");
+    return;
+  }
+  if (kind === "replace_lines") {
+    requirePlainObject(edit.replace_lines, "replace_lines");
+    requireString(edit.replace_lines.start_anchor, "replace_lines.start_anchor");
+    requireString(edit.replace_lines.end_anchor, "replace_lines.end_anchor");
+    requireString(edit.replace_lines.range_checksum, "replace_lines.range_checksum");
+    requireString(edit.replace_lines.new_text, "replace_lines.new_text");
+    return;
+  }
+  requirePlainObject(edit.replace_between, "replace_between");
+  requireString(edit.replace_between.start_anchor, "replace_between.start_anchor");
+  requireString(edit.replace_between.end_anchor, "replace_between.end_anchor");
+  requireString(edit.replace_between.new_text, "replace_between.new_text");
+  requireOptionalString(edit.replace_between.range_checksum, "replace_between.range_checksum");
+  if (edit.replace_between.boundary_mode !== void 0 && !["inclusive", "exclusive"].includes(edit.replace_between.boundary_mode)) {
+    throw badInput('replace_between.boundary_mode must be "inclusive" or "exclusive"');
+  }
+}
+function normalizeAnchoredEdits(edits) {
+  if (!Array.isArray(edits)) {
+    throw badInput("edits must be a non-empty array");
+  }
+  if (edits.length === 0) {
+    throw badInput("edits must be a non-empty array");
+  }
+  const anchored = [];
+  for (const edit of edits) {
+    validateEditShape(edit);
+    anchored.push(edit);
   }
   return anchored;
 }
@@ -1832,12 +1893,16 @@ var REASON = {
 };
 
 // lib/edit.mjs
+function asLine(value) {
+  return typeof value === "string" ? value : String(value ?? "");
+}
 function restoreIndent(origLines, newLines) {
   if (!origLines.length || !newLines.length) return newLines;
-  const origIndent = origLines[0].match(/^\s*/)[0];
-  const newIndent = newLines[0].match(/^\s*/)[0];
-  if (origIndent === newIndent) return newLines;
-  return newLines.map((line) => {
+  const safeNewLines = newLines.map(asLine);
+  const origIndent = asLine(origLines[0]).match(/^\s*/)[0];
+  const newIndent = safeNewLines[0].match(/^\s*/)[0];
+  if (origIndent === newIndent) return safeNewLines;
+  return safeNewLines.map((line) => {
     if (!line.trim()) return line;
     if (line.startsWith(newIndent)) return origIndent + line.slice(newIndent.length);
     return line;
@@ -2815,8 +2880,8 @@ Recovery: read_file path ranges=["${csStart}-${csEnd}"], then retry edit with fr
   let boundaryEchoSkipped = false;
   const insertEnd = sliceStart + newLines.length;
   if (newLines.length > 0 && insertEnd < lines.length) {
-    const lastNew = newLines[newLines.length - 1].trim();
-    const firstAfter = lines[insertEnd].trim();
+    const lastNew = asLine(newLines[newLines.length - 1]).trim();
+    const firstAfter = asLine(lines[insertEnd]).trim();
     if (lastNew && lastNew === firstAfter) {
       if (isAmbiguousDelimiter(firstAfter)) {
         boundaryEchoSkipped = true;
@@ -2834,8 +2899,8 @@ Recovery: read_file path ranges=["${csStart}-${csEnd}"], then retry edit with fr
     }
   }
   if (newLines.length > 0 && sliceStart > 0) {
-    const firstNew = newLines[0].trim();
-    const lineBefore = lines[sliceStart - 1].trim();
+    const firstNew = asLine(newLines[0]).trim();
+    const lineBefore = asLine(lines[sliceStart - 1]).trim();
     if (firstNew && firstNew === lineBefore) {
       if (isAmbiguousDelimiter(lineBefore)) {
         boundaryEchoSkipped = true;
@@ -4967,7 +5032,7 @@ function errorResult(code, message, recovery, { large = false, extra = null } =
 }
 
 // server.mjs
-var version = true ? "1.28.0" : (await null).createRequire(import.meta.url)("./package.json").version;
+var version = true ? "1.29.0" : (await null).createRequire(import.meta.url)("./package.json").version;
 var STATUS_ENUM = z2.enum(STATUS_VALUES);
 var ERROR_SHAPE = z2.object({ code: z2.string(), message: z2.string(), recovery: z2.string() }).optional();
 var LINE_REPORT_KEYS = /* @__PURE__ */ new Set([

package/package.json

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