Refactor hooks and worker service for improved error handling and initialization

- Removed try-catch blocks in new-hook, save-hook, and summary-hook for cleaner flow.
- Enhanced error handling in save and summary hooks to throw errors instead of logging and returning.
- Introduced ensureWorkerRunning utility to manage worker service lifecycle and health checks.
- Replaced dynamic port allocation with a fixed port for the worker service.
- Simplified path management and removed unused port allocator utility.
- Added database schema initialization for fresh installations and improved migration handling.

src/hooks/save.ts

@@ -44,8 +44,7 @@ export async function saveHook(input?: PostToolUseInput): Promise<void> {
   if (!session.worker_port) {
     db.close();
     logger.error('HOOK', 'No worker port for session', { sessionId: session.id });
-    console.log(createHookResponse('PostToolUse', true));
-    return;
+    throw new Error('No worker port for session - session may not be properly initialized');
   }
 
   // Get current prompt number for this session
@@ -54,36 +53,32 @@ export async function saveHook(input?: PostToolUseInput): Promise<void> {
 
   const toolStr = logger.formatTool(tool_name, tool_input);
 
-  try {
-    logger.dataIn('HOOK', `PostToolUse: ${toolStr}`, {
+  logger.dataIn('HOOK', `PostToolUse: ${toolStr}`, {
+    sessionId: session.id,
+    workerPort: session.worker_port
+  });
+
+  const response = await fetch(`http://127.0.0.1:${session.worker_port}/sessions/${session.id}/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: session.id,
-      workerPort: session.worker_port
-    });
-
-    const response = await fetch(`http://127.0.0.1:${session.worker_port}/sessions/${session.id}/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: session.id,
-        status: response.status
-      }, errorText);
-    } else {
-      logger.debug('HOOK', 'Observation sent successfully', { sessionId: session.id, toolName: tool_name });
-    }
-  } catch (error: any) {
-    logger.failure('HOOK', 'Error sending observation', { sessionId: session.id }, error);
-  } finally {
-    console.log(createHookResponse('PostToolUse', true));
+      status: response.status
+    }, errorText);
+    throw new Error(`Failed to send observation to worker: ${response.status} ${errorText}`);
   }
+
+  logger.debug('HOOK', 'Observation sent successfully', { sessionId: session.id, toolName: tool_name });
+  console.log(createHookResponse('PostToolUse', true));
 }