Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(profile-ui): explain handoff image rebuild semantics (R12-L2)

Josué416e4261378b
diff --git a/docs/how-to/desktop-setup-and-updates.md b/docs/how-to/desktop-setup-and-updates.md
index e1001fd74..3e1b7130c 100644
--- a/docs/how-to/desktop-setup-and-updates.md
+++ b/docs/how-to/desktop-setup-and-updates.md
@@ -68,9 +68,14 @@ exact active environment is retained.
The handoff is disabled by default. A release operator can enable it by setting
the `PROFILE_DESKTOP_HANDOFF_ENABLED` repository variable to `true` when
building Profile UI, after releasing the updated Desktop client and retiring
-older supported clients. While it is disabled, copy the REST API URL from
-Profile UI Settings and add it from Desktop's sign-in screen. Fleets can also
-be pre-seeded with a `CLERUM_DESKTOP_CONFIG_PATH` config file (see
+older supported clients. Changing the repository variable alone does not build
+a new image: the normal build runs only when Profile UI source paths change, or
+the **Build & Publish** workflow can be dispatched with `build_all=true` to
+rebuild every image. Production promotion reuses the digest built from dev, so
+rebuild Profile UI before promotion when the variable was the only change.
+While the handoff is disabled, copy the REST API URL from Profile UI Settings
+and add it from Desktop's sign-in screen. Fleets can also be pre-seeded with a
+`CLERUM_DESKTOP_CONFIG_PATH` config file (see
[Ship it to your users](../surfaces/desktop-app.md#ship-it-to-your-users)).
### 3. Through an invitation
diff --git a/profile-ui/README.md b/profile-ui/README.md
index c3cc17bff..298d65038 100644
--- a/profile-ui/README.md
+++ b/profile-ui/README.md
@@ -26,6 +26,12 @@ Desktop clients from ambiguous REST-only links. Enable it only after the updated
Desktop consumer is released and operators have verified that older supported
clients are no longer in use. Image builds can set the repository variable
`PROFILE_DESKTOP_HANDOFF_ENABLED=true`; unset or `false` keeps the handoff disabled.
+Changing this repository variable alone does not rebuild the Profile UI image.
+The normal **Build & Publish** workflow builds Profile UI only when its source
+paths change; dispatch that workflow with `build_all=true` to rebuild every
+image when the variable was the only change. Production promotion reuses the
+dev-built digest and does not rebuild, so create the desired digest before
+promoting it.
## Local
diff --git a/profile-ui/package-lock.json b/profile-ui/package-lock.json
index 99d30b777..aefee6c53 100644
--- a/profile-ui/package-lock.json
+++ b/profile-ui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-profile-ui",
- "version": "0.1.168",
+ "version": "0.1.169",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-profile-ui",
- "version": "0.1.168",
+ "version": "0.1.169",
"dependencies": {
"@clerum/desktop-app-links": "file:../packages/desktop-app-links",
"@clerum/frontend-components": "file:../packages/frontend-components",
diff --git a/profile-ui/package.json b/profile-ui/package.json
index 0556dd854..e82a27e47 100644
--- a/profile-ui/package.json
+++ b/profile-ui/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-profile-ui",
- "version": "0.1.168",
+ "version": "0.1.169",
"private": true,
"scripts": {
"dev": "next dev",