@silicaclaw/cli 2026.3.19-4 → 2026.3.19-6

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## v1.0 beta - 2026-03-19
 
-### 2026.3.19-4
+### 2026.3.19-6
 
 - local-console UI polish:
   - sidebar spacing, collapsed rail behavior, footer version card, and topbar shell now align more closely with OpenClaw

package/INSTALL.md

@@ -219,7 +219,33 @@ npm run health
 - Ensure `npm run local-console` is running.
 - Use `http://localhost:4310`.
 
-2. No peers in LAN mode
+2. `silicaclaw update` or `silicaclaw --version` returns `ETARGET`
+- This usually means the new npm beta was published, but your local npm metadata cache is stale.
+- Check the current beta tag with `npm view @silicaclaw/cli dist-tags --json`.
+- Retry with a clean cache:
+
+```bash
+NPM_CONFIG_CACHE=/tmp/silicaclaw-npm-cache-test silicaclaw --version
+NPM_CONFIG_CACHE=/tmp/silicaclaw-npm-cache-test silicaclaw update
+```
+
+- If that works, clear the persistent cache and retry:
+
+```bash
+rm -rf ~/.silicaclaw/npm-cache
+silicaclaw --version
+silicaclaw update
+```
+
+- You can also install the current beta directly with `npm i -g @silicaclaw/cli@beta`.
+
+3. Left sidebar version at `http://localhost:4310` still shows an older release
+- Hard refresh the page first.
+- Restart `silicaclaw gateway` / local-console.
+- Reopen `http://localhost:4310`.
+- If needed, clear the browser site data for `localhost:4310`.
+
+4. No peers in LAN mode
 - Keep `NETWORK_NAMESPACE` identical on both machines.
 - Keep `NETWORK_PORT` identical on both machines.
 - Allow UDP broadcast in firewall/router.

package/README.md

@@ -278,6 +278,58 @@ silicaclaw openclaw-demo
 node scripts/openclaw-runtime-demo.mjs
 ```
 
+## Troubleshooting
+
+### `silicaclaw update` or `silicaclaw --version` fails with `ETARGET`
+
+If you just published a new beta and npm says:
+
+- `No matching version found for @silicaclaw/cli@...`
+- `ETARGET`
+
+the package may already be published, but your local npm metadata cache may still be stale.
+
+Check the current beta tag:
+
+```bash
+npm view @silicaclaw/cli dist-tags --json
+```
+
+Try again with a clean cache:
+
+```bash
+NPM_CONFIG_CACHE=/tmp/silicaclaw-npm-cache-test silicaclaw --version
+NPM_CONFIG_CACHE=/tmp/silicaclaw-npm-cache-test silicaclaw update
+```
+
+If that works, clear the persistent SilicaClaw npm cache and retry:
+
+```bash
+rm -rf ~/.silicaclaw/npm-cache
+silicaclaw --version
+silicaclaw update
+```
+
+As a direct fallback, install the current beta tag explicitly:
+
+```bash
+npm i -g @silicaclaw/cli@beta
+```
+
+### Left sidebar version shows an older release
+
+If `http://localhost:4310` is running the new release but the sidebar still shows an older version, the browser may be displaying cached UI shell data from a previous session.
+
+Try:
+
+```text
+1. Hard refresh the page.
+2. Restart SilicaClaw gateway/local-console.
+3. Reopen http://localhost:4310.
+```
+
+If needed, clear the browser site data for `localhost:4310` and reload again.
+
 Inside the demo shell:
 
 - type plain text to broadcast a message

package/VERSION

@@ -1 +1 @@
-v2026.3.19-4
+v2026.3.19-6

package/openclaw-skills/silicaclaw-broadcast/VERSION

@@ -1 +1 @@
-2026.3.19-4
+2026.3.19-6

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

