feat: Implement Endless Mode Token Economics Calculator

- Added a new script to simulate token savings from Endless Mode using real observation data.
- Introduced functions to calculate token costs with and without Endless Mode, showcasing the differences in context handling.
- Enhanced output to display detailed token usage statistics and potential savings at scale.
- Integrated assumptions for user activity to estimate weekly and annual token savings.
- Updated worker-utils to automatically start the worker using PM2 if not running, improving service reliability.

src/shared/worker-utils.ts

@@ -1,9 +1,16 @@
 import path from "path";
 import { homedir } from "os";
 import { existsSync, readFileSync } from "fs";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 // Named constants for health checks
 const HEALTH_CHECK_TIMEOUT_MS = 100;
+const WORKER_STARTUP_WAIT_MS = 500;
+const WORKER_STARTUP_RETRIES = 10;
 
 /**
  * Get the worker port number
@@ -38,20 +45,59 @@ async function isWorkerHealthy(): Promise<boolean> {
   }
 }
 
+/**
+ * Start the worker using PM2
+ */
+async function startWorker(): Promise<boolean> {
+  try {
+    // Find the ecosystem config file (built version in plugin/)
+    const pluginRoot = path.resolve(__dirname, '..', '..');
+    const ecosystemPath = path.join(pluginRoot, 'ecosystem.config.cjs');
+
+    if (!existsSync(ecosystemPath)) {
+      throw new Error(`Ecosystem config not found at ${ecosystemPath}`);
+    }
+
+    // Start using PM2 with the ecosystem config
+    execSync(`pm2 start "${ecosystemPath}"`, {
+      stdio: 'pipe',
+      encoding: 'utf-8'
+    });
+
+    // Wait for worker to become healthy
+    for (let i = 0; i < WORKER_STARTUP_RETRIES; i++) {
+      await new Promise(resolve => setTimeout(resolve, WORKER_STARTUP_WAIT_MS));
+      if (await isWorkerHealthy()) {
+        return true;
+      }
+    }
+
+    return false;
+  } catch (error) {
+    // Failed to start worker
+    return false;
+  }
+}
+
 /**
  * Ensure worker service is running
- * Checks health and fails with instructions if not healthy
- * PM2's watch mode handles auto-restarts automatically
+ * Checks health and auto-starts if not running
  */
 export async function ensureWorkerRunning(): Promise<void> {
+  // Check if already healthy
   if (await isWorkerHealthy()) {
     return;
   }
 
-  const port = getWorkerPort();
-  throw new Error(
-    `Worker service is not responding on port ${port}.\n\n` +
-    `If you just updated the plugin, PM2's watch mode should restart automatically.\n` +
-    `If the problem persists, run: pm2 restart claude-mem-worker`
-  );
+  // Try to start the worker
+  const started = await startWorker();
+
+  if (!started) {
+    const port = getWorkerPort();
+    throw new Error(
+      `Worker service failed to start on port ${port}.\n\n` +
+      `Try manually running: pm2 start ecosystem.config.cjs\n` +
+      `Or restart: pm2 restart claude-mem-worker`
+    );
+  }
 }