ccakashic 0.2.2 → 0.2.4

package/bin/ccakashic.js

@@ -3,12 +3,14 @@
 
 const http = require('http');
 const fs = require('fs');
+const os = require('os');
 const path = require('path');
 const { exec } = require('child_process');
 const { listProjects, listSessions, findSessionForCwd } = require('../lib/discover');
 const { parseSession } = require('../lib/parser');
 const { generate } = require('../lib/html-generator');
 const { generateIndex, generateSessionList } = require('../lib/pages');
+const pkg = require('../package.json');
 
 function openInBrowser(url) {
   const cmd = process.platform === 'darwin' ? 'open'
@@ -18,14 +20,22 @@ function openInBrowser(url) {
 }
 
 const PORT = parseInt(process.env.CCAKASHIC_PORT) || 3333;
+const MAX_PORT_TRIES = 20;
+const LOCK_FILE = path.join(os.tmpdir(), `ccakashic-${os.userInfo().username || 'user'}.json`);
 
 const server = http.createServer(async (req, res) => {
   try {
     const url = new URL(req.url, `http://localhost`);
     const pathname = url.pathname;
 
+    // Health/identity endpoint used to detect an already-running ccakashic
+    if (pathname === '/__ccakashic') {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ name: 'ccakashic', version: pkg.version }));
+      return;
+    }
+
     if (pathname === '/' || pathname === '') {
-      // Project index
       const projects = listProjects();
       res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
       res.end(generateIndex(projects));
@@ -34,7 +44,6 @@ const server = http.createServer(async (req, res) => {
 
     const projectMatch = pathname.match(/^\/project\/(.+)$/);
     if (projectMatch && !pathname.includes('/session/')) {
-      // Session list for a project
       const rawName = decodeURIComponent(projectMatch[1]);
       const projects = listProjects();
       const project = projects.find(p => p.rawName === rawName);
@@ -51,7 +60,6 @@ const server = http.createServer(async (req, res) => {
 
     const sessionMatch = pathname.match(/^\/project\/(.+)\/session\/(.+)$/);
     if (sessionMatch) {
-      // Render a specific session
       const rawName = decodeURIComponent(sessionMatch[1]);
       const sessionId = decodeURIComponent(sessionMatch[2]);
       const projects = listProjects();
@@ -85,21 +93,133 @@ const server = http.createServer(async (req, res) => {
   }
 });
 
-server.listen(PORT, '127.0.0.1', async () => {
-  const addr = server.address();
-  const url = `http://127.0.0.1:${addr.port}`;
-  console.log(`ccakashic running at ${url}`);
-  console.log('Press Ctrl+C to stop');
-
-  let openUrl = url;
+async function buildOpenUrl(baseUrl) {
   try {
     const match = await findSessionForCwd(process.cwd());
     if (match) {
-      openUrl = `${url}/project/${encodeURIComponent(match.projectRawName)}/session/${encodeURIComponent(match.sessionId)}#session-bottom`;
       console.log(`Detected session for ${process.cwd()} → opening at bottom`);
+      return `${baseUrl}/project/${encodeURIComponent(match.projectRawName)}/session/${encodeURIComponent(match.sessionId)}#session-bottom`;
     }
   } catch (err) {
     console.error('Failed to auto-detect session:', err.message);
   }
-  openInBrowser(openUrl);
+  return baseUrl;
+}
+
+function probeCcakashic(port) {
+  return new Promise((resolve) => {
+    const req = http.request({
+      host: '127.0.0.1',
+      port,
+      path: '/__ccakashic',
+      method: 'GET',
+      timeout: 500,
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const parsed = JSON.parse(data);
+          resolve(parsed && parsed.name === 'ccakashic');
+        } catch {
+          resolve(false);
+        }
+      });
+    });
+    req.on('error', () => resolve(false));
+    req.on('timeout', () => { req.destroy(); resolve(false); });
+    req.end();
+  });
+}
+
+function readLockPort() {
+  try {
+    const data = JSON.parse(fs.readFileSync(LOCK_FILE, 'utf-8'));
+    return typeof data.port === 'number' ? data.port : null;
+  } catch {
+    return null;
+  }
+}
+
+function writeLockFile(port) {
+  try {
+    fs.writeFileSync(LOCK_FILE, JSON.stringify({ port, pid: process.pid, startedAt: Date.now() }));
+  } catch {
+    // best-effort
+  }
+}
+
+function cleanupLockFile() {
+  try { fs.unlinkSync(LOCK_FILE); } catch {}
+}
+
+function listenOnPort(port) {
+  return new Promise((resolve, reject) => {
+    const onError = (err) => { server.off('listening', onListening); reject(err); };
+    const onListening = () => { server.off('error', onError); resolve(); };
+    server.once('error', onError);
+    server.once('listening', onListening);
+    server.listen(port, '127.0.0.1');
+  });
+}
+
+async function findExistingCcakashic(startPort) {
+  const lockPort = readLockPort();
+  if (lockPort && await probeCcakashic(lockPort)) return lockPort;
+  if (startPort !== lockPort && await probeCcakashic(startPort)) return startPort;
+  return null;
+}
+
+async function startServer(startPort) {
+  for (let i = 0; i < MAX_PORT_TRIES; i++) {
+    const port = startPort + i;
+    try {
+      await listenOnPort(port);
+      return port;
+    } catch (err) {
+      if (err.code !== 'EADDRINUSE') throw err;
+      // Port is taken by something else; see if it's ccakashic
+      if (await probeCcakashic(port)) return -port; // negative = reuse signal
+    }
+  }
+  throw new Error(`No available port after ${MAX_PORT_TRIES} tries starting at ${startPort}`);
+}
+
+async function main() {
+  const existing = await findExistingCcakashic(PORT);
+  if (existing) {
+    const url = `http://127.0.0.1:${existing}`;
+    console.log(`Reusing existing ccakashic at ${url}`);
+    writeLockFile(existing);
+    openInBrowser(await buildOpenUrl(url));
+    return;
+  }
+
+  const result = await startServer(PORT);
+  if (result < 0) {
+    const port = -result;
+    const url = `http://127.0.0.1:${port}`;
+    console.log(`Reusing existing ccakashic at ${url}`);
+    writeLockFile(port);
+    openInBrowser(await buildOpenUrl(url));
+    return;
+  }
+
+  const port = result;
+  const url = `http://127.0.0.1:${port}`;
+  console.log(`ccakashic running at ${url}`);
+  console.log('Press Ctrl+C to stop');
+  writeLockFile(port);
+
+  const cleanup = () => { cleanupLockFile(); process.exit(0); };
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+  process.on('exit', cleanupLockFile);
+
+  openInBrowser(await buildOpenUrl(url));
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccakashic",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Browse Claude Code session logs (~/.claude/projects/) as beautiful HTML in your browser — an Akashic Record of your Claude Code sessions",
   "bin": {
     "ccakashic": "bin/ccakashic.js"