@silicaclaw/cli 2026.3.19-22 → 2026.3.19-24

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## v1.0 beta - 2026-03-19
 
+### 2026.3.19-24
+
+- release build:
+  - prepared another fresh beta-channel package build without publishing
+  - regenerated the npm tarball through the verified release packing workflow
+
+### 2026.3.19-23
+
+- release build:
+  - prepared another fresh beta-channel package build without publishing
+  - regenerated the npm tarball through the verified release packing workflow
+
 ### 2026.3.19-22
 
 - release build:

package/VERSION

@@ -1 +1 @@
-v2026.3.19-22
+v2026.3.19-24

package/docs/RELEASE_CHECKLIST.md

@@ -0,0 +1,98 @@
+# Release Checklist
+
+发布完成后，按下面这套固定流程做 1 分钟验证。
+
+## 1. 检查 npm tag
+
+```bash
+npm dist-tag ls @silicaclaw/cli
+```
+
+必须确认：
+
+- `latest` 指向这次正式要给用户用的版本
+- `beta` 不要意外比 `latest` 更新却反挂
+
+## 2. 检查两个入口实际拿到的版本
+
+```bash
+npx -y @silicaclaw/cli@latest --version
+npx -y @silicaclaw/cli@beta --version
+```
+
+目标是：
+
+- `latest` 输出刚发布的版本
+- `beta` 只有在刻意保留测试线时才不同
+
+## 3. 检查持久命令安装后跑的是谁
+
+```bash
+npx -y @silicaclaw/cli@latest install
+source ~/.silicaclaw/env.sh
+type silicaclaw
+which silicaclaw
+sed -n '1,20p' ~/.silicaclaw/bin/silicaclaw
+silicaclaw --version
+```
+
+重点看：
+
+- `~/.silicaclaw/bin/silicaclaw` 是否还在跑错误 tag
+- `silicaclaw --version` 是否直接输出新 CLI，而不是老帮助页
+
+## 4. 检查核心命令链
+
+```bash
+silicaclaw update
+silicaclaw start
+silicaclaw status
+silicaclaw stop
+```
+
+目标是：
+
+- 这四个都能进入新 CLI
+- 不会再掉回旧版 help 文本
+
+## 5. 检查页面版本和基础服务
+
+```bash
+silicaclaw start
+curl -s http://localhost:4310/api/overview
+curl -s http://localhost:4310/api/runtime/paths
+```
+
+重点看：
+
+- `app_version`
+- `storage_root`
+- `data_dir`
+
+## 6. 检查资料是否保留
+
+```bash
+ls -la ~/.silicaclaw/local-console/data
+cat ~/.silicaclaw/local-console/data/profile.json
+cat ~/.silicaclaw/local-console/data/identity.json
+```
+
+确认：
+
+- 文件存在
+- 更新或重启后内容没有变空
+
+## 7. 检查旧缓存迁移是否还有机会
+
+```bash
+find ~/.silicaclaw ~/.npm -name profile.json 2>/dev/null | grep silicaclaw
+find ~/.silicaclaw ~/.npm -name identity.json 2>/dev/null | grep silicaclaw
+```
+
+如果用户反馈“资料丢了”，这一步最直接。
+
+## 最关键的三件事
+
+- `dist-tag` 没挂反
+- `silicaclaw --version` 命中的是新 CLI
+- `profile.json` 和 `identity.json` 还在固定目录里

package/openclaw-skills/silicaclaw-broadcast/VERSION

@@ -1 +1 @@
-2026.3.19-beta.22
+2026.3.19-beta.24

package/openclaw-skills/silicaclaw-broadcast/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "silicaclaw-broadcast",
-  "version": "2026.3.19-beta.22",
+  "version": "2026.3.19-beta.24",
   "display_name": "SilicaClaw Broadcast",
   "description": "OpenClaw skill for reading SilicaClaw public broadcasts, publishing public broadcasts, and forwarding relevant updates to the owner through OpenClaw's native social channel.",
   "entrypoints": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "2026.3.19-22",
+  "version": "2026.3.19-24",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/silicaclaw-cli.mjs

@@ -148,23 +148,23 @@ function userNpmCacheDir() {
   return resolve(homedir(), ".silicaclaw", "npm-cache");
 }
 
