@scalebun/web 1.0.0

package/dist/features/watchdog/config.js

@@ -0,0 +1,28 @@
+/**
+ * W5.2 — Resource Watchdog thresholds + options.
+ *
+ * These are WEB defaults, NOT mobile's: mobile's ProfilerIncidentThresholds were calibrated against a
+ * ~2 s native RSS sample cadence; web samples heap every 20–30 s through quantized `performance.memory`
+ * and reads CPU load as coarse Compute-Pressure states. Every value here is a starting point to be
+ * calibrated during dogfood — the `thresholds` init option exists so this needs no SDK release to tune.
+ */
+export const DEFAULT_THRESHOLDS = {
+    pressureSustainMs: 6000,
+    lagP95Ms: 500,
+    mainThreadStallMs: 500,
+    jankBurstCount: 5,
+    jankWindowMs: 10000,
+    frozenFrameMs: 700,
+    memSurgeBytesPerSec: 6 * 1024 * 1024, // 6 MiB/s — web starting point (dogfood-calibrated)
+    leakSamples: 10, // ≈ 5 min at a 30 s memory cadence
+    leakMinBytes: 50 * 1024 * 1024, // 50 MiB cumulative growth
+    heapUsedRatio: 0.9,
+    cooldownMs: 60000,
+};
+/** Global incident rate cap (a session-wide backstop above the per-type cooldowns). */
+export const RATE_WINDOW_MS = 10 * 60000; // 10 min
+export const RATE_MAX = 10;
+export function resolveThresholds(o) {
+    return o ? { ...DEFAULT_THRESHOLDS, ...o } : DEFAULT_THRESHOLDS;
+}
+//# sourceMappingURL=config.js.map

package/dist/features/watchdog/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/features/watchdog/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,iBAAiB,EAAE,IAAK;IACxB,QAAQ,EAAE,GAAG;IACb,iBAAiB,EAAE,GAAG;IACtB,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,KAAM;IACpB,aAAa,EAAE,GAAG;IAClB,mBAAmB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,oDAAoD;IAC1F,WAAW,EAAE,EAAE,EAAE,mCAAmC;IACpD,YAAY,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,2BAA2B;IAC3D,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,KAAM;CACnB,CAAC;AAkBF,uFAAuF;AACvF,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,KAAM,CAAC,CAAC,SAAS;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,iBAAiB,CAAC,CAA+B;IAC/D,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,kBAAkB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC;AAClE,CAAC"}

package/dist/features/watchdog/engine.d.ts

@@ -0,0 +1,22 @@
+/**
+ * W5.2 — Resource-Watchdog orchestrator (LAZY chunk). Owns everything but the feature-detect+import:
+ * the per-session sampling gate, the browser collectors + shared jank tap wired into the pure
+ * IncidentEngine and the HealthRollup, the perf-item emit, and the `resource_pressure` signal. Kept out
+ * of the eager shell so the core bundle gate holds and nothing here loads for non-watchdog tenants.
+ */
+import type { FeatureContext } from '@scalebun/sdk-contracts';
+export interface WatchdogStats {
+    incidents: number;
+    droppedIncidents: number;
+    rollups: number;
+    tiers: {
+        pressure: boolean;
+        memory: boolean;
+    };
+}
+export interface WatchdogHandle {
+    stop: () => void;
+    stats: () => WatchdogStats;
+}
+export declare function startWatchdog(ctx: FeatureContext): WatchdogHandle;
+//# sourceMappingURL=engine.d.ts.map

package/dist/features/watchdog/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/features/watchdog/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAU9D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,aAAa,CAAC;CAC5B;AA4BD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,CAgGjE"}

package/dist/features/watchdog/engine.js

