@iann29/rastro 0.1.0-alpha.5 → 0.1.0-alpha.7

package/dist/tracker/vitals.js

@@ -0,0 +1,140 @@
+"use strict";
+// The opt-in Web Vitals module. It shares the main tracker's session identity
+// through sessionStorage but never depends on it: either script works alone.
+// Values are integers — milliseconds, except CLS which ships scaled by 1000.
+(() => {
+    const script = document.currentScript;
+    const siteId = script?.dataset.site;
+    const endpoint = script?.dataset.endpoint ||
+        (script?.src && new URL("events", script.src).href);
+    if (!siteId || !endpoint)
+        return;
+    const createId = () => crypto.randomUUID?.() || Math.random() + "";
+    let sessionId;
+    try {
+        sessionId = sessionStorage._r || createId();
+        sessionStorage._r = sessionId;
+    }
+    catch {
+        sessionId = createId();
+    }
+    const visitorId = script.dataset.visitor || sessionId;
+    // Metrics describe the loaded document, so they keep the landing path even
+    // when a SPA rewrites the URL later.
+    const path = location.pathname.slice(0, 256);
+    const values = {};
+    const observers = [];
+    const observe = (type, handler, extra) => {
+        try {
+            const observer = new PerformanceObserver((list) => handler(list.getEntries()));
+            observer.observe({
+                type,
+                buffered: true,
+                ...extra,
+            });
+            observers.push({ observer, handler });
+        }
+        catch {
+            // The metric simply goes unreported where the entry type is missing.
+        }
+    };
+    const navigation = performance.getEntriesByType?.("navigation")[0];
+    if (navigation && navigation.responseStart > 0) {
+        values.TTFB = navigation.responseStart;
+    }
+    observe("paint", (entries) => {
+        for (const entry of entries) {
+            if (entry.name === "first-contentful-paint")
+                values.FCP = entry.startTime;
+        }
+    });
+    observe("largest-contentful-paint", (entries) => {
+        const last = entries[entries.length - 1];
+        if (last)
+            values.LCP = last.startTime;
+    });
+    // CLS session windows: shifts joined by <1s gaps within a 5s span; the worst
+    // window is the score.
+    let clsWindow = 0;
+    let clsFirst = 0;
+    let clsLast = 0;
+    observe("layout-shift", (entries) => {
+        for (const entry of entries) {
+            if (entry.hadRecentInput)
+                continue;
+            if (clsWindow &&
+                entry.startTime - clsLast < 1_000 &&
+                entry.startTime - clsFirst < 5_000) {
+                clsWindow += entry.value;
+            }
+            else {
+                clsWindow = entry.value;
+                clsFirst = entry.startTime;
+            }
+            clsLast = entry.startTime;
+            values.CLS = Math.max(values.CLS || 0, clsWindow * 1_000);
+        }
+    });
+    // INP keeps the worst durations and reports the (interactions / 50)th
+    // longest — the same estimate the web-vitals library uses.
+    const durations = [];
+    const interactionIds = new Set();
+    const interactions = (entries) => {
+        for (const entry of entries) {
+            if (!entry.interactionId)
+                continue;
+            interactionIds.add(entry.interactionId);
+            durations.push(entry.duration);
+        }
+        if (!durations.length)
+            return;
+        durations.sort((left, right) => right - left);
+        durations.length = Math.min(durations.length, 10);
+        const count = performance.interactionCount ||
+            interactionIds.size;
+        values.INP =
+            durations[Math.min(durations.length - 1, Math.floor(count / 50))];
+    };
+    observe("event", interactions, { durationThreshold: 40 });
+    observe("first-input", interactions);
+    let sent = false;
+    const send = () => {
+        if (sent)
+            return;
+        for (const { observer, handler } of observers) {
+            handler(observer.takeRecords());
+            observer.disconnect();
+        }
+        const timestamp = Date.now();
+        const events = Object.keys(values).map((name, index) => ({
+            eventId: `${sessionId}.${timestamp.toString(36)}.v${index}`,
+            sessionId,
+            visitorId,
+            type: "vital",
+            name,
+            value: Math.round(values[name]),
+            path,
+            timestamp,
+            sequence: index,
+        }));
+        if (!events.length)
+            return;
+        sent = true;
+        // sentAt lets the server re-anchor a clock that is minutes off.
+        const body = new Blob([
+            JSON.stringify({ siteId, events, sentAt: timestamp }),
+        ]);
+        const beacon = navigator.sendBeacon?.bind(navigator);
+        if (!beacon || !beacon(endpoint, body)) {
+            void fetch(endpoint, { method: "POST", body, keepalive: true }).catch(() => {
+                // Best effort by design: measurement must never break the host page.
+            });
+        }
+    };
+    document.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden")
+            send();
+    });
+    addEventListener("pagehide", send);
+})();
+//# sourceMappingURL=vitals.js.map

