@agentpulselabs/cli-plugin-pulse 1.1.3 → 1.1.6

package/src/runner/transcriptFeed.js

@@ -0,0 +1,88 @@
+// Cursor transcript writes, noticed within about a second: the hub's lib/transcript-feed.mjs with the same passes and
+// the same notices, except that a folder is listed again only when its own mtime moved (an entry was added, removed
+// or renamed). Its fast pass listed every session folder of every active project every second, ~770 readdir calls a
+// second on a busy Mac; here that is a stat per folder, and a readdir only for the folders that changed.
+import fs from 'node:fs';
+import path from 'node:path';
+
+const FAST_MS = 1000;
+const FULL_MS = 30e3;
+const ACTIVE_MS = 6 * 3600e3;
+
+const safe = (fn, fallback) => { try { return fn(); } catch { return fallback; } };
+const sig = (file) => safe(() => { const s = fs.statSync(file); return { m: s.mtimeMs, z: s.size }; }, null);
+
+export function watchTranscripts(projectsDir, onChange, { fastMs = FAST_MS, fullMs = FULL_MS, activeMs = ACTIVE_MS } = {}) {
+  const seen = new Map();
+  const activeSessions = new Set();
+  const activeRoots = new Set();
+  /** folder → { m, entries }: its listing as of its mtime `m`. */
+  const listings = new Map();
+
+  const list = (dir) => {
+    const m = safe(() => fs.statSync(dir).mtimeMs, null);
+    if (m === null) { listings.delete(dir); return []; }
+    const hit = listings.get(dir);
+    if (hit && hit.m === m) return hit.entries;
+    const entries = safe(() => fs.readdirSync(dir, { withFileTypes: true }).map((d) => ({ name: d.name, dir: d.isDirectory() })), []);
+    listings.set(dir, { m, entries });
+    return entries;
+  };
+  const dirs = (dir) => list(dir).filter((e) => e.dir).map((e) => e.name);
+  const jsonl = (dir) => list(dir).filter((e) => e.name.endsWith('.jsonl')).map((e) => path.join(dir, e.name));
+  const sessionFiles = (sessionDir) => [...jsonl(sessionDir), ...jsonl(path.join(sessionDir, 'subagents'))];
+
+  const check = (file, now, notify) => {
+    const s = sig(file);
+    if (!s) return false;
+    const was = seen.get(file);
+    seen.set(file, s);
+    if (notify && (!was || was.m !== s.m || was.z !== s.z)) onChange(file);
+    return now - s.m < activeMs;
+  };
+
+  const full = (notify) => {
+    const now = Date.now();
+    activeSessions.clear();
+    activeRoots.clear();
+    const present = new Set();
+    for (const project of dirs(projectsDir)) {
+      const root = path.join(projectsDir, project, 'agent-transcripts');
+      const sessions = dirs(root);
+      if (!sessions.length) continue;
+      present.add(root);
+      const rootRecent = now - (sig(root)?.m || 0) < activeMs;
+      let any = false;
+      for (const id of sessions) {
+        const dir = path.join(root, id);
+        present.add(dir).add(path.join(dir, 'subagents'));
+        let live = false;
+        for (const f of sessionFiles(dir)) live = check(f, now, notify) || live;
+        if (live) { activeSessions.add(dir); any = true; }
+      }
+      if (any || rootRecent) activeRoots.add(root);
+    }
+    present.add(projectsDir);
+    for (const dir of listings.keys()) if (!present.has(dir)) listings.delete(dir);
+    for (const file of seen.keys()) if (!present.has(path.dirname(file))) seen.delete(file);
+  };
+
+  const fast = () => {
+    const now = Date.now();
+    for (const root of activeRoots) {
+      for (const id of dirs(root)) {
+        const dir = path.join(root, id);
+        if (!activeSessions.has(dir) && sessionFiles(dir).some((f) => !seen.has(f))) activeSessions.add(dir);
+      }
+    }
+    for (const dir of activeSessions) for (const f of sessionFiles(dir)) check(f, now, true);
+  };
+
+  full(false);
+  const timers = [setInterval(() => safe(fast), fastMs), setInterval(() => safe(() => full(true)), fullMs)];
+  for (const t of timers) t.unref();
+  return {
+    watching: () => ({ sessions: activeSessions.size, projects: activeRoots.size }),
+    close: () => { for (const t of timers) clearInterval(t); },
+  };
+}