npm - cicy-desktop - Versions diffs - 2.1.205 → 2.1.207 - Mend

cicy-desktop 2.1.205 → 2.1.207

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/package.json +6 -6
package/src/app-updater.js +27 -1
package/src/backends/homepage-preload.js +3 -0
package/src/backends/homepage-react/assets/index-D_1u1626.js +377 -0
package/src/backends/homepage-react/index.html +1 -1
package/src/backends/sidecar-ipc.js +62 -2
package/src/i18n/locales/en.json +36 -2
package/src/i18n/locales/fr.json +36 -2
package/src/i18n/locales/ja.json +36 -2
package/src/i18n/locales/zh-CN.json +36 -2
package/src/sidecar/container-scripts/cicy-code-update.sh +104 -0
package/src/sidecar/wsl-docker.js +215 -22
package/workers/render/src/App.jsx +140 -9
package/src/backends/homepage-react/assets/index-Bf9kuVZb.js +0 -377

package/src/backends/homepage-react/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
   <link rel="icon" type="image/svg+xml" href="./favicon.svg" />
   <link rel="icon" type="image/png" sizes="256x256" href="./favicon-256.png" />
   <title>CiCy Desktop</title>
-  <script type="module" crossorigin src="./assets/index-Bf9kuVZb.js"></script>
+  <script type="module" crossorigin src="./assets/index-D_1u1626.js"></script>
   <link rel="stylesheet" crossorigin href="./assets/index-C6Zrdgc0.css">
 </head>
 <body>

package/src/backends/sidecar-ipc.js CHANGED Viewed

@@ -49,6 +49,26 @@ const APP_PORT = Number(process.env.CICY_DOCKER_APP_PORT || 8008);
 // (含 port)区分。
 const APP_CONTAINER = process.env.CICY_DOCKER_APP_CONTAINER || `cicy-code-docker-${APP_PORT}`;
 const APP_VOLUME = process.env.CICY_DOCKER_APP_VOLUME || `cicy-team-${APP_PORT}`;
+// 用户自定义的额外发布端口(除 :8008 外,给容器内 agent 服务从 Windows 直达用)。
+// 持久化在 userData/docker-ports.json,bootstrap/recreate 都会带上 -p。lazy 取
+// 路径(app 未 ready 时不取)。
+function portsFile() { return path.join(require("electron").app.getPath("userData"), "docker-ports.json"); }
+function sanitizePorts(arr) {
+  const out = [], seen = new Set([APP_PORT, 8008]);
+  for (const raw of Array.isArray(arr) ? arr : []) {
+    const p = Number(raw);
+    if (!Number.isInteger(p) || p < 1 || p > 65535 || seen.has(p)) continue;
+    seen.add(p); out.push(p);
+  }
+  return out;
+}
+function readExtraPorts() {
+  try { const j = JSON.parse(fs.readFileSync(portsFile(), "utf8")); return sanitizePorts(j && j.ports); } catch { return []; }
+}
+function writeExtraPorts(ports) {
+  try { fs.writeFileSync(portsFile(), JSON.stringify({ ports: sanitizePorts(ports) }, null, 2), "utf8"); } catch (e) { log.warn("[docker-ports] write failed:", e.message); }
+}
 const APP_MOUNT = process.env.CICY_DOCKER_APP_MOUNT || "/home/cicy";
 // :8008 docker 的网关 endpoint。key 不再从 :8008 借(native 已退役)—— 容器只用它
 // 自己独立云端 team 的 key(见 ensureDockerTeam / appOpts)。
@@ -115,7 +135,7 @@ function register({ sidecarLogPath } = {}) {
       if (s.running) { try { ver = await require("../sidecar/version").running(APP_PORT); } catch {} }
       // installed: distro 装了 OR :8008 健康(WSL 抽风查不到 distro 但容器在跑 → 也算装了,
       // 否则卡片误显「下载安装」)。wslUnmanaged: 服务在跑但 WSL 管不到 → 卡片显式提示异常。
-      _dockerStatusCache = { installed: !!s.distro || !!s.healthy, dockerRunning: !!s.engineUp || !!s.healthy, running: !!s.running, unknown: !!s.unknown, wslUnmanaged: !!s.wslUnmanaged, version: ver, port: APP_PORT, platform: process.platform, chromeProxy: chromeProxyEnabled(), chromeProxyRunning: hostMihomo.running(), ts: Date.now() };
+      _dockerStatusCache = { installed: !!s.distro || !!s.healthy, dockerRunning: !!s.engineUp || !!s.healthy, running: !!s.running, unknown: !!s.unknown, wslUnmanaged: !!s.wslUnmanaged, wslWedged: !!s.wslWedged, version: ver, port: APP_PORT, platform: process.platform, chromeProxy: chromeProxyEnabled(), chromeProxyRunning: hostMihomo.running(), ts: Date.now() };
     } catch (e) {
       _dockerStatusCache = { installed: false, dockerRunning: false, running: false, unknown: true, port: APP_PORT, platform: process.platform, error: e.message, ts: Date.now() };
     }
