@wix/himalaya-cli 0.996.0 → 0.998.0

package/guides/component-reference.md

@@ -2465,7 +2465,7 @@ The verb decides what happens to the navigation stack. Where there is a target s
 | `presentation` | Effect |
 |---|---|
 | `push` | Open `screenId` on top of the current screen; Back returns to where you were. The default. |
-| `replace` | Open `screenId` without keeping the current screen to go Back to. |
+| `replace` | Open `screenId` without keeping the current screen to go Back to. The hosts differ on what Back does next: on iOS and Android the ACTIVE stack is reset to its root before `screenId` is pushed (the open sheet's or cover's own stack when one is up, otherwise the current tab's or the app's single stack), so Back returns to that root and, inside a modal, a further Back closes the modal; on web only the top screen of the current tab is swapped, so Back returns to the screen that was beneath it. |
 | `back` | Pop the current screen (nothing happens at a stack root). On iOS and Android, inside a sheet or cover it pops the modal's own stack first and closes the modal at its root; on web it pops the tab's stack, so close a modal with `dismiss`. |
 | `dismiss` | Close the presented sheet or full-screen cover (on web, an open alert too). Nothing happens when no modal is up. |
 | `sheet` | Present `screenId` as a sheet over the current screen. One at a time: presenting another replaces it. |

package/guides/headless-loop.md

@@ -198,6 +198,16 @@ with `himi ux record --content . --platform ios|android --status passed|failed|u
 actually drove; an unavailable platform drove nothing, so it takes no checks and needs its reason
 recorded, not guessed.
 
+**Record last, right before you push.** A UX record is bound to the exact release content it was
+taken against, and `himi push` refuses a draft whose record describes different content — so
+any edit after recording (a screen, a token, a worker) means recording again. And that only works
+if the build is reproducible: **a worker's initial state must be deterministic.** The build boots
+each worker and hashes its initial state into the release, so a `defineService` state computed
+from `Date.now()`, `new Date()` or `Math.random()` makes every build of unchanged source a
+different release, and no record can ever match the push. `himi validate` warns about it
+(`initial-state`, naming the worker and service); fix it by computing those values in an action
+— for example one the screen's `onAppear` dispatches — instead of in the initial state.
+
 Report v2 sharpens all of it: a worker throw carries `in tier5-src/<screen>/index.ts:<line>`
 (mapped through the bundle's sourcemap — fix it without grepping), the ledger lists worker
 functions **no axis ever executed** with their source lines (usually the error branch you

package/guides/mobile-ux.md

@@ -137,6 +137,15 @@ driving a native shell, record the result—not an assumption—with `himi ux re
 is required for `passed`/`failed` and names what you actually drove; an unavailable platform drove
 nothing, so it takes no checks and needs a `--reason` instead.
 
+Record last, immediately before `himi push`. The record is bound to the exact release content it
+was taken against, and the push refuses a draft whose record describes different content, so any
+edit after recording means recording again. That only works when the build is reproducible, so
+**a worker's boot-time initial state must be deterministic**: the build hashes each worker's
+initial state into the release, and a `defineService` state computed from `Date.now()`,
+`new Date()` or `Math.random()` makes every build of unchanged source a different release that no
+record can match. `himi validate` names such a worker as an `initial-state` warning. Compute those
+values in an action (for example one the screen's `onAppear` dispatches) instead.
+
 `himi render --width`/`--device` writes into the same `.himi/ux-audit.json`, appending the width it
 rendered. That is what the width marker below reads first, so rendering the screen at two widths is
 itself the evidence — see the strict audit contract.

package/guides/testing-himi-apps.md

@@ -589,9 +589,13 @@ You get a **new** visitor, who cannot see the old one's records, when:
 - renewing the stored visitor fails, so the browser starts a fresh one;
 - the app's `clientId` changes.
 
-One path is **not** stable at all. When the browser cannot reach Wix itself — its visitor mint
-or a request fails, after which the rest of that page load stays on the fallback — or a call
-carries its own headers or an absolute URL, the call goes through the preview server instead.
+One path is **not** stable at all: the call goes through the preview server instead. That
+happens when the browser cannot reach Wix itself (its visitor mint or a request fails, after
+which the rest of that page load stays on the fallback); when the preview's identity check
+fails or takes longer than 4 seconds, which sends calls through the server until 5 seconds
+after that check started; when the server has switched browser-direct calls off; and for a call that carries its
+own headers or an absolute URL. A write made in one of those windows can be missing when you
+read it back as the browser's own visitor.
 That server uses one anonymous visitor per server instance, **shared** by everyone it serves and
 replaced when its token expires. A signed-in member is a separate identity (the member session)
 and is not affected by any of this.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.996.0",
+  "version": "0.998.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": "302697b73846010a0fe1e425721e1e74e406e07054033a4bcc1f89cf"
+  "falconPackageHash": "5ebc9c2a8de3fd169d9b17811f10f0d83ae07430d18ea0c242214539"
 }