@levnikolaevich/hex-line-mcp 1.23.0 → 1.24.0

package/dist/server.mjs

@@ -400,6 +400,20 @@ function getGraphDB(filePath, { allowStale = false } = {}) {
     return null;
   }
 }
+function diagnoseFreshness(db, projectRoot, filePath) {
+  try {
+    const stat = statSync3(filePath);
+    if (!stat.isFile()) return "ok";
+    const relativeFile = normalizeRelativeFile(projectRoot, filePath);
+    if (!relativeFile) return "ok";
+    const indexedMtime = lookupIndexedMtime(db, relativeFile);
+    if (indexedMtime == null) return "file_not_indexed";
+    if (Math.abs(indexedMtime - stat.mtimeMs) < FRESHNESS_TOLERANCE_MS) return "ok";
+    return "stale";
+  } catch {
+    return "ok";
+  }
+}
 function diagnoseGraph(filePath) {
   if (_driverUnavailable) return { reason: "driver_missing" };
   try {
@@ -409,10 +423,7 @@ function diagnoseGraph(filePath) {
     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 };
+      return { reason: diagnoseFreshness(cached, projectRoot, filePath), projectRoot };
     }
     const require2 = createRequire(import.meta.url);
     const Database = require2("better-sqlite3");
@@ -421,9 +432,28 @@ function diagnoseGraph(filePath) {
       db.close();
       return { reason: "contract_mismatch", projectRoot };
     }
-    if (!isFilePathFresh(db, projectRoot, filePath)) {
+    _dbs.set(dbPath, db);
+    return { reason: diagnoseFreshness(db, projectRoot, filePath), projectRoot };
+  } catch {
+    _driverUnavailable = true;
+    return { reason: "driver_missing" };
+  }
+}
+function diagnoseGraphForProject(projectRoot) {
+  if (_driverUnavailable) return { reason: "driver_missing" };
+  try {
+    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)) {
+      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: "stale", projectRoot };
+      return { reason: "contract_mismatch", projectRoot };
     }
     _dbs.set(dbPath, db);
     return { reason: "ok", projectRoot };
@@ -432,9 +462,15 @@ function diagnoseGraph(filePath) {
     return { reason: "driver_missing" };
   }
 }