@@ -263,7 +283,7 @@ function register({ sidecarLogPath } = {}) {
     await ensureDockerTeam().catch(() => {});
     const env = { CICY_AI_GATEWAY_LLM_ENDPOINT: GATEWAY_ENDPOINT };
     if (dockerTeamReg && dockerTeamReg.apiKey) env.CICY_AI_GATEWAY_LLM_API_KEY = dockerTeamReg.apiKey;
-    return { port: APP_PORT, container: APP_CONTAINER, volume: APP_VOLUME, env };
+    return { port: APP_PORT, container: APP_CONTAINER, volume: APP_VOLUME, env, extraPorts: readExtraPorts() };
   };
   // Register the running :8008 instance as a (custom) team so the card's "打开"
   // reuses the token-injected open/reload flow. addTeam dedups by host:port.
@@ -383,6 +403,24 @@ function register({ sidecarLogPath } = {}) {
     }
   });
+  // 「修复 WSL」: WSL 卡死(wslWedged)时用户一键自救。先试重启 LxssManager;若还卡死(深度
+  // 死锁,杀不动)→ 返回 needsReboot,渲染层提示重启电脑(重启后启动 bootstrap 会自动重置坏
+  // distro + 重新导入)。服务恢复了就顺手跑一遍 bootstrap 自愈。
+  ipcMain.handle("docker:app-repair-wsl", async (e) => {
+    if (!APP_DOCKER_SUPPORTED) return { ok: false, error: "仅 Windows" };
+    const emit = (ev) => { try { e.sender.send("docker:app-progress", ev); } catch {} };
+    try {
+      const r = await appDocker.repairWsl({ emit });
+      if (r && r.ok) {
+        try { await ensureDockerTeam(); await appDocker.bootstrap({ ...(await appOpts()), onProgress: emit }); } catch (err) { log.warn(`[repair-wsl] bootstrap after repair: ${err.message}`); }
+        try { await registerAppTeam(); } catch {}
+        try { await maybeStartChromeProxy(); } catch {}
+      }
+      await refreshDockerStatus().catch(() => {});
+      return r;
+    } catch (err) { return { ok: false, error: err.message }; }
+  });
   // ⋯ menu → 重启 cicy-code (supervisorctl restart cicy-code; daemons stay up).
   ipcMain.handle("docker:app-restart", async () => {
     try { const ok = await appDocker.restart({ container: APP_CONTAINER, port: APP_PORT, volume: APP_VOLUME }); return { ok: !!ok }; }
@@ -457,6 +495,28 @@ function register({ sidecarLogPath } = {}) {
     }
   });
