forge-remote 2.2.0 → 2.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-remote",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Desktop relay for Forge Remote — monitor and control Claude Code sessions from your phone",
   "type": "module",
   "license": "UNLICENSED",

package/src/claude-session-watcher.js

@@ -44,6 +44,16 @@ const TOOL_RESULT_TRUNCATE_BYTES = 8 * 1024;
 // outputs occasionally exceed Firestore limits; truncate with a marker.
 const TEXT_TRUNCATE_BYTES = 64 * 1024;
 
+// First-sight backfill cap. When mirroring is enabled on a project that
+// already has a multi-MB session.jsonl on disk (e.g., a long-running
+// conversation), we don't want to dump the entire history into Firestore —
+// that's slow, expensive, and almost certainly not what the user wants.
+// Instead, jump near the end of the file and ingest only the last chunk
+// so the user gets a few hundred recent events for context. New sessions
+// (file size <= the threshold) are processed from byte 0 as normal.
+const INITIAL_BACKFILL_THRESHOLD_BYTES = 256 * 1024;
+const INITIAL_BACKFILL_TAIL_BYTES = 64 * 1024;
+
 // File-event types in the .jsonl that aren't user-visible — skip silently.
 const SKIP_TYPES = new Set([
   "queue-operation",
@@ -353,6 +363,11 @@ async function processFile(absPath) {
       offset: 0,
       idleTimer: null,
       sessionDocReady: false,
+      // True once we've decided where to start reading. Stays false until
+      // the user has opted in AND we've applied the initial-backfill rule
+      // below — that way the bootstrap only runs once, on the first real
+      // read attempt, not on every "add" event for a non-mirrored project.
+      bootstrapped: false,
     };
     fileState.set(absPath, state);
 
@@ -361,6 +376,7 @@ async function processFile(absPath) {
     const saved = cursors[absPath];
     if (saved && typeof saved.offset === "number") {
       state.offset = saved.offset;
+      state.bootstrapped = true; // saved cursor wins over backfill heuristic
     }
   }
 
@@ -373,6 +389,24 @@ async function processFile(absPath) {
   } catch {
     return;
   }
+
+  // First-sight bootstrap: if we don't have a saved cursor and the file is
+  // already larger than the threshold (because Claude has been writing to
+  // it before mirroring was enabled), jump close to the end so we ingest
+  // only the most recent chunk. Without this, opting in on a long-running
+  // session would dump the entire history into Firestore.
+  if (!state.bootstrapped) {
+    if (stat.size > INITIAL_BACKFILL_THRESHOLD_BYTES) {
+      state.offset = stat.size - INITIAL_BACKFILL_TAIL_BYTES;
+      log.info(
+        `claude-session-watcher: ${state.sessionId.slice(0, 8)} ` +
+          `large existing file (${(stat.size / 1024 / 1024).toFixed(1)}MB) — ` +
+          `tail-only from byte ${state.offset}`,
+      );
+    }
+    state.bootstrapped = true;
+  }
+
   if (stat.size <= state.offset) return;
 
   // If the file shrunk (rotation? unlikely for jsonl but possible), reset.