@silicaclaw/cli 2026.3.19-9 → 2026.3.20-1

package/scripts/silicaclaw-cli.mjs

@@ -9,6 +9,7 @@ import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const ROOT_DIR = resolve(__dirname, "..");
+const INVOCATION_CWD = process.cwd();
 
 const COLOR = {
   reset: "\x1b[0m",
@@ -34,7 +35,7 @@ function displayVersion(raw) {
 }
 
 function headline() {
-  console.log(`${paint("SilicaClaw", COLOR.bold, COLOR.orange)} ${paint(displayVersion(readVersion()), COLOR.dim)}`);
+  console.log(`${paint("🦀 SilicaClaw", COLOR.bold, COLOR.orange)} ${paint(displayVersion(readVersion()), COLOR.dim)}`);
   console.log(paint("Public identity and discovery for OpenClaw agents.", COLOR.dim));
 }
 
@@ -50,7 +51,10 @@ function run(cmd, args, extra = {}) {
   const result = spawnSync(cmd, args, {
     cwd: ROOT_DIR,
     stdio: "inherit",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -68,7 +72,10 @@ function runCapture(cmd, args, extra = {}) {
     cwd: ROOT_DIR,
     stdio: ["ignore", "pipe", "pipe"],
     encoding: "utf8",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -81,7 +88,10 @@ function runInherit(cmd, args, extra = {}) {
   const result = spawnSync(cmd, args, {
     cwd: ROOT_DIR,
     stdio: "inherit",
-    env: process.env,
+    env: {
+      ...process.env,
+      SILICACLAW_WORKSPACE_DIR: process.env.SILICACLAW_WORKSPACE_DIR || INVOCATION_CWD,
+    },
     ...extra,
   });
   if (result.error) {
@@ -138,6 +148,25 @@ function userNpmCacheDir() {
   return resolve(homedir(), ".silicaclaw", "npm-cache");
 }
 
+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@${specifier} "$@"`,
+    "",
+  ].join("\n");
+}
+
+function ensureUserShim(specifier = "latest") {
+  const shimPath = userShimPath();
+  const binDir = userShimDir();
+  const npmCacheDir = userNpmCacheDir();
+  mkdirSync(binDir, { recursive: true });
+  mkdirSync(npmCacheDir, { recursive: true });
+  writeFileSync(shimPath, shimScriptText(specifier), { encoding: "utf8", mode: 0o755 });
+}
+
 function ensureLineInFile(filePath, block) {
   try {
     const current = existsSync(filePath) ? readFileSync(filePath, "utf8") : "";
@@ -202,7 +231,7 @@ function shellInitTargets() {
   return targets;
 }
 
-function installPersistentCommand() {
+function installPersistentCommand(specifier = readPackageVersion()) {
   const binDir = userShimDir();
   const shimPath = userShimPath();
   const envFile = userEnvFile();
@@ -222,17 +251,7 @@ function installPersistentCommand() {
   mkdirSync(binDir, { recursive: true });
   mkdirSync(npmCacheDir, { recursive: true });
   writeFileSync(envFile, envBlock, { encoding: "utf8", mode: 0o755 });
-  writeFileSync(
-    shimPath,
-    [
-      "#!/usr/bin/env bash",
-      "set -euo pipefail",
-      'export npm_config_cache="${npm_config_cache:-$HOME/.silicaclaw/npm-cache}"',
-      'exec npx -y @silicaclaw/cli@beta "$@"',
-      "",
-    ].join("\n"),
-    { encoding: "utf8", mode: 0o755 }
-  );
+  writeFileSync(shimPath, shimScriptText(specifier || "latest"), { encoding: "utf8", mode: 0o755 });
   const rcFiles = shellInitTargets();
   const updatedFiles = [];
   const configuredFiles = [];
@@ -296,20 +315,39 @@ function canWriteGlobalPrefix() {
   }
 }
 
-function showUpdateGuide(current, latest, beta) {
+function showUpdateGuide(current, targetVersion) {
   headline();
   console.log("");
-  const upToDate = Boolean(beta) && current === beta;
+  const upToDate = Boolean(targetVersion) && current === targetVersion;
   if (upToDate) {
     kv("Status", `up to date (${current})`);
   } else {
-    kv("Status", `beta update available (${beta || "-"})`);
+    kv("Status", `update available (${targetVersion || "-"})`);
   }
   console.log("");
   kv("Start", "silicaclaw start");
   kv("Status", "silicaclaw status");
 }
 
+function preferredTaggedRelease(tags, current) {
+  const latest = tags.latest ? String(tags.latest) : "";
+  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"], {
@@ -369,7 +407,8 @@ function syncCurrentPackageToAppDir(appDir) {
   return true;
 }
 
-function restartGatewayIfRunning() {
+function restartGatewayIfRunning(options = {}) {
+  const preferredSpecifier = String(options.preferredSpecifier || "").trim();
   const status = getGatewayStatus();
   const appDir = status?.app_dir ? String(status.app_dir) : "";
   syncCurrentPackageToAppDir(appDir);
@@ -381,24 +420,37 @@ function restartGatewayIfRunning() {
   }
 
   const mode = String(status?.mode || "local");
-  const args = [resolve(ROOT_DIR, "scripts", "silicaclaw-gateway.mjs"), "restart", `--mode=${mode}`];
+  const gatewayArgs = ["gateway", "restart", `--mode=${mode}`];
   if (mode === "global-preview" && status?.signaling?.url) {
-    args.push(`--signaling-url=${status.signaling.url}`);
+    gatewayArgs.push(`--signaling-url=${status.signaling.url}`);
   }
   if (mode === "global-preview" && status?.signaling?.room) {
-    args.push(`--room=${status.signaling.room}`);
+    gatewayArgs.push(`--room=${status.signaling.room}`);
   }
 
   console.log("");
   console.log(paint("Refreshing services", COLOR.bold));
-  runInherit("node", args, { cwd: process.cwd() });
+  const shimPath = userShimPath();
+  const canUseUpdatedShim =
+    preferredSpecifier &&
+    existsSync(shimPath) &&
+    resolve(shimPath) !== process.argv[1];
+
+  if (canUseUpdatedShim) {
+    runInherit(shimPath, gatewayArgs, { cwd: process.cwd() });
+    return;
+  }
+
+  runInherit("node", [resolve(ROOT_DIR, "scripts", "silicaclaw-gateway.mjs"), ...gatewayArgs.slice(1)], {
+    cwd: process.cwd(),
+  });
 }
 
-function tryGlobalUpgrade(beta) {
+function tryGlobalUpgrade(version) {
   const writableGlobal = canWriteGlobalPrefix();
   if (!writableGlobal) return false;
-  kv("Upgrade", `installing @silicaclaw/cli@${beta} globally`);
-  const exactResult = runCapture("npm", ["i", "-g", `@silicaclaw/cli@${beta}`]);
+  kv("Upgrade", `installing @silicaclaw/cli@${version} globally`);
+  const exactResult = runCapture("npm", ["i", "-g", `@silicaclaw/cli@${version}`]);
   if ((exactResult.status ?? 1) === 0) {
     if (exactResult.stdout) process.stdout.write(exactResult.stdout);
     if (exactResult.stderr) process.stderr.write(exactResult.stderr);
@@ -407,8 +459,8 @@ function tryGlobalUpgrade(beta) {
 
   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"]);
+    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;
   }
 
@@ -422,35 +474,35 @@ function tryGlobalUpgrade(beta) {
 function update() {
   const current = readPackageVersion();
   try {
-    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) : "";
-    const beta = tags.beta ? String(tags.beta) : "";
-    showUpdateGuide(current, latest, beta);
-    const hasNewBeta = Boolean(beta) && beta !== current;
+    const targetVersion = registry.version;
+    ensureUserShim(targetVersion || "latest");
+    showUpdateGuide(current, targetVersion);
+    const hasNewTarget = Boolean(targetVersion) && targetVersion !== current;
     const npxRuntime = isNpxRun();
 
-    if (hasNewBeta) {
+    if (hasNewTarget) {
       if (npxRuntime) {
-        kv("Update", `next run will use ${beta}`);
-      } else if (tryGlobalUpgrade(beta)) {
-        kv("Update", `installed ${beta}`);
+        kv("Update", `next run will use ${targetVersion}`);
       } else {
-        kv("Update", `install ${beta} manually if needed`);
+        kv("Update", `command now points to ${targetVersion}`);
+        if (tryGlobalUpgrade(targetVersion)) {
+          kv("Global", `installed ${targetVersion}`);
+        } else {
+          kv("Global", `install ${targetVersion} manually if needed`);
+        }
       }
     }
 
-    restartGatewayIfRunning();
+    restartGatewayIfRunning({ preferredSpecifier: hasNewTarget ? targetVersion : "" });
     process.exit(0);
   } catch (error) {
     headline();
@@ -494,7 +546,8 @@ function help() {
   headline();
   console.log("");
   section("Commands");
-  kv("Install", "npx -y @silicaclaw/cli@beta install");
+  kv("First Run", "npx -y @silicaclaw/cli@latest onboard");
+  kv("Install", "npx -y @silicaclaw/cli@latest install");
   kv("Start", "silicaclaw start");
   kv("Status", "silicaclaw status");
   kv("Stop", "silicaclaw stop");
@@ -509,6 +562,12 @@ function help() {
   kv("Logs", "silicaclaw logs local-console");
   kv("Doctor", "silicaclaw doctor");
   kv("Help", "silicaclaw help");
+  console.log("");
+  section("Meaning");
+  kv("onboard", "first-time setup wizard");
+  kv("connect", "quick network setup wizard");
+  kv("install", "install persistent silicaclaw command only");
+  kv("channel", "@latest is the default release channel");
 }
 
 const cmd = String(process.argv[2] || "help").trim().toLowerCase();
@@ -530,7 +589,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)], {