@wix/himalaya-cli 0.1555.0 → 0.1557.0

package/guides/himi-json-output.md

@@ -251,6 +251,11 @@ redirects, invalid data, source changes and disk errors remain failures.
 - `invalid_output_path`: unsafe name, symlinked ancestor or inaccessible output parent
   (exit 2). Use the real directory path rather than a symlink.
 - `output_exists`: destination already exists; choose a new name or parent (exit 2).
+- `cli_update_required`: the installed CLI is older than the latest published version
+  (exit 1, stage `checking-cli-version`). Update before retrying; no workspace, authentication
+  or source collection has started.
+- `cli_version_unverified`: the latest or installed version could not be verified
+  (exit 1, stage `checking-cli-version`). Restore registry access and retry before collection.
 - `auth_unavailable`: a user-scoped Wix token could not be obtained (exit 1).
   `WIX_API_KEY` is not used by this workflow.
 - `source_unauthorized` / `source_forbidden`: source rejected the identity or access

package/guides/one-app-to-himi-app.md

@@ -18,6 +18,13 @@ himi one-app migrate --msid <one-app-meta-site-id> \
   --target bo --json
 ```
 
+Before collection, an installed CLI checks the latest published version afresh. An older
+version stops with `cli_update_required`: update with `npm i -g @wix/himalaya-cli@latest`
+and retry. If registry access cannot establish a version, `cli_version_unverified` asks
+you to retry; no workspace or source request has been created. This is stricter than the
+normal self-updater's build-age policy, because a fresh migration needs the current template
+features. Source checkouts and existing explicit version-check opt-outs keep their behavior.
+
 - `--msid` is required. It is the source MetaSite ID, not Structure's document ID.
 - `--app-instance` accepts `branded` or `free`; default is `branded`. Branded falls
   back to free only when no Branded configuration exists. Authorization, malformed

package/guides/trim-a-template.md

@@ -114,10 +114,18 @@ should keep working.
 It **refuses** (exit `2`, nothing written) when `--keep` is missing or names an id the app does
 not serve (the report lists the ones it does), when the app's `dev/index.ts` or `config.ts` is
 no longer in the shape `himi init` writes (a block, the `navigation` object or
-`workerSubtreeScreens` that is not plain JSON), when kept screens link to removed ones and no `--links` was given, when no tab would be
+`workerSubtreeScreens` that is not JSON data), when kept screens link to removed ones and no `--links` was given, when no tab would be
 left, and when dropping links would leave a kept screen empty or cannot reach a link. Then trim
 by hand, below.
 
+The `navigation` object and `workerSubtreeScreens` array in `config.ts` may contain
+`//` or `/* … */` comments. Read-only template commands preserve their
+source bytes. Commands that rewrite navigation, including trim and `template screens --add`,
+re-emit that block as JSON, removing comments inside it.
+Property names and strings must remain double-quoted; computed values, spreads and function
+calls are refused rather than evaluated. This also keeps migrated navigation readable by
+`himi template screens`, `himi template inspect` and `himi template trim` after an agent adds notes.
+
 Afterwards: `himi render <each kept screen>`, then `himi test`.
 
 ## How to trim by hand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1555.0",
+  "version": "0.1557.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": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "e307bc39941a4361847922e798725eec91eaa76e98753612e7133ca1"
+  "falconPackageHash": "af9ec3d733e930df474d226a826345b720afccbb9190afc75704ab57"
 }