+function getGraphDBForProject(projectRoot) {
+  const { reason } = diagnoseGraphForProject(projectRoot);
+  if (reason !== "ok") return null;
+  const dbPath = join3(projectRoot, ".hex-skills/codegraph", "index.db");
+  return _dbs.get(dbPath) || null;
+}
 function graphUnavailableHint(filePath) {
   const { reason, projectRoot } = diagnoseGraph(filePath);
-  if (reason === "ok") return [];
+  if (reason === "ok" || reason === "file_not_indexed") return [];
   const at = projectRoot ? ` at ${projectRoot.replace(/\\/g, "/")}` : "";
   switch (reason) {
     case "driver_missing":
@@ -451,6 +487,23 @@ function graphUnavailableHint(filePath) {
       return ["graph_enrichment: unavailable"];
   }
 }
+function graphUnavailableHintForProject(projectRoot) {
+  const { reason } = diagnoseGraphForProject(projectRoot);
+  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: directory is outside any project root"];
+    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}`];
+    default:
+      return ["graph_enrichment: unavailable"];
+  }
+}
 function validateContract(db) {
   try {
     for (const viewName of REQUIRED_VIEWS) {
@@ -548,6 +601,20 @@ function ensureGraphFreshForFile(db, absoluteFilePath) {
     return true;
   }
 }
+function isGraphFreshAtMtime(db, absoluteFilePath, mtimeMs) {
+  if (!db) return false;
+  try {
+    const projectRoot = findProjectRoot(absoluteFilePath);
+    if (!projectRoot) return true;
+    const relativeFile = normalizeRelativeFile(projectRoot, absoluteFilePath);
+    if (!relativeFile) return true;
+    const indexedMtime = lookupIndexedMtime(db, relativeFile);
+    if (indexedMtime == null) return false;
+    return mtimeMs <= indexedMtime + FRESHNESS_TOLERANCE_MS;
+  } catch {
+    return true;
+  }
+}
 function fileAnnotations(db, file, { startLine = null, endLine = null, limit = 8 } = {}) {
   try {
     const hasRange = Number.isInteger(startLine) && Number.isInteger(endLine);
@@ -2914,7 +2981,7 @@ ${serializeReadBlock(block)}`;
     const relFile = db ? getRelativePath(real) : null;
     if (db && relFile && fullDiff && minLine <= maxLine) {
       graphDbAvailable = true;
-      graphFresh = ensureGraphFreshForFile(db, real);
+      graphFresh = isGraphFreshAtMtime(db, real, currentSnapshot.mtimeMs);
       semanticImpacts = semanticImpact(db, relFile, minLine, maxLine);
       if (semanticImpacts.length > 0) {
         const sections = semanticImpacts.map((impact) => {
@@ -3693,16 +3760,17 @@ function entrySummary(entry) {
   if (entry.status === "STALE") return "content changed since checksum capture";
   return entry.reason;
 }
-function renderEntry(entry, index, total) {
+function renderEntry(entry, index, total, topLevelNextAction) {
   const parts = [
     `entry: ${index}/${total}`,
     `status: ${entry.status}`,
     entry.span ? `span: ${entry.span}` : null,
     `checksum: ${entry.checksum}`,
-    entry.currentChecksum && entry.currentChecksum !== entry.checksum ? `current_checksum: ${entry.currentChecksum}` : null,
-    `next_action: ${entryNextAction(entry)}`,
-    `summary: ${entrySummary(entry)}`
+    entry.currentChecksum && entry.currentChecksum !== entry.checksum ? `current_checksum: ${entry.currentChecksum}` : null
   ].filter(Boolean);
+  const action = entryNextAction(entry);
+  if (action !== topLevelNextAction) parts.push(`next_action: ${action}`);
+  if (entry.status !== "VALID") parts.push(`summary: ${entrySummary(entry)}`);
   return parts.join(" | ");
 }
 function verifyChecksums(filePath, checksums, opts = {}) {
@@ -3716,18 +3784,20 @@ function verifyChecksums(filePath, checksums, opts = {}) {
   const summary = summarizeStatuses(results);
   const status = summary.invalid > 0 ? STATUS.INVALID : summary.stale > 0 ? STATUS.STALE : STATUS.OK;
   const staleRanges = results.filter((entry) => entry.status === "STALE" && entry.span).map((entry) => entry.span);
+  const topLevelNextAction = overallNextAction(summary);
+  const verboseSummary = results.length > 1 || summary.stale > 0 || summary.invalid > 0;
   const lines = [
     `status: ${status}`,
     `reason: ${overallReason(status)}`,
-    `revision: ${currentSnapshot.revision}`,
-    `file: ${currentSnapshot.fileChecksum}`,
-    `summary: valid=${summary.valid} stale=${summary.stale} invalid=${summary.invalid}`,
-    `next_action: ${overallNextAction(summary)}`
+    `revision: ${currentSnapshot.revision}`
   ];
-  if (opts.baseRevision) {
+  if (verboseSummary) lines.push(`summary: valid=${summary.valid} stale=${summary.stale} invalid=${summary.invalid}`);
+  lines.push(`next_action: ${topLevelNextAction}`);
+  if (opts.baseRevision && opts.baseRevision !== currentSnapshot.revision) {
     lines.push(`base_revision: ${opts.baseRevision}`);
     if (hasBaseSnapshot) {
-      lines.push(`changed_ranges: ${describeChangedRanges(computeChangedRanges(baseSnapshot.lines, currentSnapshot.lines))}`);
+      const changed = describeChangedRanges(computeChangedRanges(baseSnapshot.lines, currentSnapshot.lines));
+      if (changed !== "none") lines.push(`changed_ranges: ${changed}`);
     } else {
       lines.push("base_revision_status: evicted");
     }
@@ -3735,7 +3805,7 @@ function verifyChecksums(filePath, checksums, opts = {}) {
   const suggestedReadCall = buildSuggestedReadCall2(filePath, staleRanges);
   if (suggestedReadCall) lines.push(`suggested_read_call: ${suggestedReadCall}`);
   if (results.length > 0) {
-    lines.push("", ...results.map((entry, index) => renderEntry(entry, index + 1, results.length)));
+    lines.push("", ...results.map((entry, index) => renderEntry(entry, index + 1, results.length, topLevelNextAction)));
   }
   return lines.join("\n");
 }
@@ -3837,12 +3907,13 @@ function findByPattern(dirPath, opts) {
   const truncated = shown.length < matches.length;
   const groups = topPatternGroups(matches);
   const lines = [
-    `Found ${matches.length} match${matches.length === 1 ? "" : "es"} for "${opts.pattern}" in ${rootName}/`,
-    `match_count: ${matches.length}`,
-    `shown_count: ${shown.length}`,
-    `truncated: ${truncated}`
+    `Found ${matches.length} match${matches.length === 1 ? "" : "es"} for "${opts.pattern}" in ${rootName}/`
   ];
-  if (groups.length > 0) {
+  if (truncated) {
+    lines.push(`shown_count: ${shown.length}`);
+    lines.push(`truncated: true`);
+  }
+  if (groups.length > 1) {
     lines.push(`top_groups: ${groups.map(([group, count]) => `${group} (${count})`).join(", ")}`);
   }
   if (truncated) {
@@ -4211,7 +4282,6 @@ function autoSync() {
 
 // lib/changes.mjs
 import { statSync as statSync11 } from "node:fs";
-import { join as join6 } from "node:path";
 
 // ../hex-common/src/git/semantic-diff.mjs
 import { execFileSync } from "node:child_process";
@@ -4514,9 +4584,9 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
   filePath = normalizePath(filePath);
   const real = validatePath(filePath);
   if (statSync11(real).isDirectory()) {
-    const db2 = getGraphDB(join6(real, "__hex-line_probe__"));
+    const db2 = getGraphDBForProject(real);
     const diff2 = await semanticGitDiff(real, { baseRef: compareAgainst });
-    const graphHint2 = graphUnavailableHint(join6(real, "__hex-line_probe__"));
+    const graphHint2 = graphUnavailableHintForProject(real);
     if (diff2.summary.changed_file_count === 0) {
       return [
         "status: NO_CHANGES",
@@ -4653,7 +4723,7 @@ async function fileChanges(filePath, compareAgainst = "HEAD") {
 
 // lib/bulk-replace.mjs
 import { writeFileSync as writeFileSync3, readdirSync as readdirSync3, renameSync as renameSync2, unlinkSync as unlinkSync2 } from "node:fs";
-import { resolve as resolve9, relative as relative4, join as join7 } from "node:path";
+import { resolve as resolve9, relative as relative4, join as join6 } from "node:path";
 var ignoreMod;
 try {
   ignoreMod = await import("ignore");
@@ -4669,7 +4739,7 @@ function walkFiles(dir, rootDir, ig) {
   }
   for (const e of entries) {
     if (e.name === ".git" || e.name === "node_modules") continue;
-    const full = join7(dir, e.name);
+    const full = join6(dir, e.name);
     const rel = relative4(rootDir, full).replace(/\\/g, "/");
     if (ig && ig.ignores(rel)) continue;
     if (e.isDirectory()) {
@@ -4688,7 +4758,7 @@ function loadGitignore2(rootDir) {
   if (!ignoreMod) return null;
   const ig = (ignoreMod.default || ignoreMod)();
   try {
-    const content = readText(join7(rootDir, ".gitignore"));
+    const content = readText(join6(rootDir, ".gitignore"));
     ig.add(content);
   } catch {
   }
@@ -4794,7 +4864,7 @@ function errorResult(code, message, recovery, { large = false, extra = null } =
 }
 
 // server.mjs
-var version = true ? "1.23.0" : (await null).createRequire(import.meta.url)("./package.json").version;
+var version = true ? "1.24.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.23.0",
+  "version": "1.24.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.",