@@ -1,6 +1,6 @@
 {
   "name": "silicaclaw-broadcast",
-  "version": "2026.3.19-4",
+  "version": "2026.3.19-6",
   "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-4",
+  "version": "2026.3.19-6",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/silicaclaw-cli.mjs

@@ -398,8 +398,25 @@ function tryGlobalUpgrade(beta) {
   const writableGlobal = canWriteGlobalPrefix();
   if (!writableGlobal) return false;
   kv("Upgrade", `installing @silicaclaw/cli@${beta} globally`);
-  const result = runInherit("npm", ["i", "-g", `@silicaclaw/cli@${beta}`]);
-  return (result.status ?? 1) === 0;
+  const exactResult = runCapture("npm", ["i", "-g", `@silicaclaw/cli@${beta}`]);
+  if ((exactResult.status ?? 1) === 0) {
+    if (exactResult.stdout) process.stdout.write(exactResult.stdout);
+    if (exactResult.stderr) process.stderr.write(exactResult.stderr);
+    return true;
+  }
+
+  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 @beta tag");
+    const fallbackResult = runInherit("npm", ["i", "-g", "@silicaclaw/cli@beta"]);
+    return (fallbackResult.status ?? 1) === 0;
+  }
+
+  if (detail) {
+    console.log("");
+    console.log(detail);
+  }
+  return false;
 }
 
 function update() {

package/scripts/silicaclaw-gateway.mjs

@@ -486,6 +486,16 @@ async function waitForPort(port, timeoutMs = 5000) {
   return null;
 }
 
+async function waitForPortToClear(port, timeoutMs = 5000) {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < timeoutMs) {
+    const listener = listeningProcessOnPort(port);
+    if (!listener) return true;
+    await sleep(200);
+  }
+  return false;
+}
+
 function tailText(file, lines = 20) {
   if (!existsSync(file)) return "";
   const text = String(readFileSync(file, "utf8"));
@@ -528,6 +538,24 @@ async function stopOwnedListener(port, kind) {
   return true;
 }
 
+async function drainOwnedListener(port, kind, timeoutMs = 5000) {
+  const startedAt = Date.now();
+  let attempted = false;
+  while (Date.now() - startedAt < timeoutMs) {
+    const listener = listeningProcessOnPort(port);
+    if (!listener) return { cleared: true, attempted };
+    if (!isOwnedListener(listener, kind)) {
+      return { cleared: false, attempted };
+    }
+    attempted = true;
+    await stopOwnedListener(port, kind);
+    const cleared = await waitForPortToClear(port, 1200);
+    if (cleared) return { cleared: true, attempted };
+  }
+  const finalListener = listeningProcessOnPort(port);
+  return { cleared: !finalListener, attempted };
+}
+
 function printStopSummary() {
   const localListener = listeningProcessOnPort(4310);
   const signalingListener = listeningProcessOnPort(4510);
@@ -538,6 +566,9 @@ function printStopSummary() {
     kv("Console", paint("stopped", COLOR.green));
   } else {
     kv("Console", `${paint("still busy", COLOR.yellow)} (pid=${localListener.pid})`);
+    if (isOwnedListener(localListener, "local-console")) {
+      kv("Hint", "an older SilicaClaw local-console process is still holding port 4310");
+    }
     kv("Inspect", "lsof -nP -iTCP:4310 -sTCP:LISTEN");
     kv("Stop pid", `kill ${localListener.pid}`);
   }
@@ -570,8 +601,8 @@ async function stopAll() {
   if (isLaunchdPlatform()) {
     stopLaunchAgent(LOCAL_CONSOLE_LABEL);
     stopLaunchAgent(SIGNALING_LABEL);
-    await stopOwnedListener(4310, "local-console");
-    await stopOwnedListener(4510, "signaling");
+    await drainOwnedListener(4310, "local-console", 8000);
+    await drainOwnedListener(4510, "signaling", 5000);
     removeFileIfExists(CONSOLE_PID_FILE);
     removeFileIfExists(SIGNALING_PID_FILE);
     writeState({
@@ -584,8 +615,8 @@ async function stopAll() {
   const sigPid = readPid(SIGNALING_PID_FILE);
   await stopPid(localPid, "local-console");
   await stopPid(sigPid, "signaling");
-  await stopOwnedListener(4310, "local-console");
-  await stopOwnedListener(4510, "signaling");
+  await drainOwnedListener(4310, "local-console", 5000);
+  await drainOwnedListener(4510, "signaling", 5000);
   removeFileIfExists(CONSOLE_PID_FILE);
   removeFileIfExists(SIGNALING_PID_FILE);
   writeState({
@@ -638,8 +669,8 @@ async function startAll() {
   if (isLaunchdPlatform()) {
     const npmPath = resolveCommandPath("npm");
     const signalingEntry = resolve(APP_DIR, "scripts", "webrtc-signaling-server.mjs");
-    await stopOwnedListener(4310, "local-console");
-    await stopOwnedListener(4510, "signaling");
+    await drainOwnedListener(4310, "local-console", 8000);
+    await drainOwnedListener(4510, "signaling", 5000);
     const baseEnv = {
       NETWORK_ADAPTER: adapter,
       NETWORK_MODE: mode,