aipeek 0.2.9 → 0.2.10

package/dist/{chunk-7NJSWR7E.js → chunk-FBY5P5KH.js}

@@ -127,8 +127,8 @@ function detailPerformance(p) {
   const windowSec = (p.windowMs / 1e3).toFixed(1);
   lines.push(`=== Performance (${windowSec}s window) ===`);
   if (p.hiddenFrames > 0) {
-    lines.push(`\u26A0 Tab was backgrounded \u2014 ${p.hiddenFrames} hidden frames skipped (rAF throttling lies about timing)`);
-    lines.push("For accurate profiling: keep tab FOREGROUND + run /profile/reset before reproducing");
+    lines.push(`\u26A0 Tab was backgrounded or unfocused \u2014 ${p.hiddenFrames} throttled frames skipped (rAF throttling lies about timing)`);
+    lines.push("For accurate profiling: keep tab FOREGROUND + FOCUSED + run /profile/reset before reproducing");
   }
   lines.push(`MobX attribution: ${p.mobxPatched ? "ON" : "OFF"}`);
   if (!p.mobxPatched) {
@@ -182,7 +182,7 @@ function diffPerformance(before, after) {
   const bothSampledFrames = (beforeAll?.frames.total ?? 0) > 0 && (afterAll?.frames.total ?? 0) > 0;
   const sawDrops = (beforeAll?.frames.long ?? 0) > 0 || (afterAll?.frames.long ?? 0) > 0;
   const framesExercised = bothSampledFrames && sawDrops;
-  const afterBlind = (afterAll?.frames.total ?? 0) === 0 && afterSelf === 0;
+  const afterBlind = afterSelf === 0 && (beforeSelf > 0 || (afterAll?.frames.total ?? 0) === 0);
   let verdict;
   if (afterBlind) {
     verdict = "NO DATA";
@@ -198,7 +198,8 @@ function diffPerformance(before, after) {
   }
   out.push(`=== Perf diff: ${verdict} ===`);
   if (afterBlind) {
-    out.push("after-window recorded no frames and no self-time \u2014 tab backgrounded or idle. Re-run with the tab focused and the interaction reproduced.");
+    const why = (afterAll?.frames.total ?? 0) === 0 ? "recorded no frames and no re-renders" : `recorded frames but zero re-renders (was ${Math.round(beforeSelf)}ms self-time)`;
+    out.push(`after-window ${why} \u2014 tab backgrounded or workload not reproduced. Re-run with the tab focused and the interaction repeated.`);
     out.push("");
     return out.join("\n").trimEnd();
   }

package/dist/{chunk-7ALIH3JX.cjs → chunk-NJ3KST7P.cjs}

@@ -131,8 +131,8 @@ function detailPerformance(p) {
   const windowSec = (p.windowMs / 1e3).toFixed(1);
   lines.push(`=== Performance (${windowSec}s window) ===`);
   if (p.hiddenFrames > 0) {
-    lines.push(`\u26A0 Tab was backgrounded \u2014 ${p.hiddenFrames} hidden frames skipped (rAF throttling lies about timing)`);
-    lines.push("For accurate profiling: keep tab FOREGROUND + run /profile/reset before reproducing");
+    lines.push(`\u26A0 Tab was backgrounded or unfocused \u2014 ${p.hiddenFrames} throttled frames skipped (rAF throttling lies about timing)`);
+    lines.push("For accurate profiling: keep tab FOREGROUND + FOCUSED + run /profile/reset before reproducing");
   }
   lines.push(`MobX attribution: ${p.mobxPatched ? "ON" : "OFF"}`);
   if (!p.mobxPatched) {
@@ -186,7 +186,7 @@ function diffPerformance(before, after) {
   const bothSampledFrames = (_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _ => _.frames, 'access', _2 => _2.total]), () => ( 0))) > 0 && (_nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _3 => _3.frames, 'access', _4 => _4.total]), () => ( 0))) > 0;
   const sawDrops = (_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _5 => _5.frames, 'access', _6 => _6.long]), () => ( 0))) > 0 || (_nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _7 => _7.frames, 'access', _8 => _8.long]), () => ( 0))) > 0;
   const framesExercised = bothSampledFrames && sawDrops;
