sootsim 0.1.248 → 0.1.249

package/dist-cli/chunks/{what-happened-VD7VELOG.js → what-happened-6NL3WKXA.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{C as N,D as F,F as y,Q as T,R as b,S}from"./chunk-QFNUUUSL.js";import{g as A,i as _}from"./chunk-DKJ4SUQS.js";import"./chunk-5KGCNWZ3.js";import{c as k}from"./chunk-DHTWLLSK.js";import"./chunk-MVX53RSN.js";import"./chunk-YDEAZZX2.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=A(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{C as N,D as F,F as y,Q as T,R as b,S}from"./chunk-KEK3GVB4.js";import{g as A,i as _}from"./chunk-CBT5E3CL.js";import"./chunk-TV7UGMYE.js";import{c as k}from"./chunk-BRVCAA4M.js";import"./chunk-PPUVUFO5.js";import"./chunk-C4BUHPOY.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=A(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
 sootsim what-happened \u2014 show recent events from the semantic timeline
 
 usage:

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/config.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/menu.ts
 var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -1424,6 +1424,13 @@ async function inspectMemory(bridge) {
         ? await window.__sootsimShellMemory()
         : null
       const shell = shellRaw && !shellRaw.error ? shellRaw : null
+      // the compositor paints home + app:one + app:two, so every app-surface
+      // picture and raster image is counted here and nowhere else.
+      let compositor = null
+      try {
+        const cs = await window.__sootsimCompositor?.getStats?.(false, true)
+        compositor = cs?.memory ?? null
+      } catch {}
       const normalize = (m) =>
         m
           ? {
@@ -1446,11 +1453,12 @@ async function inspectMemory(bridge) {
       return {
         tenant: normalize(stats?.memory),
         shell: normalize(shell),
+        compositor: normalize(compositor),
         hostHeap: hostMem,
       }
     })()`
   });
-  return result ?? { tenant: null, shell: null, hostHeap: null };
+  return result ?? { tenant: null, shell: null, compositor: null, hostHeap: null };
 }
 function formatTimelineSummary(summary) {
   if (summary.total === 0) return "nothing recorded";

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -1333,6 +1333,13 @@ async function inspectMemory(bridge) {
         ? await window.__sootsimShellMemory()
         : null
       const shell = shellRaw && !shellRaw.error ? shellRaw : null
+      // the compositor paints home + app:one + app:two, so every app-surface
+      // picture and raster image is counted here and nowhere else.
+      let compositor = null
+      try {
+        const cs = await window.__sootsimCompositor?.getStats?.(false, true)
+        compositor = cs?.memory ?? null
+      } catch {}
       const normalize = (m) =>
         m
           ? {
@@ -1355,11 +1362,12 @@ async function inspectMemory(bridge) {
       return {
         tenant: normalize(stats?.memory),
         shell: normalize(shell),
+        compositor: normalize(compositor),
         hostHeap: hostMem,
       }
     })()`
   });
-  return result ?? { tenant: null, shell: null, hostHeap: null };
+  return result ?? { tenant: null, shell: null, compositor: null, hostHeap: null };
 }
 function formatTimelineSummary(summary) {
   if (summary.total === 0) return "nothing recorded";

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.249 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sootsim",
-  "version": "0.1.248",
+  "version": "0.1.249",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",

package/skills/sootsim-perf/SKILL.md

@@ -16,10 +16,20 @@ indict, remeasure — and every wasted week came from skipping a step.
 
 ## the four laws (each paid for by a real incident)
 
-1. **measure the shell, in the right browser.** the shell worker owns every
-   painted pixel; the tenant hasn't painted since the two-worker split. the
-   CLI's `perf shell` reads the shell profile (the tenant sampler that
-   reported `avg 0.48ms (2069 fps)` for a visibly janky scroll was removed).
+1. **measure the worker that painted it, in the right browser.** the tenant
+   hasn't painted since the two-worker split, so never read a tenant sampler
+   (the one reporting `avg 0.48ms (2069 fps)` for a visibly janky scroll was
+   removed). but "the shell" is no longer the whole answer either: the
+   compositor worker owns `home`, `app:one` and `app:two`, so **every guest-app
+   draw call, paint boundary and raster-tier decision is in the compositor's
+   render profile, not the shell's.** `perf shell stop` prints both, labelled
+   by worker — read the compositor block for anything inside an app. for
+   months it printed only the shell's, and a uniswap token-list fling
+   therefore reported `raster tier: 0 promotions / 0 blits` while the
+   compositor was blitting ~14 rows a frame; the giveaway was `node visits: 7`
+   next to `app:one 1014 paints`. if a render-profile block describes a
+   handful of nodes while an app surface is painting hundreds of times, you
+   are reading the wrong worker.
    browser matters just as much: playwright's bundled headless chromium has
    NO GPU — CanvasKit falls back to SwiftShader and every number lies high.
    use `--browser webkit` (real Apple GPU even headless, the iOS proxy) or
