@softerist/heuristic-mcp 3.2.6 → 3.2.8

package/index.js

@@ -242,7 +242,17 @@ function formatCrashDetail(detail) {
 }
 
 function isBrokenPipeError(detail) {
-  return Boolean(detail && typeof detail === 'object' && detail.code === 'EPIPE');
+  if (!detail) return false;
+  if (typeof detail === 'string') {
+    return /(?:^|[\s:])EPIPE(?:[\s:]|$)|broken pipe/i.test(detail);
+  }
+  if (typeof detail === 'object') {
+    if (detail.code === 'EPIPE') return true;
+    if (typeof detail.message === 'string') {
+      return /(?:^|[\s:])EPIPE(?:[\s:]|$)|broken pipe/i.test(detail.message);
+    }
+  }
+  return false;
 }
 
 function isCrashShutdownReason(reason) {
@@ -250,6 +260,11 @@ function isCrashShutdownReason(reason) {
   return normalized.includes('uncaughtexception') || normalized.includes('unhandledrejection');
 }
 
+function shouldLogProcessLifecycle() {
+  const value = String(process.env.HEURISTIC_MCP_PROCESS_LIFECYCLE || '').trim().toLowerCase();
+  return value === '1' || value === 'true' || value === 'yes' || value === 'on';
+}
+
 function getShutdownExitCode(reason) {
   const normalized = String(reason || '').trim().toUpperCase();
   if (normalized === 'SIGINT') return 130;
@@ -260,15 +275,20 @@ function getShutdownExitCode(reason) {
 function registerProcessDiagnostics({ isServerMode, requestShutdown, getShutdownReason }) {
   if (!isServerMode) return;
 
-  process.on('beforeExit', (code) => {
-    const reason = getShutdownReason() || 'natural';
-    console.info(`[Server] Process beforeExit (code=${code}, reason=${reason}).`);
-  });
+  if (shouldLogProcessLifecycle()) {
+    let beforeExitLogged = false;
+    process.on('beforeExit', (code) => {
+      if (beforeExitLogged) return;
+      beforeExitLogged = true;
+      const reason = getShutdownReason() || 'natural';
+      console.info(`[Server] Process beforeExit (code=${code}, reason=${reason}).`);
+    });
 
-  process.on('exit', (code) => {
-    const reason = getShutdownReason() || 'natural';
-    console.info(`[Server] Process exit (code=${code}, reason=${reason}).`);
-  });
+    process.on('exit', (code) => {
+      const reason = getShutdownReason() || 'natural';
+      console.info(`[Server] Process exit (code=${code}, reason=${reason}).`);
+    });
+  }
 
   let fatalHandled = false;
   const handleFatalError = (reason, detail) => {
@@ -1590,8 +1610,6 @@ async function gracefulShutdown(signal) {
     keepAliveTimer = null;
   }
 
-  unregisterStdioShutdownHandlers();
-
   const cleanupTasks = [];
 
   if (indexer && indexer.watcher) {
@@ -1639,6 +1657,8 @@ async function gracefulShutdown(signal) {
 
   await Promise.allSettled(cleanupTasks);
   console.info('[Server] Goodbye!');
+
+  unregisterStdioShutdownHandlers();
   await flushLogsSafely({ close: true, timeoutMs: 1500 });
 
   setTimeout(() => process.exit(exitCode), 100);

package/lib/embedding-worker.js

@@ -7,7 +7,6 @@ import { configureNativeOnnxBackend } from './onnx-backend.js';
 import { smartChunk, hashContent } from './utils.js';
 import { extractCallData } from './call-graph.js';
 
-// Helper to get global cache dir (duplicated from config.js to avoid full config load in worker)
 function getGlobalCacheDir() {
   if (process.platform === 'win32') {
     return process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');

package/lib/logging.js

@@ -14,7 +14,17 @@ const originalConsole = {
 };
 
 function isBrokenPipeError(error) {
-  return Boolean(error && typeof error === 'object' && error.code === 'EPIPE');
+  if (!error) return false;
+  if (typeof error === 'string') {
+    return /(?:^|[\s:])EPIPE(?:[\s:]|$)|broken pipe/i.test(error);
+  }
+  if (typeof error === 'object') {
+    if (error.code === 'EPIPE') return true;
+    if (typeof error.message === 'string') {
+      return /(?:^|[\s:])EPIPE(?:[\s:]|$)|broken pipe/i.test(error.message);
+    }
+  }
+  return false;
 }
 
 function writeToOriginalStderr(...args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softerist/heuristic-mcp",
-  "version": "3.2.6",
+  "version": "3.2.8",
   "description": "An enhanced MCP server providing intelligent semantic code search with find-similar-code, recency ranking, and improved chunking. Fork of smart-coding-mcp.",
   "type": "module",
   "main": "index.js",

package/scripts/clear-cache.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import fs from 'fs/promises';
 import { loadConfig } from '../lib/config.js';
 
@@ -7,7 +6,6 @@ async function clearCache() {
     const config = await loadConfig(process.cwd());
     const cacheDir = config.cacheDirectory;
 
-    // Remove cache directory
     await fs.rm(cacheDir, { recursive: true, force: true });
     console.info(`Cache cleared successfully: ${cacheDir}`);
     console.info('Next startup will perform a full reindex.');

package/scripts/download-model.js

@@ -9,15 +9,11 @@ async function downloadModel() {
     const transformers = await import('@huggingface/transformers');
     const { pipeline, env } = transformers;
 
-    // Force cache directory to global location
     env.cacheDir = globalCacheDir;
 
     console.info(`[Model Setup] Pre-caching model to: ${globalCacheDir}`);
-    // Check if network is available by pinging HF (simple check)
-    // Actually, pipeline() will fail fast if network is down
     console.info(`[Model Setup] Downloading 'jinaai/jina-embeddings-v2-base-code'...`);
 
-    // This will download the model to the cache directory
     await pipeline('feature-extraction', 'jinaai/jina-embeddings-v2-base-code');
 
     console.info(`[Model Setup] ✅ Model cached successfully!`);
@@ -36,7 +32,6 @@ async function downloadModel() {
       '[Model Setup] This is okay! The server will attempt to download it when started.'
     );
     console.warn(`[Model Setup] Error details: ${error.message}`);
-    // Don't fail the install, just warn
   }
 }
 

package/scripts/postinstall.js

@@ -1,6 +1,5 @@
 import { register } from '../features/register.js';
 
-// Run the registration process - MUST await to ensure file writes complete
 console.info('[PostInstall] Running Heuristic MCP registration...');
 
 try {
@@ -8,5 +7,4 @@ try {
   console.info('[PostInstall] Registration complete.');
 } catch (err) {
   console.error('[PostInstall] Registration failed:', err.message);
-  // Don't fail the install if registration fails, just warn
 }