@wix/himalaya-cli 0.1443.0 → 0.1444.0

package/guides/qa-builds.md

@@ -327,6 +327,26 @@ It **fails open** throughout: an outage, a rate limit, a missing or revoked toke
 simply not being able to tell — all dispatch as before. Without `HIMI_DIST_GITHUB_TOKEN` the check
 is off entirely.
 
+### Telling a signing failure from a build failure — `failureCode`
+
+`error` is free text for a human; never parse it. A surface that shows a different message per kind
+reads `failureCode` on the job (`himi dist status`, `GET /v1/admin/dist/{jobId}`, the list):
+
+- **`signing`** — Himalaya could not mint an iOS identity the build needs: `/v1/dist/signing`
+  answered `apple_signing_failed` (for the app or an embedded bundle), or a customer signing fetch
+  failed. A *refused* `?embedded=` (a 4xx) does not count: the build continues without that bundle.
+- **absent** — any other failure, or none.
+
+It is written when the signing request is answered, so it lands while the job is still `WORKING`:
+read it only once `status` is `FAILURE`. A Job Service retry clears it once its app identity is
+minted, or when it ends `SUCCESS`. It misses a signing error raised on the Mac after the identity
+arrived (a keychain or profile install), which then reads as a plain failure.
+
+A build that throws after the build step — an S3 upload, say — reports `FAILURE` too, with
+`error: "dist failed: …"`. Before, the pool exited 0 having reported nothing, and the job ended
+`SUCCESS` with no artifact. When a failure report cannot be delivered at all, the job exits
+non-zero, so Job Service records the failure itself.
+
 ### Which commit the pool builds, and what off-repo gets
 
 Three sources, in order. The caller is absent from the list on purpose — a caller-chosen sha would

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1443.0",
+  "version": "0.1444.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": "8a70f3bc09b20693d0d5f9f3f9412dc5cdbd20ee62407d59ff646f7f"
+  "falconPackageHash": "2a5ac67ab4d6220139d0677bf644bedad760540b43889fe55394e090"
 }