@wix/himalaya-cli 0.990.0 → 0.992.0

package/dist/cli.mjs

@@ -18867,7 +18867,6 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
-    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -22292,7 +22291,6 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
-    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -54515,7 +54513,7 @@ var init_site_oauth_client = __esm({
 
 // src/cli.ts
 import { mkdtempSync as mkdtempSync4, readFileSync as readFileSync65, mkdirSync as mkdirSync25, writeFileSync as writeFileSync23, existsSync as existsSync54, rmSync as rmSync9, readdirSync as readdirSync25, statSync as statSync12, lstatSync as lstatSync6, accessSync, constants } from "node:fs";
-import { execFileSync as execFileSync7, spawnSync as spawnSync5 } from "node:child_process";
+import { execFileSync as execFileSync7, spawnSync as spawnSync5, spawn as spawn5 } from "node:child_process";
 import { createHash as createHash24, randomUUID as randomUUID3 } from "node:crypto";
 import { tmpdir as tmpdir5, homedir as homedir7, hostname } from "node:os";
 import { join as join51, resolve as resolve42, relative as relative8, basename as basename11, dirname as dirname30 } from "node:path";
@@ -58885,8 +58883,11 @@ async function fetchPackumentFrom(registry, fetchImpl, timeoutMs) {
   }
 }
 async function fetchCliPackument(fetchImpl = fetch, timeoutMs = DOCTOR_TIMEOUT_MS, env = process.env, scopedRegistry = npmScopedWixRegistry) {
+  const deadline = Date.now() + timeoutMs;
   for (const registry of registryCandidates(env, scopedRegistry())) {
-    const packument = await fetchPackumentFrom(registry, fetchImpl, timeoutMs);
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) break;
+    const packument = await fetchPackumentFrom(registry, fetchImpl, remaining);
     if (packument) return packument;
   }
   return void 0;
@@ -58926,7 +58927,7 @@ function resolvedSdkVersion(fromDir = process.cwd(), bundledManifest = new URL("
 }
 async function doctorVersionReport(running, fetchImpl = fetch, sdk = resolvedSdkVersion(), scopedRegistry = npmScopedWixRegistry) {
   const minimumSdk = "0.33.0";
-  const packument = await fetchCliPackument(fetchImpl, DOCTOR_TIMEOUT_MS, process.env, scopedRegistry);
+  const packument = await fetchCliPackument(fetchImpl, UPDATE_EXPLICIT_BUDGET_MS, process.env, scopedRegistry);
   const latest = packument?.latest;
   const publishedAt = packument?.time[running];
   const ageDays = ageInDays(publishedAt);
@@ -58958,6 +58959,10 @@ var CLI_PACKAGE = "@wix/himalaya-cli";
 var UNPUBLISHED_CLI_VERSION = "0.1.0";
 var UPDATE_MAX_AGE_DAYS = 7;
 var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var UPDATE_FOREGROUND_BUDGET_MS = 1500;
+var UPDATE_EXPLICIT_BUDGET_MS = 2e4;
+var UPDATE_BACKGROUND_BUDGET_MS = 6e4;
+var UPDATE_RETRY_AFTER_FAILURE_MS = 60 * 60 * 1e3;
 var UPDATE_SNOOZE_MS = 24 * 60 * 60 * 1e3;
 var UPDATE_REEXEC_ENV = "HIMI_UPDATED_ONCE";
 function updateCachePath(env = process.env) {
@@ -58981,7 +58986,7 @@ function writeUpdateCache(path, cache) {
 function updateCheckSuppression(running, command, env = process.env, cwd = process.cwd()) {
   if (env[UPDATE_REEXEC_ENV] === "1") return "already-updated";
   if (env.HIMI_NO_UPDATE_CHECK === "1") return "opted-out";
-  if (command === "upgrade" || command === "doctor") return "own-command";
+  if (command === "upgrade" || command === "doctor" || command === UPDATE_REFRESH_COMMAND) return "own-command";
   if (running === UNPUBLISHED_CLI_VERSION) return "unpublished";
   if (isHimalayaMonorepoCheckout(cwd)) return "monorepo";
   return void 0;
@@ -59015,12 +59020,12 @@ function npmInstallArgs(registry, version2) {
   return ["i", "-g", `${CLI_PACKAGE}@${version2}`, `--registry=${pinned}`, `--@wix:registry=${pinned}`];
 }
 var INSTALLABLE_SPEC = /^(?:latest|\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)$/;
-function createUpdateRunner(spawn5 = spawnSync5) {
+function createUpdateRunner(spawn6 = spawnSync5) {
   return {
     install: async (registry, version2) => {
       if (!isTrustedRegistry(registry)) return { ok: false, detail: `refusing untrusted registry ${registry}` };
       if (!INSTALLABLE_SPEC.test(version2)) return { ok: false, detail: `refusing install spec ${JSON.stringify(version2)}` };
-      const result = spawn5("npm", npmInstallArgs(registry, version2), {
+      const result = spawn6("npm", npmInstallArgs(registry, version2), {
         // npm's stdout goes to OUR stderr: in `himi <cmd> --json | jq` (and `himi upgrade --json`) its
         // "added 212 packages" would otherwise land in stdout ahead of the envelope and break the
         // parse — the agent case this whole feature exists for (#2985 review). And no stdin: an
@@ -59169,6 +59174,49 @@ function upgradeEnvelope(outcome) {
     ...outcome.detail ? { detail: outcome.detail } : {}
   };
 }
+var UPDATE_REFRESH_COMMAND = "__refresh-update-cache";
+async function refreshUpdateCache(opts = {}) {
+  const env = opts.env ?? process.env;
+  const running = opts.running ?? cliVersion();
+  const cachePath = opts.cachePath ?? updateCachePath(env);
+  const packument = await fetchCliPackument(opts.fetchImpl ?? fetch, UPDATE_BACKGROUND_BUDGET_MS, env, opts.scopedRegistry);
+  if (!packument) return false;
+  const now = opts.now ?? Date.now();
+  writeUpdateCache(cachePath, {
+    ...readUpdateCache(cachePath),
+    running,
+    latest: packument.latest,
+    runningPublishedAt: packument.time[running],
+    checkedAt: new Date(now).toISOString()
+  });
+  return true;
+}
+function createUpdateRefreshSpawner(spawnFn = spawn5, execArgv = process.execArgv) {
+  return () => {
+    try {
+      const child = spawnFn(process.execPath, [...loaderArgs(execArgv), fileURLToPath24(import.meta.url), UPDATE_REFRESH_COMMAND], {
+        detached: true,
+        stdio: "ignore",
+        cwd: homedir7(),
+        env: process.env
+      });
+      child.on("error", () => {
+      });
+      child.unref();
+    } catch {
+    }
+  };
+}
+function loaderArgs(execArgv) {
+  const out = [];
+  for (let i = 0; i < execArgv.length; i++) {
+    const arg = execArgv[i];
+    if (/^--(import|loader|experimental-loader|require)=/.test(arg)) out.push(arg);
+    else if (/^(--import|--loader|--experimental-loader|--require|-r)$/.test(arg) && i + 1 < execArgv.length) out.push(arg, execArgv[++i]);
+  }
+  return out;
+}
+var spawnUpdateRefresh = createUpdateRefreshSpawner();
 async function maybeSelfUpdate(argv, io, opts = {}) {
   const env = opts.env ?? process.env;
   const running = opts.running ?? cliVersion();
@@ -59186,14 +59234,19 @@ async function maybeSelfUpdate(argv, io, opts = {}) {
   if (!describesThisBuild) runningPublishedAt = void 0;
   let answeredBy;
   let answeredLatest;
-  if (!fresh) {
-    const packument = await fetchCliPackument(opts.fetchImpl ?? fetch, DOCTOR_TIMEOUT_MS, env, opts.scopedRegistry);
+  const attemptedAt = cache.attemptedAt ? Date.parse(cache.attemptedAt) : Number.NaN;
+  const recentlyTried = cache.attemptedFor === running && Number.isFinite(attemptedAt) && now - attemptedAt < UPDATE_RETRY_AFTER_FAILURE_MS;
+  if (!fresh && !recentlyTried) {
+    const packument = await fetchCliPackument(opts.fetchImpl ?? fetch, UPDATE_FOREGROUND_BUDGET_MS, env, opts.scopedRegistry);
     if (packument) {
       latest = packument.latest;
       runningPublishedAt = packument.time[running];
       answeredBy = packument.registry;
       answeredLatest = packument.latest;
       writeUpdateCache(cachePath, { ...cache, running, checkedAt: new Date(now).toISOString(), latest, runningPublishedAt });
+    } else {
+      writeUpdateCache(cachePath, { ...cache, attemptedAt: new Date(now).toISOString(), attemptedFor: running });
+      (opts.spawnRefresh ?? spawnUpdateRefresh)();
     }
   }
   const ageDays = ageInDays(runningPublishedAt, now);
@@ -59237,7 +59290,7 @@ async function maybeSelfUpdate(argv, io, opts = {}) {
   }
   try {
     if (!answeredBy) {
-      const again = await fetchCliPackument(opts.fetchImpl ?? fetch, DOCTOR_TIMEOUT_MS, env, opts.scopedRegistry);
+      const again = await fetchCliPackument(opts.fetchImpl ?? fetch, UPDATE_EXPLICIT_BUDGET_MS, env, opts.scopedRegistry);
       answeredBy = again?.registry;
       answeredLatest = again?.latest;
     }
@@ -64726,6 +64779,11 @@ ${label2}`);
         });
         return 0;
       }
+      case UPDATE_REFRESH_COMMAND: {
+        const up = deps.selfUpdate ?? {};
+        await refreshUpdateCache({ env: up.env, fetchImpl: up.fetchImpl, cachePath: up.cachePath, scopedRegistry: up.scopedRegistry, now: up.now, running: up.running });
+        return 0;
+      }
       case "upgrade": {
         const up = deps.selfUpdate ?? {};
         const runner2 = up.runner ?? defaultUpdateRunner;
@@ -64741,7 +64799,7 @@ ${label2}`);
         }
         try {
           const scoped = up.scopedRegistry ?? npmScopedWixRegistry;
-          const answered = await fetchCliPackument(up.fetchImpl ?? fetch, DOCTOR_TIMEOUT_MS, env, scoped);
+          const answered = await fetchCliPackument(up.fetchImpl ?? fetch, UPDATE_EXPLICIT_BUDGET_MS, env, scoped);
           const registry = answered?.registry ?? registryCandidates(env, scoped())[0];
           if (answered?.latest && compareVersions2(answered.latest, before) <= 0) {
             if (flags.json) print({ ok: true, running: before, installed: before, changed: false, registry, latest: answered.latest });
@@ -65228,6 +65286,10 @@ export {
   PREVIEW_TOKEN_NOTE,
   PUBLIC_NPM_REGISTRY,
   PUBLIC_WIX_API_BASE,
+  UPDATE_BACKGROUND_BUDGET_MS,
+  UPDATE_EXPLICIT_BUDGET_MS,
+  UPDATE_FOREGROUND_BUDGET_MS,
+  UPDATE_REFRESH_COMMAND,
   WIX_NPM_MIRROR,
   acquireUpdateLock,
   ageInDays,
@@ -65235,6 +65297,7 @@ export {
   buildDoctorReport,
   compareVersions2 as compareVersions,
   createScopedRegistryResolver,
+  createUpdateRefreshSpawner,
   createUpdateRunner,
   credentialKind,
   credentialSwapNotice,
@@ -65257,6 +65320,7 @@ export {
   isLoopbackBase,
   isPublicTarget,
   isTrustedRegistry,
+  loaderArgs,
   loginModeMark,
   loginModeReport,
   loopbackTargetWarning,
@@ -65286,6 +65350,7 @@ export {
   probeReachable,
   pushAuthHint,
   readUpdateCache,
+  refreshUpdateCache,
   registryCandidates,
   renderDataSource,
   renderDeviceWidths,
@@ -65297,6 +65362,7 @@ export {
   serveUnreachableHint,
   servesAll,
   shellShaDivergenceWarnings,
+  spawnUpdateRefresh,
   staleUpdateLockFile,
   switchFlagErrors,
   templatePreviewAuthError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.990.0",
+  "version": "0.992.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "c1544e612c2a8d6bbc008291e944d283faad2b1337d679a8e357ca69"
+  "falconPackageHash": "cbd96ed65b504cab0c2d276b2a961b73f9bf6730d07259f3d334a43e"
 }

package/templates/beauty-salon-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/community-club-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/events-meetups-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/gym-fitness-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/owner-lite/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/podcast-creator-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/portfolio-creative-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/restaurant-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/retail-store-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.
 

package/templates/yoga-studio-owner/tier5-src/_shared/aria-hot-path.ts

@@ -1,10 +1,10 @@
 // The Aria transcript's hot path — the rules it is written to, and the two
 // primitives that make them hold.
 //
-// Adapted from `native-apps/PERFORMANCE.md` in wix-private/aria-native-apps, which
+// Adapted from the performance guide of Aria's native app, which
 // states eleven rules, each "a class of shipped regression". Most of them govern
-// 30 Hz streaming, which this app does not do yet (#2612), and adopting all eleven
-// for a POLLED chat would be cargo-culting. These four apply now (#2623):
+// 30 Hz streaming, which this app does not do yet, and adopting all eleven
+// for a POLLED chat would be cargo-culting. These four apply now:
 //
 //  1. NEVER RE-DERIVE THE WHOLE TRANSCRIPT PER TICK. Every poll re-reads the full
 //     transcript, and turning a message into a bubble is the expensive step —
@@ -32,7 +32,7 @@
 //     a POSITION, and the moment anything before it is dropped (an empty
 //     placeholder, a hidden-only row, a windowed read) the same index names a
 //     different message. The bubble id is also the row's stable test id
-//     (`<screen>.msg_<id>`, invariant 27). `transcriptKeys`, `mintLocalId`.
+//     (`<screen>.msg_<id>`), which UI tests find it by. `transcriptKeys`, `mintLocalId`.
 //
 //  4. EVERY REPEATING CLOCK HAS AN OWNER AND STOPS ON EVERY EXIT PATH. The only
 //     clock here is the reply ladder, `_poll` id `aria-turn`, and its owner is
@@ -56,7 +56,7 @@
 // drivers) and the native app's device budgets (cold start, frame time, hangs)
 // are deliberately NOT adopted here: nothing in this repo measures them for
 // Aria, and a budget nobody measures is decoration. Each rule above is pinned by
-// a test instead — `core/dev-server/tests/aria-hot-path.test.ts`.
+// a test instead, one per rule, each asserting a count.
 //
 // Dependency-free on purpose: the tests import this file directly.