@runtimescope/collector 0.7.2 → 0.9.0

package/dist/{chunk-TUFSIGGJ.js → chunk-HZWALDZM.js}

@@ -93,7 +93,8 @@ var EventStore = class {
         connectedAt: se.connectedAt,
         sdkVersion: se.sdkVersion,
         eventCount: 0,
-        isConnected: true
+        isConnected: true,
+        projectId: se.projectId
       });
     }
     const session = this.sessions.get(event.sessionId);
@@ -113,6 +114,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "network") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const ne = e;
       if (ne.timestamp < since) return false;
       if (filter.urlPattern && !ne.url.includes(filter.urlPattern)) return false;
@@ -127,6 +129,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "console") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const ce = e;
       if (ce.timestamp < since) return false;
       if (filter.level && ce.level !== filter.level) return false;
@@ -148,26 +151,37 @@ var EventStore = class {
     return this.buffer.toArray().filter((e) => {
       if (e.timestamp < since) return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       if (typeSet && !typeSet.has(e.eventType)) return false;
       return true;
     });
   }
-  getAllEvents(sinceSeconds, sessionId) {
+  getAllEvents(sinceSeconds, sessionId, projectId) {
     const since = sinceSeconds ? Date.now() - sinceSeconds * 1e3 : 0;
     return this.buffer.toArray().filter((e) => {
       if (e.timestamp < since) return false;
       if (sessionId && e.sessionId !== sessionId) return false;
+      if (projectId && !this.matchesProjectId(e.sessionId, projectId)) return false;
       return true;
     });
   }
   getSessionIdsForProject(appName) {
     return Array.from(this.sessions.values()).filter((s) => s.appName === appName).map((s) => s.sessionId);
   }
+  getSessionIdsForProjectId(projectId) {
+    return Array.from(this.sessions.values()).filter((s) => s.projectId === projectId).map((s) => s.sessionId);
+  }
+  /** Check if an event belongs to the given projectId (via its session). */
+  matchesProjectId(sessionId, projectId) {
+    const session = this.sessions.get(sessionId);
+    return session?.projectId === projectId;
+  }
   getStateEvents(filter = {}) {
     const since = filter.sinceSeconds ? Date.now() - filter.sinceSeconds * 1e3 : 0;
     return this.buffer.query((e) => {
       if (e.eventType !== "state") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const se = e;
       if (se.timestamp < since) return false;
       if (filter.storeId && se.storeId !== filter.storeId) return false;
@@ -179,6 +193,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "render") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const re = e;
       if (re.timestamp < since) return false;
       if (filter.componentName) {
@@ -195,6 +210,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "performance") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const pe = e;
       if (pe.timestamp < since) return false;
       if (filter.metricName && pe.metricName !== filter.metricName) return false;
@@ -206,6 +222,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "database") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const de = e;
       if (de.timestamp < since) return false;
       if (filter.table) {
@@ -227,12 +244,25 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== "custom") return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       const ce = e;
       if (ce.timestamp < since) return false;
       if (filter.name && ce.name !== filter.name) return false;
       return true;
     });
   }
+  getUIInteractions(filter = {}) {
+    const since = filter.sinceSeconds ? Date.now() - filter.sinceSeconds * 1e3 : 0;
+    return this.buffer.query((e) => {
+      if (e.eventType !== "ui") return false;
+      if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
+      const ue = e;
+      if (ue.timestamp < since) return false;
+      if (filter.action && ue.action !== filter.action) return false;
+      return true;
+    });
+  }
   // ============================================================
   // Recon event queries — returns the most recent event of each type
   // ============================================================