-  const afterBlind = (_nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _9 => _9.frames, 'access', _10 => _10.total]), () => ( 0))) === 0 && afterSelf === 0;
+  const afterBlind = afterSelf === 0 && (beforeSelf > 0 || (_nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _9 => _9.frames, 'access', _10 => _10.total]), () => ( 0))) === 0);
   let verdict;
   if (afterBlind) {
     verdict = "NO DATA";
@@ -202,7 +202,8 @@ function diffPerformance(before, after) {
   }
   out.push(`=== Perf diff: ${verdict} ===`);
   if (afterBlind) {
-    out.push("after-window recorded no frames and no self-time \u2014 tab backgrounded or idle. Re-run with the tab focused and the interaction reproduced.");
+    const why = (_nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _11 => _11.frames, 'access', _12 => _12.total]), () => ( 0))) === 0 ? "recorded no frames and no re-renders" : `recorded frames but zero re-renders (was ${Math.round(beforeSelf)}ms self-time)`;
+    out.push(`after-window ${why} \u2014 tab backgrounded or workload not reproduced. Re-run with the tab focused and the interaction repeated.`);
     out.push("");
     return out.join("\n").trimEnd();
   }
@@ -214,13 +215,13 @@ function diffPerformance(before, after) {
     out.push(`Longtasks: ${before.longtasks.count} \u2192 ${after.longtasks.count}`);
   }
   out.push("");
-  const compDelta = keyedTotalDelta(_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _11 => _11.components]), () => ( {})), _nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _12 => _12.components]), () => ( {})));
+  const compDelta = keyedTotalDelta(_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _13 => _13.components]), () => ( {})), _nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _14 => _14.components]), () => ( {})));
   if (compDelta.length > 0) {
     out.push("Components (\u0394 total self-time):");
     for (const d of compDelta) out.push("  " + formatDelta(d));
     out.push("");
   }