-function shimScriptText(channel = "latest") {
+function shimScriptText(specifier = "latest") {
   return [
     "#!/usr/bin/env bash",
     "set -euo pipefail",
     'export npm_config_cache="${npm_config_cache:-$HOME/.silicaclaw/npm-cache}"',
-    `exec npx -y @silicaclaw/cli@${channel} "$@"`,
+    `exec npx -y @silicaclaw/cli@${specifier} "$@"`,
     "",
   ].join("\n");
 }
 
-function ensureLatestUserShim() {
+function ensureUserShim(specifier = "latest") {
   const shimPath = userShimPath();
   const binDir = userShimDir();
   const npmCacheDir = userNpmCacheDir();
   mkdirSync(binDir, { recursive: true });
   mkdirSync(npmCacheDir, { recursive: true });
-  writeFileSync(shimPath, shimScriptText("latest"), { encoding: "utf8", mode: 0o755 });
+  writeFileSync(shimPath, shimScriptText(specifier), { encoding: "utf8", mode: 0o755 });
 }
 
 function ensureLineInFile(filePath, block) {
@@ -231,7 +231,7 @@ function shellInitTargets() {
   return targets;
 }
 
-function installPersistentCommand() {
+function installPersistentCommand(specifier = readPackageVersion()) {
   const binDir = userShimDir();
   const shimPath = userShimPath();
   const envFile = userEnvFile();
@@ -251,7 +251,7 @@ function installPersistentCommand() {
   mkdirSync(binDir, { recursive: true });
   mkdirSync(npmCacheDir, { recursive: true });
   writeFileSync(envFile, envBlock, { encoding: "utf8", mode: 0o755 });
-  writeFileSync(shimPath, shimScriptText("latest"), { encoding: "utf8", mode: 0o755 });
+  writeFileSync(shimPath, shimScriptText(specifier || "latest"), { encoding: "utf8", mode: 0o755 });
   const rcFiles = shellInitTargets();
   const updatedFiles = [];
   const configuredFiles = [];
@@ -330,6 +330,32 @@ function showUpdateGuide(current, targetVersion, channel = "latest") {
   kv("Channel", channel);
 }
 
+function preferredTaggedRelease(tags, current) {
+  const latest = tags.latest ? String(tags.latest) : "";
+  const beta = tags.beta ? String(tags.beta) : "";
+  if (latest && beta) {
+    return compareVersionTokens(beta, latest) > 0
+      ? { version: beta, channel: "beta" }
+      : { version: latest, channel: "latest" };
+  }
+  if (beta) return { version: beta, channel: "beta" };
+  if (latest) return { version: latest, channel: "latest" };
+  return { version: current, channel: "unknown" };
+}
+
+function preferredRegistryRelease(current) {
+  try {
+    const result = runCapture("npm", ["view", "@silicaclaw/cli", "dist-tags", "--json"]);
+    if ((result.status ?? 1) !== 0) return { version: current, channel: "current", tags: null };
+    const text = String(result.stdout || "").trim();
+    const tags = text ? JSON.parse(text) : {};
+    const preferred = preferredTaggedRelease(tags, current);
+    return { ...preferred, tags };
+  } catch {
+    return { version: current, channel: "current", tags: null };
+  }
+}
+
 function getGatewayStatus() {
   try {
     const result = runCapture("node", [resolve(ROOT_DIR, "scripts", "silicaclaw-gateway.mjs"), "status", "--json"], {
@@ -427,8 +453,8 @@ function tryGlobalUpgrade(version) {
 
   const detail = compactOutput(`${exactResult.stdout || ""}\n${exactResult.stderr || ""}`);
   if (detail.includes("ETARGET") || detail.includes("No matching version found")) {
-    kv("Fallback", "registry metadata is still settling, retrying via @latest tag");
-    const fallbackResult = runInherit("npm", ["i", "-g", "@silicaclaw/cli@latest"]);
+    kv("Fallback", `registry metadata is still settling, retrying via exact version ${version}`);
+    const fallbackResult = runInherit("npm", ["i", "-g", `@silicaclaw/cli@${version}`]);
     return (fallbackResult.status ?? 1) === 0;
   }
 
@@ -442,31 +468,34 @@ function tryGlobalUpgrade(version) {
 function update() {
   const current = readPackageVersion();
   try {
-    ensureLatestUserShim();
-    const result = runCapture("npm", ["view", "@silicaclaw/cli", "dist-tags", "--json"]);
-    if ((result.status ?? 1) !== 0) {
+    const registry = preferredRegistryRelease(current);
+    if (!registry.tags) {
       headline();
       console.log("");
       console.error(paint("Update check failed", COLOR.bold, COLOR.yellow));
-      if (result.stderr) console.error(result.stderr.trim());
       console.log("");
       kv("Try", "npm view @silicaclaw/cli dist-tags --json");
-      process.exit(result.status ?? 1);
+      process.exit(1);
     }
-    const text = String(result.stdout || "").trim();
-    const tags = text ? JSON.parse(text) : {};
-    const latest = tags.latest ? String(tags.latest) : "";
-    showUpdateGuide(current, latest, "latest");
-    const hasNewLatest = Boolean(latest) && latest !== current;
+    const targetVersion = registry.version;
+    const targetChannel = registry.channel;
+    ensureUserShim(targetVersion || "latest");
+    showUpdateGuide(current, targetVersion, targetChannel);
+    const latest = registry.tags.latest ? String(registry.tags.latest) : "";
+    const beta = registry.tags.beta ? String(registry.tags.beta) : "";
+    if (latest && beta && compareVersionTokens(beta, latest) > 0) {
+      kv("Registry", `latest tag is older than beta (${latest} < ${beta})`);
+    }
+    const hasNewTarget = Boolean(targetVersion) && targetVersion !== current;
     const npxRuntime = isNpxRun();
 
-    if (hasNewLatest) {
+    if (hasNewTarget) {
       if (npxRuntime) {
-        kv("Update", `next run will use ${latest}`);
-      } else if (tryGlobalUpgrade(latest)) {
-        kv("Update", `installed ${latest}`);
+        kv("Update", `next run will use ${targetVersion}`);
+      } else if (tryGlobalUpgrade(targetVersion)) {
+        kv("Update", `installed ${targetVersion}`);
       } else {
-        kv("Update", `install ${latest} manually if needed`);
+        kv("Update", `install ${targetVersion} manually if needed`);
       }
     }
 
@@ -557,7 +586,10 @@ switch (cmd) {
     update();
     break;
   case "install":
-    installPersistentCommand();
+    {
+      const preferred = preferredRegistryRelease(readPackageVersion());
+      installPersistentCommand(preferred.version || readPackageVersion());
+    }
     break;
   case "gateway":
     run("node", [resolve(ROOT_DIR, "scripts", "silicaclaw-gateway.mjs"), ...process.argv.slice(3)], {