@@ -64,7 +74,22 @@ the report and how to read it:
 - `raster tier: promotions / blits` — blits per scrolled frame > 0 or the
   tier is not firing; `raster skips` names the first gate each candidate
   failed (rebuild / animated / cacheable). zero blits on a feed scroll is
-  a bug, not a tuning matter.
+  a bug, not a tuning matter — but check you are reading the compositor's
+  block first (law 1), because the shell's is legitimately zero for an app
+  workload.
+  **before widening any skip bucket, read the `also fail a later gate`
+  line under it.** the counters name only the FIRST failed gate, so a big
+  bucket can be entirely blocked a second time and unwidenable: on a uniswap
+  token-list fling all 8298 `animated` skips also carried a style transform
+  or a non-cacheable chunk, and narrowing the animated gate moved 6007 to
+  `transform` and 2350 to `cacheable` while promoting nothing. a bucket is
+  worth attacking when its also-blocked share is small.
+  and blits firing is not the same as the tier paying for itself: on the
+  uniswap token list the tier blits every visible row and costs 70MB of GPU
+  cache for no frame-time change, while the retained row boundaries under it
+  cost 2.4ms a frame. the discriminator is per-row draw density, so check
+  `draw calls` in the same block before concluding a cache is earning its
+  keep.
 - `worst frames` — read the layout/render split of each; they are usually
   a different problem than the average.
 
@@ -141,7 +166,7 @@ which tier *should* absorb your cost and prove whether it does.
 | layer compositor (`paint-boundary.ts`) | animating a child never re-records ancestors | replays >> records |
 | damage rects (`damage-rect.ts`) | repaint clips to changed region (opaque-backdrop gated) | worst-frame render bounded during small updates |
 | scroll blit | scroll-only frames blit prior frame + paint revealed strip | blits/frame ≈ 1-2 during fling; `blitBlocked` rare |
-| raster tier | stable rows become GPU textures; scroll skips recording | promotions > 0 once warm, blits ~2/frame |
+| raster tier | stable rows become GPU textures; scroll skips recording | compositor block: promotions > 0 once warm, blits ≈ one per visible row (uniswap token list: ~13.7/frame) |
 | flood guard, pointer coalescing, vsync hysteresis | message-storm and pump-thrash protection | msgs/s sane during gestures and at rest |
 
 if a workload's cost lands in a tier that shows zero activity, the fix is

package/dist-cli/chunks/beta-H4BMGHBX.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d}from"./chunk-WMDCUC6A.js";import"./chunk-YDEAZZX2.js";export{d as BETA_ASK_HEADLINE,b as BETA_LABEL,c as BETA_TAGLINE,a as IS_BETA};

package/dist-cli/chunks/chunk-KIXGV5CB.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/chunk-RA2MGELV.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/cli-version-53VGUXL2.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-OKY55E46.js";import"./chunk-YDEAZZX2.js";export{a as getCliVersion};

package/dist-cli/chunks/daemon-W7ZNHUDM.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d,e}from"./chunk-N5KM3VCB.js";import"./chunk-462HY7RJ.js";import"./chunk-2NUGYM3P.js";import"./chunk-CVIV2P4Q.js";import"./chunk-UQXZXGW4.js";import"./chunk-F7NEOEEF.js";import"./chunk-BEM3CFV5.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-6X4JXE74.js";import"./chunk-MVX53RSN.js";import"./chunk-OKY55E46.js";import"./chunk-WMDCUC6A.js";import"./chunk-4OR7VDQS.js";import"./chunk-YDEAZZX2.js";export{c as daemonInstall,b as getDaemonServiceStatus,a as runDaemon,d as teardownDaemonService,e as teardownSootsimHome};

package/dist-cli/chunks/drivers-XX7BTQWD.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-RA2MGELV.js";import{f as a,g as b,h as c,i as d,j as e,k as f,l as g,m as h,n as i}from"./chunk-GZBHBLLW.js";import"./chunk-EELDZ6XJ.js";import"./chunk-34V3Q2QN.js";import"./chunk-DHTWLLSK.js";import"./chunk-MVX53RSN.js";import"./chunk-YDEAZZX2.js";export{e as ALL_DRIVERS,i as buildDriverListRows,a as chromiumDriver,b as electronDriver,f as getAllDrivers,g as getDriver,c as playwrightDriver,h as resolveDriver,d as systemDriver};