@@ -0,0 +1,123 @@
+import { uuid, now, getReplayCoord } from '../../core';
+import { fnv1a32 } from '../config/bucketing';
+import { onJank } from '../performance/jankTap';
+import { flameAvailable, captureFlameWindow } from '../profiler/capture';
+import { IncidentEngine } from './incidents';
+import { HealthRollup } from './rollup';
+import { startCollectors } from './collectors';
+import { resolveThresholds } from './config';
+const NOOP = {
+    stop: () => { },
+    stats: () => ({ incidents: 0, droppedIncidents: 0, rollups: 0, tiers: { pressure: false, memory: false } }),
+};
+/** Deterministic per-session keep (server-reconcilable), matching the perf tail-sampler's fnv1a32 style. */
+function keepSession(sessionId, rate) {
+    const r = rate ?? 1;
+    if (r >= 1)
+        return true;
+    if (r <= 0)
+        return false;
+    return fnv1a32(`${sessionId ?? ''}:wzb-watchdog-v1`) % 100 < r * 100;
+}
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// W5.3 — a flame window per incident is expensive; cap it to at most one per minute even under an
+// incident burst (the per-type cooldowns + rate cap already bound incidents, this bounds profiling).
+const FLAME_WINDOW_MS = 10000;
+const FLAME_COOLDOWN_MS = 60000;
+export function startWatchdog(ctx) {
+    const opts = (ctx.watchdogOptions ?? {});
+    if (!keepSession(ctx.sessionId, opts.sampleRate))
+        return NOOP; // not a sampled session
+    const emit = (metric, value, metadata, clientId) => {
+        const replay = getReplayCoord();
+        ctx.emit({
+            kind: 'performance',
+            metric,
+            value,
+            screenName: currentScreen(),
+            metadata: replay ? { ...metadata, replay } : metadata, // frame-accurate incident→replay deep-link
+            clientId: clientId ?? `wd_${uuid()}`,
+            timestamp: now(),
+        });
+    };
+    // W5.3 — Tier-2 escalation: when an incident fires and the page opted into the js-profiling header,
+    // capture a short flame window and ship it as `js_profile` back-linked to the incident. No-op without
+    // the header — so flame capture happens automatically only where it's available AND at the moment it matters.
+    const captureProfile = opts.captureProfileOnIncident !== false;
+    let capturing = false;
+    let lastFlameAt = 0;
+    const maybeCaptureFlame = (incidentClientId) => {
+        if (!captureProfile || capturing || !flameAvailable())
+            return;
+        const t = now();
+        if (t - lastFlameAt < FLAME_COOLDOWN_MS)
+            return;
+        lastFlameAt = t;
+        capturing = true;
+        void captureFlameWindow(FLAME_WINDOW_MS)
+            .then((res) => {
+            if (res)
+                emit('js_profile', res.samples, { profile: res.profile, format: 'w3c-js-self-profiling', incidentClientId });
+        })
+            .finally(() => {
+            capturing = false;
+        });
+    };
+    const th = resolveThresholds(opts.thresholds);
+    const rollup = new HealthRollup();
+    let incidentCount = 0;
+    let rollups = 0;
+    const pressureAvailable = typeof globalThis.PressureObserver === 'function';
+    const engine = new IncidentEngine({
+        thresholds: th,
+        now,
+        pressureAvailable,
+        onIncident: (inc) => {
+            incidentCount++;
+            rollup.noteIncident();
+            const incidentClientId = `wd_${uuid()}`;
+            emit('resource_incident', inc.value ?? 1, inc, incidentClientId);
+            // Arm replay capture-on-signal + let engage react (e.g. a "having trouble?" survey).
+            ctx.signal('resource_pressure');
+            // Tier-2: grab a flame trace of the live jank, linked back to this incident (header-gated).
+            maybeCaptureFlame(incidentClientId);
+        },
+    });
+    const offJank = onJank((r) => engine.onJank(r)); // JankTapReading is structurally engine.onJank's input
+    const handle = startCollectors({
+        onHeartbeat: (lag) => {
+            engine.onHeartbeat(lag);
+            rollup.onHeartbeat(lag);
+        },
+        onPressure: (s) => {
+            engine.onPressure(s);
+            rollup.onPressure(s);
+        },
+        onMemory: (used, limit) => {
+            engine.onMemory(used, limit);
+            rollup.onMemory(used);
+        },
+    }, { heartbeatMs: Math.max(250, opts.heartbeatMs ?? 1000), memorySampleMs: opts.memorySampleMs ?? 20000 });
+    const tiers = () => ({ pressure: pressureAvailable, memory: handle.memoryAvailable });
+    const rollupTimer = setInterval(() => {
+        rollups++;
+        const snap = rollup.drain(tiers(), engine.dropped);
+        emit('resource_health', snap.lagP95, snap);
+    }, opts.rollupMs ?? 30000);
+    return {
+        stop: () => {
+            clearInterval(rollupTimer);
+            offJank();
+            handle.stop();
+        },
+        stats: () => ({ incidents: incidentCount, droppedIncidents: engine.dropped, rollups, tiers: tiers() }),
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/features/watchdog/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/features/watchdog/engine.ts"],"names":[],"mappings":"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"}

package/dist/features/watchdog/incidents.d.ts

@@ -0,0 +1,79 @@
+/**
+ * W5.2 — Resource-Watchdog incident engine. PURE: no browser APIs, no timers — it consumes discrete
+ * readings pushed by the collectors and a `now()` clock, and calls `onIncident`. That makes the whole
+ * detection matrix exhaustively unit-testable with a synthetic clock (mobile's native detector, which
+ * can't run in CI, is the cautionary tale this design fixes).
+ *
+ * It ports mobile's incident heuristics with mobile's four reference bugs FIXED — windowed jank
+ * (not a cumulative counter), per-type cooldowns (not one global cooldown that shadows other types),
+ * a real dwell model for compute-pressure (which is edge-triggered, not sampled), — and implements
+ * `main_thread_stall` + `memory_leak_suspicion`, which mobile declares but never built.
+ */
+import type { WatchdogThresholds } from './config';
+export type Severity = 'info' | 'warning' | 'critical';
+export type Confidence = 'low' | 'medium' | 'high';
+export type IncidentType = 'cpu_spike' | 'main_thread_stall' | 'jank_burst' | 'frozen_frame' | 'memory_surge' | 'memory_leak_suspicion' | 'low_memory_pressure';
+export type PressureState = 'nominal' | 'fair' | 'serious' | 'critical';
+export interface JankReading {
+    metric: 'loaf' | 'longtask';
+    blockingMs: number;
+    frameDurationMs: number;
+    script?: {
+        url?: string;
+        invoker?: string;
+        fn?: string;
+    };
+}
+export interface Incident {
+    type: IncidentType;
+    severity: Severity;
+    confidence: Confidence;
+    startTs: number;
+    likelyCause: string;
+    description: string;
+    /** Provenance of the signal — the dashboard grades cross-browser claims honestly with this. */
+    tier: 'pressure' | 'lag-proxy' | 'loaf' | 'longtask' | 'memory';
+    value?: number;
+    script?: {
+        url?: string;
+        invoker?: string;
+        fn?: string;
+    };
+}
+export interface IncidentEngineDeps {
+    thresholds: WatchdogThresholds;
+    now: () => number;
+    /** Whether Compute Pressure is available — decides the cpu_spike model (dwell vs lag-proxy). */
+    pressureAvailable: boolean;
+    onIncident: (i: Incident) => void;
+}
+export declare class IncidentEngine {
+    private readonly th;
+    private readonly deps;
+    private lag;
+    private static readonly LAG_RING;
+    private pressure;
+    private pressureSince;
+    private jankAt;
+    private prevMem?;
+    private highSlopeStreak;
+    private memTrend;
+    private lastEmit;
+    private emitTimes;
+    private droppedCount;
+    constructor(deps: IncidentEngineDeps);
+    /** Dropped-by-rate-cap counter (surfaced on the health rollup — "no silent caps"). */
+    get dropped(): number;
+    /** One event-loop-lag heartbeat (ms of drift). Also serves as the periodic evaluate tick for the
+     *  time-based conditions (pressure dwell) so the engine needs no timer of its own. */
+    onHeartbeat(lagMs: number): void;
+    /** Compute-pressure state change (edge-triggered — fires only on transitions). */
+    onPressure(state: PressureState): void;
+    /** A LoAF / long-task reading (from the shared jank tap). */
+    onJank(r: JankReading): void;
+    /** A heap sample: used bytes + the heap limit (both from `performance.memory`, quantized). */
+    onMemory(usedBytes: number, limitBytes: number): void;
+    private evaluateCpu;
+    private emit;
+}
+//# sourceMappingURL=incidents.d.ts.map

package/dist/features/watchdog/incidents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.d.ts","sourceRoot":"","sources":["../../../src/features/watchdog/incidents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,mBAAmB,GACnB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,gGAAgG;IAChG,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC;AAQD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAG1C,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAGtC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,aAAa,CAAK;IAG1B,OAAO,CAAC,MAAM,CAAgB;IAG9B,OAAO,CAAC,OAAO,CAAC,CAA+B;IAC/C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAgB;IAGhC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAK;gBAEb,IAAI,EAAE,kBAAkB;IAKpC,sFAAsF;IACtF,IAAI,OAAO,IAAI,MAAM,CAEpB;IAGD;0FACsF;IACtF,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBhC,kFAAkF;IAClF,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOtC,6DAA6D;IAC7D,MAAM,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAmC5B,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAkErD,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,IAAI;CAYb"}

package/dist/features/watchdog/incidents.js

@@ -0,0 +1,204 @@
+import { RATE_MAX, RATE_WINDOW_MS } from './config';
+function p95(sorted) {
+    if (!sorted.length)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.floor(sorted.length * 0.95));
+    return sorted[idx];
+}
+export class IncidentEngine {
+    constructor(deps) {
+        // main-thread lag ring (for cpu_spike lag-proxy p95); bounded.
+        this.lag = [];
+        // compute-pressure dwell
+        this.pressure = 'nominal';
+        this.pressureSince = 0;
+        // jank sliding window (timestamps of readings)
+        this.jankAt = [];
+        this.highSlopeStreak = 0;
+        this.memTrend = []; // used-heap samples (for leak monotonicity)
+        // emit gating
+        this.lastEmit = new Map();
+        this.emitTimes = [];
+        this.droppedCount = 0;
+        this.deps = deps;
+        this.th = deps.thresholds;
+    }
+    /** Dropped-by-rate-cap counter (surfaced on the health rollup — "no silent caps"). */
+    get dropped() {
+        return this.droppedCount;
+    }
+    // ── inputs ────────────────────────────────────────────────────────────────────
+    /** One event-loop-lag heartbeat (ms of drift). Also serves as the periodic evaluate tick for the
+     *  time-based conditions (pressure dwell) so the engine needs no timer of its own. */
+    onHeartbeat(lagMs) {
+        this.lag.push(lagMs);
+        if (this.lag.length > IncidentEngine.LAG_RING)
+            this.lag.shift();
+        // main_thread_stall — a single bad tick.
+        if (lagMs >= this.th.mainThreadStallMs) {
+            this.emit({
+                type: 'main_thread_stall',
+                severity: lagMs >= 2000 ? 'critical' : 'warning',
+                confidence: 'high',
+                tier: 'lag-proxy',
+                value: Math.round(lagMs),
+                likelyCause: 'main thread blocked',
+                description: `The main thread was blocked for ${Math.round(lagMs)} ms.`,
+            });
+        }
+        this.evaluateCpu();
+    }
+    /** Compute-pressure state change (edge-triggered — fires only on transitions). */
+    onPressure(state) {
+        if (state === this.pressure)
+            return;
+        this.pressure = state;
+        this.pressureSince = this.deps.now();
+        this.evaluateCpu();
+    }
+    /** A LoAF / long-task reading (from the shared jank tap). */
+    onJank(r) {
+        const t = this.deps.now();
+        // frozen_frame — one very long frame.
+        if (r.frameDurationMs >= this.th.frozenFrameMs) {
+            this.emit({
+                type: 'frozen_frame',
+                severity: r.frameDurationMs >= 2000 ? 'critical' : 'warning',
+                confidence: 'high',
+                tier: r.metric,
+                value: Math.round(r.frameDurationMs),
+                script: r.script,
+                likelyCause: r.script?.url ? `long frame in ${r.script.url}` : 'long animation frame',
+                description: `A single frame took ${Math.round(r.frameDurationMs)} ms.`,
+            });
+        }
+        // jank_burst — N readings within a sliding window (fixes mobile's cumulative counter).
+        this.jankAt.push(t);
+        const cutoff = t - this.th.jankWindowMs;
+        while (this.jankAt.length && this.jankAt[0] < cutoff)
+            this.jankAt.shift();
+        if (this.jankAt.length >= this.th.jankBurstCount) {
+            this.emit({
+                type: 'jank_burst',
+                severity: 'warning',
+                confidence: 'medium',
+                tier: r.metric,
+                value: this.jankAt.length,
+                script: r.script,
+                likelyCause: r.script?.url ? `repeated jank in ${r.script.url}` : 'repeated main-thread jank',
+                description: `${this.jankAt.length} janky frames within ${Math.round(this.th.jankWindowMs / 1000)} s.`,
+            });
+        }
+    }
+    /** A heap sample: used bytes + the heap limit (both from `performance.memory`, quantized). */
+    onMemory(usedBytes, limitBytes) {
+        const t = this.deps.now();
+        // low_memory_pressure — near the ceiling.
+        if (limitBytes > 0 && usedBytes / limitBytes >= this.th.heapUsedRatio) {
+            this.emit({
+                type: 'low_memory_pressure',
+                severity: 'critical',
+                confidence: 'high',
+                tier: 'memory',
+                value: Math.round((usedBytes / limitBytes) * 100),
+                likelyCause: 'JS heap near its limit',
+                description: `Used heap is ${Math.round((usedBytes / limitBytes) * 100)}% of the limit.`,
+            });
+        }
+        // memory_surge — high growth rate sustained across 2 consecutive intervals (debounces quantization).
+        if (this.prevMem) {
+            const dt = (t - this.prevMem.at) / 1000;
+            const slope = dt > 0 ? (usedBytes - this.prevMem.used) / dt : 0;
+            if (slope > this.th.memSurgeBytesPerSec) {
+                this.highSlopeStreak++;
+                if (this.highSlopeStreak >= 2) {
+                    this.emit({
+                        type: 'memory_surge',
+                        severity: slope > 2 * this.th.memSurgeBytesPerSec ? 'critical' : 'warning',
+                        confidence: 'medium',
+                        tier: 'memory',
+                        value: Math.round(slope),
+                        likelyCause: 'rapid heap allocation',
+                        description: `Heap grew ~${Math.round(slope / (1024 * 1024))} MiB/s.`,
+                    });
+                }
+            }
+            else {
+                this.highSlopeStreak = 0;
+            }
+        }
+        this.prevMem = { used: usedBytes, at: t };
+        // memory_leak_suspicion — monotonic growth across N samples with a meaningful total.
+        this.memTrend.push(usedBytes);
+        if (this.memTrend.length > this.th.leakSamples)
+            this.memTrend.shift();
+        if (this.memTrend.length === this.th.leakSamples) {
+            let monotonic = true;
+            for (let i = 1; i < this.memTrend.length; i++) {
+                if (this.memTrend[i] < this.memTrend[i - 1]) {
+                    monotonic = false;
+                    break;
+                }
+            }
+            const growth = this.memTrend[this.memTrend.length - 1] - this.memTrend[0];
+            if (monotonic && growth >= this.th.leakMinBytes) {
+                this.emit({
+                    type: 'memory_leak_suspicion',
+                    severity: 'warning',
+                    confidence: 'low', // honest — heap growth can be legitimate; "suspicion" not "leak"
+                    tier: 'memory',
+                    value: Math.round(growth),
+                    likelyCause: 'monotonic heap growth',
+                    description: `Heap grew ~${Math.round(growth / (1024 * 1024))} MiB over ${this.memTrend.length} samples without release.`,
+                });
+            }
+        }
+    }
+    // ── cpu_spike (dwell on Chromium, lag-proxy elsewhere) ──────────────────────────
+    evaluateCpu() {
+        if (this.deps.pressureAvailable) {
+            if (this.pressure === 'critical' && this.deps.now() - this.pressureSince >= this.th.pressureSustainMs) {
+                this.emit({
+                    type: 'cpu_spike',
+                    severity: 'critical',
+                    confidence: 'high',
+                    tier: 'pressure',
+                    likelyCause: 'sustained CPU pressure',
+                    description: `CPU stayed under critical pressure for ${Math.round(this.th.pressureSustainMs / 1000)}s+.`,
+                });
+            }
+            return;
+        }
+        // Universal fallback: lag p95 over the trailing ring (need a few samples to be meaningful).
+        if (this.lag.length < 6)
+            return;
+        const val = p95([...this.lag].sort((a, b) => a - b));
+        if (val > this.th.lagP95Ms) {
+            this.emit({
+                type: 'cpu_spike',
+                severity: val > 2 * this.th.lagP95Ms ? 'critical' : 'warning',
+                confidence: 'medium',
+                tier: 'lag-proxy',
+                value: Math.round(val),
+                likelyCause: 'sustained event-loop lag',
+                description: `Event-loop lag p95 was ${Math.round(val)} ms.`,
+            });
+        }
+    }
+    // ── emit gating (per-type cooldown + global rate cap) ───────────────────────────
+    emit(base) {
+        const t = this.deps.now();
+        if (t - (this.lastEmit.get(base.type) ?? -Infinity) < this.th.cooldownMs)
+            return; // per-type cooldown
+        this.emitTimes = this.emitTimes.filter((x) => t - x < RATE_WINDOW_MS);
+        if (this.emitTimes.length >= RATE_MAX) {
+            this.droppedCount++; // global backstop — surfaced on the rollup, never silent
+            return;
+        }
+        this.lastEmit.set(base.type, t);
+        this.emitTimes.push(t);
+        this.deps.onIncident({ ...base, startTs: t });
+    }
+}
+IncidentEngine.LAG_RING = 32;
+//# sourceMappingURL=incidents.js.map

package/dist/features/watchdog/incidents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.js","sourceRoot":"","sources":["../../../src/features/watchdog/incidents.ts"],"names":[],"mappings":"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"}

package/dist/features/watchdog/rollup.d.ts

@@ -0,0 +1,41 @@
+import type { PressureState } from './incidents';
+export interface HealthSnapshot {
+    lagP50: number;
+    lagP95: number;
+    lagMax: number;
+    heartbeats: number;
+    pressure?: Record<PressureState, number>;
+    heap?: {
+        firstBytes: number;
+        lastBytes: number;
+        slopeBytesPerSec: number;
+    };
+    incidents: number;
+    droppedIncidents: number;
+    /** Honest cross-browser provenance: which enrichment tiers were live this window. */
+    tiers: {
+        pressure: boolean;
+        memory: boolean;
+    };
+}
+export declare class HealthRollup {
+    private lags;
+    private pressureCounts;
+    private sawPressure;
+    private memFirst?;
+    private memFirstAt;
+    private memLast?;
+    private memLastAt;
+    private incidents;
+    onHeartbeat(lagMs: number): void;
+    onPressure(state: PressureState): void;
+    onMemory(usedBytes: number): void;
+    noteIncident(): void;
+    /** Produce the snapshot and reset per-window counters. `droppedIncidents` is the engine's running
+     *  rate-cap drop count (monotonic) — passed in so the snapshot can surface "no silent caps". */
+    drain(tiers: {
+        pressure: boolean;
+        memory: boolean;
+    }, droppedIncidents: number): HealthSnapshot;
+}
+//# sourceMappingURL=rollup.d.ts.map

package/dist/features/watchdog/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../../src/features/watchdog/rollup.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IAEtB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAGhC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAItC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASjC,YAAY,IAAI,IAAI;IAIpB;oGACgG;IAChG,KAAK,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc;CA+B/F"}

package/dist/features/watchdog/rollup.js

@@ -0,0 +1,76 @@
+/**
+ * W5.2 — windowed health rollup. Accumulates the same collector outputs the incident engine sees and,
+ * once per rollup window, produces ONE `resource_health` snapshot (lag percentiles, pressure-state
+ * distribution, heap slope, incident/drop counts, honest tier availability). Rollups — not raw samples —
+ * are what egress, so a session costs ≤ ~2 perf items/min regardless of sampling cadence.
+ */
+import { now } from '../../core';
+function pct(sorted, q) {
+    if (!sorted.length)
+        return 0;
+    return sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * q))];
+}
+export class HealthRollup {
+    constructor() {
+        this.lags = [];
+        this.pressureCounts = { nominal: 0, fair: 0, serious: 0, critical: 0 };
+        this.sawPressure = false;
+        this.memFirstAt = 0;
+        this.memLastAt = 0;
+        this.incidents = 0;
+    }
+    onHeartbeat(lagMs) {
+        this.lags.push(lagMs);
+    }
+    onPressure(state) {
+        this.pressureCounts[state]++;
+        this.sawPressure = true;
+    }
+    onMemory(usedBytes) {
+        const t = now();
+        if (this.memFirst == null) {
+            this.memFirst = usedBytes;
+            this.memFirstAt = t;
+        }
+        this.memLast = usedBytes;
+        this.memLastAt = t;
+    }
+    noteIncident() {
+        this.incidents++;
+    }
+    /** Produce the snapshot and reset per-window counters. `droppedIncidents` is the engine's running
+     *  rate-cap drop count (monotonic) — passed in so the snapshot can surface "no silent caps". */
+    drain(tiers, droppedIncidents) {
+        const sorted = [...this.lags].sort((a, b) => a - b);
+        const snap = {
+            lagP50: Math.round(pct(sorted, 0.5)),
+            lagP95: Math.round(pct(sorted, 0.95)),
+            lagMax: sorted.length ? Math.round(sorted[sorted.length - 1]) : 0,
+            heartbeats: this.lags.length,
+            incidents: this.incidents,
+            droppedIncidents,
+            tiers,
+        };
+        if (this.sawPressure)
+            snap.pressure = { ...this.pressureCounts };
+        if (this.memLast != null && this.memFirst != null) {
+            const dt = (this.memLastAt - this.memFirstAt) / 1000;
+            snap.heap = {
+                firstBytes: this.memFirst,
+                lastBytes: this.memLast,
+                slopeBytesPerSec: dt > 0 ? Math.round((this.memLast - this.memFirst) / dt) : 0,
+            };
+        }
+        // Reset window; carry the last heap reading forward as the next window's baseline.
+        this.lags = [];
+        this.pressureCounts = { nominal: 0, fair: 0, serious: 0, critical: 0 };
+        this.sawPressure = false;
+        this.incidents = 0;
+        if (this.memLast != null) {
+            this.memFirst = this.memLast;
+            this.memFirstAt = now();
+        }
+        return snap;
+    }
+}
+//# sourceMappingURL=rollup.js.map

package/dist/features/watchdog/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../../../src/features/watchdog/rollup.ts"],"names":[],"mappings":"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"}