sootsim 0.1.173 → 0.1.174

package/dist-cli/chunks/{what-happened-GUIQ3GXK.js → what-happened-QRPH35TD.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{C as N,D as F,E as y,P as T,Q as b,R as S}from"./chunk-PPDVP56P.js";import{c as A,e as _}from"./chunk-HSACKNHS.js";import"./chunk-KBTADP77.js";import{b as k}from"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.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.174 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{C as N,D as F,E as y,P as T,Q as b,R as S}from"./chunk-GERUGIKH.js";import{c as A,e as _}from"./chunk-O2PWKVDV.js";import"./chunk-QWKK2QEY.js";import{b as k}from"./chunk-3SU6H3TH.js";import"./chunk-6OROZMOR.js";import"./chunk-U7BX2XYL.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-cli/chunks/{whoami-U6J5UL6X.js → whoami-BPGQUMYX.js}

@@ -1,2 +1,2 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as i}from"./chunk-X4A5YX56.js";import{d as n}from"./chunk-VQQVVMNO.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};
+/*! sootsim v0.1.174 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{d as i}from"./chunk-SWKBOGBZ.js";import{d as n}from"./chunk-SFHH65G2.js";import"./chunk-6OROZMOR.js";import"./chunk-U7BX2XYL.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};

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

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.174 | (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.173",
+  "version": "0.1.174",
   "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/soot.md

@@ -99,7 +99,7 @@ skills for working with the SootSim native preview engine:
 
 | skill | description |
 | --- | --- |
-| `/sootsim-debug` | Debug rendering, performance, and accessibility issues in your React Native app under sootsim |
+| `/sootsim-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under sootsim. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the sootsim CLI debug tooling first, not screenshots or ad-hoc logging. |
 | `/sootsim-setup` | Get sootsim connected to your React Native app — from `npm install sootsim` to a driveable sim |
 | `/sootsim-test` | Run automated tests against your React Native app under sootsim — native YAML flows, Maestro drop-in, or Detox drop-in |
 | `/sootsim-visual` | Pixel-level rendering comparison between sootsim and native iOS — fonts, gradients, shadows, image fidelity |

package/skills/sootsim-debug.md

@@ -1,6 +1,6 @@
 ---
 name: sootsim-debug
-description: Debug rendering, performance, and accessibility issues in your React Native app under sootsim
+description: Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under sootsim. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the sootsim CLI debug tooling first, not screenshots or ad-hoc logging.
 ---
 
 # sootsim debug
@@ -15,6 +15,28 @@ load `/sootsim-visual` instead.
 > needs a connected, pinned sim. if `sootsim describe` errors, load
 > `/sootsim-setup` first.
 
+## principle — drive the CLI, don't probe by hand
+
+for any rendering, animation, gesture, or interaction bug, reach for the
+sootsim CLI debug tooling **first** — `describe` and `find` to read the
+tree, `debug snapshot` + `debug diff` to capture before/after, `debug
+recent` on a channel and `debug perf` for frame-by-frame stats, and the
+timeline for "what just happened". **do not** debug these by eye with
+screenshots, sprinkle `console.log` through the render path, or spin up a
+one-off browser-automation script. the canvas has no DOM to inspect, and a
+CLI capture is reproducible, diffable, and shareable in a way a screenshot
+never is.
+
+if the existing CLI tools don't capture the issue cleanly — the animation
+is too fast to read, the signal you need isn't on any channel, the
+interaction spans a boundary the timeline doesn't section — the right move
+is to **improve the debug tooling**, not to paper over it with throwaway
+probes. add a durable, channel-gated, start/stop instrument that's off by
+default (so baseline performance is untouched) and emits exactly the signal
+you're chasing. a good capture command is one-shot reproducible, every
+agent after you benefits from it, and the same capture can become a
+regression test. a pile of ad-hoc logs helps no one and gets deleted.
+
 ## route in
 
 - "my app renders wrong / wrong props / wrong tree" → [debugging](#branch--debugging)

package/dist-cli/chunks/beta-3VFRMFCE.js

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

package/dist-cli/chunks/chunk-4UNCEOKE.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-var t="http://localhost:5173/";export{t as a};

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

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

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

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

package/dist-cli/chunks/cli-version-7EPWQ5XZ.js

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

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

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d,e}from"./chunk-3N4T6ZCZ.js";import"./chunk-TAFDTRBK.js";import"./chunk-VQQVVMNO.js";import"./chunk-RXB7KMHB.js";import"./chunk-5RLVAUSR.js";import"./chunk-TYCNPLOA.js";import"./chunk-WYGYIQOE.js";import"./chunk-HGUPRH7F.js";import"./chunk-4UNCEOKE.js";import"./chunk-KBTADP77.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-WS4M3ANJ.js";import"./chunk-MPVUKE2L.js";import"./chunk-ODWORXXD.js";import"./chunk-HTCJBVQD.js";export{c as daemonInstall,b as getDaemonServiceStatus,a as runDaemon,d as teardownDaemonService,e as teardownSootsimHome};

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

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-F2VINQ62.js";import{a,b,c,d,e,f,g,h,i}from"./chunk-KHMFZHHP.js";import"./chunk-A43ZSZMJ.js";import"./chunk-AOFD6E2Z.js";import"./chunk-I3UUCR2A.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.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-AHIM2QYC.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as c,b as d,c as e,d as f}from"./chunk-4NEHOYQH.js";import"./chunk-D5MW3FJE.js";import"./chunk-M4TI3GFJ.js";import"./chunk-DFP5BKYL.js";import{c as a,d as b}from"./chunk-MJQCN4PS.js";import"./chunk-2IUYPQC6.js";import"./chunk-LOP35MNF.js";import"./chunk-FLKV4YHL.js";import"./chunk-PPDVP56P.js";import"./chunk-GTIQVAJP.js";import"./chunk-KHMFZHHP.js";import"./chunk-A43ZSZMJ.js";import"./chunk-AOFD6E2Z.js";import"./chunk-FX3YWIDK.js";import"./chunk-X4A5YX56.js";import"./chunk-7O64AC44.js";import"./chunk-N7HUNHH6.js";import"./chunk-HSACKNHS.js";import"./chunk-I3UUCR2A.js";import"./chunk-TAFDTRBK.js";import"./chunk-VQQVVMNO.js";import"./chunk-HGUPRH7F.js";import"./chunk-4UNCEOKE.js";import"./chunk-KBTADP77.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-QGQSKDXQ.js";import"./chunk-ODWORXXD.js";import"./chunk-HTCJBVQD.js";export{c as discoverSootsimUrl,e as hoistLeadingSimFlag,a as parseFlowFile,f as runFlow,d as runFlowPlayback,b as validateFlowFile};

package/dist-cli/chunks/help-7JOCVVN6.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-RXB7KMHB.js";import"./chunk-5RLVAUSR.js";import"./chunk-TYCNPLOA.js";import"./chunk-WYGYIQOE.js";import"./chunk-HGUPRH7F.js";import"./chunk-4UNCEOKE.js";import"./chunk-KBTADP77.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-WS4M3ANJ.js";import"./chunk-MPVUKE2L.js";import"./chunk-ODWORXXD.js";import"./chunk-HTCJBVQD.js";export{c as printCommandHelp,b as printGroupHelp,a as printHelp};

package/dist-cli/chunks/optional-demo-registry-4IEF2MIB.js

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

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

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-M2GYHZES.js";import"./chunk-Q6VYTVCL.js";import"./chunk-HSACKNHS.js";import"./chunk-KBTADP77.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.js";export{a as runRuntime};

package/dist-cli/chunks/skills-XJOVDRCF.js

@@ -1,40 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-HTCJBVQD.js";import*as r from"fs";import*as S from"os";import*as i from"path";import{fileURLToPath as g}from"url";function b(){try{let n=g(import.meta.resolve("sootsim/package.json"));return i.join(i.dirname(n),"skills")}catch{let n=i.dirname(g(import.meta.url));return i.resolve(n,"../../skills")}}var c=b(),$=new Set(["all","codex","claude"]);function k(){console.log(`sootsim skill
-
-install and inspect bundled SootSim agent skills.
-
-usage:
-  sootsim skill install [all|codex|claude] [skill-name...]
-  sootsim skill install --target <dir> [skill-name...]
-  sootsim skill show [skill-name]
-
-commands:
-  install   install skills; no target means all supported local agents
-  show      list bundled skills, or print one skill markdown
-
-targets:
-  all       Codex and Claude Code (default)
-  codex     $CODEX_HOME/skills, or ~/.codex/skills
-  claude    $CLAUDE_CONFIG_DIR/skills, or ~/.claude/skills
-`)}function p(){console.log(`sootsim skill install
-
-install bundled SootSim skills in the agent skill layout: <skill>/SKILL.md.
-
-usage:
-  sootsim skill install [all|codex|claude] [skill-name...]
-  sootsim skill install --target <dir> [skill-name...]
-
-examples:
-  sootsim skill install
-  sootsim skill install codex
-  sootsim skill install codex sootsim-debug
-`)}function u(n,t){let s=process.env[n]||i.join(S.homedir(),t);return i.join(s,"skills")}function x(){return[{label:"codex",dir:u("CODEX_HOME",".codex")},{label:"claude",dir:u("CLAUDE_CONFIG_DIR",".claude")}]}function _(n){if(n==="all")return x();if(n==="codex")return[{label:"codex",dir:u("CODEX_HOME",".codex")}];if(n==="claude")return[{label:"claude",dir:u("CLAUDE_CONFIG_DIR",".claude")}];console.error(`  unknown skill install target: ${n}`),console.error("  expected all, codex, or claude"),process.exit(1)}function D(n){let t=n.match(/^---\n([\s\S]*?)\n---/);if(!t)return null;let s=t[1],l=h(s,"name");return l?{name:l,description:h(s,"description")||""}:null}function h(n,t){let s=n.split(`
-`),l=`${t}:`;for(let e=0;e<s.length;e++){let o=s[e];if(!o.startsWith(l))continue;let a=o.slice(l.length).trim();if(a===">-"||a===">"||a==="|-"||a==="|"){let f=[];for(let m=e+1;m<s.length;m++){let d=s[m];if(/^[A-Za-z0-9_-]+:\s*/.test(d))break;if(d.trim()===""){f.push("");continue}if(!/^\s+/.test(d))break;f.push(d.trim())}return f.join(a.startsWith("|")?`
-`:" ").trim()}return a.startsWith('"')&&a.endsWith('"')||a.startsWith("'")&&a.endsWith("'")?a.slice(1,-1):a}return null}function I(){if(!r.existsSync(c))return[];let n=r.readdirSync(c).filter(s=>s.endsWith(".md")),t=[];for(let s of n){let l=r.readFileSync(i.join(c,s),"utf8"),e=D(l);e&&t.push({...e,filename:s})}return t.sort((s,l)=>s.name.localeCompare(l.name))}function y(n,t){if(t.length===0)return n;let s=n.filter(l=>t.some(e=>l.name.includes(e)||l.name.replace("sootsim-","").includes(e)||l.filename.includes(e)));return s.length===0&&(console.error(`  no skills matched: ${t.join(", ")}`),console.error("  available: "+n.map(l=>l.name).join(", ")),process.exit(1)),s}function w(n,t){let s=i.join(c,n.filename),l=i.join(t,n.name),e=i.join(l,"SKILL.md");r.mkdirSync(l,{recursive:!0}),r.copyFileSync(s,e),console.log(`  copied ${n.name} -> ${e}`)}function C(n){if(n.length===0){console.log("  no skills found");return}console.log(`
-  available skills:
-`);for(let t of n)console.log(`  ${t.name}`),console.log(`    ${t.description}
-`);console.log("  usage: sootsim skill install [all|codex|claude] [skill-name...]"),console.log(`  usage: sootsim skill show [skill-name]
-`)}function L(n){let t=null,s=[];for(let l=0;l<n.length;l++){let e=n[l];if((e==="--help"||e==="-h")&&(p(),process.exit(0)),e==="--target"){let o=n[l+1];(!o||o.startsWith("-"))&&(console.error("  --target requires a directory"),process.exit(1)),t&&(console.error("  pass only one install target"),process.exit(1)),t=[{label:"target",dir:o}],l++;continue}if(e.startsWith("-")&&(console.error(`  unknown option: ${e}`),p(),process.exit(1)),!t&&$.has(e)){t=_(e);continue}s.push(e)}return{targets:t??x(),filters:s}}async function j(n){let t=I();t.length===0&&(console.error("  no skills found in sootsim package"),process.exit(1));let s=L(n),l=y(t,s.filters),e=s.targets.map(o=>({...o,dir:i.resolve(o.dir)}));for(let o of e)r.mkdirSync(o.dir,{recursive:!0}),r.statSync(o.dir).isDirectory()||(console.error(`  target is not a directory: ${o.dir}`),process.exit(1));console.log(`
-  installing ${l.length} skill(s) to ${e.length} target(s)
-`);for(let o of e){console.log(`  target ${o.label}: ${o.dir}`);for(let a of l)w(a,o.dir);console.log("")}console.log(`  done. restart the agent session to load newly installed skills.
-`)}function T(n){let t=I(),s=n.find(o=>!o.startsWith("-"));if(!s){C(t);return}let[l]=y(t,[s]),e=r.readFileSync(i.join(c,l.filename),"utf8");console.log(e)}async function F(n){let[t,...s]=n;if(!t||t==="--help"||t==="-h"){k();return}if(t==="install"){await j(s);return}if(t==="show"||t==="list"){T(s);return}console.error(`  unknown skill command: ${t}`),k(),process.exit(1)}export{F as runSkill};

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

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

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

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-TAFDTRBK.js";import"./chunk-VQQVVMNO.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.js";export{b as flushCliTelemetry,a as trackCliEvent};

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

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.173 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-FX3YWIDK.js";import"./chunk-X4A5YX56.js";import"./chunk-7O64AC44.js";import"./chunk-N7HUNHH6.js";import"./chunk-HSACKNHS.js";import"./chunk-I3UUCR2A.js";import"./chunk-TAFDTRBK.js";import"./chunk-VQQVVMNO.js";import"./chunk-KBTADP77.js";import"./chunk-6D2B6YM5.js";import"./chunk-7LCS6UB7.js";import"./chunk-HTCJBVQD.js";export{a as resolveDefaultUploadOrigin,b as resolvePublicPreviewOrigin,c as runUpload};