package/dist-cli/chunks/flow-7X5KENGJ.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{c,d,e,f,g,h}from"./chunk-XS5JRRXV.js";import"./chunk-57NHZHU5.js";import"./chunk-NABNKW6U.js";import{c as a,d as b}from"./chunk-2CEGABQL.js";import"./chunk-YQUNWDJL.js";import"./chunk-MT44VAZ2.js";import"./chunk-JONKJ42L.js";import"./chunk-K2HZVZ2E.js";import"./chunk-66IMHVU7.js";import"./chunk-KIXGV5CB.js";import"./chunk-GZBHBLLW.js";import"./chunk-EELDZ6XJ.js";import"./chunk-CXFFLG6N.js";import"./chunk-UBEW3BNN.js";import"./chunk-34V3Q2QN.js";import"./chunk-M2WTLO5S.js";import"./chunk-VXCRFN3R.js";import"./chunk-QFNUUUSL.js";import"./chunk-DKJ4SUQS.js";import"./chunk-VFH26SN2.js";import"./chunk-462HY7RJ.js";import"./chunk-2NUGYM3P.js";import"./chunk-F7NEOEEF.js";import"./chunk-BEM3CFV5.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-6X4JXE74.js";import"./chunk-MVX53RSN.js";import"./chunk-R6M5DIKF.js";import"./chunk-4OR7VDQS.js";import"./chunk-YDEAZZX2.js";export{e as discoverSootsimUrl,c as getLastFlowPreviewUploadResult,d as getLastFlowTraceSteps,g as hoistLeadingSimFlag,a as parseFlowFile,f as runFlowPlayback,h as runMaestroAuthoring,b as validateFlowFile};

package/dist-cli/chunks/help-2YDMOSLD.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-CVIV2P4Q.js";import"./chunk-UQXZXGW4.js";import"./chunk-F7NEOEEF.js";import"./chunk-BEM3CFV5.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-6X4JXE74.js";import"./chunk-MVX53RSN.js";import"./chunk-OKY55E46.js";import"./chunk-WMDCUC6A.js";import"./chunk-4OR7VDQS.js";import"./chunk-YDEAZZX2.js";export{c as printCommandHelp,b as printGroupHelp,a as printHelp};

package/dist-cli/chunks/inspect-IBURV7JU.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{j as a,k as b}from"./chunk-2CEGABQL.js";import"./chunk-YQUNWDJL.js";import"./chunk-K2HZVZ2E.js";import"./chunk-66IMHVU7.js";import"./chunk-KIXGV5CB.js";import"./chunk-GZBHBLLW.js";import"./chunk-EELDZ6XJ.js";import"./chunk-CXFFLG6N.js";import"./chunk-UBEW3BNN.js";import"./chunk-34V3Q2QN.js";import"./chunk-M2WTLO5S.js";import"./chunk-VXCRFN3R.js";import"./chunk-QFNUUUSL.js";import"./chunk-DKJ4SUQS.js";import"./chunk-VFH26SN2.js";import"./chunk-F7NEOEEF.js";import"./chunk-BEM3CFV5.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-6X4JXE74.js";import"./chunk-MVX53RSN.js";import"./chunk-R6M5DIKF.js";import"./chunk-4OR7VDQS.js";import"./chunk-YDEAZZX2.js";export{a as printShellPerfReport,b as runInspect};

package/dist-cli/chunks/install-desktop-5XOUUOHA.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-A5A7VGJZ.js";import"./chunk-EELDZ6XJ.js";import"./chunk-XAMISJHN.js";import"./chunk-YDEAZZX2.js";export{a as runInstallDesktop};

package/dist-cli/chunks/optional-demo-registry-OURTK7FX.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-M2WTLO5S.js";import"./chunk-YDEAZZX2.js";export{a as loadOptionalDemoApps,b as optionalDemoAppsSync};

package/dist-cli/chunks/runtime-YVKHFE3N.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-WNX7PTZR.js";import"./chunk-YVEDV73R.js";import"./chunk-DKJ4SUQS.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-MVX53RSN.js";import"./chunk-YDEAZZX2.js";export{a as runRuntime};

package/dist-cli/chunks/store-MCRMRG7Z.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-R6M5DIKF.js";import"./chunk-4OR7VDQS.js";import"./chunk-YDEAZZX2.js";export{a as settingsStore};

package/dist-cli/chunks/telemetry-RMR2LXE7.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-462HY7RJ.js";import"./chunk-2NUGYM3P.js";import"./chunk-MVX53RSN.js";import"./chunk-YDEAZZX2.js";export{b as flushCliTelemetry,a as trackCliEvent};

package/dist-cli/chunks/upload-MK7JETTN.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.248 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{e as a,f as b,g as c}from"./chunk-MT44VAZ2.js";import"./chunk-JONKJ42L.js";import"./chunk-CXFFLG6N.js";import"./chunk-UBEW3BNN.js";import"./chunk-34V3Q2QN.js";import"./chunk-DKJ4SUQS.js";import"./chunk-462HY7RJ.js";import"./chunk-2NUGYM3P.js";import"./chunk-5KGCNWZ3.js";import"./chunk-DHTWLLSK.js";import"./chunk-MVX53RSN.js";import"./chunk-YDEAZZX2.js";export{a as resolveDefaultUploadOrigin,b as resolvePublicPreviewOrigin,c as runUpload};