Refactor worker management and cleanup hooks

- Removed ensureWorkerRunning calls from multiple hooks (cleanup, context, new, save, summary) to streamline code and avoid unnecessary checks.
- Introduced fixed port usage for worker communication across hooks.
- Enhanced error handling in newHook, saveHook, and summaryHook to provide clearer messages for worker connection issues.
- Updated worker service to start without health checks, relying on PM2 for management.
- Cached Claude executable path to optimize repeated calls.
- Improved logging for better traceability of worker actions and errors.

src/hooks/save-hook.ts

@@ -7,7 +7,6 @@ import { stdin } from 'process';
 import { SessionStore } from '../services/sqlite/SessionStore.js';
 import { createHookResponse } from './hook-response.js';
 import { logger } from '../utils/logger.js';
-import { ensureWorkerRunning } from '../shared/worker-utils.js';
 
 export interface PostToolUseInput {
   session_id: string;
@@ -38,12 +37,6 @@ async function saveHook(input?: PostToolUseInput): Promise<void> {
     return;
   }
 
-  // Ensure worker is running first
-  const workerReady = await ensureWorkerRunning();
-  if (!workerReady) {
-    throw new Error('Worker service failed to start or become healthy');
-  }
-
   const db = new SessionStore();
 
   // Get or create session
@@ -61,28 +54,38 @@ async function saveHook(input?: PostToolUseInput): Promise<void> {
     workerPort: FIXED_PORT
   });
 
-  const response = await fetch(`http://127.0.0.1:${FIXED_PORT}/sessions/${sessionDbId}/observations`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      tool_name,
-      tool_input: tool_input !== undefined ? JSON.stringify(tool_input) : '{}',
-      tool_output: tool_output !== undefined ? JSON.stringify(tool_output) : '{}',
-      prompt_number: promptNumber
-    }),
-    signal: AbortSignal.timeout(2000)
-  });
+  try {
+    const response = await fetch(`http://127.0.0.1:${FIXED_PORT}/sessions/${sessionDbId}/observations`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        tool_name,
+        tool_input: tool_input !== undefined ? JSON.stringify(tool_input) : '{}',
+        tool_output: tool_output !== undefined ? JSON.stringify(tool_output) : '{}',
+        prompt_number: promptNumber
+      }),
+      signal: AbortSignal.timeout(2000)
+    });
 
-  if (!response.ok) {
-    const errorText = await response.text();
-    logger.failure('HOOK', 'Failed to send observation', {
-      sessionId: sessionDbId,
-      status: response.status
-    }, errorText);
-    throw new Error(`Failed to send observation to worker: ${response.status} ${errorText}`);
+    if (!response.ok) {
+      const errorText = await response.text();
+      logger.failure('HOOK', 'Failed to send observation', {
+        sessionId: sessionDbId,
+        status: response.status
+      }, errorText);
+      throw new Error(`Failed to send observation to worker: ${response.status} ${errorText}`);
+    }
+
+    logger.debug('HOOK', 'Observation sent successfully', { sessionId: sessionDbId, toolName: tool_name });
+  } catch (error: any) {
+    // Only show restart message for connection errors, not HTTP errors
+    if (error.cause?.code === 'ECONNREFUSED' || error.name === 'TimeoutError' || error.message.includes('fetch failed')) {
+      throw new Error("There's a problem with the worker. If you just updated, type `pm2 restart claude-mem-worker` in your terminal to continue");
+    }
+    // Re-throw HTTP errors and other errors as-is
+    throw error;
   }
 
-  logger.debug('HOOK', 'Observation sent successfully', { sessionId: sessionDbId, toolName: tool_name });
   console.log(createHookResponse('PostToolUse', true));
 }