@levnikolaevich/hex-line-mcp 1.21.1 → 1.23.0

package/dist/hook.mjs

@@ -54,7 +54,7 @@ function normalizeOutput(text, opts = {}) {
 }
 
 // hook.mjs
-import { readFileSync, writeSync, writeFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from "node:fs";
+import { readFileSync, writeSync } from "node:fs";
 import { resolve } from "node:path";
 import { homedir } from "node:os";
 
@@ -361,53 +361,6 @@ function extractBashText(response) {
   }
   return "";
 }
-var ERROR_RECOVERY_DIR = ".hex-skills/logs/error_recovery";
-var ERROR_RECOVERY_MAX_FILES = 20;
-var ERROR_RECOVERY_MAX_BYTES = 1024 * 1024;
-function isBashFailure(response) {
-  if (!response || typeof response !== "object") return false;
-  if (response.is_error === true) return true;
-  if (response.interrupted === true) return true;
-  if (typeof response.exit_code === "number" && response.exit_code !== 0) return true;
-  return false;
-}
-function saveErrorArtifact(rawText, commandType, command, cwd) {
-  try {
-    const dir = resolve(cwd, ERROR_RECOVERY_DIR);
-    mkdirSync(dir, { recursive: true });
-    try {
-      const entries = readdirSync(dir).filter((name) => name.endsWith(".log")).map((name) => {
-        try {
-          return { name, mtime: statSync(resolve(dir, name)).mtimeMs };
-        } catch {
-          return null;
-        }
-      }).filter((e) => e !== null).sort((a, b) => b.mtime - a.mtime);
-      for (const entry of entries.slice(ERROR_RECOVERY_MAX_FILES - 1)) {
-        try {
-          unlinkSync(resolve(dir, entry.name));
-        } catch {
-        }
-      }
-    } catch {
-    }
-    let content = `# command: ${String(command).slice(0, 500)}
-# type: ${commandType}
-# timestamp: ${(/* @__PURE__ */ new Date()).toISOString()}
-
-${rawText}`;
-    if (Buffer.byteLength(content, "utf-8") > ERROR_RECOVERY_MAX_BYTES) {
-      content = content.slice(0, ERROR_RECOVERY_MAX_BYTES) + "\n[TRUNCATED at 1 MB]";
-    }
-    const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const fileName = `${ts}_${commandType}.log`;
-    const filePath = resolve(dir, fileName);
-    writeFileSync(filePath, content, "utf-8");
-    return `${ERROR_RECOVERY_DIR}/${fileName}`;
-  } catch {
-    return null;
-  }
-}
 var _hexLineDisabled = null;
 function isHexLineDisabled(configPath) {
   if (_hexLineDisabled !== null) return _hexLineDisabled;
@@ -600,18 +553,10 @@ function handlePostToolUse(data) {
   if (!rawText) {
     process.exit(0);
   }
-  const failure = isBashFailure(data.tool_response);
   const type = detectCommandType(command);
-  let recoveryPath = null;
-  if (failure) {
-    recoveryPath = saveErrorArtifact(rawText, type, command, process.cwd());
-  }
   const lines = rawText.split("\n");
   const originalCount = lines.length;
   if (originalCount < HOOK_OUTPUT_POLICY.lineThreshold) {
-    if (recoveryPath) {
-      safeExit(2, `Full output preserved at: ${recoveryPath}`, 2);
-    }
     process.exit(0);
   }
   const filtered = normalizeOutput(lines.join("\n"), {
@@ -620,7 +565,7 @@ function handlePostToolUse(data) {
   });
   const filteredCount = filtered.split("\n").length;
   const header = `RTK FILTERED: ${type} (${originalCount} lines -> ${filteredCount} lines)`;
-  const outputParts = [
+  const output = [
     "=".repeat(50),
     header,
     "=".repeat(50),
@@ -628,42 +573,11 @@ function handlePostToolUse(data) {
     filtered,
     "",
     "-".repeat(50),
-    `Original: ${originalCount} lines | Filtered: ${filteredCount} lines`
-  ];
-  if (recoveryPath) {
-    outputParts.push(`Full output preserved at: ${recoveryPath}`);
-  }
-  outputParts.push("=".repeat(50));
-  const output = outputParts.join("\n");
+    `Original: ${originalCount} lines | Filtered: ${filteredCount} lines`,
+    "=".repeat(50)
+  ].join("\n");
   safeExit(2, output, 2);
 }
-function handlePostToolUseFailure(data) {
-  const toolName = data.tool_name || "";
-  if (toolName !== "Bash") {
-    process.exit(0);
-  }
-  const toolInput = data.tool_input || {};
-  const command = toolInput.command || "";
-  const error = typeof data.error === "string" ? data.error : "";
-  const isInterrupt = data.is_interrupt === true;
-  if (!command && !error) {
-    process.exit(0);
-  }
-  const type = detectCommandType(command);
-  const body = `error: ${error}
-is_interrupt: ${isInterrupt}`;
-  const recoveryPath = saveErrorArtifact(body, type, command, process.cwd());
-  if (!recoveryPath) {
-    process.exit(0);
-  }
-  const output = {
-    hookSpecificOutput: {
-      hookEventName: "PostToolUseFailure",
-      additionalContext: `Failure metadata logged at: ${recoveryPath}`
-    }
-  };
-  safeExit(1, JSON.stringify(output), 0);
-}
 function handleSessionStart() {
   const settingsFiles = [
     resolve(process.cwd(), ".claude/settings.local.json"),
@@ -721,7 +635,6 @@ if (_norm(process.argv[1]) === _norm(fileURLToPath(import.meta.url))) {
       if (event === "SessionStart") handleSessionStart();
       else if (event === "PreToolUse") handlePreToolUse(data);
       else if (event === "PostToolUse") handlePostToolUse(data);
-      else if (event === "PostToolUseFailure") handlePostToolUseFailure(data);
       else if (event === "PermissionDenied") handlePermissionDenied(data);
       else process.exit(0);
     } catch {

package/dist/server.mjs

@@ -202,6 +202,13 @@ function readText(filePath) {
 
 // lib/security.mjs
 var MAX_FILE_SIZE = 10 * 1024 * 1024;
+var EXTERNAL_SAFE_FOLDERS = [
+  ".hex-skills/",
+  ".claude/"
+];
+function isInExternalSafeFolder(absPath) {
+  return EXTERNAL_SAFE_FOLDERS.some((folder) => absPath.includes(folder));
+}
 function normalizePath(p) {
   if (process.platform === "win32") {
     if (p === "/tmp" || p.startsWith("/tmp/")) {
@@ -234,6 +241,7 @@ function assertProjectScopedPath(filePath, { allowExternal = false } = {}) {
   if (!filePath) throw new Error("Empty file path");
   const abs = resolveInputPath(filePath);
   if (allowExternal) return abs;
+  if (isInExternalSafeFolder(abs)) return abs;
   const projectRoot = resolve(process.cwd()).replace(/\\/g, "/");
   if (isWithinRoot(projectRoot, abs)) return abs;
   throw new Error(
@@ -392,6 +400,57 @@ function getGraphDB(filePath, { allowStale = false } = {}) {
     return null;
   }
 }
+function diagnoseGraph(filePath) {
+  if (_driverUnavailable) return { reason: "driver_missing" };
+  try {
+    const projectRoot = findProjectRoot(filePath);
+    if (!projectRoot) return { reason: "no_project_root" };
+    const dbPath = join3(projectRoot, ".hex-skills/codegraph", "index.db");
+    if (!existsSync2(dbPath)) return { reason: "index_missing", projectRoot };
+    if (_dbs.has(dbPath)) {
+      const cached = _dbs.get(dbPath);
+      if (!isFilePathFresh(cached, projectRoot, filePath)) {
+        return { reason: "stale", projectRoot };
+      }
+      return { reason: "ok", projectRoot };
+    }
+    const require2 = createRequire(import.meta.url);
+    const Database = require2("better-sqlite3");
+    const db = new Database(dbPath, { readonly: true });
+    if (!validateContract(db)) {
+      db.close();
+      return { reason: "contract_mismatch", projectRoot };
+    }
+    if (!isFilePathFresh(db, projectRoot, filePath)) {
+      db.close();
+      return { reason: "stale", projectRoot };
+    }
+    _dbs.set(dbPath, db);
+    return { reason: "ok", projectRoot };
+  } catch {
+    _driverUnavailable = true;
+    return { reason: "driver_missing" };
+  }
+}
+function graphUnavailableHint(filePath) {
+  const { reason, projectRoot } = diagnoseGraph(filePath);
+  if (reason === "ok") return [];
+  const at = projectRoot ? ` at ${projectRoot.replace(/\\/g, "/")}` : "";
+  switch (reason) {
+    case "driver_missing":
+      return ["graph_enrichment: unavailable", "graph_fix: install better-sqlite3 in hex-line-mcp package"];
+    case "no_project_root":
+      return ["graph_enrichment: unavailable", "graph_fix: file is outside any project root (no package.json / pyproject.toml / .git marker)"];
+    case "index_missing":
+      return ["graph_enrichment: unavailable", `graph_fix: run mcp__hex-graph__index_project${at}`];
+    case "contract_mismatch":
+      return ["graph_enrichment: unavailable", `graph_fix: index built by incompatible hex-graph version; re-run mcp__hex-graph__index_project${at}`];
+    case "stale":
+      return ["graph_enrichment: unavailable", `graph_fix: file modified after last index; re-run mcp__hex-graph__index_project${at} or wait for background refresh`];
+    default:
+      return ["graph_enrichment: unavailable"];
+  }
+}
 function validateContract(db) {
   try {
     for (const viewName of REQUIRED_VIEWS) {
@@ -1259,7 +1318,7 @@ function serializeSearchBlock(block, opts = {}) {
   }
   if (block.meta.summary) lines.push(`summary: ${block.meta.summary}`);
   lines.push(...renderMetaLines(Object.fromEntries(
-    Object.entries(block.meta).filter(([key]) => key !== "matchLines" && key !== "summary")
+    Object.entries(block.meta).filter(([key]) => key !== "matchLines" && key !== "summary" && key !== "graphScore")
   )));
   lines.push(...block.entries.map((entry) => serializeSearchEntry(entry, opts)));
   lines.push(`checksum: ${block.checksum}`);
@@ -1893,8 +1952,6 @@ retry_edit: ${entry.retry_edit}`;
   if (entry.remapped_refs) msg += `
 remapped_refs: ${entry.remapped_refs}`;
   msg += `
-summary: ${entry.summary}`;
-  msg += `
 snippet: ${entry.snippet.range}
 ${entry.snippet.text}`;
   return msg;
@@ -1929,8 +1986,7 @@ function buildSingleConflictReport({
 function renderSingleConflictReport(report) {
   let msg = `status: ${report.status}
 reason: ${report.reason}
-revision: ${report.revision}
-file: ${report.file}`;
+revision: ${report.revision}`;
   if (report.path) msg += `
 path: ${report.path}`;
   if (report.changed_ranges) msg += `
@@ -1950,8 +2006,6 @@ retry_plan: ${report.retry_plan}`;
   if (report.remapped_refs) msg += `
 remapped_refs: ${report.remapped_refs}`;
   msg += `
-summary: ${report.summary}`;
-  msg += `
 snippet: ${report.snippet.range}
 ${report.snippet.text}`;
   return msg;
@@ -2005,12 +2059,11 @@ function buildSuggestedReadCall(filePath, recoveryRanges) {
     }
   });
 }
-function buildRetryPlan(filePath, { recoveryRanges = [], retryEdit = null, retryEdits = null } = {}) {
+function buildRetryPlan(filePath, { retryEdit = null, retryEdits = null } = {}) {
   if (!filePath) return null;
   const steps = [];
   const parsedRetryEdits = Array.isArray(retryEdits) ? retryEdits.map(parseRetryEdit).filter(Boolean) : [];
   const parsedRetryEdit = parsedRetryEdits.length === 0 ? parseRetryEdit(retryEdit) : null;
-  const dedupedRanges = dedupeRanges(recoveryRanges);
   if (parsedRetryEdits.length > 0) {
     steps.push({
       tool: "mcp__hex-line__edit_file",
@@ -2029,14 +2082,6 @@ function buildRetryPlan(filePath, { recoveryRanges = [], retryEdit = null, retry
         conflict_policy: "conservative"
       }
     });
-  } else if (dedupedRanges.length > 0) {
-    steps.push({
-      tool: "mcp__hex-line__read_file",
-      arguments: {
-        path: filePath,
-        ranges: dedupedRanges
-      }
-    });
   }
   if (steps.length === 0) return null;
   return JSON.stringify({ steps });
@@ -2119,7 +2164,7 @@ function buildRetryEdit(edit, lines, options = {}) {
 function buildBatchConflictMessage({
   filePath,
   revision,
-  fileChecksum,
+  fileChecksum: _fileChecksum,
   lines,
   changedRanges,
   conflicts
@@ -2147,7 +2192,6 @@ function buildBatchConflictMessage({
   let msg = `status: ${STATUS.CONFLICT}
 reason: ${REASON.BATCH_CONFLICT}
 revision: ${revision}
-file: ${fileChecksum}
 edit_conflicts: ${conflicts.length}`;
   if (filePath) msg += `
 path: ${filePath}`;
@@ -2629,8 +2673,7 @@ function editFile(filePath, edits, opts = {}) {
     const nextAction = deriveNextAction({ retryEdit, suggestedReadCall });
     let msg2 = `status: ${STATUS.CONFLICT}
 reason: ${reason}
-revision: ${currentSnapshot.revision}
-file: ${currentSnapshot.fileChecksum}`;
+revision: ${currentSnapshot.revision}`;
     if (filePath) msg2 += `
 path: ${filePath}`;
     if (staleRevision && hasBaseSnapshot) msg2 += `
@@ -2648,8 +2691,6 @@ suggested_read_call: ${suggestedReadCall}`;
     if (retryPlan) msg2 += `
 retry_plan: ${retryPlan}`;
     msg2 += `
-summary: ${summarizeConflictDetails(details)}`;
-    msg2 += `
 snippet: ${snip.start}-${snip.end}
 ${snip.text}`;
     return new Error(msg2);
@@ -2804,21 +2845,16 @@ ${snip.text}`;
   if (opts.dryRun) {
     let msg2 = `status: ${autoRebased ? STATUS.AUTO_REBASED : STATUS.OK}
 reason: ${REASON.DRY_RUN_PREVIEW}
-revision: ${currentSnapshot.revision}
-file: ${currentSnapshot.fileChecksum}`;
+revision: ${currentSnapshot.revision}`;
     if (staleRevision && hasBaseSnapshot) msg2 += `
 changed_ranges: ${describeChangedRanges(changedRanges)}`;
     msg2 += `
 summary: lines_changed=${changedSpan} diff_entries=${diffEntryCount} lines_after=${lines.length}`;
     msg2 += `
-next_action: ${ACTION.KEEP_USING}`;
-    msg2 += `
 payload_sections: ${payloadSections(displayDiff ? ["diff"] : [])}`;
-    msg2 += "\ngraph_enrichment: unavailable";
-    msg2 += "\nsemantic_impact_count: 0";
-    msg2 += "\nsemantic_fact_count: 0";
-    msg2 += "\nclone_warning_count: 0";
-    msg2 += "\nprovenance_summary: edit_protocol=snapshot+anchors graph=unavailable";
+    const hint = graphUnavailableHint(real);
+    if (hint.length > 0) msg2 += `
+${hint.join("\n")}`;
     msg2 += `
 Dry run: ${filePath} would change (${lines.length} lines)`;
     if (displayDiff) msg2 += `
@@ -2834,23 +2870,23 @@ ${displayDiff}
   const nextSnapshot = rememberSnapshot(real, content, { mtimeMs: nextStat.mtimeMs, size: nextStat.size });
   let msg = `status: ${autoRebased ? STATUS.AUTO_REBASED : STATUS.OK}
 reason: ${autoRebased ? REASON.EDIT_AUTO_REBASED : REASON.EDIT_APPLIED}
-revision: ${nextSnapshot.revision}
-file: ${nextSnapshot.fileChecksum}`;
+revision: ${nextSnapshot.revision}`;
   if (autoRebased && staleRevision && hasBaseSnapshot) {
     msg += `
 changed_ranges: ${describeChangedRanges(changedRanges)}`;
-  }
-  msg += `
+    msg += `
 next_action: ${ACTION.KEEP_USING}`;
+  }
   if (remaps.length > 0) {
     msg += `
 remapped_refs:
 ${remaps.map(({ from, to }) => `${from} -> ${to}`).join("\n")}`;
   }
   let hasPostEditBlock = false;
-  let graphEnrichment = "unavailable";
   let semanticImpacts = [];
   let cloneWarnings = [];
+  let graphDbAvailable = false;
+  let graphFresh = true;
   msg += `
 Updated ${filePath} (${lines.length} lines)`;
   if (fullDiff && minLine <= maxLine) {
@@ -2877,7 +2913,8 @@ ${serializeReadBlock(block)}`;
     const db = getGraphDB(real, { allowStale: true });
     const relFile = db ? getRelativePath(real) : null;
     if (db && relFile && fullDiff && minLine <= maxLine) {
-      graphEnrichment = "available";
+      graphDbAvailable = true;
+      graphFresh = ensureGraphFreshForFile(db, real);
       semanticImpacts = semanticImpact(db, relFile, minLine, maxLine);
       if (semanticImpacts.length > 0) {
         const sections = semanticImpacts.map((impact) => {
@@ -2910,7 +2947,7 @@ ${sections.join("\n")}`;
       }
       cloneWarnings = cloneWarning(db, relFile, minLine, maxLine);
       if (cloneWarnings.length > 0) {
-        const list = cloneWarnings.map((c) => `${c.file}:${c.line}`).join(", ");
+        const list = cloneWarnings.map((c) => `${c.file}:${c.line}${c.cloneType ? ` (${c.cloneType})` : ""}`).join(", ");
         msg += `
 
 \u26A0 ${cloneWarnings.length} clone(s): ${list}`;
@@ -2918,21 +2955,18 @@ ${sections.join("\n")}`;
     }
   } catch {
   }
+  if (!graphFresh) msg += "\ngraph_fresh: stale";
   const payloadKinds = [];
   if (hasPostEditBlock) payloadKinds.push("post_edit");
   if (semanticImpacts.length > 0) payloadKinds.push("semantic_impact");
   if (cloneWarnings.length > 0) payloadKinds.push("clone_warning");
   if (displayDiff) payloadKinds.push("diff");
-  const semanticFactCount = semanticImpacts.reduce((sum, impact) => sum + (impact.facts?.length || 0), 0);
-  const summaryLines = [
+  const summaryLineParts = [
     `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}`,
-    `semantic_fact_count: ${semanticFactCount}`,
-    `clone_warning_count: ${cloneWarnings.length}`,
-    `provenance_summary: edit_protocol=snapshot+anchors graph=${graphEnrichment === "available" ? "hex_line_contract" : "unavailable"}`
-  ].join("\n");
+    `payload_sections: ${payloadSections(payloadKinds)}`
+  ];
+  if (!graphDbAvailable) summaryLineParts.push(...graphUnavailableHint(real));
+  const summaryLines = summaryLineParts.join("\n");
   msg = msg.replace(`
 Updated ${filePath} (${lines.length} lines)`, `
 ${summaryLines}
@@ -4050,10 +4084,6 @@ var CLAUDE_HOOKS = {
   PostToolUse: {
     matcher: "Bash",
     hooks: [{ type: "command", command: HOOK_COMMAND, timeout: 10 }]
-  },
-  PostToolUseFailure: {
-    matcher: "Bash",
-    hooks: [{ type: "command", command: HOOK_COMMAND, timeout: 5 }]
   }
 };
 function readJson(filePath) {
@@ -4114,6 +4144,15 @@ function writeHooksToFile(settingsPath) {
       changed = true;
     }
   }
+  for (const event of Object.keys(config.hooks)) {
+    if (event in CLAUDE_HOOKS) continue;
+    if (!Array.isArray(config.hooks[event])) continue;
+    const idx = findEntryByCommand(config.hooks[event]);
+    if (idx < 0) continue;
+    config.hooks[event].splice(idx, 1);
+    if (config.hooks[event].length === 0) delete config.hooks[event];
+    changed = true;
+  }
   if (changed) writeJson(settingsPath, config);
   return changed;
 }
@@ -4433,12 +4472,6 @@ async function semanticGitDiff(targetPath, { baseRef = "HEAD", headRef = null }
 }
 
 // lib/changes.mjs
-function graphEnrichmentState(db) {
-  return db ? "available" : "unavailable";
-}
-function provenanceSummary(semanticDiffState, db) {
-  return `semantic_diff=${semanticDiffState} graph=${db ? "hex_line_contract" : "unavailable"}`;
-}
 function payloadSections2(sections) {
   return sections.length > 0 ? sections.join(",") : "summary_only";
 }
@@ -4483,7 +4516,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
   if (statSync11(real).isDirectory()) {
     const db2 = getGraphDB(join6(real, "__hex-line_probe__"));
     const diff2 = await semanticGitDiff(real, { baseRef: compareAgainst });
-    const graphEnrichment2 = graphEnrichmentState(db2);
+    const graphHint2 = graphUnavailableHint(join6(real, "__hex-line_probe__"));
     if (diff2.summary.changed_file_count === 0) {
       return [
         "status: NO_CHANGES",
@@ -4492,16 +4525,9 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
         `compare_against: ${compareAgainst}`,
         "scope: directory",
         "summary: changed_files=0",
-        `next_action: ${ACTION.NO_ACTION}`,
-        `graph_enrichment: ${graphEnrichment2}`,
-        "risk_summary_count: 0",
-        "removed_api_warning_count: 0",
-        `payload_sections: ${payloadSections2([])}`,
-        `provenance_summary: ${provenanceSummary("clean", db2)}`
+        ...graphHint2
       ].join("\n");
     }
-    const supportedCount = diff2.changed_files.filter((entry) => entry.semantic_supported).length;
-    const semanticDiffState = supportedCount === 0 ? "unsupported" : supportedCount === diff2.changed_files.length ? "semantic" : "mixed";
     let emittedRiskCount = 0;
     let emittedRemovedApiWarnings = 0;
     const sectionKinds2 = ["files"];
@@ -4513,7 +4539,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
       "scope: directory",
       `summary: changed_files=${diff2.summary.changed_file_count}`,
       `next_action: ${ACTION.INSPECT_FILE}`,
-      `graph_enrichment: ${graphEnrichment2}`,
+      ...graphHint2,
       ""
     ];
     for (const file2 of diff2.changed_files) {
@@ -4535,20 +4561,15 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
     }
     if (emittedRiskCount > 0) sectionKinds2.push("risk_summary");
     if (emittedRemovedApiWarnings > 0) sectionKinds2.push("removed_api_warning");
-    sections.splice(
-      8,
-      0,
-      `risk_summary_count: ${emittedRiskCount}`,
-      `removed_api_warning_count: ${emittedRemovedApiWarnings}`,
-      `payload_sections: ${payloadSections2(sectionKinds2)}`,
-      `provenance_summary: ${provenanceSummary(semanticDiffState, db2)}`
-    );
+    const spliceLines = [];
+    if (sectionKinds2.length > 0) spliceLines.push(`payload_sections: ${payloadSections2(sectionKinds2)}`);
+    sections.splice(7 + graphHint2.length, 0, ...spliceLines);
     return sections.join("\n");
   }
   const db = getGraphDB(real);
   const diff = await semanticGitDiff(real, { baseRef: compareAgainst });
   const file = diff.changed_files[0];
-  const graphEnrichment = graphEnrichmentState(db);
+  const graphHint = graphUnavailableHint(real);
   if (!file) {
     return [
       "status: NO_CHANGES",
@@ -4557,12 +4578,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
       `compare_against: ${compareAgainst}`,
       "scope: file",
       "summary: added=0 removed=0 modified=0",
-      `next_action: ${ACTION.NO_ACTION}`,
-      `graph_enrichment: ${graphEnrichment}`,
-      "risk_summary_count: 0",
-      "removed_api_warning_count: 0",
-      `payload_sections: ${payloadSections2([])}`,
-      `provenance_summary: ${provenanceSummary("clean", db)}`
+      ...graphHint
     ].join("\n");
   }
   if (!file.semantic_supported) {
@@ -4574,11 +4590,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
       "scope: file",
       `summary: semantic diff unavailable for ${file.extension} files`,
       `next_action: ${ACTION.INSPECT_RAW_DIFF}`,
-      `graph_enrichment: ${graphEnrichment}`,
-      "risk_summary_count: 0",
-      "removed_api_warning_count: 0",
-      `payload_sections: ${payloadSections2([])}`,
-      `provenance_summary: ${provenanceSummary("unsupported", db)}`
+      ...graphHint
     ].join("\n");
   }
   const relFile = getRelativePath(real) || file.path?.replace(/\\/g, "/");
@@ -4592,9 +4604,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
     `compare_against: ${compareAgainst}`,
     "scope: file",
     `summary: ${symbolCountSummary(file)}`,
-    `graph_enrichment: ${graphEnrichment}`,
-    `risk_summary_count: ${riskLines.length}`,
-    `removed_api_warning_count: ${removedApiWarnings.length}`
+    ...graphHint
   ];
   if (file.added_symbols.length) {
     sectionKinds.push("added");
@@ -4628,12 +4638,10 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
   }
   if (riskLines.length > 0) sectionKinds.push("risk_summary");
   if (removedApiWarnings.length > 0) sectionKinds.push("removed_api_warning");
-  parts.splice(
-    9,
-    0,
-    `payload_sections: ${payloadSections2(sectionKinds)}`,
-    `provenance_summary: ${provenanceSummary("semantic", db)}`
-  );
+  if (sectionKinds.length > 0) {
+    const insertIdx = 6 + graphHint.length;
+    parts.splice(insertIdx, 0, `payload_sections: ${payloadSections2(sectionKinds)}`);
+  }
   if (riskLines.length || removedApiWarnings.length) {
     parts.push("");
     parts.push("risk_summary:");
@@ -4777,8 +4785,7 @@ function result(structured, { large = false } = {}) {
 function errorResult(code, message, recovery, { large = false, extra = null } = {}) {
   const payload = {
     status: "ERROR",
-    error: { code, message, recovery },
-    summary: message
+    error: { code, message, recovery }
   };
   if (extra && typeof extra === "object") {
     Object.assign(payload, extra);
@@ -4787,7 +4794,7 @@ function errorResult(code, message, recovery, { large = false, extra = null } =
 }
 
 // server.mjs
-var version = true ? "1.21.1" : (await null).createRequire(import.meta.url)("./package.json").version;
+var version = true ? "1.23.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.21.1",
+  "version": "1.23.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.",