@keepsnappy/agent 0.1.0-alpha.12 → 0.1.0-alpha.13

package/dist/keepsnappy.js

@@ -413,7 +413,7 @@ function validateConfig(raw, opts = {}) {
   }
   const pin = strList("steps.pin", steps.pin);
   const output = section("output", ["dir"], false);
-  const outDir = str("output.dir", output.dir, false, "perflab-out");
+  const outDir = str("output.dir", output.dir, false, "keepsnappy-out");
   let timeoutSeconds;
   if (raw.timeout_seconds !== undefined) {
     if (typeof raw.timeout_seconds !== "number" || raw.timeout_seconds <= 0)
@@ -519,12 +519,12 @@ import { join as join11, resolve as resolve3 } from "node:path";
 
 // apps/agent/src/data-source.ts
 import { join as join2 } from "node:path";
-var PERF_LAB_LOG = "Documents/perf-lab/log.txt";
+var KEEPSNAPPY_LOG = "Documents/keepsnappy/log.txt";
 var SAFE_FILE = /^[\w.+:-]+$/;
 var profilePath = (fileName) => {
   if (!SAFE_FILE.test(fileName) || fileName.includes(".."))
     throw new Error(`unsafe profile file name: ${fileName}`);
-  return `Documents/perf-lab/${fileName}`;
+  return `Documents/keepsnappy/${fileName}`;
 };
 function parseSimctlDevices(json, udid) {
   let data;
@@ -561,7 +561,7 @@ class IosSimulatorDataSource {
     return this.deps.fs.readFile(join2(await this.dataDir(bundleId), profilePath(fileName)));
   }
   async fetchLog(bundleId) {
-    return this.deps.fs.readFile(join2(await this.dataDir(bundleId), PERF_LAB_LOG));
+    return this.deps.fs.readFile(join2(await this.dataDir(bundleId), KEEPSNAPPY_LOG));
   }
   async describeDevice() {
     const r = await this.deps.spawner.run("xcrun", ["simctl", "list", "devices", this.udid === "booted" ? "booted" : "", "-j"].filter(Boolean));
@@ -580,7 +580,7 @@ class IosDeviceDataSource {
   }
   async fetchLog(bundleId) {
     await this.deps.fs.mkdir(this.scratchDir);
-    const dest = join2(this.scratchDir, "perf-lab.log");
+    const dest = join2(this.scratchDir, "keepsnappy.log");
     const r = await this.deps.spawner.run("xcrun", [
       "devicectl",
       "device",
@@ -593,7 +593,7 @@ class IosDeviceDataSource {
       "--domain-identifier",
       bundleId,
       "--source",
-      PERF_LAB_LOG,
+      KEEPSNAPPY_LOG,
       "--destination",
       dest
     ]);
@@ -614,7 +614,7 @@ class IosDeviceDataSource {
         "--domain-identifier",
         bundleId,
         "--source",
-        PERF_LAB_LOG,
+        KEEPSNAPPY_LOG,
         "--destination",
         dest
       ]);
@@ -651,7 +651,7 @@ class IosDeviceDataSource {
 // apps/agent/src/flows.ts
 import { basename, dirname, join as join3 } from "node:path";
 var FLOW_FILE = /\.ya?ml$/i;
-var NOT_FLOWS = new Set(["config.yaml", "config.yml", "keepsnappy.yml", "keepsnappy.yaml", "perflab.yml", "perflab.yaml"]);
+var NOT_FLOWS = new Set(["config.yaml", "config.yml", "keepsnappy.yml", "keepsnappy.yaml", "keepsnappy.yml", "keepsnappy.yaml"]);
 var flowStem = (path) => basename(path).replace(FLOW_FILE, "");
 function flowTags(text) {
   const head = text.split(/^---\s*$/m)[0] ?? "";
@@ -1193,20 +1193,20 @@ var MEASURES = {
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "Time of the PerfLab SDK in the window",
-    short: "time of the PerfLab SDK",
+    label: "Time of the KeepSnappy SDK in the window",
+    short: "time of the KeepSnappy SDK",
     decimals: 1,
-    what: "Time the PerfLab SDK spent on the JavaScript thread after each screen update in the window (reading the update, its profile and, when on, the React export); evidence only, never decides a result. Clock time, so it also holds pauses for garbage collection or other threads while the SDK ran. Not known when the window had more updates than the SDK keeps times for"
+    what: "Time the KeepSnappy SDK spent on the JavaScript thread after each screen update in the window (reading the update, its profile and, when on, the React export); evidence only, never decides a result. Clock time, so it also holds pauses for garbage collection or other threads while the SDK ran. Not known when the window had more updates than the SDK keeps times for"
   },
   sdk_hook_commits: {
     unit: "count",
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "Screen updates the PerfLab SDK read",
+    label: "Screen updates the KeepSnappy SDK read",
     short: "screen updates the SDK read",
     decimals: 0,
-    what: "How many screen updates the PerfLab SDK read in the window, the ones its time is summed over"
+    what: "How many screen updates the KeepSnappy SDK read in the window, the ones its time is summed over"
   },
   sdk_hook_capped: {
     unit: "count",
@@ -1216,17 +1216,17 @@ var MEASURES = {
     label: "Windows with too many updates to time the SDK",
     short: "windows the SDK time is not known for",
     decimals: 0,
-    what: "Windows of this place with more screen updates than the PerfLab SDK keeps times for (5000), so its time there is not given"
+    what: "Windows of this place with more screen updates than the KeepSnappy SDK keeps times for (5000), so its time there is not given"
   },
   js_thread_app_ms: {
     unit: "ms",
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "JavaScript thread CPU time without the PerfLab SDK",
+    label: "JavaScript thread CPU time without the KeepSnappy SDK",
     short: "JavaScript thread time without the SDK",
     decimals: 0,
-    what: "JavaScript thread CPU time in the window minus the time the PerfLab SDK spent after screen updates (not below 0); evidence only, never decides a result. Approximate either way: the thread time is CPU time in 10 ms steps on Android, the SDK time is clock time and includes pauses inside it"
+    what: "JavaScript thread CPU time in the window minus the time the KeepSnappy SDK spent after screen updates (not below 0); evidence only, never decides a result. Approximate either way: the thread time is CPU time in 10 ms steps on Android, the SDK time is clock time and includes pauses inside it"
   },
   main_thread_ms: {
     unit: "ms",
@@ -4205,7 +4205,7 @@ function netMetrics(windows) {
 // packages/derive/dist/src/sampler.js
 var obj6 = (v) => typeof v === "object" && v !== null ? v : {};
 var num6 = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
-var SAMPLE_MARK = "PERF_LAB sample {";
+var SAMPLE_MARK = "KEEPSNAPPY sample {";
 function parseSamples(logText) {
   const out = [];
   for (const line of logText.split(`
@@ -4215,7 +4215,7 @@ function parseSamples(logText) {
       continue;
     let raw;
     try {
-      raw = JSON.parse(line.slice(sp + 1 + "PERF_LAB sample ".length));
+      raw = JSON.parse(line.slice(sp + 1 + "KEEPSNAPPY sample ".length));
     } catch {
       continue;
     }
@@ -5184,7 +5184,7 @@ function parseMarkersNdjson(text) {
   return out;
 }
 // packages/derive/dist/src/window-log.js
-var WINDOW_MARK = "PERF_LAB window {";
+var WINDOW_MARK = "KEEPSNAPPY window {";
 function parseWindows(logText) {
   const out = [];
   for (const line of logText.split(`
@@ -5197,7 +5197,7 @@ function parseWindows(logText) {
       continue;
     let raw;
     try {
-      raw = JSON.parse(line.slice(sp + 1 + "PERF_LAB window ".length));
+      raw = JSON.parse(line.slice(sp + 1 + "KEEPSNAPPY window ".length));
     } catch {
       continue;
     }
@@ -5294,21 +5294,21 @@ async function uploadRuns(deps, outDir, runs, opts) {
       skipped.push({ run_id: r.run_id, why: r.invalid_reason || "invalid" });
       continue;
     }
-    const log = await deps.fs.readFile(join4(outDir, r.run_id, "perf-lab.log"));
+    const log = await deps.fs.readFile(join4(outDir, r.run_id, "keepsnappy.log"));
     const windows = windowsInRun(parseWindows(log), r.t0, r.t1);
     if (windows.length === 0) {
       skipped.push({ run_id: r.run_id, why: "no-windows" });
       continue;
     }
     const externalId = `${opts.externalPrefix}-${r.run_id}`;
-    const created = await call(f, opts.ingestUrl, "/v1/runs", { "x-perflab-key": opts.key }, {
+    const created = await call(f, opts.ingestUrl, "/v1/runs", { "x-keepsnappy-key": opts.key }, {
       external_id: externalId,
       started_at: r.t0,
       ended_at: r.t1,
       device: { ...opts.device?.model ? { model: opts.device.model } : {}, ...opts.device?.os ? { os: opts.device.os } : {}, ...opts.device?.id ? { id: opts.device.id } : {}, exclusive: true },
       meta: {
         arm: r.arm,
-        driver: opts.driver ?? "perflab-run",
+        driver: opts.driver ?? "keepsnappy-run",
         ...opts.meta,
         ...r.scenario ? { scenario: r.scenario } : {},
         ...opts.runSetId ? { run_set_id: opts.runSetId } : {}
@@ -5318,16 +5318,16 @@ async function uploadRuns(deps, outDir, runs, opts) {
     const token = String(created.run_token ?? "");
     if (!runId || !token)
       throw new UploadError("POST /v1/runs: response has no run_id/run_token");
-    const items = windows.map((w) => `${w.endWall} PERF_LAB window ${JSON.stringify(w.raw)}`);
+    const items = windows.map((w) => `${w.endWall} KEEPSNAPPY window ${JSON.stringify(w.raw)}`);
     for (let i = 0;i * size < items.length; i++) {
-      await call(f, opts.ingestUrl, "/v1/windows", { "x-perflab-key": opts.key, "x-perflab-run-token": token }, {
+      await call(f, opts.ingestUrl, "/v1/windows", { "x-keepsnappy-key": opts.key, "x-keepsnappy-run-token": token }, {
         batch_id: `${externalId}-${String(i + 1).padStart(4, "0")}`,
         items: items.slice(i * size, (i + 1) * size)
       });
     }
-    const samples = samplesInRun(parseSamples(log), r.t0, r.t1).map((x) => `${x.wall} PERF_LAB sample ${JSON.stringify(x.raw)}`);
+    const samples = samplesInRun(parseSamples(log), r.t0, r.t1).map((x) => `${x.wall} KEEPSNAPPY sample ${JSON.stringify(x.raw)}`);
     for (let i = 0;i * size < samples.length; i++) {
-      await call(f, opts.ingestUrl, "/v1/windows", { "x-perflab-key": opts.key, "x-perflab-run-token": token }, {
+      await call(f, opts.ingestUrl, "/v1/windows", { "x-keepsnappy-key": opts.key, "x-keepsnappy-run-token": token }, {
         batch_id: `${externalId}-s${String(i + 1).padStart(4, "0")}`,
         items: samples.slice(i * size, (i + 1) * size)
       });
@@ -5339,7 +5339,7 @@ async function uploadRuns(deps, outDir, runs, opts) {
     for (const m of markers) {
       await call(f, opts.ingestUrl, "/v1/markers", { authorization: `Bearer ${token}` }, { step: m.step, phase: m.phase, t_host: m.t_host });
     }
-    await call(f, opts.ingestUrl, `/v1/runs/${runId}/finish`, { "x-perflab-key": opts.key }, {});
+    await call(f, opts.ingestUrl, `/v1/runs/${runId}/finish`, { "x-keepsnappy-key": opts.key }, {});
     uploaded++;
   }
   return { uploaded, skipped };
@@ -5570,7 +5570,7 @@ function movedCounts(sc) {
 }
 var addCounts = (xs) => xs.reduce((a, c) => ({ worse: a.worse + c.worse, warnings: a.warnings + c.warnings, better: a.better + c.better, noChange: a.noChange + c.noChange, inconclusive: a.inconclusive + c.inconclusive }), { worse: 0, warnings: 0, better: 0, noChange: 0, inconclusive: 0 });
 var setupLine = (h) => h?.measured_differently?.length ? `Measured differently (${h.measured_differently.join(", ")}) — ${NOT_BLOCKING}` : null;
-var keyHeader = (t) => ({ "x-perflab-key": t.key });
+var keyHeader = (t) => ({ "x-keepsnappy-key": t.key });
 async function createRunSet(t, body) {
   const r = await call(t.fetch ?? fetch, t.url, "/v1/run-sets", keyHeader(t), body);
   return { run_set_id: String(r.run_set_id), dashboard_url: String(r.dashboard_url) };
@@ -7628,7 +7628,7 @@ function summarizeCpuProfile(raw, sessionId, name) {
   };
 }
 
-// packages/profile-analysis/dist/src/perflab/hermes.js
+// packages/profile-analysis/dist/src/keepsnappy/hermes.js
 var HERMES_ROOT = "[root]";
 function hermesIdleAsCdp(profile) {
   const hasParent = new Set;
@@ -8205,7 +8205,7 @@ function selectTaskCards(profile, durationMs, taskSet, classes) {
   };
 }
 
-// packages/profile-analysis/dist/src/perflab/keys.js
+// packages/profile-analysis/dist/src/keepsnappy/keys.js
 function keyPath(path) {
   const normalized = path.replace(/\\/g, "/");
   const marker = normalized.lastIndexOf("node_modules/");
@@ -8228,9 +8228,9 @@ function functionKey(frame, options = {}) {
   return `${name}@${compactLocation(frame.url, frame.lineNumber, frame.columnNumber)}`;
 }
 
-// packages/profile-analysis/dist/src/perflab/measuring.js
-var MEASURING_NAME = "(PerfLab measuring)";
-var SDK_PATH = /(?:^|\/)(?:node_modules\/)?@(?:keepsnappy|perf-labs)\/react-native\//;
+// packages/profile-analysis/dist/src/keepsnappy/measuring.js
+var MEASURING_NAME = "(KeepSnappy measuring)";
+var SDK_PATH = /(?:^|\/)(?:node_modules\/)?@keepsnappy\/react-native\//;
 var SDK_FUNCTION_NAMES = new Set([
   "recordCommit",
   "recordUnmount",
@@ -8263,8 +8263,8 @@ var SDK_FUNCTION_NAMES = new Set([
   "finalizeWindow",
   "windowAggregate",
   "perfLog",
-  "handlePerfLabDeepLink",
-  "isPerfLabUrl",
+  "handleKeepSnappyDeepLink",
+  "isKeepSnappyUrl",
   "logStartup",
   "addStartupSection",
   "extraStartupSections",
@@ -8343,7 +8343,7 @@ function foldMeasuring(profile) {
   return { profile: { ...profile, nodes, samples }, measuringId };
 }
 
-// packages/profile-analysis/dist/src/perflab/task-cards.js
+// packages/profile-analysis/dist/src/keepsnappy/task-cards.js
 var REACT_INTERNALS = new Set([
   "propagateParentContextChanges",
   "lazilyPropagateParentContextChanges",
@@ -8481,7 +8481,7 @@ function finishCard(card, measuringMs, profileStartMs) {
   const cleaned = { ...card, boundaryFrames, culprits: keep(card.culprits) };
   const { title, location } = taskCardTitle(cleaned);
   const what = card.boundaries === "measured" ? "task" : "stretch of uninterrupted JS work";
-  const measuring = measuringMs >= 1 ? ` (${formatMs(measuringMs)} of it PerfLab's own measuring)` : "";
+  const measuring = measuringMs >= 1 ? ` (${formatMs(measuringMs)} of it KeepSnappy's own measuring)` : "";
   return {
     ...cleaned,
     headline: `${title} — a ${formatMs(card.durationMs)} ${what}${measuring}`,
@@ -8693,7 +8693,7 @@ function originClassTable(frames, origins) {
 }
 // packages/profile-analysis/dist/src/tracesift/lib/card-prompt.js
 var DRAWABLE3 = new Set(SHOWN_CLASSES);
-// packages/profile-analysis/dist/src/perflab/slice.js
+// packages/profile-analysis/dist/src/keepsnappy/slice.js
 function sliceCpuProfile(profile, window, options = {}) {
   const offsetUs = (options.clockOffsetMs ?? 0) * 1000;
   const t0Us = window.t0Ms * 1000 - offsetUs;
@@ -8765,10 +8765,10 @@ function pruneNodes(nodes, samples) {
     return out;
   });
 }
-// packages/profile-analysis/dist/src/perflab/source-map.js
+// packages/profile-analysis/dist/src/keepsnappy/source-map.js
 var BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 var BASE64_VALUE = new Map([...BASE64].map((char, index) => [char, index]));
-// packages/profile-analysis/dist/src/perflab/symbolicate.js
+// packages/profile-analysis/dist/src/keepsnappy/symbolicate.js
 var FRAMEWORK_PACKAGES = new Set([
   "react",
   "react-native",
@@ -8777,9 +8777,9 @@ var FRAMEWORK_PACKAGES = new Set([
   "scheduler",
   "metro-runtime"
 ]);
-// packages/profile-analysis/dist/src/perflab/composition.js
+// packages/profile-analysis/dist/src/keepsnappy/composition.js
 var HOST_PRIMITIVES = new Set(["View", "Text", "Image", "TextInput", "ScrollView"]);
-// packages/profile-analysis/dist/src/perflab/summary.js
+// packages/profile-analysis/dist/src/keepsnappy/summary.js
 var DEFAULT_TOP_N = 10;
 var NOT_WORK = new Set(["(root)", "[root]", "(idle)", "(program)"]);
 var MAX_CALLERS2 = 3;
@@ -9020,7 +9020,7 @@ async function extract(deps, outDir, ri, memWindow, clockOffsetMs) {
     let logText = "";
     let cpuProfiles = new Map;
     try {
-      const log = await deps.fs.readFile(join6(outDir, r.run_id, "perf-lab.log"));
+      const log = await deps.fs.readFile(join6(outDir, r.run_id, "keepsnappy.log"));
       logText = log;
       cpuProfiles = await readCpuProfiles(deps, join6(outDir, r.run_id), log);
       windows = windowsInRun(parseWindows(log), r.t0, r.t1);
@@ -9141,7 +9141,7 @@ ${r.stderr}` : ""}`);
     try {
       const text = await source.fetchLog(opts.bundleId);
       logText = text;
-      await fs.writeFile(join7(dir, "perf-lab.log"), text);
+      await fs.writeFile(join7(dir, "keepsnappy.log"), text);
       windows = windowsInRun(parseWindows(text), t0, t1);
       samples = samplesInRun(parseSamples(text), t0, t1);
       cpuProfiles = await pullCpuProfiles(source, opts.bundleId, text, pulled);
@@ -9150,7 +9150,7 @@ ${r.stderr}` : ""}`);
       await saveCpuProfiles(deps, dir, cpuProfiles);
     } catch (e) {
       if (!reason)
-        reason = `no-perf-lab-log: ${e.message}`;
+        reason = `no-keepsnappy-log: ${e.message}`;
     }
     const markers = opts.markers?.forRun(p.runId) ?? [];
     if (markers.length)
@@ -9294,7 +9294,7 @@ async function writeComparisonDataset(deps, baselineDir, outDir) {
 `);
   return dir;
 }
-async function perflabRun(deps, source, opts) {
+async function keepsnappyRun(deps, source, opts) {
   const { runs, rows: raw } = await measure(deps, source, undefined, {
     arms: [{ name: "A" }],
     repeat: opts.repetitions,
@@ -9321,7 +9321,7 @@ async function replayRuns(deps, sources, outDir, scenario) {
   const runs = [];
   for (const src of sources) {
     const text = await deps.fs.readFile(join9(src.dir, "runs.ndjson")).catch(() => {
-      throw new Error(`--replay ${src.dir}: no runs.ndjson (not a perflab out dir)`);
+      throw new Error(`--replay ${src.dir}: no runs.ndjson (not a keepsnappy out dir)`);
     });
     for (const line of text.split(`
 `)) {
@@ -9332,7 +9332,7 @@ async function replayRuns(deps, sources, outDir, scenario) {
         continue;
       const id = `${String(runs.length + 1).padStart(3, "0")}-A`;
       await deps.fs.mkdir(join9(outDir, id));
-      for (const f of ["perf-lab.log", "markers.ndjson", "test.log"]) {
+      for (const f of ["keepsnappy.log", "markers.ndjson", "test.log"]) {
         const body = await deps.fs.readFile(join9(src.dir, r.run_id, f)).catch(() => null);
         if (body !== null)
           await deps.fs.writeFile(join9(outDir, id, f), body);
@@ -9350,7 +9350,7 @@ async function replayRuns(deps, sources, outDir, scenario) {
 }
 
 // apps/agent/src/remote-verdict.ts
-var RUN_INFO = "perflab-run.json";
+var RUN_INFO = "keepsnappy-run.json";
 async function remoteVerdict(deps, outDir, api, opts = {}) {
   let info = {};
   try {
@@ -9401,7 +9401,7 @@ ${output.table}`);
 }
 
 // apps/agent/src/defaults.ts
-var DEFAULT_API_URL = "https://keepsnappy-api-864539138788.europe-west1.run.app";
+var DEFAULT_API_URL = "https://keepsnappy-api-922918702810.europe-west1.run.app";
 
 // apps/agent/src/journeys.ts
 import { isAbsolute, relative, resolve as resolve2, sep } from "node:path";
@@ -9579,7 +9579,7 @@ async function runCommand(deps, o, positionals, rt = { env: process.env, print:
       }
     }
     deps.log(`running ${flows.length} flow${flows.length === 1 ? "" : "s"} x${repeat}: ${flows.map((f) => f.name).join(", ")}`);
-    const outcome = await perflabRun(deps, source, {
+    const outcome = await keepsnappyRun(deps, source, {
       config,
       flows,
       outDir: out,
@@ -9605,7 +9605,7 @@ ${outcome.summary}`);
     device: { ...device, ...config.device && config.device !== "booted" ? { id: config.device } : {} },
     meta: { device_provider: provider, ...git.commit ? { commit_sha: git.commit } : {}, ...git.branch ? { branch: git.branch } : {} },
     ...runSet ? { runSetId: runSet.run_set_id } : {},
-    driver: config.flows.runner === "maestro" && positionals.length === 0 ? "maestro" : "perflab-run",
+    driver: config.flows.runner === "maestro" && positionals.length === 0 ? "maestro" : "keepsnappy-run",
     ...api.fetch ? { fetch: api.fetch } : {}
   }).catch(infra(`results are saved in ${out}, but the upload failed`));
   rt.print(`uploaded ${up.uploaded} runs to ${api.url}${up.skipped.length ? ` (${up.skipped.length} skipped: ${up.skipped.map((x) => `${x.run_id} ${x.why}`).join(", ")})` : ""}`);
@@ -9643,7 +9643,7 @@ var infra = (what) => (e) => {
 };
 async function writeResult(deps, out, rt, runSet, summary, branch) {
   const url = summary?.dashboard_url ?? runSet.dashboard_url;
-  await deps.fs.writeFile(join11(out, "perflab-result.json"), `${JSON.stringify({ run_set_id: runSet.run_set_id, dashboard_url: url, state: summary?.verdicts?.state ?? null, summary }, null, 2)}
+  await deps.fs.writeFile(join11(out, "keepsnappy-result.json"), `${JSON.stringify({ run_set_id: runSet.run_set_id, dashboard_url: url, state: summary?.verdicts?.state ?? null, summary }, null, 2)}
 `);
   const step = rt.env.GITHUB_STEP_SUMMARY;
   if (step)
@@ -9770,7 +9770,7 @@ import { dirname as dirname3, join as join13, resolve as resolve5 } from "node:p
 // packages/appium-driver/dist/src/links.js
 var ALERT_POLL_MS = 250;
 var RUN_DEFAULTS = { ttl: 3600, profile: 1, diag: 1 };
-var route = (scheme) => `${scheme}devtools/perf-lab`;
+var route = (scheme) => `${scheme}devtools/keepsnappy`;
 function parseSdkArgs(args) {
   return args.split("&").filter(Boolean).map((kv) => {
     const i = kv.indexOf("=");
@@ -9980,7 +9980,7 @@ class Screen {
 // packages/appium-driver/dist/src/platform.js
 var modelOf2 = (device) => device.replace(/-[^-]*$/, "");
 var versionOf = (device) => device.replace(/^.*-/, "");
-var FLUSH_ID = "perflab.flushed";
+var FLUSH_ID = "keepsnappy.flushed";
 function parseBroadcastAnswer(out, n) {
   const data = /data="([^"]*)"/.exec(String(out ?? ""))?.[1];
   return data !== undefined && data.startsWith(`gc:${n} `) ? data : null;
@@ -10042,7 +10042,7 @@ var ANDROID = {
   uploadFields: {},
   async gcCommand(driver, n) {
     const out = await driver.execute("mobile: broadcast", {
-      action: `${driver.bundleId}.perflab.COMMAND`,
+      action: `${driver.bundleId}.keepsnappy.COMMAND`,
       package: driver.bundleId,
       extras: [["s", "cmd", "gc"], ["i", "n", String(n)]],
       flags: "0x10000000"
@@ -10069,7 +10069,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { dirname as dirname2, join as join12, relative as relative2, resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
 function driverVersion() {
-  const built = "0.1.0-alpha.12";
+  const built = "0.1.0-alpha.13";
   if (built)
     return built;
   let dir = dirname2(fileURLToPath(import.meta.url));
@@ -10328,7 +10328,7 @@ function linksCommand(cmd, argv, rt) {
   rt.print(activationLink(o.scheme, o.token, set.join("&")));
   return 0;
 }
-var maestroLinkFields = (sdkArgs = "") => ({ perflabLinkArgs: linkArgs(sdkArgs) });
+var maestroLinkFields = (sdkArgs = "") => ({ keepsnappyLinkArgs: linkArgs(sdkArgs) });
 
 // apps/agent/src/farm.ts
 var STATE_VERSION = 1;
@@ -10355,17 +10355,17 @@ function instrumentFlags(f) {
   const journey = f["journey-version"] ?? hash;
   return { ...driver ? { "driver-version": driver } : {}, ...journey ? { "journey-version": journey } : {} };
 }
-var TOKENS_STUB = "// Replaced by `keepsnappy farm open` for one upload. Never commit real tokens.\noutput.perflabTokens = {};\n";
+var TOKENS_STUB = "// Replaced by `keepsnappy farm open` for one upload. Never commit real tokens.\noutput.keepsnappyTokens = {};\n";
 var JOURNEY = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
 var DEFAULT_TTL = 21600;
 var POLL_MS = 5000;
 function tokensJs(api, runSetId, tokens, links = maestroLinkFields()) {
   return [
     `// Generated by \`keepsnappy farm open\` for run set ${runSetId}. Overlaid into the suite for one upload; never commit.`,
-    `output.perflabApi = ${JSON.stringify(api.replace(/\/+$/, ""))};`,
-    `output.perflabRunSet = ${JSON.stringify(runSetId)};`,
-    `output.perflabTokens = ${JSON.stringify(tokens)};`,
-    `output.perflabLinkArgs = ${JSON.stringify(links.perflabLinkArgs)};`,
+    `output.keepsnappyApi = ${JSON.stringify(api.replace(/\/+$/, ""))};`,
+    `output.keepsnappyRunSet = ${JSON.stringify(runSetId)};`,
+    `output.keepsnappyTokens = ${JSON.stringify(tokens)};`,
+    `output.keepsnappyLinkArgs = ${JSON.stringify(links.keepsnappyLinkArgs)};`,
     ""
   ].join(`
 `);
@@ -10443,7 +10443,7 @@ async function farmOpen(deps, f, rt) {
   if (!Number.isInteger(ttl) || ttl < 60)
     problems.push("--ttl-seconds must be a whole number >= 60");
   if (!f["tokens-js"])
-    problems.push("--tokens-js <path> is required (the file the suite overlay puts at flows/perflab/tokens.js)");
+    problems.push("--tokens-js <path> is required (the file the suite overlay puts at flows/keepsnappy/tokens.js)");
   if (!f.state)
     problems.push("--state <path> is required (read by keepsnappy farm close)");
   if (problems.length)
@@ -10712,7 +10712,7 @@ async function closeRunSet(deps, f, rt, state, statePath) {
   await deps.fs.writeFile(statePath, `${JSON.stringify(state2, null, 2)}
 `);
   await deps.fs.mkdir(out);
-  await deps.fs.writeFile(join13(out, "perflab-result.json"), `${JSON.stringify({ run_set_id: state.run_set_id, dashboard_url: summary.dashboard_url, state: state2.result.state, session: { status: session.status, message: session.message }, summary }, null, 2)}
+  await deps.fs.writeFile(join13(out, "keepsnappy-result.json"), `${JSON.stringify({ run_set_id: state.run_set_id, dashboard_url: summary.dashboard_url, state: state2.result.state, session: { status: session.status, message: session.message }, summary }, null, 2)}
 `);
   await githubOutputs(deps, rt, { state: state2.result.state ?? "none", dashboard_url: summary.dashboard_url, run_set_id: state.run_set_id });
   const step = rt.env.GITHUB_STEP_SUMMARY;
@@ -10893,7 +10893,7 @@ class BrowserStack {
   }
   async runMaestro(b) {
     const appUrl = await this.uploadApp(b.app, b.customId);
-    const work = join15(this.o.tmpDir ?? "/tmp", `perflab-suite-${(this.o.uniqueId ?? randomUUID)()}`);
+    const work = join15(this.o.tmpDir ?? "/tmp", `keepsnappy-suite-${(this.o.uniqueId ?? randomUUID)()}`);
     let suiteUrl;
     try {
       const zip = await this.zipSuite(b, work);
@@ -10911,8 +10911,8 @@ class BrowserStack {
       testSuite: suiteUrl,
       devices: [b.device],
       setEnvVariables: { ...b.env, RUN_ID: b.runId },
-      buildTag: `perflab-${b.runId}`,
-      customBuildName: `perflab ${b.runId} ${b.platform}`,
+      buildTag: `keepsnappy-${b.runId}`,
+      customBuildName: `keepsnappy ${b.runId} ${b.platform}`,
       execute: [b.execute],
       deviceLogs: true,
       ...b.localIdentifier ? { local: "true", localIdentifier: b.localIdentifier } : {},
@@ -11045,7 +11045,7 @@ function nodeFarmRunPorts(deps, rt) {
   if (!user || !key)
     throw new ConfigError(["BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY must be set"]);
   const tmp = rt.env.RUNNER_TEMP ?? rt.env.TMPDIR ?? "/tmp";
-  const dir = join16(tmp, "perflab-bs-local");
+  const dir = join16(tmp, "keepsnappy-bs-local");
   return {
     apps: new DefaultAppResolver(deps, rt.env),
     provider: new BrowserStack(deps, { credentials: { user, key }, tmpDir: tmp, ...rt.fetch ? { fetch: rt.fetch } : {}, ...rt.sleep ? { sleep: rt.sleep } : {}, ...rt.now ? { now: rt.now } : {} }),
@@ -11158,10 +11158,10 @@ function printPlan(p, f, rt) {
   line("keepsnappy farm run: dry run, no request is made and nothing is written");
   line(`  1. validate: ${p.journeys.join(", ")} x ${p.repeat} on ${p.device} (${p.platform}), driver ${p.driver}`);
   line(`  2. resolve the app: ${p.app.startsWith("eas:") ? `eas-cli build:view ${p.app.slice(4)}, download into ${p.out}` : p.app.startsWith("bs://") ? "bs:// passes through" : `${p.app} (local file)`}`);
-  line(`  3. farm open -> ${join16(p.out, "perflab-tokens.js")}, ${join16(p.out, "perflab-farm.json")} (POST /v1/run-sets, then POST /v1/runs x ${p.journeys.length * p.repeat})`);
+  line(`  3. farm open -> ${join16(p.out, "keepsnappy-tokens.js")}, ${join16(p.out, "keepsnappy-farm.json")} (POST /v1/run-sets, then POST /v1/runs x ${p.journeys.length * p.repeat})`);
   line(`  4. tunnel: ${p.ports.length ? `BrowserStackLocal for bs-local.com ports ${p.ports.join(", ")}, identifier = run id` : "none (no --tunnel-for)"}`);
   if (p.driver === "maestro") {
-    line(`  5. maestro on BrowserStack: upload app, zip ${f["suite-dir"]} with the tokens at ${f["tokens-path"] ?? "flows/perflab/tokens.js"}, upload suite, POST build (execute ${f.execute}), poll`);
+    line(`  5. maestro on BrowserStack: upload app, zip ${f["suite-dir"]} with the tokens at ${f["tokens-path"] ?? "flows/keepsnappy/tokens.js"}, upload suite, POST build (execute ${f.execute}), poll`);
   } else {
     line(`  5. appium: ${f["journey-module"] ? `built-in driver, journey module ${f["journey-module"]}` : `node ${f["driver-script"]}`} --platform ${p.platform} --device ... --tokens-js ... --journeys ... --repeat ${p.repeat}${p.driverArgs.length ? ` ${p.driverArgs.map((a) => substitute(a, {})).join(" ")}` : ""}`);
   }
@@ -11180,7 +11180,7 @@ async function runDriver2(deps, rt, f, p, ports, ctx) {
       app: ctx.app,
       ...f["custom-id"] ? { customId: f["custom-id"] } : {},
       suiteDir: resolve6(f["suite-dir"]),
-      tokensPath: f["tokens-path"] ?? "flows/perflab/tokens.js",
+      tokensPath: f["tokens-path"] ?? "flows/keepsnappy/tokens.js",
       tokensJs: ctx.tokensJs,
       execute: f.execute,
       runId: ctx.runId,
@@ -11251,7 +11251,7 @@ async function runDriver2(deps, rt, f, p, ports, ctx) {
 }
 async function farmRun(deps, f, rt, ports) {
   const p = planFarmRun(f);
-  const statePath = join16(p.out, "perflab-farm.json");
+  const statePath = join16(p.out, "keepsnappy-farm.json");
   if (await deps.fs.exists(statePath))
     throw new ConfigError([`${statePath} exists: a run set was opened here before; use another --out or remove ${p.out} (close it first with keepsnappy farm close)`]);
   if (f["dry-run"]) {
@@ -11259,7 +11259,7 @@ async function farmRun(deps, f, rt, ports) {
     return EXIT.ok;
   }
   const farm = ports ?? nodeFarmRunPorts(deps, rt);
-  const tokensJs = join16(p.out, "perflab-tokens.js");
+  const tokensJs = join16(p.out, "keepsnappy-tokens.js");
   await deps.fs.mkdir(p.out);
   const resolved = await farm.apps.resolve(p.app, { outDir: p.out });
   const commit = f.commit ?? resolved.commit ?? undefined;
@@ -11287,7 +11287,7 @@ async function farmRun(deps, f, rt, ports) {
       return openCode;
     opened = true;
     const state = JSON.parse(await deps.fs.readFile(statePath));
-    const runId = f["run-id"] ?? `perflab-${p.platform}-${state.run_set_id.slice(0, 8)}`;
+    const runId = f["run-id"] ?? `keepsnappy-${p.platform}-${state.run_set_id.slice(0, 8)}`;
     const ctx = { runId, out: p.out, tokensJs, runSetId: state.run_set_id, app: resolved.app };
     try {
       await deps.spawner.run("rm", ["-f", join16(p.out, `browserstack.${p.platform}.json`)]);
@@ -11371,7 +11371,7 @@ async function put(f, upload, body) {
 async function uploadSourcemaps(opts) {
   const f = opts.fetch ?? fetch;
   const read = opts.readFile ?? ((p) => readFile4(p, "utf8"));
-  const headers = { "x-perflab-key": opts.key };
+  const headers = { "x-keepsnappy-key": opts.key };
   const out = [];
   for (const file of opts.files) {
     let parsed;
@@ -11625,7 +11625,7 @@ async function get(t, path, query = {}) {
   for (const [k, v] of Object.entries(query))
     if (v !== undefined && v !== "")
       u.searchParams.set(k, String(v));
-  const r = await (t.fetch ?? fetch)(u, { headers: { "x-perflab-key": t.key, accept: "application/json" } });
+  const r = await (t.fetch ?? fetch)(u, { headers: { "x-keepsnappy-key": t.key, accept: "application/json" } });
   const text = await r.text();
   const body = text ? JSON.parse(text) : {};
   if (!r.ok) {
@@ -11767,7 +11767,7 @@ var USAGE = `keepsnappy <command>
   farm close --state <file> [--wait [--fail-on-worse]] [--bs-build browserstack.ios.json] [--settle-seconds 60] [--max-wait-seconds 300] [--out DIR]
   farm run   --app <eas:ID|file.ipa|bs://ID> --journeys a,b [--repeat 5] --device "iPhone 15 Pro-17" [--platform ios|android] [--driver maestro|appium]
              [--tunnel-for localhost:PORT ...] [--env KEY=VALUE ...] (values may use {tunnel:PORT} {run_id} {out} {tokens_js} {run_set_id})
-             maestro: --suite-dir DIR --execute FLOW [--tokens-path flows/perflab/tokens.js] [--maestro-version V]
+             maestro: --suite-dir DIR --execute FLOW [--tokens-path flows/keepsnappy/tokens.js] [--maestro-version V]
              appium:  --journey-module FILE | --driver-script FILE [--driver-arg ARG ...]
              [--branch NAME --commit SHA] [--wait [--fail-on-worse]] [--out DIR] [--dry-run]   (open + tunnel + device + close; docs/plans/54a)
   extract <out-dir> --ri-capture observations.ndjson [--mem-window NAME]
@@ -11899,7 +11899,7 @@ async function main2(argv) {
     if (platform === "ios-device" && !o.device)
       throw new Error("--device <udid> is required for ios-device");
     const arms = parseArmEnv(o["arm-env"], parseArms(o.arms));
-    const out = resolve7(o.out ?? `perflab-${new Date().toISOString().replace(/[:.]/g, "-")}`);
+    const out = resolve7(o.out ?? `keepsnappy-${new Date().toISOString().replace(/[:.]/g, "-")}`);
     const udid = o.device ?? "booted";
     const source = platform === "ios-sim" ? new IosSimulatorDataSource(deps, udid) : new IosDeviceDataSource(deps, udid, resolve7(out, ".scratch"));
     const installer = platform === "ios-sim" ? new IosSimulatorInstaller(deps, udid) : new IosDeviceInstaller(deps, udid);

package/examples/farm/flows/{perflab → keepsnappy}/begin-run.yaml

@@ -13,5 +13,5 @@ appId: com.gigaverse.appdev
       id: ${output.elements.home.screen}
     timeout: 30000
 # The settings come from tokens.js (`keepsnappy farm open`): the run defaults, never written by hand here (REQ-FARM-28).
-- openLink: gigaversedev://devtools/perf-lab?activate=1&${output.perflabLinkArgs}&runToken=${output.perflabToken}
+- openLink: gigaversedev://devtools/keepsnappy?activate=1&${output.keepsnappyLinkArgs}&runToken=${output.keepsnappyToken}
 - runFlow: ../../subflows/confirm-open-link.yaml

package/examples/farm/flows/{perflab → keepsnappy}/end-run.yaml

@@ -1,16 +1,16 @@
 # End of one measured iteration: the SDK sends everything still unsent (nothing is sent while a run is active), then
-# shows `perflab.flushed` (ok | error | off). `activate=0` makes the next launch dormant again.
+# shows `keepsnappy.flushed` (ok | error | off). `activate=0` makes the next launch dormant again.
 appId: com.gigaverse.appdev
 ---
 - runScript: send-markers.js   # the iteration's step markers, recorded by step.js, sent now that it has ended
-- openLink: gigaversedev://devtools/perf-lab?flush=1&activate=0
+- openLink: gigaversedev://devtools/keepsnappy?flush=1&activate=0
 - runFlow: ../../subflows/confirm-open-link.yaml
 - extendedWaitUntil:
     visible:
-      id: perflab.flushed
+      id: keepsnappy.flushed
     timeout: 60000
     optional: true   # a dormant iteration (activation failed) shows nothing; farm close marks it invalid
 - assertVisible:
-    id: perflab.flushed
+    id: keepsnappy.flushed
     text: ok
     optional: true

package/examples/farm/flows/keepsnappy/next-token.js

@@ -0,0 +1,7 @@
+// Hands out the run tokens of one journey in order: iteration i of JOURNEY gets output.keepsnappyTokens[JOURNEY][i].
+// ES5 (Maestro runScript). An empty token (more iterations than tokens) leaves the SDK dormant: no data, no harm.
+var list = (output.keepsnappyTokens || {})[JOURNEY] || [];
+output.keepsnappyIdx = output.keepsnappyIdx || {};
+var i = output.keepsnappyIdx[JOURNEY] || 0;
+output.keepsnappyToken = list[i] || '';
+output.keepsnappyIdx[JOURNEY] = i + 1;

package/examples/farm/flows/{perflab/run-perflab.yaml → keepsnappy/run-keepsnappy.yaml}

@@ -1,4 +1,4 @@
-# e2e/flows/perflab/run-perflab.yaml (plan 36 D10). One BrowserStack session runs every iteration: the session is the
+# e2e/flows/keepsnappy/run-keepsnappy.yaml (plan 36 D10). One BrowserStack session runs every iteration: the session is the
 # noise block. Untagged, so smoke/regression never select it; the dispatcher names it with --execute.
 # `times` must equal `keepsnappy farm open --repeat`. One begin/journey/end triple per journey listed in --journeys.
 appId: com.gigaverse.appdev