package/dist/tracker/vitals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.js","sourceRoot":"","sources":["../../src/tracker/vitals.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAc7E,CAAC,GAAG,EAAE;IACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAyC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;IACpC,MAAM,QAAQ,GACZ,MAAM,EAAE,OAAO,CAAC,QAAQ;QACxB,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEjC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IACnE,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,cAAc,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC5C,cAAc,CAAC,EAAE,GAAG,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IACtD,2EAA2E;IAC3E,qCAAqC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,MAAM,SAAS,GAGV,EAAE,CAAC;IACR,MAAM,OAAO,GAAG,CACd,IAAY,EACZ,OAA8C,EAC9C,KAA+B,EAC/B,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE,CAChD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAC3B,CAAC;YACF,QAAQ,CAAC,OAAO,CAAC;gBACf,IAAI;gBACJ,QAAQ,EAAE,IAAI;gBACd,GAAG,KAAK;aACkB,CAAC,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CACxB,CAAC;IAC1C,IAAI,UAAU,IAAI,UAAU,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB;gBAAE,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,0BAA0B,EAAE,CAAC,OAAO,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,uBAAuB;IACvB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;QAClC,KAAK,MAAM,KAAK,IAAI,OAA6B,EAAE,CAAC;YAClD,IAAI,KAAK,CAAC,cAAc;gBAAE,SAAS;YACnC,IACE,SAAS;gBACT,KAAK,CAAC,SAAS,GAAG,OAAO,GAAG,KAAK;gBACjC,KAAK,CAAC,SAAS,GAAG,QAAQ,GAAG,KAAK,EAClC,CAAC;gBACD,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;gBACxB,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;YAC7B,CAAC;YACD,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;YAC1B,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,sEAAsE;IACtE,2DAA2D;IAC3D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,YAAY,GAAG,CAAC,OAA2B,EAAE,EAAE;QACnD,KAAK,MAAM,KAAK,IAAI,OAA6B,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,aAAa;gBAAE,SAAS;YACnC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO;QAC9B,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC9C,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GACR,WAA6C,CAAC,gBAAgB;YAC/D,cAAc,CAAC,IAAI,CAAC;QACtB,MAAM,CAAC,GAAG;YACR,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAErC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,IAAI;YAAE,OAAO;QACjB,KAAK,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;YAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAChC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxE,OAAO,EAAE,GAAG,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE;YAC3D,SAAS;YACT,SAAS;YACT,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC;YAChC,IAAI;YACJ,SAAS;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO;QAC3B,IAAI,GAAG,IAAI,CAAC;QACZ,gEAAgE;QAChE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;SACtD,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACvC,KAAK,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CACnE,GAAG,EAAE;gBACH,qEAAqE;YACvE,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACjD,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ;YAAE,IAAI,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC,CAAC,EAAE,CAAC"}

package/dist/tracker.min.js

