cap inspector modificationHistory at 200 entries

Pre-cap, modificationHistory was an unbounded module-scoped array that
grew for every CSS edit through $B css across the entire session.
Small per-entry footprint but no upper bound, the kind of slow leak
that compounds over multi-day inspector use.

Cap is 200, oldest evicted on push past the cap. modHistoryTotalPushed
stays monotonic across the session so undoModification can tell the
user when their target index has been evicted, instead of just the
opaque pre-cap "No modification at index 500" with no context.

__testInternals export lets the cap + eviction error be unit-tested
without spinning up a CDP-driven Page. Production code must continue
to go through modifyStyle / undoModification / resetModifications.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

browse/src/cdp-inspector.ts

@@ -139,7 +139,41 @@ async function getOrCreateSession(page: Page): Promise<any> {
 
 // ─── Modification History ───────────────────────────────────────
 
+// Bounded FIFO of style modifications. Pre-cap, this was an unbounded
+// module-scoped array that grew for every CSS edit made through $B css
+// across the whole browser session — small per-entry footprint but no
+// upper bound, the kind of slow leak that compounds over multi-day
+// inspector use. The cap is 200 because per-session undo workflows
+// rarely walk back more than a handful of edits, and a user who really
+// wants to roll a long change back can `$B css reset` to revert all of
+// them. totalPushed is monotonic across the session so undoModification
+// can tell the user when their target index has been evicted, instead
+// of just "no modification at index N".
+const MOD_HISTORY_CAP = 200;
 const modificationHistory: StyleModification[] = [];
+let modHistoryTotalPushed = 0;
+
+function pushModification(mod: StyleModification): void {
+  modificationHistory.push(mod);
+  modHistoryTotalPushed++;
+  while (modificationHistory.length > MOD_HISTORY_CAP) {
+    modificationHistory.shift();
+  }
+}
+
+// Test-only entry: exposes the history-cap mechanics (push, reset, cap value)
+// without requiring a CDP-driven Page. Production code must go through
+// modifyStyle / undoModification / resetModifications.
+export const __testInternals = {
+  pushModification,
+  MOD_HISTORY_CAP,
+  getRawHistory: () => modificationHistory.slice(),
+  getTotalPushed: () => modHistoryTotalPushed,
+  resetForTest: () => {
+    modificationHistory.length = 0;
+    modHistoryTotalPushed = 0;
+  },
+};
 
 // ─── Specificity Calculation ────────────────────────────────────
 
@@ -568,7 +602,7 @@ export async function modifyStyle(
     method,
   };
 
-  modificationHistory.push(modification);
+  pushModification(modification);
   return modification;
 }
 
@@ -578,7 +612,12 @@ export async function modifyStyle(
 export async function undoModification(page: Page, index?: number): Promise<void> {
   const idx = index ?? modificationHistory.length - 1;
   if (idx < 0 || idx >= modificationHistory.length) {
-    throw new Error(`No modification at index ${idx}. History has ${modificationHistory.length} entries.`);
+    const evictedNote = modHistoryTotalPushed > MOD_HISTORY_CAP
+      ? ` (most recent ${MOD_HISTORY_CAP} only — ${modHistoryTotalPushed - MOD_HISTORY_CAP} earlier entries evicted at the cap)`
+      : '';
+    throw new Error(
+      `No modification at index ${idx}. History has ${modificationHistory.length} entries${evictedNote}.`,
+    );
   }
 
   const mod = modificationHistory[idx];
@@ -657,6 +696,7 @@ export async function resetModifications(page: Page): Promise<void> {
     }
   }
   modificationHistory.length = 0;
+  modHistoryTotalPushed = 0;
 }
 
 /**