-  const lineDelta = keyedTotalDelta(_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _13 => _13.lines]), () => ( {})), _nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _14 => _14.lines]), () => ( {})));
+  const lineDelta = keyedTotalDelta(_nullishCoalesce(_optionalChain([beforeAll, 'optionalAccess', _15 => _15.lines]), () => ( {})), _nullishCoalesce(_optionalChain([afterAll, 'optionalAccess', _16 => _16.lines]), () => ( {})));
   if (lineDelta.length > 0) {
     out.push("Hot lines (\u0394 total inclusive time):");
     for (const d of lineDelta) out.push("  " + formatDelta(d));
@@ -231,8 +232,8 @@ function keyedTotalDelta(a, b) {
   const keys = /* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(b)]);
   const rows = [];
   for (const key of keys) {
-    const beforeT = _nullishCoalesce(_optionalChain([a, 'access', _15 => _15[key], 'optionalAccess', _16 => _16.total]), () => ( 0));
-    const afterT = _nullishCoalesce(_optionalChain([b, 'access', _17 => _17[key], 'optionalAccess', _18 => _18.total]), () => ( 0));
+    const beforeT = _nullishCoalesce(_optionalChain([a, 'access', _17 => _17[key], 'optionalAccess', _18 => _18.total]), () => ( 0));
+    const afterT = _nullishCoalesce(_optionalChain([b, 'access', _19 => _19[key], 'optionalAccess', _20 => _20.total]), () => ( 0));
     const delta = afterT - beforeT;
     if (Math.round(delta) === 0) continue;
     rows.push({ key, before: beforeT, after: afterT, delta, isNew: !a[key], gone: !b[key] });
@@ -349,7 +350,7 @@ function formatActions(entries, anchorTs) {
 }
 function appendAction(log, tab, entry, max) {
   const last = log[log.length - 1];
-  if (entry.type === "input" && _optionalChain([last, 'optionalAccess', _19 => _19.type]) === "input" && last.tab === tab && last.target === entry.target) {
+  if (entry.type === "input" && _optionalChain([last, 'optionalAccess', _21 => _21.type]) === "input" && last.tab === tab && last.target === entry.target) {
     log[log.length - 1] = { ...entry, tab };
     return;
   }
@@ -360,7 +361,7 @@ function appendAction(log, tab, entry, max) {
 function uiChange(prev, cur) {
   if (cur.modal === void 0)
     return "";
-  const prevModal = _nullishCoalesce(_optionalChain([prev, 'optionalAccess', _20 => _20.modal]), () => ( "none"));
+  const prevModal = _nullishCoalesce(_optionalChain([prev, 'optionalAccess', _22 => _22.modal]), () => ( "none"));
   if (cur.modal !== prevModal) {
     if (cur.modal === "none")
       return "\u5F39\u7A97\u5173\u95ED";
@@ -910,7 +911,7 @@ function emit(state) {
   for (const key of SECTIONS) {
     if (state[key]) {
       const countKey = COUNTED_SECTIONS[key];
-      const count = countKey ? _nullishCoalesce(_optionalChain([state, 'access', _21 => _21.counts, 'optionalAccess', _22 => _22[countKey]]), () => ( 0)) : 0;
+      const count = countKey ? _nullishCoalesce(_optionalChain([state, 'access', _23 => _23.counts, 'optionalAccess', _24 => _24[countKey]]), () => ( 0)) : 0;
       const attr = count ? ` count="${count}"` : "";
       sections.push(`<${key}${attr}>
 ${state[key]}
@@ -1265,9 +1266,9 @@ function aipeekPlugin() {
     const prev = tabs.get(data.tab);
     tabs.set(data.tab, {
       id: data.tab,
-      url: _nullishCoalesce(_nullishCoalesce(data.url, () => ( _optionalChain([prev, 'optionalAccess', _23 => _23.url]))), () => ( "")),
-      title: _nullishCoalesce(_nullishCoalesce(data.title, () => ( _optionalChain([prev, 'optionalAccess', _24 => _24.title]))), () => ( "")),
-      visible: _nullishCoalesce(_nullishCoalesce(data.visible, () => ( _optionalChain([prev, 'optionalAccess', _25 => _25.visible]))), () => ( false)),
+      url: _nullishCoalesce(_nullishCoalesce(data.url, () => ( _optionalChain([prev, 'optionalAccess', _25 => _25.url]))), () => ( "")),
+      title: _nullishCoalesce(_nullishCoalesce(data.title, () => ( _optionalChain([prev, 'optionalAccess', _26 => _26.title]))), () => ( "")),
+      visible: _nullishCoalesce(_nullishCoalesce(data.visible, () => ( _optionalChain([prev, 'optionalAccess', _27 => _27.visible]))), () => ( false)),
       lastSeen: Date.now()
     });
   }
@@ -1276,7 +1277,7 @@ function aipeekPlugin() {
   const actionLog = [];
   const BOOT_ID = Date.now().toString(36);
   const mergeActions = (tab, actions) => {
-    if (!tab || !_optionalChain([actions, 'optionalAccess', _26 => _26.length]))
+    if (!tab || !_optionalChain([actions, 'optionalAccess', _28 => _28.length]))
       return;
     for (const entry of actions) {
       if (!actionLog.some((e) => e.tab === tab && e.ts === entry.ts))
@@ -1521,7 +1522,7 @@ function aipeekPlugin() {
             const r = await fetch(target, { method: req.method, body });
             send(res, r.status, await r.text());
           } catch (e) {
-            const code = _optionalChain([e, 'access', _27 => _27.cause, 'optionalAccess', _28 => _28.code]);
+            const code = _optionalChain([e, 'access', _29 => _29.cause, 'optionalAccess', _30 => _30.code]);
             const why = code === "ECONNREFUSED" ? `nothing is listening on ${host} \u2014 its dev server isn't running (start it), or the port is wrong.` : code === "ENOTFOUND" ? `host '${host}' doesn't resolve \u2014 check the hostname.` : code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" ? `connection to ${host} timed out \u2014 it's unreachable (firewall, or wrong host).` : `${e.message} (code ${_nullishCoalesce(code, () => ( "unknown"))}).`;
             send(res, 502, `cannot reach aipeek peer at ${host}: ${why}`);
           }

package/dist/index.cjs

@@ -5,7 +5,7 @@
 
 
 
-var _chunk7ALIH3JXcjs = require('./chunk-7ALIH3JX.cjs');
+var _chunkNJ3KST7Pcjs = require('./chunk-NJ3KST7P.cjs');
 require('./chunk-Z2Y65YOY.cjs');
 
 
@@ -14,4 +14,4 @@ require('./chunk-Z2Y65YOY.cjs');
 
 
 
-exports.aipeekPlugin = _chunk7ALIH3JXcjs.aipeekPlugin; exports.check = _chunk7ALIH3JXcjs.check; exports.diffState = _chunk7ALIH3JXcjs.diffState; exports.emitCheck = _chunk7ALIH3JXcjs.emitCheck; exports.emitDiff = _chunk7ALIH3JXcjs.emitDiff; exports.emitSummary = _chunk7ALIH3JXcjs.emitSummary;
+exports.aipeekPlugin = _chunkNJ3KST7Pcjs.aipeekPlugin; exports.check = _chunkNJ3KST7Pcjs.check; exports.diffState = _chunkNJ3KST7Pcjs.diffState; exports.emitCheck = _chunkNJ3KST7Pcjs.emitCheck; exports.emitDiff = _chunkNJ3KST7Pcjs.emitDiff; exports.emitSummary = _chunkNJ3KST7Pcjs.emitSummary;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   emitCheck,
   emitDiff,
   emitSummary
-} from "./chunk-7NJSWR7E.js";
+} from "./chunk-FBY5P5KH.js";
 export {
   aipeekPlugin,
   check,

package/dist/plugin.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunk7ALIH3JXcjs = require('./chunk-7ALIH3JX.cjs');
+var _chunkNJ3KST7Pcjs = require('./chunk-NJ3KST7P.cjs');
 require('./chunk-Z2Y65YOY.cjs');
 
 
@@ -12,4 +12,4 @@ require('./chunk-Z2Y65YOY.cjs');
 
 
 
-exports.END_TAG = _chunk7ALIH3JXcjs.END_TAG; exports.START_TAG = _chunk7ALIH3JXcjs.START_TAG; exports.aipeekPlugin = _chunk7ALIH3JXcjs.aipeekPlugin; exports.injectClaudeMd = _chunk7ALIH3JXcjs.injectClaudeMd; exports.renderClaudeMd = _chunk7ALIH3JXcjs.renderClaudeMd;
+exports.END_TAG = _chunkNJ3KST7Pcjs.END_TAG; exports.START_TAG = _chunkNJ3KST7Pcjs.START_TAG; exports.aipeekPlugin = _chunkNJ3KST7Pcjs.aipeekPlugin; exports.injectClaudeMd = _chunkNJ3KST7Pcjs.injectClaudeMd; exports.renderClaudeMd = _chunkNJ3KST7Pcjs.renderClaudeMd;

package/dist/plugin.js

@@ -4,7 +4,7 @@ import {
   aipeekPlugin,
   injectClaudeMd,
   renderClaudeMd
-} from "./chunk-7NJSWR7E.js";
+} from "./chunk-FBY5P5KH.js";
 export {
   END_TAG,
   START_TAG,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aipeek",
-    "version": "0.2.9",
+    "version": "0.2.10",
     "description": "Gives AI a peek into your running browser app — UI tree, console, network, errors, state",
     "license": "MIT",
     "repository": {

package/src/client/client-patch.ts

@@ -129,16 +129,19 @@ function hitFrame(dt: number) {
     }
 }
 
-// (b) Frame loop — zero-coupling, holds for any app. document.hidden guard: backgrounded rAF
-// throttles to ~1fps, so each hidden frame looks like a 1000ms "dropped" frame and lies.
-// Don't count dt while hidden; tally hiddenFrames so the report can flag it.
+// (b) Frame loop — zero-coupling, holds for any app. Throttle guard: a backgrounded OR unfocused
+// window throttles rAF to ~1fps, so each such frame looks like a ~1000ms "dropped" frame and lies.
+// document.hidden only fires when the TAB is switched away; a window that's merely unfocused
+// (another app has focus, minimized, fully occluded) keeps document.hidden=false yet the OS still
+// throttles its rAF — same lie, different probe. document.hasFocus() catches that second case.
+// Don't count dt while throttled; tally hiddenFrames so the report can flag it.
 const WARN_THRESHOLD = 20 // dropped% — push warning when ≥20% frames jank
 const WARN_COOLDOWN = 5000 // ms — don't spam, at most one warn per 5s
 let lastFrame = performance.now()
 let lastWarn = 0
 function frameLoop() {
     const now = performance.now()
-    if (document.hidden) {
+    if (document.hidden || !document.hasFocus()) {
         perf.hiddenFrames += 1
         lastFrame = now
         requestAnimationFrame(frameLoop)

package/src/client/client.ts

@@ -775,16 +775,41 @@ if (import.meta.hot) {
     hello()
     addEventListener('visibilitychange', hello)
 
-    // WS-death beacon for the HTTP heartbeat in client-patch. The whole action chain rides this
-    // HMR socket; when it drops, Vite's own reconnect (client.mjs waitForSuccessfulPing) is
-    // GATED on document.visibilityState === 'visible' — so a backgrounded Electron window (we
-    // app.hide() on launch, and backgroundThrottling throttles it) never reconnects and never
-    // reloads, stranding the chain on a dead socket while BOOT_ID is unchanged. client-patch
-    // can't see import.meta.hot (it's a non-module inline script), so we surface liveness as a
-    // global flag it polls: WS dead + ping OK + same BOOT_ID → it forces the reload Vite won't.
-    import.meta.hot.on('vite:ws:disconnect', () => { (window as { __aipeek_ws_dead__?: boolean }).__aipeek_ws_dead__ = true })
+    // Self-heal a dropped HMR socket. The whole action chain rides this WS; when it drops,
+    // Vite's own reconnect (client.mjs waitForSuccessfulPing) is GATED on visibilityState ===
+    // 'visible', so a backgrounded tab/window (Electron we app.hide() on launch) never reconnects
+    // and never reloads — stranding the chain on a dead socket while BOOT_ID is unchanged.
+    //
+    // The fix is EVENT-DRIVEN, not polled. An earlier version set a flag for the client-patch
+    // HTTP heartbeat to notice — but a long-lived background setInterval is exactly what the
+    // browser throttles/freezes (verified: a page-load-time interval stops firing in a long-
+    // backgrounded tab, while the WS message channel stays instantly live). So we act the moment
+    // vite:ws:disconnect fires: kick off a short self-bound setTimeout poll (armed by the event,
+    // not a resident timer) that waits for /ping to answer, then reloads to re-handshake. We also
+    // keep the global flag for the heartbeat as a belt-and-suspenders second trigger.
+    const wsDead = (v: boolean) => { (window as { __aipeek_ws_dead__?: boolean }).__aipeek_ws_dead__ = v }
+    let healing = false
+    const healAfterDrop = async () => {
+        if (healing) return
+        healing = true
+        // Poll the HTTP heartbeat (independent of the dead WS). Once the server answers, reload.
+        // setTimeout (re-armed per tick) rather than setInterval: a fresh timer scheduled right
+        // after live activity resists the background freeze that kills resident intervals.
+        const tick = async () => {
+            try {
+                await fetch('/__aipeek/ping', { cache: 'no-store' })
+                location.reload() // server reachable again → re-handshake the WS via a fresh load
+            }
+            catch {
+                setTimeout(tick, 2000) // server still down — keep waiting, don't reload on failure
+            }
+        }
+        tick()
+    }
+    import.meta.hot.on('vite:ws:disconnect', () => { wsDead(true); healAfterDrop() })
     import.meta.hot.on('vite:ws:connect', () => {
-        ;(window as { __aipeek_ws_dead__?: boolean }).__aipeek_ws_dead__ = false
+        wsDead(false)
+        healing = false
         hello() // socket came back without a page reload — re-register so roster doesn't go stale
     })
 

package/src/core/perf.ts

@@ -77,8 +77,8 @@ export function detailPerformance(p: PerformanceData): string {
     const windowSec = (p.windowMs / 1000).toFixed(1)
     lines.push(`=== Performance (${windowSec}s window) ===`)
     if (p.hiddenFrames > 0) {
-        lines.push(`⚠ Tab was backgrounded — ${p.hiddenFrames} hidden frames skipped (rAF throttling lies about timing)`)
-        lines.push('For accurate profiling: keep tab FOREGROUND + run /profile/reset before reproducing')
+        lines.push(`⚠ Tab was backgrounded or unfocused — ${p.hiddenFrames} throttled frames skipped (rAF throttling lies about timing)`)
+        lines.push('For accurate profiling: keep tab FOREGROUND + FOCUSED + run /profile/reset before reproducing')
     }
     lines.push(`MobX attribution: ${p.mobxPatched ? 'ON' : 'OFF'}`)
     if (!p.mobxPatched) {
@@ -175,12 +175,16 @@ export function diffPerformance(before: PerformanceData, after: PerformanceData)
     const sawDrops = (beforeAll?.frames.long ?? 0) > 0 || (afterAll?.frames.long ?? 0) > 0
     const framesExercised = bothSampledFrames && sawDrops
 
-    // Blind-window guard: a backgrounded after-tab records NEITHER frames (rAF frozen) NOR
-    // self-time (nothing re-renders, so Reaction.track never fires). Both signals are absent, so
-    // selfDelta = 0 - beforeSelf is a large negative → a FALSE "IMPROVED" off an empty window.
-    // (The fallback comment above assumed self-time survives backgrounding; live data disproved it
-    // — a hidden tab renders nothing.) No data is not a win: refuse to render any direction.
-    const afterBlind = (afterAll?.frames.total ?? 0) === 0 && afterSelf === 0
+    // Blind-window guard: the after-window must actually REPRODUCE the workload to be diffable.
+    // afterSelf===0 means zero components re-rendered. Two shapes both mean "workload not run":
+    //   (a) hard-blind — frames.total===0 too (rAF frozen, tab fully suspended);
+    //   (b) soft-blind — frames still ticked (rAF only throttled) but self-time is zero while the
+    //       before-window had real self-time. Frames alone then describe an idle tab's compositor,
+    //       not the render workload — a -5% frame delta off a backgrounded tab is NOT a code win.
+    // A genuine fix shows frames recovering AND self-time dropping in agreement; "frames still
+    // dropping but self-time vanished entirely" is the contradiction that betrays an idle after-tab.
+    // The pure-paint case (beforeSelf===0===afterSelf, frames>0) is NOT blind — it goes to frames.
+    const afterBlind = afterSelf === 0 && (beforeSelf > 0 || (afterAll?.frames.total ?? 0) === 0)
     let verdict: string
     if (afterBlind) {
         verdict = 'NO DATA'
@@ -197,7 +201,10 @@ export function diffPerformance(before: PerformanceData, after: PerformanceData)
 
     out.push(`=== Perf diff: ${verdict} ===`)
     if (afterBlind) {
-        out.push('after-window recorded no frames and no self-time — tab backgrounded or idle. Re-run with the tab focused and the interaction reproduced.')
+        const why = (afterAll?.frames.total ?? 0) === 0
+            ? 'recorded no frames and no re-renders'
+            : `recorded frames but zero re-renders (was ${Math.round(beforeSelf)}ms self-time)`
+        out.push(`after-window ${why} — tab backgrounded or workload not reproduced. Re-run with the tab focused and the interaction repeated.`)
         out.push('')
         return out.join('\n').trimEnd()
     }