+  // 端口设置:读当前已发布的额外端口(:8008 固定,不在列)。
+  ipcMain.handle("docker:get-ports", () => {
+    return { ok: true, mainPort: APP_PORT, ports: readExtraPorts() };
+  });
+  // 保存端口 → 持久化 → recreate 容器带上新的 -p(:8008 + 各额外端口)。volume 保留。
+  ipcMain.handle("docker:set-ports", async (e, input) => {
+    if (!APP_DOCKER_SUPPORTED) return { ok: false, error: "Docker cicy-code 仅支持 Windows" };
+    const ports = sanitizePorts(input && input.ports);
+    writeExtraPorts(ports);
+    try {
+      await ensureDockerTeam();
+      const result = await appDocker.recreate({
+        ...(await appOpts()), // 已含 extraPorts: readExtraPorts()(刚写入的)
+        onProgress: (ev) => { try { e.sender.send("docker:app-progress", ev); } catch {} },
+      });
+      await registerAppTeam();
+      return { ok: true, ports, result };
+    } catch (err) {
+      return { ok: false, error: err.message };
+    }
+  });
   // Start (or reuse) the cicy-code daemon. probeExisting inside start() reuses
   // a healthy :8008; otherwise it spawns `npx cicy-code` / the Docker container.
   ipcMain.handle("sidecar:start", async (e) => {

package/src/i18n/locales/en.json CHANGED Viewed

@@ -213,7 +213,40 @@
     "repairWsl": "Repair WSL",
     "wslBrokenRepair": "WSL unmanaged · click Repair WSL to reinstall",
     "openWslDir": "Open WSL folder",
-    "openProjectsDir": "Open projects folder"
+    "openProjectsDir": "Open projects folder",
+    "wslWedged": "WSL frozen · click Repair WSL",
+    "wslNeedReboot": "WSL service is stuck — please RESTART Windows; CiCy auto-repairs on next launch (old data is renamed/kept, not deleted).",
+    "wslRepaired": "WSL repaired",
+    "repairFailed": "Repair failed",
+    "updating": {
+      "checking": "Checking cicy-code version…",
+      "alreadyLatest": "Already up to date — v{{v}} ✅",
+      "toVersion": "Updating cicy-code → v{{v}}…",
+      "pulling": "Updating cicy-code (pulling latest)…",
+      "doneVersion": "cicy-code updated to v{{v}} 🎉",
+      "doneLatest": "cicy-code updated to latest 🎉",
+      "notReady": "Updated, but :8008 isn't responding yet — wait a moment or retry",
+      "failed": "Update failed: {{msg}} (this image may not support it; try Upgrade to reinstall)",
+      "hostResolveFail": "Host version lookup failed; resolving inside container…",
+      "scriptReady": "In-container update script refreshed (fast)",
+      "scriptPushFail": "Failed to push update script; using baked one",
+      "starting": "Starting cicy-code service…"
+    },
+    "ports": {
+      "menu": "Port settings",
+      "title": "Port settings",
+      "sub": "Extra ports (besides :8008) published so Windows can reach in-container services",
+      "mainFixed": ":8008 · cicy-code (fixed)",
+      "add": "+ Add port",
+      "ph": "Port 1-65535",
+      "save": "Save & rebuild",
+      "saving": "Saving…",
+      "cancel": "Cancel",
+      "hint": "Saving rebuilds the container (volume data kept) with a brief interruption",
+      "invalid": "Invalid port (1-65535, not 8008, no duplicates)",
+      "none": "No extra ports",
+      "remove": "Remove"
+    }
   },
   "common": {
     "close": "Close",
@@ -466,7 +499,8 @@
     "opening": "Opening {{url}} …",
     "opened": "Opened",
     "hintOpenFailed": "Got the token but failed to open the window: {{err}}",
-    "hintException": "Open failed with an exception: {{err}}"
+    "hintException": "Open failed with an exception: {{err}}",
+    "engineStartingNoReset": "Docker engine not running, starting it (without resetting WSL)…"
   },
   "dockerBadge": {
     "install-docker": "Prep",

package/src/i18n/locales/fr.json CHANGED Viewed

@@ -213,7 +213,40 @@
     "repairWsl": "Réparer WSL",
     "wslBrokenRepair": "WSL non géré · cliquez Réparer WSL pour réinstaller",
     "openWslDir": "Ouvrir le dossier WSL",
-    "openProjectsDir": "Ouvrir le dossier projets"
+    "openProjectsDir": "Ouvrir le dossier projets",
+    "wslWedged": "WSL bloqué · cliquez Réparer WSL",
+    "wslNeedReboot": "Service WSL bloqué — REDÉMARREZ Windows ; réparation auto au prochain lancement (anciennes données renommées/conservées).",
+    "wslRepaired": "WSL réparé",
+    "repairFailed": "Échec de la réparation",
+    "updating": {
+      "checking": "Vérification de la version de cicy-code…",
+      "alreadyLatest": "Déjà à jour — v{{v}} ✅",
+      "toVersion": "Mise à jour de cicy-code → v{{v}}…",
+      "pulling": "Mise à jour de cicy-code (récupération de la dernière version)…",
+      "doneVersion": "cicy-code mis à jour vers v{{v}} 🎉",
+      "doneLatest": "cicy-code mis à jour vers la dernière version 🎉",
+      "notReady": "Mis à jour, mais :8008 ne répond pas encore — patientez ou réessayez",
+      "failed": "Échec de la mise à jour : {{msg}} (cette image peut ne pas le prendre en charge ; essayez « Mettre à niveau » pour réinstaller)",
+      "hostResolveFail": "Échec de la résolution de version côté hôte ; résolution dans le conteneur…",
+      "scriptReady": "Script de mise à jour du conteneur actualisé (rapide)",
+      "scriptPushFail": "Échec de l'envoi du script ; utilisation de la version intégrée",
+      "starting": "Démarrage du service cicy-code…"
+    },
+    "ports": {
+      "menu": "Réglage des ports",
+      "title": "Réglage des ports",
+      "sub": "Ports supplémentaires (hors :8008) publiés pour que Windows atteigne les services du conteneur",
+      "mainFixed": ":8008 · cicy-code (fixe)",
+      "add": "+ Ajouter un port",
+      "ph": "Port 1-65535",
+      "save": "Enregistrer et reconstruire",
+      "saving": "Enregistrement…",
+      "cancel": "Annuler",
+      "hint": "L'enregistrement reconstruit le conteneur (données du volume conservées), brève interruption",
+      "invalid": "Port invalide (1-65535, pas 8008, sans doublon)",
+      "none": "Aucun port supplémentaire",
+      "remove": "Retirer"
+    }
   },
   "common": {
     "close": "Close",
@@ -466,7 +499,8 @@
     "opening": "Ouverture de {{url}} …",
     "opened": "Ouvert",
     "hintOpenFailed": "Token obtenu mais échec d'ouverture de la fenêtre : {{err}}",
-    "hintException": "Exception lors de l'ouverture : {{err}}"
+    "hintException": "Exception lors de l'ouverture : {{err}}",
+    "engineStartingNoReset": "Moteur Docker non démarré, démarrage (sans réinitialiser WSL)…"
   },
   "dockerBadge": {
     "install-docker": "Prép.",

package/src/i18n/locales/ja.json CHANGED Viewed

@@ -213,7 +213,40 @@
     "repairWsl": "WSL を修復",
     "wslBrokenRepair": "WSL 管理異常 · 「WSL を修復」で再インストール",
     "openWslDir": "WSL フォルダを開く",
-    "openProjectsDir": "プロジェクトフォルダを開く"
+    "openProjectsDir": "プロジェクトフォルダを開く",
+    "wslWedged": "WSL フリーズ · 「WSL を修復」をクリック",
+    "wslNeedReboot": "WSL サービスが停止不能です — Windows を再起動してください。次回起動時に自動修復します(旧データは改名保存、削除しません)。",
+    "wslRepaired": "WSL を修復しました",
+    "repairFailed": "修復に失敗",
+    "updating": {
+      "checking": "cicy-code のバージョンを確認中…",
+      "alreadyLatest": "すでに最新です — v{{v}} ✅",
+      "toVersion": "cicy-code を更新中 → v{{v}}…",
+      "pulling": "cicy-code を更新中（最新版を取得）…",
+      "doneVersion": "cicy-code を v{{v}} に更新しました 🎉",
+      "doneLatest": "cicy-code を最新版に更新しました 🎉",
+      "notReady": "更新しましたが :8008 がまだ応答しません — 少し待つか再試行してください",
+      "failed": "更新に失敗：{{msg}}（このイメージは未対応の可能性。「アップグレード」で再インストールを）",
+      "hostResolveFail": "ホストでのバージョン解決に失敗。コンテナ内で解決します…",
+      "scriptReady": "コンテナ内の更新スクリプトを更新(高速版)",
+      "scriptPushFail": "更新スクリプトの送信に失敗。内蔵版を使用します",
+      "starting": "cicy-code サービスを起動中…"
+    },
+    "ports": {
+      "menu": "ポート設定",
+      "title": "ポート設定",
+      "sub": ":8008 以外に公開し、Windows からコンテナ内サービスへ直接到達できるポート",
+      "mainFixed": ":8008 · cicy-code(固定)",
+      "add": "+ ポートを追加",
+      "ph": "ポート 1-65535",
+      "save": "保存して再構築",
+      "saving": "保存中…",
+      "cancel": "キャンセル",
+      "hint": "保存するとコンテナを再構築します(ボリュームのデータは保持、短時間中断)",
+      "invalid": "無効なポート(1-65535、8008 不可、重複不可)",
+      "none": "追加ポートなし",
+      "remove": "削除"
+    }
   },
   "common": {
     "close": "Close",
@@ -466,7 +499,8 @@
     "opening": "{{url}} を開いています…",
     "opened": "開きました",
     "hintOpenFailed": "token は取得しましたがウィンドウを開けませんでした:{{err}}",
-    "hintException": "オープン中に例外:{{err}}"
+    "hintException": "オープン中に例外:{{err}}",
+    "engineStartingNoReset": "Docker エンジン未起動、起動します(WSL はリセットしません)…"
   },
   "dockerBadge": {
     "install-docker": "準備",

package/src/i18n/locales/zh-CN.json CHANGED Viewed

@@ -213,7 +213,40 @@
     "repairWsl": "修复 WSL",
     "wslBrokenRepair": "WSL 管理异常 · 点「修复 WSL」重装",
     "openWslDir": "打开 WSL 目录",
-    "openProjectsDir": "打开项目目录"
+    "openProjectsDir": "打开项目目录",
+    "wslWedged": "WSL 卡死 · 点「修复 WSL」",
+    "wslNeedReboot": "WSL 服务卡死,请【重启 Windows】;重启后打开 CiCy 会自动修复(旧数据已改名备份,不删)。",
+    "wslRepaired": "WSL 已修复",
+    "repairFailed": "修复失败",
+    "updating": {
+      "checking": "检查 cicy-code 版本…",
+      "alreadyLatest": "已是最新版 v{{v}} ✅",
+      "toVersion": "更新 cicy-code → v{{v}}…",
+      "pulling": "更新 cicy-code（拉取最新版）…",
+      "doneVersion": "cicy-code 已更新到 v{{v}} 🎉",
+      "doneLatest": "cicy-code 已更新到最新 🎉",
+      "notReady": "更新了但 :8008 还没响应——稍等或点重试",
+      "failed": "更新失败：{{msg}}（此镜像可能不支持，试试「升级」重装）",
+      "hostResolveFail": "宿主机解析版本失败,改由容器内解析…",
+      "scriptReady": "已更新容器内更新脚本(快速版)",
+      "scriptPushFail": "推送更新脚本失败,改用镜像内置脚本",
+      "starting": "启动 cicy-code 服务…"
+    },
+    "ports": {
+      "menu": "端口设置",
+      "title": "端口设置",
+      "sub": "除 :8008 外,额外发布、可从 Windows 直达容器内服务的端口",
+      "mainFixed": ":8008 · cicy-code(固定)",
+      "add": "+ 添加端口",
+      "ph": "端口号 1-65535",
+      "save": "保存并重建",
+      "saving": "保存中…",
+      "cancel": "取消",
+      "hint": "保存会重建容器(volume 数据保留),会有短暂中断",
+      "invalid": "有端口无效(1-65535,不能是 8008,不能重复)",
+      "none": "暂无额外端口",
+      "remove": "移除"
+    }
   },
   "common": {
     "close": "关闭",
@@ -466,7 +499,8 @@
     "opening": "打开 {{url}} …",
     "opened": "已打开",
     "hintOpenFailed": "拿到 token 但打开窗口失败:{{err}}",
-    "hintException": "打开过程异常:{{err}}"
+    "hintException": "打开过程异常:{{err}}",
+    "engineStartingNoReset": "Docker 引擎未运行,正在启动(不重置 WSL)…"
   },
   "dockerBadge": {
     "install-docker": "准备",

package/src/sidecar/container-scripts/cicy-code-update.sh ADDED Viewed

@@ -0,0 +1,104 @@
+#!/bin/bash
+# Vendored copy pushed INTO the running container by cicy-desktop at update time
+# (see wsl-docker.js update()), then executed. This is the authoritative script
+# for the "更新 cicy-code" flow: shipping a fix here rides cicy-desktop's own
+# auto-update (OSS, reaches Windows) — NO new container image / pull required,
+# which is why we cp-then-run instead of relying on the baked image copy.
+#
+# Hot-update cicy-code WITHOUT bouncing the container, the cloudflared tunnel,
+# or any user daemons: install the new version side-by-side, repoint one symlink,
+# restart only the supervisor program.
+#
+#   cicy-code-update            # → latest
+#   cicy-code-update 2.3.16     # → a pinned version
+set -euo pipefail
+HOME_DIR="${HOME:-/home/cicy}"
+# Registry selection: honor an explicit NPM_REGISTRY (cicy-desktop injects it via
+# `docker exec -e` per host network) — otherwise probe registry.npmjs.org with a
+# short timeout: reachable fast → official npm (best overseas); slow/blocked →
+# registry.npmmirror.com (CN mirror, the safe default).
+NPM_OFFICIAL="https://registry.npmjs.org"
+NPM_CN="https://registry.npmmirror.com"
+pick_registry() {
+  if [ -n "${NPM_REGISTRY:-}" ]; then echo "$NPM_REGISTRY"; return; fi
+  if curl -fsS -m 3 --connect-timeout 3 -o /dev/null "$NPM_OFFICIAL/cicy-code"; then
+    echo "$NPM_OFFICIAL"
+  else
+    echo "$NPM_CN"
+  fi
+}
+REG="$(pick_registry)"
+RT="$HOME_DIR/cicy-ai/runtime/cicy-code"
+LINK="$HOME_DIR/.local/bin/cicy-code"
+VERSIONS="$HOME_DIR/cicy-ai/runtime/versions.json"
+SVCTL="supervisorctl -c /etc/supervisor/supervisord.conf"
+want="${1:-latest}"
+log() { printf '[cicy-code-update] %s\n' "$*"; }
+log "registry: $REG"
+# Resolve the concrete version number (so the install dir is version-named and
+# re-runs are idempotent / cacheable).
+if printf '%s' "$want" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+'; then
+  # Caller (cicy-desktop) already resolved a concrete version on the HOST (fast,
+  # reliable network) → trust it, skip the in-container `npm view` entirely. This
+  # is the path that avoids the ~2min npm-view hang on a slow container registry.
+  ver="$want"
+else
+  # 'latest' / range → resolve via registry. FAIL FAST: npm's default retry/backoff
+  # can burn ~2min on a slow/blocked registry — cap retries+timeout so one bad
+  # registry fails in ~15s, then fall back to the other registry instead of hanging.
+  resolve_ver() {
+    npm view "cicy-code@${want}" version --registry "$1" \
+      --fetch-retries=1 --fetch-timeout=15000 --fetch-retry-mintimeout=3000 --fetch-retry-maxtimeout=15000 \
+      2>/dev/null | tail -n1
+  }
+  ver="$(resolve_ver "$REG")"
+  if [ -z "$ver" ]; then
+    alt="$NPM_CN"; [ "$REG" = "$NPM_CN" ] && alt="$NPM_OFFICIAL"
+    log "registry $REG slow/unreachable → falling back to $alt"
+    ver="$(resolve_ver "$alt")"
+    [ -n "$ver" ] && REG="$alt"
+  fi
+fi
+[ -n "$ver" ] || { log "could not resolve cicy-code@${want}"; exit 1; }
+dest="$RT/$ver"
+if [ -x "$dest/bin/cicy-code" ]; then
+  log "v$ver already installed → repointing"
+else
+  log "installing v$ver from $REG"
+  rm -rf "$dest"
+  mkdir -p "$dest"
+  npm install -g "cicy-code@$ver" --prefix "$dest" --registry "$REG" \
+    --fetch-retries=2 --fetch-timeout=60000 --fetch-retry-maxtimeout=30000
+fi
+mkdir -p "$(dirname "$LINK")"
+ln -sfn "$dest/bin/cicy-code" "$LINK"
+# Keep the npm-global bin (first on PATH) following the canonical link too, so
+# interactive `cicy-code` matches what supervisor runs.
+ln -sfn "$LINK" "$HOME_DIR/.npm-global/bin/cicy-code" 2>/dev/null || true
+# Record current pointer (merge into the shared versions.json).
+mkdir -p "$(dirname "$VERSIONS")"
+tmp="$(mktemp)"
+if [ -s "$VERSIONS" ] && jq -e . "$VERSIONS" >/dev/null 2>&1; then
+  jq --arg v "$ver" '.["cicy-code"] = ((.["cicy-code"] // {}) + {current: $v})' "$VERSIONS" > "$tmp"
+else
+  jq -n --arg v "$ver" '{"cicy-code": {current: $v}}' > "$tmp"
+fi
+mv "$tmp" "$VERSIONS"
+log "symlink → $(readlink -f "$LINK")"
+# Reload: restart only this program (no-op gracefully if supervisord isn't up).
+if $SVCTL pid >/dev/null 2>&1; then
+  log "restarting via supervisor"
+  $SVCTL restart cicy-code
+else
+  log "supervisord not running yet; symlink set, will start on boot"
+fi
+log "done → v$ver"