@@ -1 +1 @@
-(()=>{const e=document.currentScript,t=e?.dataset.site,s=e?.dataset.endpoint||e?.src&&new URL("events",e.src).href;if(!t||!s)return;const o=()=>crypto.randomUUID?.()||Math.random()+"",n=new URLSearchParams(location.search),r=n.get("ref")?.slice(0,64);let i,a,c;for(const e of["source","medium","campaign","term","content"]){const t=n.get("utm_"+e)?.slice(0,64);t&&((i??={})["utm_"+e]=t)}try{a=sessionStorage._r||o(),sessionStorage._r=a,c=r||sessionStorage._a,c&&(sessionStorage._a=c),i||=sessionStorage._u&&JSON.parse(sessionStorage._u),i&&(sessionStorage._u=JSON.stringify(i))}catch{a=o(),c=r}const d=e.dataset.visitor||a;let l,p=0;const g=[],u=document.referrer?new URL(document.referrer).origin:void 0,h=e=>{const o=g.splice(0,50);if(!o.length)return;const n=()=>new Blob([JSON.stringify({siteId:t,events:o})]);let r=n();for(;r.size>64e3&&o.length>1;)g.unshift(o.pop()),r=n();e&&navigator.sendBeacon(s,r)||fetch(s,{method:"POST",body:r,keepalive:1}).catch(()=>{}),g.length&&h(e)},m=(e,t,s)=>{const o=Date.now();g.push({eventId:`${a}.${o.toString(36)}.${p}`,sessionId:a,visitorId:d,type:e,name:t,path:location.pathname.slice(0,256),referrer:u,timestamp:o,sequence:p++,affiliateSlug:c,...s}),clearTimeout(l),l=setTimeout(h,1200)};let f;const v=()=>{const e=location.pathname;e!==f&&(f=e,m("pageview",void 0,i&&{properties:i}))};window.rastro=(e,t,s)=>{if("context"===e)return{sessionId:a,visitorId:d};"event"===e&&m("custom",`${t||"event"}`.slice(0,80),s&&JSON.stringify(s).length>2e4?void 0:{properties:s})},document.addEventListener("click",e=>{const t=e.target?.closest("a,button,[data-rastro-event]");if(!t)return;const s=t.dataset.rastroEvent,o=t.href,n=o&&new URL(o),r=/^https?:$/.test(n?.protocol),i=r&&n.origin!==location.origin;m(s?"custom":i?"outbound":"click",s,{target:(t.dataset.rastroLabel||t.innerText||t.tagName).slice(0,64),href:r?((i?n.origin:"")+n.pathname).slice(0,256):void 0})},1);const S=e=>{const t=history[e];history[e]=(...e)=>{t.apply(history,e),v()}};S("pushState"),S("replaceState"),addEventListener("popstate",v),addEventListener("pagehide",()=>h(1)),setInterval(()=>{m("heartbeat"),h()},2e4),v()})();
+(()=>{const e=document.currentScript,t=e?.dataset.site,s=e?.dataset.endpoint||e?.src&&new URL("events",e.src).href;if(!t||!s)return;const o=()=>crypto.randomUUID?.()||Math.random()+"",n=new URLSearchParams(location.search),r=n.get("ref")?.slice(0,64);let a,i,c;for(const e of["source","medium","campaign","term","content"]){const t=n.get("utm_"+e)?.slice(0,64);t&&((a??={})["utm_"+e]=t)}try{i=sessionStorage._r||o(),sessionStorage._r=i,c=r||sessionStorage._a,c&&(sessionStorage._a=c),a||=sessionStorage._u&&JSON.parse(sessionStorage._u),a&&(sessionStorage._u=JSON.stringify(a))}catch{i=o(),c=r}const d=e.dataset.visitor||i;let l,p=0;const g=[],u=document.referrer?new URL(document.referrer).origin:void 0,h=e=>{const o=g.splice(0,50);if(!o.length)return;const n=()=>new Blob([JSON.stringify({siteId:t,events:o,sentAt:Date.now()})]);let r=n();for(;r.size>64e3&&o.length>1;)g.unshift(o.pop()),r=n();e&&navigator.sendBeacon(s,r)||fetch(s,{method:"POST",body:r,keepalive:1}).catch(()=>{}),g.length&&h(e)},m=(e,t,s)=>{const o=Date.now();g.push({eventId:`${i}.${o.toString(36)}.${p}`,sessionId:i,visitorId:d,type:e,name:t,path:location.pathname.slice(0,256),referrer:u,timestamp:o,sequence:p++,affiliateSlug:c,...s}),clearTimeout(l),l=setTimeout(h,1200)};let f;const v=()=>{const e=location.pathname;e!==f&&(f=e,m("pageview",void 0,a&&{properties:a}))};window.rastro=(e,t,s)=>{if("context"===e)return{sessionId:i,visitorId:d};"event"===e&&m("custom",`${t||"event"}`.slice(0,80),s&&JSON.stringify(s).length>2e4?void 0:{properties:s})},document.addEventListener("click",e=>{const t=e.target?.closest("a,button,[data-rastro-event]");if(!t)return;const s=t.dataset.rastroEvent,o=t.href,n=o&&new URL(o),r=/^https?:$/.test(n?.protocol),a=r&&n.origin!==location.origin;m(s?"custom":a?"outbound":"click",s,{target:(t.dataset.rastroLabel||t.innerText||t.tagName).slice(0,64),href:r?((a?n.origin:"")+n.pathname).slice(0,256):void 0})},1);const S=e=>{const t=history[e];history[e]=(...e)=>{t.apply(history,e),v()}};S("pushState"),S("replaceState"),addEventListener("popstate",v),addEventListener("pagehide",()=>h(1)),setInterval(()=>{m("heartbeat"),h()},2e4),v()})();

