@levnikolaevich/hex-line-mcp 1.19.0 → 1.20.0

package/dist/hook.mjs

@@ -115,8 +115,8 @@ var REVERSE_TOOL_HINTS = {
   "mcp__hex-line__bulk_replace": "Edit (text rename/refactor across files inside an explicit root path)"
 };
 var TOOL_HINTS = {
-  Read: "mcp__hex-line__read_file (not Read). For writing: write_file (no prior Read needed)",
-  Edit: "mcp__hex-line__edit_file for revision-aware hash edits. Batch same-file hunks, carry base_revision, use replace_between for block rewrites",
+  Read: "mcp__hex-line__read_file (not Read). For structure-first: mcp__hex-line__outline then mcp__hex-line__read_file with ranges",
+  Edit: "mcp__hex-line__edit_file (not Edit). If you need hash anchors: mcp__hex-line__grep_search(output='content', edit_ready=true) first",
   Write: "mcp__hex-line__write_file (not Write). No prior Read needed",
   Grep: "mcp__hex-line__grep_search (not Grep). Params: output, literal, context_before, context_after, multiline",
   Glob: "mcp__hex-line__inspect_path (not Glob). Use pattern=... with an explicit path for project file discovery and name/path globbing",
@@ -133,7 +133,7 @@ var TOOL_HINTS = {
   changes: "mcp__hex-line__changes (git diff with change symbols)",
   bulk: "mcp__hex-line__bulk_replace with path=<project root> (multi-file search-replace)"
 };
-var DEFERRED_HINT = "If schemas not loaded: ToolSearch('+hex-line read edit')";
+var DEFERRED_HINT = "Run ToolSearch('+hex-line read edit') first if hex-line tools show InputValidationError.";
 var BASH_REDIRECTS = [
   { regex: /^(cat|type)\b/i, key: "cat", kind: "reader" },
   { regex: /^head\b/i, key: "head", kind: "reader" },
@@ -443,8 +443,8 @@ function handlePreToolUse(data) {
     const isPlanSafe = targetPath.includes("/.hex-skills/") || targetPath.includes(".hex-skills/") || targetPath.includes("/.claude/") || targetPath.includes(".claude/");
     if (!isPlanSafe) {
       block(
-        "PLAN_MODE: hex-line write tools are blocked during planning.",
-        "Use read-only tools: read_file, grep_search, outline, verify, inspect_path, changes."
+        "PLAN_MODE: You are in planning mode. Write your plan to the plan file, then call ExitPlanMode to get approval before making changes.",
+        "Do NOT try other write tools (Write, Edit, Bash). Only the plan file can be edited in plan mode. Finish planning first."
       );
     }
   }
@@ -463,13 +463,14 @@ function handlePreToolUse(data) {
     }
     if (toolName === "Read") {
       const ext = filePath ? extOf(filePath) : "";
-      const rangeHint = isPartialRead(toolInput) ? " Preserve the same offset/limit or ranges in read_file." : "";
-      const outlineHint = filePath && OUTLINEABLE_EXT.has(ext) ? `Use mcp__hex-line__outline(path="${filePath}") for structure, then mcp__hex-line__read_file(path="${filePath}") with ranges to read only what you need.${rangeHint}` : filePath ? `Use mcp__hex-line__read_file(path="${filePath}") with ranges or offset/limit.${rangeHint}` : "Use mcp__hex-line__inspect_path or mcp__hex-line__read_file";
-      redirect(outlineHint, "Use hex-line for project text-file reads to keep hashes, revision metadata, and graph hints in one flow.\n" + DEFERRED_HINT);
+      const rangeHint = isPartialRead(toolInput) ? " Preserve the same offset/limit or ranges." : "";
+      const outlineTip = filePath && OUTLINEABLE_EXT.has(ext) ? ` For structure-first discovery: mcp__hex-line__outline then mcp__hex-line__read_file with ranges.` : "";
+      const target = filePath ? `Use mcp__hex-line__read_file(path="${filePath}").${rangeHint}${outlineTip}` : "Use mcp__hex-line__read_file or mcp__hex-line__inspect_path.";
+      redirect(target, DEFERRED_HINT);
     }
     if (toolName === "Edit") {
-      const target = filePath ? `Use mcp__hex-line__grep_search or mcp__hex-line__read_file, then mcp__hex-line__edit_file with path="${filePath}"` : "Use mcp__hex-line__grep_search or mcp__hex-line__read_file, then mcp__hex-line__edit_file";
-      redirect(target, "Use hash-verified edits for project text files. Locate anchors/checksums first, then call edit_file once with batched edits.\n" + DEFERRED_HINT);
+      const target = filePath ? `Use mcp__hex-line__edit_file(path="${filePath}"). If you need hash anchors first: mcp__hex-line__grep_search(output="content", edit_ready=true).` : 'Use mcp__hex-line__edit_file. If you need hash anchors first: mcp__hex-line__grep_search(output="content", edit_ready=true).';
+      redirect(target, "Hash-verified edits for project text files.\n" + DEFERRED_HINT);
     }
     if (toolName === "Write") {
       const pathNote = filePath ? ` with path="${filePath}"` : "";
@@ -591,7 +592,7 @@ function handleSessionStart() {
     } catch {
     }
   }
-  const msg = styleActive ? "Hex-line MCP available. Output style active.\n<hex-line_instructions>\n  <deferred_loading>If hex-line schemas not loaded, run: ToolSearch('+hex-line read edit')</deferred_loading>\n  <note>Follow the active hex-line output style for primary tool choices.</note>\n  <exceptions>Built-in tools stay OK for images, PDFs, notebooks, and text paths outside the current project root.</exceptions>\n</hex-line_instructions>" : "Hex-line MCP available.\n<hex-line_instructions>\n  <deferred_loading>If hex-line schemas not loaded, run: ToolSearch('+hex-line read edit')</deferred_loading>\n  <exploration>\n    <rule>Use outline for structure (code + markdown), not Read. ~10-20 lines vs hundreds.</rule>\n    <rule>Use read_file with offset/limit or ranges for targeted reads.</rule>\n    <rule>Use grep_search before editing to get hash anchors.</rule>\n  </exploration>\n  <editing>\n    <path name='surgical'>grep_search \u2192 edit_file (fastest: hash-verified, no full read needed)</path>\n    <path name='exploratory'>outline \u2192 read_file (ranges) \u2192 edit_file with base_revision</path>\n    <path name='multi-file'>bulk_replace(path=&quot;&lt;project root&gt;&quot;) for text rename/refactor across files</path>\n  </editing>\n  <tips>\n    <tip>Auto-fill path from the active file or project root. Read-only tools may inspect explicit temp-file paths outside the repo. Mutating tools stay project-scoped unless you intentionally pass allow_external=true.</tip>\n    <tip>Never invent range_checksum. Copy it from fresh read_file or grep_search blocks.</tip>\n    <tip>Prefer set_line or insert_after for small local changes and replace_between for larger bounded rewrites.</tip>\n    <tip>Carry revision from read_file into base_revision on edit_file.</tip>\n    <tip>If edit returns CONFLICT, call verify \u2014 only reread when STALE.</tip>\n    <tip>Avoid large first-pass edit batches. Start with 1-2 hunks, then continue from the returned revision.</tip>\n    <tip>Use write_file for new files (no prior Read needed).</tip>\n    <tip>Use inspect_path(pattern=...) for project file discovery and name/path globbing.</tip>\n  </tips>\n  <exceptions>Built-in tools stay OK for images, PDFs, notebooks, and text paths outside the current project root.</exceptions>\n</hex-line_instructions>";
+  const msg = styleActive ? "Hex-line MCP available. Output style active.\n<hex-line_instructions>\n  <deferred_loading>If hex-line schemas not loaded, run: ToolSearch('+hex-line read edit')</deferred_loading>\n  <tool_map>Read\u2192mcp__hex-line__read_file, Edit\u2192mcp__hex-line__edit_file, Write\u2192mcp__hex-line__write_file, Grep\u2192mcp__hex-line__grep_search, Glob\u2192mcp__hex-line__inspect_path</tool_map>\n  <note>Follow the active hex-line output style for primary tool choices.</note>\n  <exceptions>Built-in tools stay OK for images, PDFs, notebooks, and text paths outside the current project root.</exceptions>\n</hex-line_instructions>" : "Hex-line MCP available.\n<hex-line_instructions>\n  <deferred_loading>If hex-line schemas not loaded, run: ToolSearch('+hex-line read edit')</deferred_loading>\n  <exploration>\n    <rule>Use outline for structure (code + markdown), not Read. ~10-20 lines vs hundreds.</rule>\n    <rule>Use read_file with offset/limit or ranges for targeted reads.</rule>\n    <rule>Use grep_search before editing to get hash anchors.</rule>\n  </exploration>\n  <editing>\n    <path name='surgical'>grep_search \u2192 edit_file (fastest: hash-verified, no full read needed)</path>\n    <path name='exploratory'>outline \u2192 read_file (ranges) \u2192 edit_file with base_revision</path>\n    <path name='multi-file'>bulk_replace(path=&quot;&lt;project root&gt;&quot;) for text rename/refactor across files</path>\n  </editing>\n  <tips>\n    <tip>Auto-fill path from the active file or project root. Read-only tools may inspect explicit temp-file paths outside the repo. Mutating tools stay project-scoped unless you intentionally pass allow_external=true.</tip>\n    <tip>Never invent range_checksum. Copy it from fresh read_file or grep_search blocks.</tip>\n    <tip>Prefer set_line or insert_after for small local changes and replace_between for larger bounded rewrites.</tip>\n    <tip>Carry revision from read_file into base_revision on edit_file.</tip>\n    <tip>If edit returns CONFLICT, call verify \u2014 only reread when STALE.</tip>\n    <tip>Avoid large first-pass edit batches. Start with 1-2 hunks, then continue from the returned revision.</tip>\n    <tip>Use write_file for new files (no prior Read needed).</tip>\n    <tip>Use inspect_path(pattern=...) for project file discovery and name/path globbing.</tip>\n  </tips>\n  <exceptions>Built-in tools stay OK for images, PDFs, notebooks, and text paths outside the current project root.</exceptions>\n</hex-line_instructions>";
   safeExit(1, JSON.stringify({ systemMessage: msg }), 0);
 }
 function handleConfigChange(data) {

package/dist/server.mjs

@@ -2579,6 +2579,25 @@ function applyReplaceBetweenEdit(edit, ctx) {
     return null;
   }
   replaceLogicalRange(lines, lineEndings, sliceStart, sliceStart + removeCount - 1, newLines, defaultEol);
+  const insertEnd = sliceStart + newLines.length;
+  if (newLines.length > 0 && insertEnd < lines.length) {
+    const lastNew = newLines[newLines.length - 1].trim();
+    const firstAfter = lines[insertEnd].trim();
+    if (lastNew && lastNew === firstAfter) {
+      lines.splice(insertEnd, 1);
+      lineEndings.splice(insertEnd, 1);
+      ctx.corrections.push({ type: "tail_echo", line: insertEnd + 1, content: firstAfter });
+    }
+  }
+  if (newLines.length > 0 && sliceStart > 0) {
+    const firstNew = newLines[0].trim();
+    const lineBefore = lines[sliceStart - 1].trim();
+    if (firstNew && firstNew === lineBefore) {
+      lines.splice(sliceStart - 1, 1);
+      lineEndings.splice(sliceStart - 1, 1);
+      ctx.corrections.push({ type: "head_echo", line: sliceStart, content: lineBefore });
+    }
+  }
   return null;
 }
 function editFile(filePath, edits, opts = {}) {
@@ -2721,7 +2740,8 @@ ${snip.text}`;
     locateOrConflict,
     opts,
     origLines,
-    staleRevision
+    staleRevision,
+    corrections: []
   };
   const batchConflicts = collectBatchConflicts({
     edits: anchored,
@@ -2905,7 +2925,7 @@ ${sections.join("\n")}`;
   if (displayDiff) payloadKinds.push("diff");
   const semanticFactCount = semanticImpacts.reduce((sum, impact) => sum + (impact.facts?.length || 0), 0);
   const summaryLines = [
-    `summary: lines_changed=${changedSpan} diff_entries=${diffEntryCount} lines_after=${lines.length}`,
+    `summary: lines_changed=${changedSpan} diff_entries=${diffEntryCount} lines_after=${lines.length}${editContext.corrections.length > 0 ? ` boundary_echo_stripped=${editContext.corrections.length}` : ``}`,
     `payload_sections: ${payloadSections(payloadKinds)}`,
     `graph_enrichment: ${graphEnrichment}`,
     `semantic_impact_count: ${semanticImpacts.length}`,
@@ -4013,8 +4033,8 @@ var NODE_COMMAND = process.execPath.replace(/\\/g, "/");
 var HOOK_COMMAND = `"${NODE_COMMAND}" "${STABLE_HOOK_PATH}"`;
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname = dirname4(__filename);
-var SOURCE_HOOK = resolve7(__dirname, "..", "hook.mjs");
 var DIST_HOOK = resolve7(__dirname, "hook.mjs");
+var BUILT_HOOK = resolve7(__dirname, "..", "dist", "hook.mjs");
 var SOURCE_STYLE = resolve7(__dirname, "..", "output-style.md");
 var INSTALLED_STYLE = resolve7(homedir(), ".claude", "output-styles", "hex-line.md");
 var HOOK_SIGNATURE = "hex-line";
@@ -4126,8 +4146,8 @@ function syncOutputStyle() {
   return true;
 }
 function autoSync() {
-  const hookSource = existsSync6(DIST_HOOK) ? DIST_HOOK : SOURCE_HOOK;
-  if (!existsSync6(hookSource)) return;
+  const hookSource = existsSync6(DIST_HOOK) ? DIST_HOOK : existsSync6(BUILT_HOOK) ? BUILT_HOOK : null;
+  if (!hookSource) return;
   const changes = [];
   const srcHook = safeRead(hookSource);
   const dstHook = safeRead(STABLE_HOOK_PATH);
@@ -4763,7 +4783,7 @@ function errorResult(code, message, recovery, { large = false, extra = null } =
 }
 
 // server.mjs
-var version = true ? "1.19.0" : (await null).createRequire(import.meta.url)("./package.json").version;
+var version = true ? "1.20.0" : (await null).createRequire(import.meta.url)("./package.json").version;
 var STATUS_ENUM = z2.enum(["OK", "ERROR", "AUTO_REBASED", "CONFLICT", "STALE", "INVALID", "NO_CHANGES", "CHANGED", "UNSUPPORTED"]);
 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.19.0",
+  "version": "1.20.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.",
@@ -23,7 +23,8 @@
     "scenarios": "node scenarios/index.mjs",
     "scenarios:diagnostic": "node scenarios/index.mjs --diagnostics",
     "scenarios:diagnostic:graph": "node scenarios/index.mjs --diagnostics --with-graph",
-    "check": "node --check server.mjs && node --check hook.mjs"
+    "check": "node --check server.mjs && node --check hook.mjs",
+    "prepare": "npm run build"
   },
   "_dep_notes": {
     "web-tree-sitter": "Tracks the latest stable runtime together with the repo-owned first-party grammar WASM bundle. Keep runtime upgrades coupled to grammar load/parse validation across Windows, macOS, and Linux.",
@@ -39,7 +40,7 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "better-sqlite3": "^12.8.0"
+    "better-sqlite3": "^12.9.0"
   },
   "author": "Lev Nikolaevich <https://github.com/levnikolaevich>",
   "license": "MIT",