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

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

package/examples/farm/flows/{perflab → keepsnappy}/send-markers.js

@@ -13,8 +13,7 @@
 try {
   var g = typeof globalThis !== 'undefined' ? globalThis : this;
   var pick = function (name, dflt) {
-    var modern = name.replace(/^PERFLAB_/, 'KEEPSNAPPY_');
-    var names = modern === name ? [name, 'MAESTRO_' + name] : [modern, 'MAESTRO_' + modern, name, 'MAESTRO_' + name];
+    var names = [name, 'MAESTRO_' + name];
     for (var i = 0; i < names.length; i++) {
       var v = g[names[i]];
       if (typeof v === 'string' && (v !== '' || names[i].indexOf('KEEPSNAPPY_') >= 0)) return v;
@@ -27,9 +26,9 @@ try {
   var RETRY_CAP_MS = 30000;
   var CLOCK_PROBES = 4;
   var out = typeof output !== 'undefined' && output ? output : {};
-  var list = out.perflabMarkers || [];
-  out.perflabMarkers = [];
-  var api = pick('PERFLAB_API_URL', typeof out.perflabApi === 'string' ? out.perflabApi : '').replace(/\/+$/, '');
+  var list = out.keepsnappyMarkers || [];
+  out.keepsnappyMarkers = [];
+  var api = pick('KEEPSNAPPY_API_URL', typeof out.keepsnappyApi === 'string' ? out.keepsnappyApi : '').replace(/\/+$/, '');
   var wait = function (ms) {
     try {
       java.lang.Thread.sleep(ms);

package/examples/farm/flows/keepsnappy/step-markers.yaml

@@ -0,0 +1,13 @@
+# Declared steps in farm mode (plan 36 M2, G4). Copy apps/agent/maestro/keepsnappy/step.yaml and step.js next to this file
+# (e2e/flows/keepsnappy/); send-markers.js is already here, the same file as maestro/keepsnappy/send-markers.js. In farm mode
+# step.js only records the marker with the iteration's token (`output.keepsnappyToken`, taken by begin-run.yaml); send-markers.js in end-run.yaml posts them to
+# <output.keepsnappyApi>/v1/markers once the iteration ended, so the test never waits on the network between actions and
+# no CLI listens on the farm host. Without send-markers.js in end-run.yaml no farm marker is ever sent.
+# A journey that failed half-way drops out of the statistics because it never posted its set's completion marker and
+# `keepsnappy farm close` marks it invalid. Its step markers still reach KeepSnappy: run-keepsnappy.yaml sends what is left from
+# onFlowComplete, for diagnosis. Inside the journey, around the part to measure:
+appId: com.gigaverse.appdev
+---
+- runFlow: { file: ../keepsnappy/step.yaml, env: { STEP: chat.open, PHASE: start } }
+- tapOn: { id: chat-open }
+- runFlow: { file: ../keepsnappy/step.yaml, env: { STEP: chat.open, PHASE: end } }

package/examples/farm/flows/keepsnappy/tokens.js

@@ -0,0 +1,2 @@
+// Replaced by `keepsnappy farm open` for one upload. Never commit real tokens.
+output.keepsnappyTokens = {};

package/examples/farm/workflows/{perflab-measure.yml → keepsnappy-measure.yml}

@@ -1,8 +1,8 @@
-# .github/workflows/perflab-measure.yml (plan 36 D8): KeepSnappy on BrowserStack, called last in perf-device-run.yml.
+# .github/workflows/keepsnappy-measure.yml (plan 36 D8): KeepSnappy on BrowserStack, called last in perf-device-run.yml.
 #
 # The CLI never touches the device. `farm open` makes the run set and one KeepSnappy run per journey per iteration, and
-# writes their run tokens into perflab-tokens.js. BrowserStack caps env values at 100 characters, so the tokens ride
-# inside the uploaded suite: browserstack-run.mjs --suite-overlay writes that file to e2e/flows/perflab/tokens.js for
+# writes their run tokens into keepsnappy-tokens.js. BrowserStack caps env values at 100 characters, so the tokens ride
+# inside the uploaded suite: browserstack-run.mjs --suite-overlay writes that file to e2e/flows/keepsnappy/tokens.js for
 # this one upload. The app, activated per iteration with its token, pushes its windows to the KeepSnappy API itself.
 # `farm close` waits until no batch has arrived for --settle-seconds, finishes every run (the one a failed session
 # broke is marked invalid; iterations that never ran show as "no data"), closes the set and prints the verdict.
@@ -11,8 +11,8 @@
 # iteration sent data) or the API failed, 2 for a configuration problem, 3 with --fail-on-worse on "More work".
 # Re-running close is safe: finished runs are left alone and the same result is printed again.
 #
-# Files in $OUT_DIR after the job (uploaded below): perflab-farm.json (state: run set, runs, result; no tokens),
-# perflab-result.json, browserstack.ios.json. perflab-tokens.js holds live run tokens (valid for hours): close puts the
+# Files in $OUT_DIR after the job (uploaded below): keepsnappy-farm.json (state: run set, runs, result; no tokens),
+# keepsnappy-result.json, browserstack.ios.json. keepsnappy-tokens.js holds live run tokens (valid for hours): close puts the
 # empty stub back even when it fails, and the job deletes the file before the upload whatever happened.
 
 name: KeepSnappy measure (reusable)
@@ -36,12 +36,12 @@ jobs:
       BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
       BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}
       KEEPSNAPPY_KEY: ${{ secrets.KEEPSNAPPY_KEY }}                  # run scope; never leaves this runner
-      KEEPSNAPPY_API: https://perflab-api-864539138788.europe-west1.run.app
-      PERFLAB_CLI: '@keepsnappy/agent@0.1.0-alpha.1'           # first version with `farm` (not published yet)
+      KEEPSNAPPY_API: https://keepsnappy-api-922918702810.europe-west1.run.app
+      KEEPSNAPPY_CLI: '@keepsnappy/agent@0.1.0-alpha.1'           # first version with `farm` (not published yet)
       OUT_DIR: ${{ github.workspace }}/farm-run
-      RUN_ID: perflab-${{ inputs.platform }}-${{ github.run_id }}-${{ github.run_attempt }}
-      JOURNEYS: e2e-community-and-live-chat                    # = the JOURNEY values in run-perflab.yaml
-      REPEAT: '5'                                              # = repeat.times in run-perflab.yaml
+      RUN_ID: keepsnappy-${{ inputs.platform }}-${{ github.run_id }}-${{ github.run_attempt }}
+      JOURNEYS: e2e-community-and-live-chat                    # = the JOURNEY values in run-keepsnappy.yaml
+      REPEAT: '5'                                              # = repeat.times in run-keepsnappy.yaml
     steps:
       - uses: actions/checkout@v5
       - uses: actions/setup-node@v4
@@ -71,11 +71,11 @@ jobs:
           APP_COMMIT: ${{ steps.app.outputs.app_commit }}
         run: |
           [ -n "$APP_COMMIT" ] || { echo '::error::the artifact carries no commit'; exit 1; }
-          npx --yes "$PERFLAB_CLI" farm open \
+          npx --yes "$KEEPSNAPPY_CLI" farm open \
             --api "$KEEPSNAPPY_API" --branch main --commit "$APP_COMMIT" \
             --device-model 'iPhone 15 Pro' --device-os 17 --device-provider browserstack \
             --journeys "$JOURNEYS" --repeat "$REPEAT" \
-            --tokens-js "$OUT_DIR/perflab-tokens.js" --state "$OUT_DIR/perflab-farm.json"
+            --tokens-js "$OUT_DIR/keepsnappy-tokens.js" --state "$OUT_DIR/keepsnappy-farm.json"
 
       - name: Run the KeepSnappy orchestrator on the device
         id: device
@@ -88,30 +88,30 @@ jobs:
           PLATFORM: ${{ inputs.platform }}
         run: |
           args=(--platform "$PLATFORM" --device "$DEVICE" --app "$APP" --run-id "$RUN_ID"
-                --label perflab --maestro-version "$MAESTRO" --out "$OUT_DIR" --timeout-minutes 80
-                --execute flows/perflab/run-perflab.yaml
-                --suite-overlay "flows/perflab/tokens.js:$OUT_DIR/perflab-tokens.js")
+                --label keepsnappy --maestro-version "$MAESTRO" --out "$OUT_DIR" --timeout-minutes 80
+                --execute flows/keepsnappy/run-keepsnappy.yaml
+                --suite-overlay "flows/keepsnappy/tokens.js:$OUT_DIR/keepsnappy-tokens.js")
           [ -n "$APP_CUSTOM_ID" ] && args+=(--custom-id "$APP_CUSTOM_ID")
           node scripts/farm/browserstack-run.mjs "${args[@]}"
 
       # Runs whatever the device step did: a failed session still closes the set with what arrived. Writes the verdict
       # and the dashboard link to $GITHUB_STEP_SUMMARY.
       - name: Close the run set and print the verdict
-        if: always() && hashFiles('farm-run/perflab-farm.json') != ''
+        if: always() && hashFiles('farm-run/keepsnappy-farm.json') != ''
         run: |
-          npx --yes "$PERFLAB_CLI" farm close \
-            --state "$OUT_DIR/perflab-farm.json" \
+          npx --yes "$KEEPSNAPPY_CLI" farm close \
+            --state "$OUT_DIR/keepsnappy-farm.json" \
             --bs-build "$OUT_DIR/browserstack.${{ inputs.platform }}.json" --settle-seconds 60 --wait
 
       # Run tokens never go into the artifact, also when open or close failed half-way.
       - name: Remove the run tokens
         if: always()
-        run: rm -f "$OUT_DIR/perflab-tokens.js"
+        run: rm -f "$OUT_DIR/keepsnappy-tokens.js"
 
       - name: Upload the run
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: perflab-${{ inputs.platform }}-${{ github.run_id }}
+          name: keepsnappy-${{ inputs.platform }}-${{ github.run_id }}
           path: ${{ env.OUT_DIR }}
           retention-days: 30

package/examples/farm/workflows/perf-device-run.fragment.yml

@@ -1,19 +1,19 @@
 # Fragment for .github/workflows/perf-device-run.yml (plan 36 D7): KeepSnappy takes the React profiler's slot, last in the
-# chain, on the same eas:<id> the baseline and gigaload measured. Add `perflab` to the `prepare` options parsing
-# (perflab=on|off, on by default; refuse baseline=off gigaload=off perflab=off) and its output, then this job:
+# chain, on the same eas:<id> the baseline and gigaload measured. Add `keepsnappy` to the `prepare` options parsing
+# (keepsnappy=on|off, on by default; refuse baseline=off gigaload=off keepsnappy=off) and its output, then this job:
 
 jobs:
   # Last, in the slot the React profiler was built for: the same eas:<id> the baseline and gigaload measured, one
   # BrowserStack session, no tunnel, no load fleet. It runs whatever the perf jobs concluded and never fails the night
   # on a KeepSnappy result (exit 1 only when nothing could be judged).
-  perflab:
+  keepsnappy:
     needs: [prepare, baseline-report, gigaload]
     if: >-
       always() && !cancelled() && needs.prepare.result == 'success'
-      && needs.prepare.outputs.perflab == 'on'
+      && needs.prepare.outputs.keepsnappy == 'on'
       && needs.prepare.outputs.drive == 'device'
       && inputs.platform == 'ios'
-    uses: ./.github/workflows/perflab-measure.yml
+    uses: ./.github/workflows/keepsnappy-measure.yml
     secrets: inherit
     with:
       platform: ${{ inputs.platform }}

package/examples/github-actions.yml

@@ -1,16 +1,16 @@
-# .github/workflows/perflab.yml: measure every pull request against main, and grow main's history on every merge.
+# .github/workflows/keepsnappy.yml: measure every pull request against main, and grow main's history on every merge.
 #
-# Needs: a perf build of your app (built with PERFLAB=1, so the KeepSnappy SDK writes its data), Maestro flows, a
-# perflab.yml in the repo root (see examples/perflab.yml), and a project key with `run` scope stored as the repository
-# secret KEEPSNAPPY_KEY. The key never appears in logs; perflab reads it from the environment variable perflab.yml names.
+# Needs: a perf build of your app (built with KEEPSNAPPY=1, so the KeepSnappy SDK writes its data), Maestro flows, a
+# keepsnappy.yml in the repo root (see examples/keepsnappy.yml), and a project key with `run` scope stored as the repository
+# secret KEEPSNAPPY_KEY. The key never appears in logs; keepsnappy reads it from the environment variable keepsnappy.yml names.
 #
 # What you get: on main, the runs join the history of each journey (one journey per Maestro flow file). On a pull
 # request, each journey is compared with main's recent history; the verdict ("More work", "Less work", "No change",
 # "Not enough data yet") is printed in the log and written to the job summary with a link to the comparison page.
 # The job does not fail on "More work" (no blocking checks for now); add --fail-on-worse to make it exit 3 instead.
-# Exit 2 = configuration problem (perflab.yml, flags), exit 1 = infrastructure (device log, upload).
+# Exit 2 = configuration problem (keepsnappy.yml, flags), exit 1 = infrastructure (device log, upload).
 
-name: perflab
+name: keepsnappy
 
 on:
   pull_request:
@@ -18,7 +18,7 @@ on:
     branches: [main]
 
 concurrency:
-  group: perflab-${{ github.ref }}
+  group: keepsnappy-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
@@ -30,7 +30,7 @@ jobs:
 
       # Your own build step. It must produce the simulator .app of the perf build.
       - name: Build the perf build
-        run: ./scripts/build-perf-simulator.sh   # e.g. expo prebuild + xcodebuild with PERFLAB=1 -> build/MyApp.app
+        run: ./scripts/build-perf-simulator.sh   # e.g. expo prebuild + xcodebuild with KEEPSNAPPY=1 -> build/MyApp.app
 
       - name: Boot a simulator and install the app
         run: |
@@ -43,10 +43,10 @@ jobs:
           curl -fsSL "https://get.maestro.mobile.dev" | bash
           echo "$HOME/.maestro/bin" >> "$GITHUB_PATH"
 
-      - name: Install perflab
-        run: npm install -g @keepsnappy/agent   # the KeepSnappy CLI (`perflab`)
+      - name: Install keepsnappy
+        run: npm install -g @keepsnappy/agent   # the KeepSnappy CLI (`keepsnappy`)
 
-      # perflab picks the branch and commit from the GitHub environment (GITHUB_HEAD_REF on a pull request, else
+      # keepsnappy picks the branch and commit from the GitHub environment (GITHUB_HEAD_REF on a pull request, else
       # GITHUB_REF_NAME; GITHUB_SHA). On a pull request GITHUB_SHA is the merge commit, so the head commit is passed.
       - name: Measure, upload and wait for the verdict
         env:
@@ -56,22 +56,22 @@ jobs:
         run: |
           args=(run --upload --wait)
           if [ -n "$PR_HEAD_SHA" ]; then args+=(--commit "$PR_HEAD_SHA" --base-commit "$PR_BASE_SHA"); fi
-          perflab "${args[@]}"
-          # perflab appends the verdict and the dashboard link to $GITHUB_STEP_SUMMARY itself, and writes
-          # perflab-out/perflab-result.json ({run_set_id, dashboard_url, state, summary}) for later steps.
+          keepsnappy "${args[@]}"
+          # keepsnappy appends the verdict and the dashboard link to $GITHUB_STEP_SUMMARY itself, and writes
+          # keepsnappy-out/keepsnappy-result.json ({run_set_id, dashboard_url, state, summary}) for later steps.
 
       # When the measuring step failed before a verdict, still point the summary at the dashboard if a run set exists.
       - name: Link the dashboard
         if: failure()
         run: |
-          if [ -f perflab-out/perflab-run.json ]; then
-            echo "KeepSnappy did not finish; runs uploaded so far are on the dashboard (run set $(jq -r '.run_set_id // "none"' perflab-out/perflab-run.json))." >> "$GITHUB_STEP_SUMMARY"
+          if [ -f keepsnappy-out/keepsnappy-run.json ]; then
+            echo "KeepSnappy did not finish; runs uploaded so far are on the dashboard (run set $(jq -r '.run_set_id // "none"' keepsnappy-out/keepsnappy-run.json))." >> "$GITHUB_STEP_SUMMARY"
           fi
 
       - name: Keep the raw results
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: perflab-out
-          path: perflab-out
+          name: keepsnappy-out
+          path: keepsnappy-out
           retention-days: 14

package/examples/keepsnappy.yml

@@ -1,11 +1,11 @@
-# perflab.yml: the only file you maintain for KeepSnappy. Run it with `keepsnappy run`.
+# keepsnappy.yml: the only file you maintain for KeepSnappy. Run it with `keepsnappy run`.
 
 project:
   key_env: KEEPSNAPPY_KEY            # NAME of the env var holding the project key (a CI secret), never the key itself
   ingest_url: https://ingest.example.com   # optional; only used with `keepsnappy run --upload`
 
 app:
-  bundle_id: com.example.app      # the app under test; its perf-lab data is read from the device after every run
+  bundle_id: com.example.app      # the app under test; its keepsnappy data is read from the device after every run
 
 platform: ios-sim                 # ios-sim | ios-device
 device: booted                    # simulator UDID or "booted"; required (UDID) for ios-device
@@ -31,6 +31,6 @@ steps:
   pin: [community.open]           # always listed in the summary, even without a change
 
 output:
-  dir: perflab-out                # runs.ndjson, metrics.csv, <run>/ logs, verdict (compare/verdict.json)
+  dir: keepsnappy-out                # runs.ndjson, metrics.csv, <run>/ logs, verdict (compare/verdict.json)
 
 timeout_seconds: 600              # per run of the command; optional

package/examples/maestro-steps/e2e-community-and-live-chat.yaml

@@ -1,7 +1,7 @@
 # Gigaverse chat message lifecycle (send -> edit -> delete), with two declared KeepSnappy steps:
 #   chat.open  tap the chat button .. composer visible
 #   chat.send  tap send .. the sent message is visible
-# Copied from gigaverse-mobile-perflab/e2e/flows/chat/e2e-community-and-live-chat.yaml; only the paths to
+# Copied from gigaverse-mobile-keepsnappy/e2e/flows/chat/e2e-community-and-live-chat.yaml; only the paths to
 # the shared elements/scripts/subflows (sibling checkout) and the four step.yaml calls differ.
 # Run: see README.md in this folder.
 appId: com.gigaverse.appdev
@@ -30,20 +30,20 @@ appId: com.gigaverse.appdev
     label: Aborted — the login gate failed, no QA session
 - launchApp
 - runScript:
-    file: ../../../../../gigaverse-mobile-perflab/e2e/elements/home.js
+    file: ../../../../../gigaverse-mobile-keepsnappy/e2e/elements/home.js
 - runScript:
-    file: ../../../../../gigaverse-mobile-perflab/e2e/elements/community.js
+    file: ../../../../../gigaverse-mobile-keepsnappy/e2e/elements/community.js
 - runScript:
-    file: ../../../../../gigaverse-mobile-perflab/e2e/elements/community-chat.js
+    file: ../../../../../gigaverse-mobile-keepsnappy/e2e/elements/community-chat.js
 - runScript:
-    file: ../../../../../gigaverse-mobile-perflab/e2e/scripts/generate-test-values.js
+    file: ../../../../../gigaverse-mobile-keepsnappy/e2e/scripts/generate-test-values.js
 
-- runFlow: ../../../../../gigaverse-mobile-perflab/e2e/subflows/open-qa-community.yaml
+- runFlow: ../../../../../gigaverse-mobile-keepsnappy/e2e/subflows/open-qa-community.yaml
 
 # 1) Open the chat sheet. The chat button sits beside the destination bar,
 # not inside it — it is not one of the nav destinations.
 - runFlow:
-    file: ../../maestro/perflab/step.yaml
+    file: ../../maestro/keepsnappy/step.yaml
     env: { STEP: chat.open, PHASE: start }
 - tapOn:
     id: ${output.elements.communityChat.open}
@@ -52,7 +52,7 @@ appId: com.gigaverse.appdev
       id: ${output.elements.communityChat.composerInput}
     timeout: 30000
 - runFlow:
-    file: ../../maestro/perflab/step.yaml
+    file: ../../maestro/keepsnappy/step.yaml
     env: { STEP: chat.open, PHASE: end }
 
 # 2) Send a message. Every assertion below pins it by id + text rather than by
@@ -70,7 +70,7 @@ appId: com.gigaverse.appdev
       text: .*${output.testChatMessage}.*
     timeout: 10000
 - runFlow:
-    file: ../../maestro/perflab/step.yaml
+    file: ../../maestro/keepsnappy/step.yaml
     env: { STEP: chat.send, PHASE: start }
 - tapOn:
     id: ${output.elements.communityChat.send}
@@ -79,7 +79,7 @@ appId: com.gigaverse.appdev
       id: ${output.elements.communityChat.message}
     timeout: 20000
 - runFlow:
-    file: ../../maestro/perflab/step.yaml
+    file: ../../maestro/keepsnappy/step.yaml
     env: { STEP: chat.send, PHASE: end }
 - extendedWaitUntil:
     visible:

package/maestro/{perflab → keepsnappy}/send-markers.js

@@ -13,8 +13,7 @@
 try {
   var g = typeof globalThis !== 'undefined' ? globalThis : this;
   var pick = function (name, dflt) {
-    var modern = name.replace(/^PERFLAB_/, 'KEEPSNAPPY_');
-    var names = modern === name ? [name, 'MAESTRO_' + name] : [modern, 'MAESTRO_' + modern, name, 'MAESTRO_' + name];
+    var names = [name, 'MAESTRO_' + name];
     for (var i = 0; i < names.length; i++) {
       var v = g[names[i]];
       if (typeof v === 'string' && (v !== '' || names[i].indexOf('KEEPSNAPPY_') >= 0)) return v;
@@ -27,9 +26,9 @@ try {
   var RETRY_CAP_MS = 30000;
   var CLOCK_PROBES = 4;
   var out = typeof output !== 'undefined' && output ? output : {};
-  var list = out.perflabMarkers || [];
-  out.perflabMarkers = [];
-  var api = pick('PERFLAB_API_URL', typeof out.perflabApi === 'string' ? out.perflabApi : '').replace(/\/+$/, '');
+  var list = out.keepsnappyMarkers || [];
+  out.keepsnappyMarkers = [];
+  var api = pick('KEEPSNAPPY_API_URL', typeof out.keepsnappyApi === 'string' ? out.keepsnappyApi : '').replace(/\/+$/, '');
   var wait = function (ms) {
     try {
       java.lang.Thread.sleep(ms);

package/maestro/{perflab → keepsnappy}/step.js

@@ -1,18 +1,17 @@
 // Declared step marker. Runs on the Maestro HOST, so it never touches the device. ES5 only (older Maestro builds run
 // Rhino). Must not throw: a marker is never a test failure.
 // Inputs: STEP, PHASE (from step.yaml). t_host is taken now, when the action happens, whenever the marker is sent.
-// Farm mode (`perflab farm open`): the flow has set `output.perflabToken` (one run token per iteration, from the
-// generated tokens.js) and the API base comes from `output.perflabApi` or PERFLAB_API_URL. The marker is only recorded
+// Farm mode (`keepsnappy farm open`): the flow has set `output.keepsnappyToken` (one run token per iteration, from the
+// generated tokens.js) and the API base comes from `output.keepsnappyApi` or KEEPSNAPPY_API_URL. The marker is only recorded
 // in the flow's memory; send-markers.js (end-run.yaml) posts the iteration's markers to <api>/v1/markers after it
 // ended, so the test never waits on the network between actions.
-// Local mode (`perflab run` / `measure`): PERFLAB_MARKER_URL, PERFLAB_RUN_ID point at the CLI's own endpoint on this
+// Local mode (`keepsnappy run` / `measure`): KEEPSNAPPY_MARKER_URL, KEEPSNAPPY_RUN_ID point at the CLI's own endpoint on this
 // host, posted at once (local flows have no end-run step). Maestro only forwards host env vars with the MAESTRO_ prefix,
 // unprefixed, so both spellings are read (docs/research/28).
 try {
   var g = typeof globalThis !== 'undefined' ? globalThis : this;
   var pick = function (name, dflt) {
-    var modern = name.replace(/^PERFLAB_/, 'KEEPSNAPPY_');
-    var names = modern === name ? [name, 'MAESTRO_' + name] : [modern, 'MAESTRO_' + modern, name, 'MAESTRO_' + name];
+    var names = [name, 'MAESTRO_' + name];
     for (var i = 0; i < names.length; i++) {
       var v = g[names[i]];
       if (typeof v === 'string' && (v !== '' || names[i].indexOf('KEEPSNAPPY_') >= 0)) return v;
@@ -22,16 +21,16 @@ try {
   var out = typeof output !== 'undefined' && output ? output : {};
   var step = pick('STEP', '');
   var phase = pick('PHASE', '');
-  var token = typeof out.perflabToken === 'string' ? out.perflabToken : '';
-  var api = pick('PERFLAB_API_URL', typeof out.perflabApi === 'string' ? out.perflabApi : '');
+  var token = typeof out.keepsnappyToken === 'string' ? out.keepsnappyToken : '';
+  var api = pick('KEEPSNAPPY_API_URL', typeof out.keepsnappyApi === 'string' ? out.keepsnappyApi : '');
   if (token !== '' && api !== '') {
-    out.perflabMarkers = out.perflabMarkers || [];
-    out.perflabMarkers.push({ token: token, step: step, phase: phase, t_host: Date.now() });
+    out.keepsnappyMarkers = out.keepsnappyMarkers || [];
+    out.keepsnappyMarkers.push({ token: token, step: step, phase: phase, t_host: Date.now() });
   } else {
-    var base = pick('PERFLAB_MARKER_URL', 'http://127.0.0.1:47321');
+    var base = pick('KEEPSNAPPY_MARKER_URL', 'http://127.0.0.1:47321');
     http.post(base + '/marker', {
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ run: pick('PERFLAB_RUN_ID', ''), step: step, phase: phase, t_host: Date.now() }),
+      body: JSON.stringify({ run: pick('KEEPSNAPPY_RUN_ID', ''), step: step, phase: phase, t_host: Date.now() }),
     });
   }
 } catch (e) {

package/maestro/keepsnappy/step.yaml

@@ -0,0 +1,11 @@
+# KeepSnappy step marker. Call with env STEP (name) and PHASE (start|end):
+#   - runFlow: { file: keepsnappy/step.yaml, env: { STEP: chat.open, PHASE: start } }
+# Never fails the surrounding flow, even when no KeepSnappy CLI is listening. On the farm it only records the marker:
+# run send-markers.js at the end of each iteration (examples/farm/flows/keepsnappy/end-run.yaml).
+appId: any
+---
+- runScript:
+    file: step.js
+    env:
+      STEP: ${STEP}
+      PHASE: ${PHASE}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepsnappy/agent",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "description": "KeepSnappy CLI: runs your app journeys, measures from inside the app and reports More work / Less work / No change per step.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,8 +16,7 @@
     "node": ">=22"
   },
   "bin": {
-    "keepsnappy": "dist/keepsnappy.js",
-    "perflab": "dist/keepsnappy.js"
+    "keepsnappy": "dist/keepsnappy.js"
   },
   "files": [
     "dist",

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

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

package/examples/farm/flows/perflab/step-markers.yaml

@@ -1,13 +0,0 @@
-# Declared steps in farm mode (plan 36 M2, G4). Copy apps/agent/maestro/perflab/step.yaml and step.js next to this file
-# (e2e/flows/perflab/); send-markers.js is already here, the same file as maestro/perflab/send-markers.js. In farm mode
-# step.js only records the marker with the iteration's token (`output.perflabToken`, taken by begin-run.yaml); send-markers.js in end-run.yaml posts them to
-# <output.perflabApi>/v1/markers once the iteration ended, so the test never waits on the network between actions and
-# no CLI listens on the farm host. Without send-markers.js in end-run.yaml no farm marker is ever sent.
-# A journey that failed half-way drops out of the statistics because it never posted its set's completion marker and
-# `keepsnappy farm close` marks it invalid. Its step markers still reach KeepSnappy: run-perflab.yaml sends what is left from
-# onFlowComplete, for diagnosis. Inside the journey, around the part to measure:
-appId: com.gigaverse.appdev
----
-- runFlow: { file: ../perflab/step.yaml, env: { STEP: chat.open, PHASE: start } }
-- tapOn: { id: chat-open }
-- runFlow: { file: ../perflab/step.yaml, env: { STEP: chat.open, PHASE: end } }

package/examples/farm/flows/perflab/tokens.js

@@ -1,2 +0,0 @@
-// Replaced by `perflab farm open` for one upload. Never commit real tokens.
-output.perflabTokens = {};

package/examples/perflab.yml

@@ -1,36 +0,0 @@
-# perflab.yml: the only file you maintain for KeepSnappy. Run it with `keepsnappy run`.
-
-project:
-  key_env: KEEPSNAPPY_KEY            # NAME of the env var holding the project key (a CI secret), never the key itself
-  ingest_url: https://ingest.example.com   # optional; only used with `keepsnappy run --upload`
-
-app:
-  bundle_id: com.example.app      # the app under test; its perf-lab data is read from the device after every run
-
-platform: ios-sim                 # ios-sim | ios-device
-device: booted                    # simulator UDID or "booted"; required (UDID) for ios-device
-
-repetitions: 10                   # how many times the whole flow set runs
-baseline_branch: main             # the branch your baseline comes from (CI passes --baseline <its out dir>)
-
-flows:
-  runner: maestro                 # maestro: build `maestro test ...` from this file | command: run flows.command
-  maestro_version: 2.6.1          # note only: printed at the start, so a drifting Maestro is visible in logs
-  tags: [perf]                    # maestro --include-tags=perf
-  exclude_tags: [flaky]           # maestro --exclude-tags=flaky
-  paths:                          # files, directories or globs (*, ?, **); default "." when only tags are given
-    - e2e/flows/**/*.yaml
-    # - path: e2e/flows/chat/open.yaml  # one flow file with its dashboard title (else its `name:` / opening comment)
-    #   title: Open the chat
-    #   description: Community screen -> chat sheet, first message visible
-  # command: bun run e2e          # runner: command. Anything that exits 0 on success (Appium, Detox, ...)
-
-steps:
-  rename:                         # stable names in history; keys are window/step names as they appear in metrics.csv
-    "screen:(app)/community/[handle]/(tabs)": community.open
-  pin: [community.open]           # always listed in the summary, even without a change
-
-output:
-  dir: perflab-out                # runs.ndjson, metrics.csv, <run>/ logs, verdict (compare/verdict.json)
-
-timeout_seconds: 600              # per run of the command; optional

package/maestro/perflab/step.yaml

@@ -1,11 +0,0 @@
-# PerfLab step marker. Call with env STEP (name) and PHASE (start|end):
-#   - runFlow: { file: perflab/step.yaml, env: { STEP: chat.open, PHASE: start } }
-# Never fails the surrounding flow, even when no PerfLab CLI is listening. On the farm it only records the marker:
-# run send-markers.js at the end of each iteration (examples/farm/flows/perflab/end-run.yaml).
-appId: any
----
-- runScript:
-    file: step.js
-    env:
-      STEP: ${STEP}
-      PHASE: ${PHASE}