package/dist/vitals.min.js

@@ -0,0 +1 @@
+(()=>{const t=document.currentScript,e=t?.dataset.site,n=t?.dataset.endpoint||t?.src&&new URL("events",t.src).href;if(!e||!n)return;const r=()=>crypto.randomUUID?.()||Math.random()+"";let a;try{a=sessionStorage._r||r(),sessionStorage._r=a}catch{a=r()}const s=t.dataset.visitor||a,o=location.pathname.slice(0,256),i={},c=[],d=(t,e,n)=>{try{const r=new PerformanceObserver(t=>e(t.getEntries()));r.observe({type:t,buffered:1,...n}),c.push({observer:r,handler:e})}catch{}},h=performance.getEntriesByType?.("navigation")[0];h&&h.responseStart>0&&(i.TTFB=h.responseStart),d("paint",t=>{for(const e of t)"first-contentful-paint"===e.name&&(i.FCP=e.startTime)}),d("largest-contentful-paint",t=>{const e=t[t.length-1];e&&(i.LCP=e.startTime)});let l=0,f=0,m=0;d("layout-shift",t=>{for(const e of t)e.hadRecentInput||(l&&e.startTime-m<1e3&&e.startTime-f<5e3?l+=e.value:(l=e.value,f=e.startTime),m=e.startTime,i.CLS=Math.max(i.CLS||0,1e3*l))});const u=[],p=new Set,v=t=>{for(const e of t)e.interactionId&&(p.add(e.interactionId),u.push(e.duration));if(!u.length)return;u.sort((t,e)=>e-t),u.length=Math.min(u.length,10);const e=performance.interactionCount||p.size;i.INP=u[Math.min(u.length-1,Math.floor(e/50))]};d("event",v,{durationThreshold:40}),d("first-input",v);let g=0;const y=()=>{if(g)return;for(const{observer:t,handler:e}of c)e(t.takeRecords()),t.disconnect();const t=Date.now(),r=Object.keys(i).map((e,n)=>({eventId:`${a}.${t.toString(36)}.v${n}`,sessionId:a,visitorId:s,type:"vital",name:e,value:Math.round(i[e]),path:o,timestamp:t,sequence:n}));if(!r.length)return;g=1;const d=new Blob([JSON.stringify({siteId:e,events:r,sentAt:t})]),h=navigator.sendBeacon?.bind(navigator);h&&h(n,d)||fetch(n,{method:"POST",body:d,keepalive:1}).catch(()=>{})};document.addEventListener("visibilitychange",()=>{"hidden"===document.visibilityState&&y()}),addEventListener("pagehide",y)})();