@@ -241,6 +271,7 @@ var EventStore = class {
     const results = this.buffer.query((e) => {
       if (e.eventType !== eventType) return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       if (e.timestamp < since) return false;
       if (filter.url) {
         const re = e;
@@ -255,6 +286,7 @@ var EventStore = class {
     return this.buffer.query((e) => {
       if (e.eventType !== eventType) return false;
       if (filter.sessionId && e.sessionId !== filter.sessionId) return false;
+      if (filter.projectId && !this.matchesProjectId(e.sessionId, filter.projectId)) return false;
       if (e.timestamp < since) return false;
       if (filter.url) {
         const re = e;
@@ -295,9 +327,43 @@ var EventStore = class {
   }
 };
 
+// src/project-id.ts
+import { randomBytes } from "crypto";
+var PROJECT_ID_PREFIX = "proj_";
+var PROJECT_ID_CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+var PROJECT_ID_LENGTH = 12;
+var PROJECT_ID_REGEX = /^proj_[a-z0-9]{12}$/;
+function generateProjectId() {
+  const bytes = randomBytes(PROJECT_ID_LENGTH);
+  let id = PROJECT_ID_PREFIX;
+  for (let i = 0; i < PROJECT_ID_LENGTH; i++) {
+    id += PROJECT_ID_CHARS[bytes[i] % PROJECT_ID_CHARS.length];
+  }
+  return id;
+}
+function isValidProjectId(id) {
+  return PROJECT_ID_REGEX.test(id);
+}
+function getOrCreateProjectId(projectManager, appName) {
+  const existing = projectManager.getProjectIdForApp(appName);
+  if (existing) return existing;
+  const projectId = generateProjectId();
+  projectManager.ensureProjectDir(appName);
+  projectManager.setProjectIdForApp(appName, projectId);
+  return projectId;
+}
+
 // src/sqlite-store.ts
-import Database from "better-sqlite3";
 import { renameSync, existsSync } from "fs";
+import { createRequire } from "module";
+var DatabaseConstructor;
+function getDatabase() {
+  if (!DatabaseConstructor) {
+    const require2 = createRequire(import.meta.url);
+    DatabaseConstructor = require2("better-sqlite3");
+  }
+  return DatabaseConstructor;
+}
 var SqliteStore = class _SqliteStore {
   db;
   writeBuffer = [];
@@ -316,8 +382,9 @@ var SqliteStore = class _SqliteStore {
     this.flushTimer = setInterval(() => this.flush(), flushInterval);
   }
   openDatabase(options) {
+    const Db = getDatabase();
     try {
-      const db = new Database(options.dbPath);
+      const db = new Db(options.dbPath);
       if (options.walMode !== false) {
         db.pragma("journal_mode = WAL");
       }
@@ -347,7 +414,7 @@ var SqliteStore = class _SqliteStore {
         }
       } catch {
       }
-      const db = new Database(options.dbPath);
+      const db = new Db(options.dbPath);
       if (options.walMode !== false) {
         db.pragma("journal_mode = WAL");
       }
@@ -643,14 +710,14 @@ var SqliteStore = class _SqliteStore {
 };
 
 // src/sqlite-check.ts
-import { createRequire } from "module";
+import { createRequire as createRequire2 } from "module";
 var _checked = false;
 var _available = false;
 function isSqliteAvailable() {
   if (_checked) return _available;
   _checked = true;
   try {
-    const require2 = createRequire(import.meta.url);
+    const require2 = createRequire2(import.meta.url);
     require2("better-sqlite3");
     _available = true;
   } catch {
@@ -975,7 +1042,7 @@ var CollectorServer = class {
           console.error(`[RuntimeScope] Session ${clientInfo.sessionId} disconnected`);
           for (const cb of this.disconnectCallbacks) {
             try {
-              cb(clientInfo.sessionId, clientInfo.projectName);
+              cb(clientInfo.sessionId, clientInfo.projectName, clientInfo.projectId);
             } catch {
             }
           }
@@ -1007,9 +1074,11 @@ var CollectorServer = class {
           this.pendingHandshakes.delete(ws);
         }
         const projectName = payload.appName;
+        const projectId = payload.projectId ?? (this.projectManager ? getOrCreateProjectId(this.projectManager, projectName) : void 0);
         this.clients.set(ws, {
           sessionId: payload.sessionId,
-          projectName
+          projectName,
+          projectId
         });
         const sqliteStore = this.ensureSqliteStore(projectName);
         if (sqliteStore) {
@@ -1030,6 +1099,7 @@ var CollectorServer = class {
           timestamp: msg.timestamp,
           eventType: "session",
           appName: payload.appName,
+          projectId,
           connectedAt: msg.timestamp,
           sdkVersion: payload.sdkVersion
         });
@@ -1038,7 +1108,7 @@ var CollectorServer = class {
         );
         for (const cb of this.connectCallbacks) {
           try {
-            cb(payload.sessionId, projectName);
+            cb(payload.sessionId, projectName, projectId);
           } catch {
           }
         }
@@ -1097,7 +1167,7 @@ var CollectorServer = class {
   getConnectedSessions() {
     const sessions = [];
     for (const [, info] of this.clients) {
-      sessions.push({ sessionId: info.sessionId, projectName: info.projectName });
+      sessions.push({ sessionId: info.sessionId, projectName: info.projectName, projectId: info.projectId });
     }
     return sessions;
   }
@@ -1266,6 +1336,29 @@ var ProjectManager = class {
   projectExists(projectName) {
     return existsSync2(this.getProjectDir(projectName));
   }
+  // --- Project ID helpers ---
+  /** Look up the stored projectId for an appName. Returns null if none set. */
+  getProjectIdForApp(appName) {
+    const config = this.getProjectConfig(appName);
+    return config?.projectId ?? null;
+  }
+  /** Persist a projectId for an appName in its project config. */
+  setProjectIdForApp(appName, projectId) {
+    this.ensureProjectDir(appName);
+    const config = this.getProjectConfig(appName);
+    if (config) {
+      config.projectId = projectId;
+      this.saveProjectConfig(appName, config);
+    }
+  }
+  /** Resolve a projectId to an appName by scanning all project configs. Returns null if not found. */
+  getAppForProjectId(projectId) {
+    for (const name of this.listProjects()) {
+      const config = this.getProjectConfig(name);
+      if (config?.projectId === projectId) return name;
+    }
+    return null;
+  }
   // --- Environment variable resolution ---
   resolveEnvVars(value) {
     return value.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
@@ -1320,7 +1413,7 @@ var ProjectManager = class {
 };
 
 // src/auth.ts
-import { randomBytes, timingSafeEqual } from "crypto";
+import { randomBytes as randomBytes2, timingSafeEqual } from "crypto";
 var AuthManager = class {
   keys = /* @__PURE__ */ new Map();
   enabled;
@@ -1367,7 +1460,7 @@ var AuthManager = class {
 };
 function generateApiKey(label, project) {
   return {
-    key: randomBytes(32).toString("hex"),
+    key: randomBytes2(32).toString("hex"),
     label,
     project,
     createdAt: Date.now()
@@ -1480,6 +1573,198 @@ var Redactor = class {
   }
 };
 
+// src/platform.ts
+import { execFileSync, execSync } from "child_process";
+import { readlinkSync, readdirSync as readdirSync2 } from "fs";
+import { join as join2 } from "path";
+var IS_WIN = process.platform === "win32";
+var IS_LINUX = process.platform === "linux";
+function runFile(cmd, args, timeoutMs = 5e3) {
+  try {
+    return execFileSync(cmd, args, { encoding: "utf-8", timeout: timeoutMs }).trim();
+  } catch {
+    return null;
+  }
+}
+function runShell(cmd, timeoutMs = 5e3) {
+  try {
+    return execSync(cmd, { encoding: "utf-8", timeout: timeoutMs }).trim();
+  } catch {
+    return null;
+  }
+}
+function getPidsOnPort_unix(port) {
+  const lsof = runFile("lsof", ["-ti", `:${port}`], 5e3);
+  if (lsof) {
+    return lsof.split("\n").map(Number).filter((n) => n > 0);
+  }
+  if (IS_LINUX) {
+    const ss = runShell(`ss -tlnp 2>/dev/null | grep ':${port} '`);
+    if (ss) {
+      const pids = [];
+      for (const match of ss.matchAll(/pid=(\d+)/g)) {
+        pids.push(parseInt(match[1], 10));
+      }
+      return [...new Set(pids)];
+    }
+  }
+  return [];
+}
+function getPidsOnPort_win(port) {
+  const out = runShell(`netstat -ano | findstr :${port} | findstr LISTENING`);
+  if (!out) return [];
+  const pids = [];
+  for (const line of out.split("\n")) {
+    const parts = line.trim().split(/\s+/);
+    const pid = parseInt(parts[parts.length - 1], 10);
+    if (pid > 0) pids.push(pid);
+  }
+  return [...new Set(pids)];
+}
+function getPidsOnPort(port) {
+  return IS_WIN ? getPidsOnPort_win(port) : getPidsOnPort_unix(port);
+}
+function getListenPorts_unix(pid) {
+  const lsof = runShell(`lsof -nP -p ${pid} 2>/dev/null | grep LISTEN`, 3e3);
+  if (lsof) {
+    const ports = [];
+    for (const line of lsof.split("\n")) {
+      const match = line.match(/:(\d+)\s+\(LISTEN\)/);
+      if (match) ports.push(parseInt(match[1], 10));
+    }
+    return [...new Set(ports)];
+  }
+  if (IS_LINUX) {
+    const ss = runShell(`ss -tlnp 2>/dev/null | grep 'pid=${pid},'`, 3e3);
+    if (ss) {
+      const ports = [];
+      for (const match of ss.matchAll(/:(\d+)\s/g)) {
+        ports.push(parseInt(match[1], 10));
+      }
+      return [...new Set(ports)];
+    }
+  }
+  return [];
+}
+function getListenPorts_win(pid) {
+  const out = runShell(`netstat -ano | findstr ${pid} | findstr LISTENING`);
+  if (!out) return [];
+  const ports = [];
+  for (const line of out.split("\n")) {
+    const match = line.match(/:(\d+)\s/);
+    if (match) {
+      const port = parseInt(match[1], 10);
+      const linePid = parseInt(line.trim().split(/\s+/).pop(), 10);
+      if (linePid === pid) ports.push(port);
+    }
+  }
+  return [...new Set(ports)];
+}
+function getListenPorts(pid) {
+  return IS_WIN ? getListenPorts_win(pid) : getListenPorts_unix(pid);
+}
+function getProcessCwd_mac(pid) {
+  const out = runShell(`lsof -p ${pid} 2>/dev/null | grep cwd`, 3e3);
+  if (!out) return void 0;
+  const match = out.match(/cwd\s+\w+\s+\w+\s+\d+\w?\s+\d+\s+\d+\s+\d+\s+(.+)/);
+  return match?.[1]?.trim();
+}
+function getProcessCwd_linux(pid) {
+  try {
+    return readlinkSync(`/proc/${pid}/cwd`);
+  } catch {
+    return getProcessCwd_mac(pid);
+  }
+}
+function getProcessCwd(pid) {
+  if (IS_WIN) return void 0;
+  if (IS_LINUX) return getProcessCwd_linux(pid);
+  return getProcessCwd_mac(pid);
+}
+function findPidsInDir_lsof(dir) {
+  const out = runShell(`lsof -t +D "${dir}" 2>/dev/null | head -20`);
+  if (!out) return [];
+  return out.split("\n").map(Number).filter((n) => n > 0);
+}
+function findPidsInDir_linux(dir) {
+  const lsofResult = findPidsInDir_lsof(dir);
+  if (lsofResult.length > 0) return lsofResult;
+  try {
+    const pids = [];
+    for (const entry of readdirSync2("/proc")) {
+      const pid = parseInt(entry, 10);
+      if (isNaN(pid) || pid <= 1) continue;
+      try {
+        const cwd = readlinkSync(join2("/proc", entry, "cwd"));
+        if (cwd.startsWith(dir)) pids.push(pid);
+      } catch {
+      }
+    }
+    return pids;
+  } catch {
+    return [];
+  }
+}
+function findPidsInDirectory(dir) {
+  if (IS_WIN) return [];
+  if (IS_LINUX) return findPidsInDir_linux(dir);
+  return findPidsInDir_lsof(dir);
+}
+function parseProcessList_unix() {
+  const output = runFile("ps", ["aux"]);
+  if (!output) return [];
+  const lines = output.split("\n").slice(1);
+  const results = [];
+  for (const line of lines) {
+    const parts = line.trim().split(/\s+/);
+    if (parts.length < 11) continue;
+    const pid = parseInt(parts[1], 10);
+    const cpu = parseFloat(parts[2]);
+    const mem = parseFloat(parts[3]);
+    const command = parts.slice(10).join(" ");
+    if (isNaN(pid)) continue;
+    results.push({ pid, cpu, mem, command });
+  }
+  return results;
+}
+function parseProcessList_win() {
+  const output = runFile("tasklist", ["/FO", "CSV", "/NH"], 1e4);
+  if (!output) return [];
+  const results = [];
+  for (const line of output.split("\n")) {
+    const parts = line.match(/"([^"]*)"/g);
+    if (!parts || parts.length < 5) continue;
+    const pid = parseInt(parts[1].replace(/"/g, ""), 10);
+    const command = parts[0].replace(/"/g, "");
+    const memStr = parts[4].replace(/"/g, "").replace(/[, K]/gi, "");
+    const mem = parseInt(memStr, 10) / 1024;
+    if (isNaN(pid)) continue;
+    results.push({ pid, cpu: 0, mem, command });
+  }
+  return results;
+}
+function parseProcessList() {
+  return IS_WIN ? parseProcessList_win() : parseProcessList_unix();
+}
+function getProcessMemoryMB_unix(pid) {
+  const out = runFile("ps", ["-o", "rss=", "-p", String(pid)], 2e3);
+  if (!out) return 0;
+  const rss = parseInt(out, 10);
+  return isNaN(rss) ? 0 : rss / 1024;
+}
+function getProcessMemoryMB_win(pid) {
+  const out = runFile("tasklist", ["/FI", `PID eq ${pid}`, "/FO", "CSV", "/NH"], 3e3);
+  if (!out) return 0;
+  const parts = out.match(/"([^"]*)"/g);
+  if (!parts || parts.length < 5) return 0;
+  const memStr = parts[4].replace(/"/g, "").replace(/[, K]/gi, "");
+  const kb = parseInt(memStr, 10);
+  return isNaN(kb) ? 0 : kb / 1024;
+}
+function getProcessMemoryMB(pid) {
+  return IS_WIN ? getProcessMemoryMB_win(pid) : getProcessMemoryMB_unix(pid);
+}
+
 // src/session-manager.ts
 var SessionManager = class {
   projectManager;
@@ -1622,9 +1907,9 @@ import { WebSocketServer as WebSocketServer2 } from "ws";
 // src/pm/pm-routes.ts
 import { readdir, readFile, writeFile, unlink, mkdir } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { homedir as homedir2 } from "os";
-import { spawn, execSync, execFileSync } from "child_process";
+import { spawn, execFileSync as execFileSync2 } from "child_process";
 var LOG_RING_SIZE = 500;
 var managedProcesses = /* @__PURE__ */ new Map();
 function pushLog(mp, stream, line) {
@@ -1934,13 +2219,13 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       helpers.json(res, { data: [], count: 0 });
       return;
     }
-    const memoryDir = join2(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory");
+    const memoryDir = join3(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory");
     try {
       const files = await readdir(memoryDir);
       const mdFiles = files.filter((f) => f.endsWith(".md"));
       const result = await Promise.all(
         mdFiles.map(async (filename) => {
-          const content = await readFile(join2(memoryDir, filename), "utf-8");
+          const content = await readFile(join3(memoryDir, filename), "utf-8");
           return { filename, content, sizeBytes: Buffer.byteLength(content) };
         })
       );
@@ -1957,7 +2242,7 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       helpers.json(res, { error: "Project not found" }, 404);
       return;
     }
-    const filePath = join2(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory", filename);
+    const filePath = join3(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory", filename);
     try {
       const content = await readFile(filePath, "utf-8");
       helpers.json(res, { filename, content, sizeBytes: Buffer.byteLength(content) });
@@ -1980,9 +2265,9 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
     }
     try {
       const { content } = JSON.parse(body);
-      const memoryDir = join2(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory");
+      const memoryDir = join3(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory");
       await mkdir(memoryDir, { recursive: true });
-      await writeFile(join2(memoryDir, filename), content, "utf-8");
+      await writeFile(join3(memoryDir, filename), content, "utf-8");
       helpers.json(res, { ok: true });
     } catch (err) {
       helpers.json(res, { error: err.message }, 500);
@@ -1996,7 +2281,7 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       helpers.json(res, { error: "Project not found" }, 404);
       return;
     }
-    const filePath = join2(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory", filename);
+    const filePath = join3(homedir2(), ".claude", "projects", project.claudeProjectKey, "memory", filename);
     try {
       await unlink(filePath);
       helpers.json(res, { ok: true });
@@ -2056,7 +2341,7 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       const { content } = JSON.parse(body);
       const paths = getRulesPaths(project.claudeProjectKey, project.path);
       const filePath = paths[scope];
-      const dir = join2(filePath, "..");
+      const dir = join3(filePath, "..");
       await mkdir(dir, { recursive: true });
       await writeFile(filePath, content, "utf-8");
       helpers.json(res, { ok: true });
@@ -2076,7 +2361,7 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       return;
     }
     try {
-      const pkgPath = join2(project.path, "package.json");
+      const pkgPath = join3(project.path, "package.json");
       const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
       const scripts = pkg.scripts ?? {};
       const recommended = ["dev", "start", "serve"].find((s) => s in scripts) ?? null;
@@ -2246,15 +2531,8 @@ function createPmRouter(pmStore, discovery, helpers, broadcastDevServer) {
       }
       managedProcesses.delete(id);
     } else if (project.path) {
-      try {
-        const output = execSync(
-          `lsof -t +D "${project.path}" 2>/dev/null | head -5`,
-          { encoding: "utf-8", timeout: 5e3 }
-        ).trim();
-        const pids = output.split("\n").filter(Boolean).map(Number).filter((n) => n > 1 && n !== process.pid);
-        if (pids.length > 0) pid = pids[0];
-      } catch {
-      }
+      const pids = findPidsInDirectory(project.path).filter((n) => n > 1 && n !== process.pid);
+      if (pids.length > 0) pid = pids[0];
     }
     if (!pid) {
       helpers.json(res, { error: "No running dev server found for this project" }, 404);
@@ -2509,17 +2787,17 @@ function sanitizeFilename(name) {
 function getRulesPaths(claudeProjectKey, projectPath) {
   const home = homedir2();
   return {
-    global: join2(home, ".claude", "CLAUDE.md"),
-    project: claudeProjectKey ? join2(home, ".claude", "projects", claudeProjectKey, "CLAUDE.md") : join2(projectPath ?? "", ".claude", "CLAUDE.md"),
-    local: projectPath ? join2(projectPath, "CLAUDE.md") : join2(home, "CLAUDE.md")
+    global: join3(home, ".claude", "CLAUDE.md"),
+    project: claudeProjectKey ? join3(home, ".claude", "projects", claudeProjectKey, "CLAUDE.md") : join3(projectPath ?? "", ".claude", "CLAUDE.md"),
+    local: projectPath ? join3(projectPath, "CLAUDE.md") : join3(home, "CLAUDE.md")
   };
 }
 function execGit(args, cwd) {
-  return execFileSync("git", args, { cwd, encoding: "utf-8", timeout: 1e4, maxBuffer: 10 * 1024 * 1024 });
+  return execFileSync2("git", args, { cwd, encoding: "utf-8", timeout: 1e4, maxBuffer: 10 * 1024 * 1024 });
 }
 function isGitRepo(path) {
   try {
-    execFileSync("git", ["rev-parse", "--git-dir"], { cwd: path, encoding: "utf-8", timeout: 3e3 });
+    execFileSync2("git", ["rev-parse", "--git-dir"], { cwd: path, encoding: "utf-8", timeout: 3e3 });
     return true;
   } catch {
     return false;
@@ -2582,6 +2860,8 @@ var HttpServer = class {
   activePort = 9091;
   startedAt = Date.now();
   connectedSessionsGetter = null;
+  pmStore = null;
+  projectManager = null;
   constructor(store, processMonitor, options) {
     this.store = store;
     this.processMonitor = processMonitor ?? null;
@@ -2589,6 +2869,8 @@ var HttpServer = class {
     this.allowedOrigins = options?.allowedOrigins ?? null;
     this.rateLimiter = options?.rateLimiter ?? null;
     this.connectedSessionsGetter = options?.getConnectedSessions ?? null;
+    this.pmStore = options?.pmStore ?? null;
+    this.projectManager = options?.projectManager ?? null;
     this.registerRoutes();
     if (options?.pmStore && options?.discovery) {
       this.pmRouter = createPmRouter(options.pmStore, options.discovery, {
@@ -2620,12 +2902,14 @@ var HttpServer = class {
           existing.sessions.push(s.sessionId);
           existing.eventCount += s.eventCount;
           if (s.isConnected) existing.isConnected = true;
+          if (!existing.projectId && s.projectId) existing.projectId = s.projectId;
         } else {
           projectMap.set(s.appName, {
             appName: s.appName,
             sessions: [s.sessionId],
             isConnected: s.isConnected,
-            eventCount: s.eventCount
+            eventCount: s.eventCount,
+            projectId: s.projectId
           });
         }
       }
@@ -2695,7 +2979,8 @@ var HttpServer = class {
         sinceSeconds: numParam(params, "since_seconds"),
         urlPattern: params.get("url_pattern") ?? void 0,
         method: params.get("method") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2704,7 +2989,8 @@ var HttpServer = class {
         sinceSeconds: numParam(params, "since_seconds"),
         level: params.get("level") ?? void 0,
         search: params.get("search") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2712,7 +2998,8 @@ var HttpServer = class {
       const events = this.store.getStateEvents({
         sinceSeconds: numParam(params, "since_seconds"),
         storeId: params.get("store_id") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2720,7 +3007,8 @@ var HttpServer = class {
       const events = this.store.getRenderEvents({
         sinceSeconds: numParam(params, "since_seconds"),
         componentName: params.get("component") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2728,7 +3016,8 @@ var HttpServer = class {
       const events = this.store.getPerformanceMetrics({
         sinceSeconds: numParam(params, "since_seconds"),
         metricName: params.get("metric") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2738,7 +3027,8 @@ var HttpServer = class {
         table: params.get("table") ?? void 0,
         minDurationMs: numParam(params, "min_duration_ms"),
         search: params.get("search") ?? void 0,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2747,7 +3037,8 @@ var HttpServer = class {
       const events = this.store.getEventTimeline({
         sinceSeconds: numParam(params, "since_seconds"),
         eventTypes,
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2755,7 +3046,18 @@ var HttpServer = class {
       const events = this.store.getCustomEvents({
         name: params.get("name") ?? void 0,
         sinceSeconds: numParam(params, "since_seconds"),
-        sessionId: params.get("session_id") ?? void 0
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
+      });
+      this.json(res, { data: events, count: events.length });
+    });
+    this.routes.set("GET /api/events/ui", (_req, res, params) => {
+      const action = params.get("action");
+      const events = this.store.getUIInteractions({
+        action: action ?? void 0,
+        sinceSeconds: numParam(params, "since_seconds"),
+        sessionId: params.get("session_id") ?? void 0,
+        projectId: params.get("project_id") ?? void 0
       });
       this.json(res, { data: events, count: events.length });
     });
@@ -2777,6 +3079,7 @@ var HttpServer = class {
         return;
       }
       const payload = parsed;
+      const projectId = typeof payload.projectId === "string" ? payload.projectId : payload.appName && this.projectManager ? getOrCreateProjectId(this.projectManager, payload.appName) : void 0;
       if (!payload.sessionId || !Array.isArray(payload.events) || payload.events.length === 0) {
         this.json(res, {
           error: "Required: sessionId (string), events (non-empty array)",
@@ -2793,9 +3096,16 @@ var HttpServer = class {
           timestamp: Date.now(),
           eventType: "session",
           appName: payload.appName,
+          projectId,
           connectedAt: Date.now(),
           sdkVersion: payload.sdkVersion ?? "http"
         });
+        if (this.pmStore) {
+          try {
+            this.pmStore.autoLinkApp(payload.appName, projectId);
+          } catch {
+          }
+        }
       }
       const VALID_EVENT_TYPES = /* @__PURE__ */ new Set([
         "network",
@@ -2806,6 +3116,9 @@ var HttpServer = class {
         "dom_snapshot",
         "performance",
         "database",
+        "custom",
+        "navigation",
+        "ui",
         "recon_metadata",
         "recon_design_tokens",
         "recon_fonts",
@@ -3124,11 +3437,11 @@ function numParam(params, key) {
 }
 
 // src/pm/pm-store.ts
-import Database2 from "better-sqlite3";
+import Database from "better-sqlite3";
 var PmStore = class {
   db;
   constructor(options) {
-    this.db = new Database2(options.dbPath);
+    this.db = new Database(options.dbPath);
     if (options.walMode !== false) {
       this.db.pragma("journal_mode = WAL");
     }
@@ -3265,6 +3578,10 @@ var PmStore = class {
       this.db.exec("ALTER TABLE pm_projects ADD COLUMN runtime_apps TEXT DEFAULT NULL");
     } catch {
     }
+    try {
+      this.db.exec("ALTER TABLE pm_projects ADD COLUMN runtime_project_id TEXT DEFAULT NULL");
+    } catch {
+    }
   }
   // ============================================================
   // Projects
@@ -3350,6 +3667,10 @@ var PmStore = class {
       sets.push("runtimescope_project = ?");
       params.push(updates.runtimescopeProject ?? null);
     }
+    if (updates.runtimeProjectId !== void 0) {
+      sets.push("runtime_project_id = ?");
+      params.push(updates.runtimeProjectId ?? null);
+    }
     if (updates.metadata !== void 0) {
       sets.push("metadata = ?");
       params.push(JSON.stringify(updates.metadata));
@@ -3360,6 +3681,55 @@ var PmStore = class {
     params.push(id);
     this.db.prepare(`UPDATE pm_projects SET ${sets.join(", ")} WHERE id = ?`).run(...params);
   }
+  /**
+   * Auto-link an SDK appName to a PM project.
+   * Matches by: exact name, directory basename, runtimescopeProject, or existing runtimeApps.
+   * Returns the project ID if linked, null if no match found.
+   */
+  autoLinkApp(appName, projectId) {
+    const projects = this.listProjects();
+    const appLower = appName.toLowerCase();
+    if (projectId) {
+      const byProjectId = projects.find((p) => p.runtimeProjectId === projectId);
+      if (byProjectId) {
+        const apps2 = byProjectId.runtimeApps ?? [];
+        if (!apps2.some((a) => a.toLowerCase() === appLower)) {
+          apps2.push(appName);
+          this.updateProject(byProjectId.id, { runtimeApps: apps2 });
+        }
+        return byProjectId.id;
+      }
+    }
+    const alreadyLinked = projects.find(
+      (p) => p.runtimeApps?.some((a) => a.toLowerCase() === appLower)
+    );
+    if (alreadyLinked) {
+      if (projectId && !alreadyLinked.runtimeProjectId) {
+        this.updateProject(alreadyLinked.id, { runtimeProjectId: projectId });
+      }
+      return alreadyLinked.id;
+    }
+    const match = projects.find((p) => {
+      if (p.name.toLowerCase() === appLower) return true;
+      if (p.path) {
+        const basename3 = p.path.replace(/\/+$/, "").split("/").pop()?.toLowerCase();
+        if (basename3 === appLower) return true;
+      }
+      if (p.runtimescopeProject?.toLowerCase() === appLower) return true;
+      return false;
+    });
+    if (!match) return null;
+    const apps = match.runtimeApps ?? [];
+    if (!apps.some((a) => a.toLowerCase() === appLower)) {
+      apps.push(appName);
+    }
+    const updates = { runtimeApps: apps };
+    if (projectId && !match.runtimeProjectId) {
+      updates.runtimeProjectId = projectId;
+    }
+    this.updateProject(match.id, updates);
+    return match.id;
+  }
   listCategories() {
     const rows = this.db.prepare("SELECT DISTINCT category FROM pm_projects WHERE category IS NOT NULL ORDER BY category ASC").all();
     return rows.map((r) => r.category);
@@ -3371,6 +3741,7 @@ var PmStore = class {
       path: row.path ?? void 0,
       claudeProjectKey: row.claude_project_key ?? void 0,
       runtimescopeProject: row.runtimescope_project ?? void 0,
+      runtimeProjectId: row.runtime_project_id ?? void 0,
       runtimeApps: row.runtime_apps ? JSON.parse(row.runtime_apps) : void 0,
       phase: row.phase,
       managementAuthorized: row.management_authorized === 1,
@@ -3668,6 +4039,7 @@ var PmStore = class {
         p.category,
         p.sdk_installed,
         p.runtimescope_project,
+        p.runtime_apps,
         COUNT(s.id) as session_count,
         COALESCE(SUM(s.cost_microdollars), 0) as total_cost,
         COALESCE(SUM(s.active_minutes), 0) as total_active_minutes,
@@ -4206,13 +4578,13 @@ async function parseSessionJsonl(jsonlPath, sessionId, projectId) {
 
 // src/pm/project-discovery.ts
 import { readdir as readdir2, readFile as readFile2, stat as stat2 } from "fs/promises";
-import { join as join3, basename as basename2 } from "path";
+import { join as join4, basename as basename2 } from "path";
 import { existsSync as existsSync5 } from "fs";
 import { homedir as homedir3 } from "os";
 var LOG_PREFIX = "[RuntimeScope PM]";
 async function detectSdkInstalled(projectPath) {
   try {
-    const pkgPath = join3(projectPath, "package.json");
+    const pkgPath = join4(projectPath, "package.json");
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
     if ("@runtimescope/sdk" in allDeps || "@runtimescope/server-sdk" in allDeps) {
@@ -4222,13 +4594,13 @@ async function detectSdkInstalled(projectPath) {
       const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : pkg.workspaces.packages ?? [];
       for (const ws of workspaces) {
         const wsBase = ws.replace(/\/?\*$/, "");
-        const wsDir = join3(projectPath, wsBase);
+        const wsDir = join4(projectPath, wsBase);
         try {
           const entries = await readdir2(wsDir, { withFileTypes: true });
           for (const entry of entries) {
             if (!entry.isDirectory()) continue;
             try {
-              const wsPkg = JSON.parse(await readFile2(join3(wsDir, entry.name, "package.json"), "utf-8"));
+              const wsPkg = JSON.parse(await readFile2(join4(wsDir, entry.name, "package.json"), "utf-8"));
               const wsDeps = { ...wsPkg.dependencies, ...wsPkg.devDependencies };
               if ("@runtimescope/sdk" in wsDeps || "@runtimescope/server-sdk" in wsDeps) {
                 return true;
@@ -4243,7 +4615,7 @@ async function detectSdkInstalled(projectPath) {
   } catch {
   }
   try {
-    await stat2(join3(projectPath, "node_modules", "@runtimescope"));
+    await stat2(join4(projectPath, "node_modules", "@runtimescope"));
     return true;
   } catch {
     return false;
@@ -4286,7 +4658,7 @@ function resolvePathSegments(parts) {
     }
     for (let count = remaining.length; count >= 1; count--) {
       const segment = remaining.slice(0, count).join("-");
-      const candidate = join3(prefix, segment);
+      const candidate = join4(prefix, segment);
       if (count === remaining.length) {
         if (existsSync5(candidate)) return candidate;
       } else {
@@ -4313,7 +4685,7 @@ var ProjectDiscovery = class {
   constructor(pmStore, projectManager, claudeBaseDir) {
     this.pmStore = pmStore;
     this.projectManager = projectManager;
-    this.claudeBaseDir = claudeBaseDir ?? join3(homedir3(), ".claude");
+    this.claudeBaseDir = claudeBaseDir ?? join4(homedir3(), ".claude");
   }
   claudeBaseDir;
   /**
@@ -4346,7 +4718,7 @@ var ProjectDiscovery = class {
       sessionsUpdated: 0,
       errors: []
     };
-    const projectsDir = join3(this.claudeBaseDir, "projects");
+    const projectsDir = join4(this.claudeBaseDir, "projects");
     try {
       await stat2(projectsDir);
     } catch {
@@ -4399,9 +4771,14 @@ var ProjectDiscovery = class {
           const sourcePath = existing?.path ?? projectDir;
           const sdkInstalled = await detectSdkInstalled(sourcePath);
           if (existing) {
+            const apps = existing.runtimeApps ?? [];
+            if (!apps.some((a) => a.toLowerCase() === projectName.toLowerCase())) {
+              apps.push(projectName);
+            }
             const updated = {
               ...existing,
               runtimescopeProject: projectName,
+              runtimeApps: apps,
               sdkInstalled: sdkInstalled || existing.sdkInstalled,
               updatedAt: now
             };
@@ -4414,6 +4791,7 @@ var ProjectDiscovery = class {
               name: projectName,
               path: fsPath,
               runtimescopeProject: projectName,
+              runtimeApps: [projectName],
               phase: "application_development",
               managementAuthorized: false,
               probableToComplete: true,
@@ -4452,10 +4830,10 @@ var ProjectDiscovery = class {
     if (!project.claudeProjectKey) {
       return 0;
     }
-    const projectDir = join3(this.claudeBaseDir, "projects", project.claudeProjectKey);
+    const projectDir = join4(this.claudeBaseDir, "projects", project.claudeProjectKey);
     let sessionsIndexed = 0;
     try {
-      const indexPath = join3(projectDir, "sessions-index.json");
+      const indexPath = join4(projectDir, "sessions-index.json");
       let indexEntries = null;
       try {
         const indexContent = await readFile2(indexPath, "utf-8");
@@ -4468,7 +4846,7 @@ var ProjectDiscovery = class {
       for (const jsonlFile of jsonlFiles) {
         try {
           const sessionId = jsonlFile.replace(".jsonl", "");
-          const jsonlPath = join3(projectDir, jsonlFile);
+          const jsonlPath = join4(projectDir, jsonlFile);
           const fileStat = await stat2(jsonlPath);
           const fileSize = fileStat.size;
           const existingSession = await this.pmStore.getSession(sessionId);
@@ -4503,7 +4881,7 @@ var ProjectDiscovery = class {
    * Process a single Claude project directory key.
    */
   async processClaudeProject(key, result) {
-    const projectDir = join3(this.claudeBaseDir, "projects", key);
+    const projectDir = join4(this.claudeBaseDir, "projects", key);
     let fsPath = decodeClaudeKey(key);
     if (!fsPath) {
       fsPath = await this.resolvePathFromIndex(projectDir);
@@ -4555,7 +4933,7 @@ var ProjectDiscovery = class {
    */
   async resolvePathFromIndex(projectDir) {
     try {
-      const indexPath = join3(projectDir, "sessions-index.json");
+      const indexPath = join4(projectDir, "sessions-index.json");
       const content = await readFile2(indexPath, "utf-8");
       const index = JSON.parse(content);
       const entry = index.entries?.find((e) => e.projectPath);
@@ -4570,11 +4948,11 @@ var ProjectDiscovery = class {
    */
   async indexSessionsForClaudeProject(projectId, claudeKey) {
     const counts = { discovered: 0, updated: 0 };
-    const projectDir = join3(this.claudeBaseDir, "projects", claudeKey);
+    const projectDir = join4(this.claudeBaseDir, "projects", claudeKey);
     try {
       let indexEntries = null;
       try {
-        const indexPath = join3(projectDir, "sessions-index.json");
+        const indexPath = join4(projectDir, "sessions-index.json");
         const indexContent = await readFile2(indexPath, "utf-8");
         const index = JSON.parse(indexContent);
         indexEntries = index.entries ?? [];
@@ -4585,7 +4963,7 @@ var ProjectDiscovery = class {
       for (const jsonlFile of jsonlFiles) {
         try {
           const sessionId = jsonlFile.replace(".jsonl", "");
-          const jsonlPath = join3(projectDir, jsonlFile);
+          const jsonlPath = join4(projectDir, jsonlFile);
           const fileStat = await stat2(jsonlPath);
           const fileSize = fileStat.size;
           const existingSession = await this.pmStore.getSession(sessionId);
@@ -4766,6 +5144,9 @@ export {
   __require,
   RingBuffer,
   EventStore,
+  generateProjectId,
+  isValidProjectId,
+  getOrCreateProjectId,
   SqliteStore,
   isSqliteAvailable,
   SessionRateLimiter,
@@ -4777,6 +5158,12 @@ export {
   generateApiKey,
   BUILT_IN_RULES,
   Redactor,
+  getPidsOnPort,
+  getListenPorts,
+  getProcessCwd,
+  findPidsInDirectory,
+  parseProcessList,
+  getProcessMemoryMB,
   SessionManager,
   HttpServer,
   PmStore,
@@ -4785,4 +5172,4 @@ export {
   parseSessionJsonl,
   ProjectDiscovery
 };
-//# sourceMappingURL=chunk-TUFSIGGJ.js.map
+//# sourceMappingURL=chunk-HZWALDZM.js.map