package/docs/benchmarks/2026-08-20-realistic.md

@@ -1,13 +1,13 @@
 # Realistic ingest validation, 2026-08-20
 
 This report preserves the performance evidence produced while developing PR
-[#8](https://github.com/amageweb/amage-rastro/pull/8), merged as `93a0b4e`.
-It is a historical engineering record, not a production SLA.
+[#8](https://github.com/amageweb/amage-rastro/pull/8), merged as `93a0b4e`. It
+is a historical engineering record, not a production SLA.
 
 ## Status
 
-- The realistic workload demonstrated the 100 million accepted-events/day
-  target during a sustained ten-minute soak.
+- The realistic workload demonstrated the 100 million accepted-events/day target
+  during a sustained ten-minute soak.
 - The sustained run predates the current `--certify` contract and did not
   preserve a run-scoped JSON artifact with aggregate reconciliation.
 - A later smoke against the final PR code reconciled every expected stored
@@ -22,19 +22,19 @@ certified for 100 million stored events/day.
 
 ## Environment
 
-| Item | Value |
-| --- | --- |
-| Date | 2026-08-20 |
-| Platform | Synapse-managed Convex |
-| Deployment | DEV canary `fast-finch-7454` |
-| Allocation | 4 GiB |
-| Site scope | One dedicated benchmark site |
-| Profile | `realistic` |
-| Concurrency | 75 workers |
-| Batch size | 50 events |
-| Session pool | 2,048 reused sessions |
-| Browser context | 12 geographic locations and 4 user-agent families |
-| Event mix | Pageviews, clicks, custom events, outbound events, and heartbeats |
+| Item            | Value                                                             |
+| --------------- | ----------------------------------------------------------------- |
+| Date            | 2026-08-20                                                        |
+| Platform        | Synapse-managed Convex                                            |
+| Deployment      | DEV canary `fast-finch-7454`                                      |
+| Allocation      | 4 GiB                                                             |
+| Site scope      | One dedicated benchmark site                                      |
+| Profile         | `realistic`                                                       |
+| Concurrency     | 75 workers                                                        |
+| Batch size      | 50 events                                                         |
+| Session pool    | 2,048 reused sessions                                             |
+| Browser context | 12 geographic locations and 4 user-agent families                 |
+| Event mix       | Pageviews, clicks, custom events, outbound events, and heartbeats |
 
 The deployment name is historical and may be deleted or repointed. Never use
 this document as deployment configuration.
@@ -44,51 +44,51 @@ this document as deployment configuration.
 The sustained soak ran after the raw-event batching and five-second live-sweep
 work in `bbfb9ad`, before the final review fixes later included in `93a0b4e`.
 
-| Metric | Result |
-| --- | ---: |
-| Target duration | 600 seconds |
-| Accepted events | 1,067,650 |
-| Failed requests | 0 |
-| Rejected events | 0 |
-| Accepted throughput | 1,773 events/s |
-| Accepted daily-rate estimate | 153.2 million events/day |
-| Target daily rate | 100 million events/day |
-| Headroom over target | 53.2% |
-| Request latency p99 | approximately 5.4 seconds |
+| Metric                       |                    Result |
+| ---------------------------- | ------------------------: |
+| Target duration              |               600 seconds |
+| Accepted events              |                 1,067,650 |
+| Failed requests              |                         0 |
+| Rejected events              |                         0 |
+| Accepted throughput          |            1,773 events/s |
+| Accepted daily-rate estimate |  153.2 million events/day |
+| Target daily rate            |    100 million events/day |
+| Headroom over target         |                     53.2% |
+| Request latency p99          | approximately 5.4 seconds |
 
 The target requires approximately 1,157 accepted events/s. The daily figure is
 an extrapolation from the measured soak, not a full-day load test.
 
 This run established sustained accepted-ingress capacity. Its exact heartbeat
-count and stored-event delta were not retained, so it must not be presented as
-a formally reconciled stored-events certification under the current harness.
+count and stored-event delta were not retained, so it must not be presented as a
+formally reconciled stored-events certification under the current harness.
 
 ## Reconciled corroboration
 
 A separate two-minute realistic rerun on the same canary used the same
 concurrency, batch size, and session pool:
 
-| Metric | Result |
-| --- | ---: |
-| Run label | `realistic-2m-rerun` |
-| Run ID | `mt1ydsq5-jjmbjv` |
-| Target duration | 120 seconds |
-| Measured elapsed time | 122.021 seconds |
-| Requests completed | 4,363 |
-| Accepted events | 218,150 |
-| Accepted heartbeats | 10,775 |
-| Expected stored events | 207,375 |
-| Aggregate event delta | 207,375 |
-| Reconciliation | exact |
-| Failed requests | 0 |
-| Duplicate events | 0 |
-| Rejected events | 0 |
-| Accepted throughput | 1,788 events/s |
+| Metric                       |                 Result |
+| ---------------------------- | ---------------------: |
+| Run label                    |   `realistic-2m-rerun` |
+| Run ID                       |      `mt1ydsq5-jjmbjv` |
+| Target duration              |            120 seconds |
+| Measured elapsed time        |        122.021 seconds |
+| Requests completed           |                  4,363 |
+| Accepted events              |                218,150 |
+| Accepted heartbeats          |                 10,775 |
+| Expected stored events       |                207,375 |
+| Aggregate event delta        |                207,375 |
+| Reconciliation               |                  exact |
+| Failed requests              |                      0 |
+| Duplicate events             |                      0 |
+| Rejected events              |                      0 |
+| Accepted throughput          |         1,788 events/s |
 | Accepted daily-rate estimate | 154,466,612 events/day |
-| Request latency p50 | 2,049 ms |
-| Request latency p95 | 2,570 ms |
-| Request latency p99 | 3,082 ms |
-| Request latency max | 3,366 ms |
+| Request latency p50          |               2,049 ms |
+| Request latency p95          |               2,570 ms |
+| Request latency p99          |               3,082 ms |
+| Request latency max          |               3,366 ms |
 
 Reconciliation was a site-wide before/after delta. It is reliable only because
 the benchmark site was kept idle apart from this run.
@@ -99,28 +99,28 @@ After the final correctness review, commit `c43d971` was deployed to the canary.
 That source was subsequently squash-merged unchanged as `93a0b4e`. A 30-second
 smoke produced:
 
-| Metric | Result |
-| --- | ---: |
-| Run label | `final-pr-smoke` |
-| Run ID | `mt2072x6-4c0avl` |
-| Measured elapsed time | 31.747 seconds |
-| Requests completed | 1,243 |
-| Accepted events | 62,150 |
-| Accepted heartbeats | 2,486 |
-| Expected stored events | 59,664 |
-| Aggregate event delta | 59,664 |
-| Reconciliation | exact |
-| Failed requests | 0 |
-| Duplicate events | 0 |
-| Rejected events | 0 |
-| Accepted throughput | 1,958 events/s |
-| Stored throughput | 1,879 events/s |
+| Metric                       |                 Result |
+| ---------------------------- | ---------------------: |
+| Run label                    |       `final-pr-smoke` |
+| Run ID                       |      `mt2072x6-4c0avl` |
+| Measured elapsed time        |         31.747 seconds |
+| Requests completed           |                  1,243 |
+| Accepted events              |                 62,150 |
+| Accepted heartbeats          |                  2,486 |
+| Expected stored events       |                 59,664 |
+| Aggregate event delta        |                 59,664 |
+| Reconciliation               |                  exact |
+| Failed requests              |                      0 |
+| Duplicate events             |                      0 |
+| Rejected events              |                      0 |
+| Accepted throughput          |         1,958 events/s |
+| Stored throughput            |         1,879 events/s |
 | Accepted daily-rate estimate | 169,139,895 events/day |
-| Stored daily-rate estimate | 162,374,299 events/day |
-| Request latency p50 | 1,882 ms |
-| Request latency p95 | 2,430 ms |
-| Request latency p99 | 2,733 ms |
-| Request latency max | 2,827 ms |
+| Stored daily-rate estimate   | 162,374,299 events/day |
+| Request latency p50          |               1,882 ms |
+| Request latency p95          |               2,430 ms |
+| Request latency p99          |               2,733 ms |
+| Request latency max          |               2,827 ms |
 
 The harness correctly marked this result as an estimate, not a certification,
 because it was shorter than 600 seconds.

package/docs/benchmarks/2026-08-21-formal-certification.md

@@ -6,16 +6,16 @@ and deployment, not a production SLA.
 
 ## Environment
 
-| Item | Value |
-| --- | --- |
-| Git commit | `e6ae92658c86c1931e697fa2a38c80fd902f7afa` |
-| Package version | `0.1.0-alpha.3` |
-| Deployment | DEV `fast-finch-7454` |
-| Benchmark site | `kx75pnr9wap522n0zmh4nnb4jh8cv110` |
-| Driver | One local Node.js process |
-| Reconciliation | Exact run-scoped session IDs, indexed pages of 100 |
-| Health before/after | `ok: true` |
-| GeoIP provider | Disabled |
+| Item                | Value                                              |
+| ------------------- | -------------------------------------------------- |
+| Git commit          | `e6ae92658c86c1931e697fa2a38c80fd902f7afa`         |
+| Package version     | `0.1.0-alpha.3`                                    |
+| Deployment          | DEV `fast-finch-7454`                              |
+| Benchmark site      | `kx75pnr9wap522n0zmh4nnb4jh8cv110`                 |
+| Driver              | One local Node.js process                          |
+| Reconciliation      | Exact run-scoped session IDs, indexed pages of 100 |
+| Health before/after | `ok: true`                                         |
+| GeoIP provider      | Disabled                                           |
 
 All runs used `--duration 600 --certify`. Runs were sequential so the profiles
 did not compete with each other. A harness certification means the run lasted
@@ -25,12 +25,12 @@ requires at least 1,157.41 stored events/second.
 
 ## Results
 
-| Profile | Concurrency | Batch | Accepted | Stored | Stored/s | Certified stored/day | p95 | Exact reconciliation | 100M/day target |
-| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | --- | --- |
-| Lean | 100 | 50 | 952,600 | 952,600 | 1,582 | 136,654,617 | 4,543 ms | 952,600 / 952,600 | Pass |
-| Realistic | 75 | 50 | 885,700 | 842,080 | 1,398 | 120,808,947 | 4,247 ms | 842,080 / 842,080 | Pass |
-| Heavy | 100 | 20 | 353,980 | 353,980 | 588 | 50,769,480 | 5,787 ms | 353,980 / 353,980 | **Below target** |
-| Feature | 100 | 15 | 232,170 | 232,170 | 384 | 33,218,356 | 6,226 ms | 232,170 / 232,170 | **Below target** |
+| Profile   | Concurrency | Batch | Accepted |  Stored | Stored/s | Certified stored/day |      p95 | Exact reconciliation | 100M/day target  |
+| --------- | ----------: | ----: | -------: | ------: | -------: | -------------------: | -------: | -------------------- | ---------------- |
+| Lean      |         100 |    50 |  952,600 | 952,600 |    1,582 |          136,654,617 | 4,543 ms | 952,600 / 952,600    | Pass             |
+| Realistic |          75 |    50 |  885,700 | 842,080 |    1,398 |          120,808,947 | 4,247 ms | 842,080 / 842,080    | Pass             |
+| Heavy     |         100 |    20 |  353,980 | 353,980 |      588 |           50,769,480 | 5,787 ms | 353,980 / 353,980    | **Below target** |
+| Feature   |         100 |    15 |  232,170 | 232,170 |      384 |           33,218,356 | 6,226 ms | 232,170 / 232,170    | **Below target** |
 
 The realistic run accepted 43,620 heartbeats, which intentionally update live
 presence without increasing persistent event counts. Its accepted-versus-stored
@@ -39,18 +39,18 @@ sustained 1,828,443 request bytes/second below the 64 KiB HTTP body limit.
 
 ## Heavy recertification after byte-accounting optimization
 
-Commit `4460ad34314a6e15c24a0c78aab6e6ce85db5c60` reused each event's
-exact UTF-8 byte measurement for both batch validation and rate limits, removing
-one full-payload serialization from the ingestion transaction. A new isolated
+Commit `4460ad34314a6e15c24a0c78aab6e6ce85db5c60` reused each event's exact
+UTF-8 byte measurement for both batch validation and rate limits, removing one
+full-payload serialization from the ingestion transaction. A new isolated
 ten-minute run on 2026-08-22 used the same deployment, site, concurrency, batch
 size, and heavy payload.
 
-| Result | Original | Recertified | Change |
-| --- | ---: | ---: | ---: |
-| Stored events/s | 588 | 887 | +50.9% |
-| Certified stored/day | 50,769,480 | 76,623,702 | +50.9% |
-| Request bytes/s | 1,828,443 | 2,759,875 | +50.9% |
-| p95 latency | 5,787 ms | 3,670 ms | -36.6% |
+| Result               |   Original | Recertified | Change |
+| -------------------- | ---------: | ----------: | -----: |
+| Stored events/s      |        588 |         887 | +50.9% |
+| Certified stored/day | 50,769,480 |  76,623,702 | +50.9% |
+| Request bytes/s      |  1,828,443 |   2,759,875 | +50.9% |
+| p95 latency          |   5,787 ms |    3,670 ms | -36.6% |
 
 The recertification remained below the separate 100 million events/day target,
 but raised the measured heavy-payload ceiling without changing payload shape or
@@ -65,7 +65,11 @@ weakening validation, rate limits, or reconciliation.
   "elapsedMs": 601726,
   "terminationReason": "duration",
   "durationCompleted": true,
-  "certification": { "requested": true, "passed": true, "minimumDurationSeconds": 600 },
+  "certification": {
+    "requested": true,
+    "passed": true,
+    "minimumDurationSeconds": 600
+  },
   "concurrency": 100,
   "batchSize": 20,
   "sessionPool": 2048,
@@ -119,7 +123,11 @@ weakening validation, rate limits, or reconciliation.
   "elapsedMs": 602282,
   "terminationReason": "duration",
   "durationCompleted": true,
-  "certification": { "requested": true, "passed": true, "minimumDurationSeconds": 600 },
+  "certification": {
+    "requested": true,
+    "passed": true,
+    "minimumDurationSeconds": 600
+  },
   "concurrency": 100,
   "batchSize": 50,
   "sessionPool": "unique-per-request",
@@ -171,7 +179,11 @@ weakening validation, rate limits, or reconciliation.
   "elapsedMs": 602238,
   "terminationReason": "duration",
   "durationCompleted": true,
-  "certification": { "requested": true, "passed": true, "minimumDurationSeconds": 600 },
+  "certification": {
+    "requested": true,
+    "passed": true,
+    "minimumDurationSeconds": 600
+  },
   "concurrency": 75,
   "batchSize": 50,
   "sessionPool": 2048,
@@ -223,7 +235,11 @@ weakening validation, rate limits, or reconciliation.
   "elapsedMs": 602407,
   "terminationReason": "duration",
   "durationCompleted": true,
-  "certification": { "requested": true, "passed": true, "minimumDurationSeconds": 600 },
+  "certification": {
+    "requested": true,
+    "passed": true,
+    "minimumDurationSeconds": 600
+  },
   "concurrency": 100,
   "batchSize": 20,
   "sessionPool": 2048,
@@ -275,7 +291,11 @@ weakening validation, rate limits, or reconciliation.
   "elapsedMs": 603868,
   "terminationReason": "duration",
   "durationCompleted": true,
-  "certification": { "requested": true, "passed": true, "minimumDurationSeconds": 600 },
+  "certification": {
+    "requested": true,
+    "passed": true,
+    "minimumDurationSeconds": 600
+  },
   "concurrency": 100,
   "batchSize": 15,
   "sessionPool": 2048,