@silicaclaw/cli 2026.3.19-27 → 2026.3.19-29

package/CHANGELOG.md

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

package/DEMO_GUIDE.md

@@ -1,4 +1,4 @@
-# SilicaClaw Demo Guide (v1.0 beta)
+# SilicaClaw Demo Guide (v1.0)
 
 This guide provides 3 shortest demo paths.
 

package/INSTALL.md

@@ -1,4 +1,4 @@
-# SilicaClaw Quick Start Install (v1.0 beta)
+# SilicaClaw Quick Start Install (v1.0)
 
 This page follows an OpenClaw-like quick-start flow: install, run, verify.
 

package/VERSION

@@ -1 +1 @@
-v2026.3.19-27
+v2026.3.19-29

package/apps/local-console/dist/apps/local-console/src/server.d.ts

@@ -191,6 +191,8 @@ export declare class LocalNodeService {
     private webrtcSeedPeers;
     private webrtcBootstrapHints;
     private webrtcBootstrapSources;
+    private networkStarted;
+    private networkStartupError;
     private appVersion;
     constructor(options?: {
         workspaceRoot?: string;
@@ -269,6 +271,8 @@ export declare class LocalNodeService {
         real_preview_transport_stats: any;
         real_preview_discovery_stats: any;
         webrtc_preview: {
+            started: boolean;
+            startup_error: string | null;
             signaling_url: any;
             signaling_endpoints: any;
             room: any;
@@ -295,6 +299,8 @@ export declare class LocalNodeService {
         limits: any;
         adapter_config: any;
         adapter_extra: {
+            started: boolean;
+            startup_error: string | null;
             signaling_url: any;
             signaling_endpoints: any;
             room: any;
@@ -363,6 +369,8 @@ export declare class LocalNodeService {
         adapter_transport_stats: any;
         adapter_discovery_stats: any;
         adapter_diagnostics_summary: {
+            started: boolean;
+            startup_error: string | null;
             signaling_url: any;
             signaling_endpoints: any;
             room: any;
@@ -406,6 +414,8 @@ export declare class LocalNodeService {
         components: any;
         limits: any;
         diagnostics_summary: {
+            started: boolean;
+            startup_error: string | null;
             signaling_url: any;
             signaling_endpoints: any;
             room: any;

package/apps/local-console/dist/apps/local-console/src/server.js

@@ -144,6 +144,12 @@ function resolveWorkspaceRoot(cwd = process.cwd()) {
     return cwd;
 }
 function resolveProjectRoot(appRoot, cwd = process.cwd()) {
+    const envAppRoot = String(process.env.SILICACLAW_APP_DIR || "").trim();
+    if (envAppRoot &&
+        (0, fs_1.existsSync)((0, path_1.resolve)(envAppRoot, "apps", "local-console", "package.json")) &&
+        (0, fs_1.existsSync)((0, path_1.resolve)(envAppRoot, "package.json"))) {
+        return (0, path_1.resolve)(envAppRoot);
+    }
     const envRoot = String(process.env.SILICACLAW_WORKSPACE_DIR || "").trim();
     if (envRoot) {
         return (0, path_1.resolve)(envRoot);
@@ -728,6 +734,8 @@ class LocalNodeService {
     webrtcSeedPeers = [];
     webrtcBootstrapHints = [];
     webrtcBootstrapSources = [];
+    networkStarted = false;
+    networkStartupError = null;
     appVersion = "unknown";
     constructor(options) {
         this.workspaceRoot = options?.workspaceRoot || resolveWorkspaceRoot();
@@ -772,9 +780,18 @@ class LocalNodeService {
     async start() {
         await this.hydrateFromDisk();
         this.bindNetworkSubscriptions();
-        await this.network.start();
-        await this.log("info", `Local node started (${this.adapterMode}, mode=${this.networkMode}, signaling=${this.webrtcSignalingUrls[0] || "-"}, room=${this.webrtcRoom})`);
-        if (this.profile?.public_enabled && this.broadcastEnabled) {
+        try {
+            await this.network.start();
+            this.networkStarted = true;
+            this.networkStartupError = null;
+            await this.log("info", `Local node started (${this.adapterMode}, mode=${this.networkMode}, signaling=${this.webrtcSignalingUrls[0] || "-"}, room=${this.webrtcRoom})`);
+        }
+        catch (error) {
+            this.networkStarted = false;
+            this.networkStartupError = error instanceof Error ? error.message : String(error);
+            await this.log("warn", `Network start failed (${this.adapterMode}, mode=${this.networkMode}): ${this.networkStartupError}`);
+        }
+        if (this.networkStarted && this.profile?.public_enabled && this.broadcastEnabled) {
             try {
                 await this.broadcastNow("adapter_start");
             }
@@ -782,14 +799,19 @@ class LocalNodeService {
                 await this.log("warn", `Initial broadcast failed: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
-        this.startBroadcastLoop();
+        if (this.networkStarted) {
+            this.startBroadcastLoop();
+        }
     }
     async stop() {
         if (this.broadcaster) {
             clearInterval(this.broadcaster);
             this.broadcaster = null;
         }
-        await this.network.stop();
+        if (this.networkStarted) {
+            await this.network.stop();
+        }
+        this.networkStarted = false;
     }
     ensureLocalDirectoryBaseline() {
         if (this.profile) {
@@ -867,6 +889,8 @@ class LocalNodeService {
             real_preview_discovery_stats: diagnostics?.discovery_stats ?? null,
             webrtc_preview: relayCapable
                 ? {
+                    started: this.networkStarted,
+                    startup_error: this.networkStartupError,
                     signaling_url: network.signaling_url,
                     signaling_endpoints: network.signaling_endpoints,
                     room: network.room,
@@ -905,6 +929,8 @@ class LocalNodeService {
             adapter_config: diagnostics?.config ?? null,
             adapter_extra: relayCapable
                 ? {
+                    started: this.networkStarted,
+                    startup_error: this.networkStartupError,
                     signaling_url: network.signaling_url,
                     signaling_endpoints: network.signaling_endpoints,
                     room: network.room,
@@ -946,7 +972,7 @@ class LocalNodeService {
             demo_mode: this.adapterMode === "real-preview"
                 ? "lan-preview"
                 : this.adapterMode === "webrtc-preview" || this.adapterMode === "relay-preview"
-                    ? "internet-preview"
+                    ? "global-preview"
                     : "local-process",
             mode_explainer: this.getModeExplainer(),
         };
@@ -982,6 +1008,8 @@ class LocalNodeService {
             adapter_discovery_stats: diagnostics?.discovery_stats ?? null,
             adapter_diagnostics_summary: relayCapable || diagnostics
                 ? {
+                    started: this.networkStarted,
+                    startup_error: this.networkStartupError,
                     signaling_url: network.signaling_url,
                     signaling_endpoints: network.signaling_endpoints,
                     room: network.room,
@@ -1030,6 +1058,8 @@ class LocalNodeService {
             components: diagnostics.components,
             limits: diagnostics.limits,
             diagnostics_summary: {
+                started: this.networkStarted,
+                startup_error: this.networkStartupError,
                 signaling_url: network.signaling_url,
                 signaling_endpoints: network.signaling_endpoints,
                 room: network.room,
@@ -1119,9 +1149,10 @@ class LocalNodeService {
     }
     getIntegrationStatus() {
         const runtimeGenerated = Boolean(this.socialRuntime && this.socialRuntime.last_loaded_at > 0);
-        const connected = this.socialFound && runtimeGenerated && !this.socialParseError;
-        const configured = connected && this.socialConfig.enabled;
-        const running = configured && this.broadcastEnabled;
+        const runtimeReady = this.socialFound && runtimeGenerated && !this.socialParseError;
+        const connected = runtimeReady && this.networkStarted;
+        const configured = runtimeReady && this.socialConfig.enabled;
+        const running = configured && this.broadcastEnabled && this.networkStarted;
         const publicEnabled = Boolean(this.profile?.public_enabled);
         const discoveryEnabled = this.socialConfig.discovery.discoverable &&
             this.socialConfig.discovery.allow_profile_broadcast &&
@@ -1140,9 +1171,11 @@ class LocalNodeService {
             ? "running"
             : !configured
                 ? "not configured"
-                : !this.broadcastEnabled
-                    ? "broadcast paused"
-                    : "not running";
+                : this.networkStartupError
+                    ? this.networkStartupError
+                    : !this.broadcastEnabled
+                        ? "broadcast paused"
+                        : "not running";
         const discoverableReason = discoverable
             ? "discoverable"
             : !running
@@ -2831,7 +2864,6 @@ async function main() {
     const staticDir = resolveLocalConsoleStaticDir();
     const staticIndexFile = (0, path_1.resolve)(staticDir, "index.html");
     const node = new LocalNodeService();
-    await node.start();
     app.use((0, cors_1.default)({ origin: true }));
     app.use(express_1.default.json());
     app.get("/api/identity", (_req, res) => {
@@ -3087,6 +3119,7 @@ async function main() {
         // eslint-disable-next-line no-console
         console.log(`SilicaClaw local-console running: http://localhost:${port}`);
     });
+    await node.start();
     process.on("SIGINT", async () => {
         await node.stop();
         process.exit(0);

package/apps/local-console/src/server.ts

@@ -198,6 +198,14 @@ function resolveWorkspaceRoot(cwd = process.cwd()): string {
 }
 
 function resolveProjectRoot(appRoot: string, cwd = process.cwd()): string {
+  const envAppRoot = String(process.env.SILICACLAW_APP_DIR || "").trim();
+  if (
+    envAppRoot &&
+    existsSync(resolve(envAppRoot, "apps", "local-console", "package.json")) &&
+    existsSync(resolve(envAppRoot, "package.json"))
+  ) {
+    return resolve(envAppRoot);
+  }
   const envRoot = String(process.env.SILICACLAW_WORKSPACE_DIR || "").trim();
   if (envRoot) {
     return resolve(envRoot);
@@ -943,6 +951,8 @@ export class LocalNodeService {
   private webrtcSeedPeers: string[] = [];
   private webrtcBootstrapHints: string[] = [];
   private webrtcBootstrapSources: string[] = [];
+  private networkStarted = false;
+  private networkStartupError: string | null = null;
   private appVersion = "unknown";
 
   constructor(options?: { workspaceRoot?: string; projectRoot?: string; storageRoot?: string }) {
@@ -993,13 +1003,24 @@ export class LocalNodeService {
     await this.hydrateFromDisk();
 
     this.bindNetworkSubscriptions();
-    await this.network.start();
-    await this.log(
-      "info",
-      `Local node started (${this.adapterMode}, mode=${this.networkMode}, signaling=${this.webrtcSignalingUrls[0] || "-"}, room=${this.webrtcRoom})`
-    );
+    try {
+      await this.network.start();
+      this.networkStarted = true;
+      this.networkStartupError = null;
+      await this.log(
+        "info",
+        `Local node started (${this.adapterMode}, mode=${this.networkMode}, signaling=${this.webrtcSignalingUrls[0] || "-"}, room=${this.webrtcRoom})`
+      );
+    } catch (error) {
+      this.networkStarted = false;
+      this.networkStartupError = error instanceof Error ? error.message : String(error);
+      await this.log(
+        "warn",
+        `Network start failed (${this.adapterMode}, mode=${this.networkMode}): ${this.networkStartupError}`
+      );
+    }
 
-    if (this.profile?.public_enabled && this.broadcastEnabled) {
+    if (this.networkStarted && this.profile?.public_enabled && this.broadcastEnabled) {
       try {
         await this.broadcastNow("adapter_start");
       } catch (error) {
@@ -1010,7 +1031,9 @@ export class LocalNodeService {
       }
     }
 
-    this.startBroadcastLoop();
+    if (this.networkStarted) {
+      this.startBroadcastLoop();
+    }
   }
 
   async stop(): Promise<void> {
@@ -1018,7 +1041,10 @@ export class LocalNodeService {
       clearInterval(this.broadcaster);
       this.broadcaster = null;
     }
-    await this.network.stop();
+    if (this.networkStarted) {
+      await this.network.stop();
+    }
+    this.networkStarted = false;
   }
 
   private ensureLocalDirectoryBaseline(): void {
@@ -1101,6 +1127,8 @@ export class LocalNodeService {
       real_preview_discovery_stats: diagnostics?.discovery_stats ?? null,
       webrtc_preview: relayCapable
         ? {
+            started: this.networkStarted,
+            startup_error: this.networkStartupError,
             signaling_url: network.signaling_url,
             signaling_endpoints: network.signaling_endpoints,
             room: network.room,
@@ -1140,6 +1168,8 @@ export class LocalNodeService {
       adapter_config: diagnostics?.config ?? null,
       adapter_extra: relayCapable
         ? {
+            started: this.networkStarted,
+            startup_error: this.networkStartupError,
             signaling_url: network.signaling_url,
             signaling_endpoints: network.signaling_endpoints,
             room: network.room,
@@ -1182,7 +1212,7 @@ export class LocalNodeService {
         this.adapterMode === "real-preview"
           ? "lan-preview"
           : this.adapterMode === "webrtc-preview" || this.adapterMode === "relay-preview"
-            ? "internet-preview"
+            ? "global-preview"
             : "local-process",
       mode_explainer: this.getModeExplainer(),
     };
@@ -1220,6 +1250,8 @@ export class LocalNodeService {
       adapter_discovery_stats: diagnostics?.discovery_stats ?? null,
       adapter_diagnostics_summary: relayCapable || diagnostics
         ? {
+            started: this.networkStarted,
+            startup_error: this.networkStartupError,
             signaling_url: network.signaling_url,
             signaling_endpoints: network.signaling_endpoints,
             room: network.room,
@@ -1269,6 +1301,8 @@ export class LocalNodeService {
       components: diagnostics.components,
       limits: diagnostics.limits,
       diagnostics_summary: {
+        started: this.networkStarted,
+        startup_error: this.networkStartupError,
         signaling_url: network.signaling_url,
         signaling_endpoints: network.signaling_endpoints,
         room: network.room,
@@ -1364,9 +1398,10 @@ export class LocalNodeService {
 
   getIntegrationStatus(): IntegrationStatusSummary {
     const runtimeGenerated = Boolean(this.socialRuntime && this.socialRuntime.last_loaded_at > 0);
-    const connected = this.socialFound && runtimeGenerated && !this.socialParseError;
-    const configured = connected && this.socialConfig.enabled;
-    const running = configured && this.broadcastEnabled;
+    const runtimeReady = this.socialFound && runtimeGenerated && !this.socialParseError;
+    const connected = runtimeReady && this.networkStarted;
+    const configured = runtimeReady && this.socialConfig.enabled;
+    const running = configured && this.broadcastEnabled && this.networkStarted;
     const publicEnabled = Boolean(this.profile?.public_enabled);
     const discoveryEnabled =
       this.socialConfig.discovery.discoverable &&
@@ -1388,6 +1423,8 @@ export class LocalNodeService {
       ? "running"
       : !configured
         ? "not configured"
+        : this.networkStartupError
+          ? this.networkStartupError
         : !this.broadcastEnabled
           ? "broadcast paused"
           : "not running";
@@ -3282,7 +3319,6 @@ export async function main() {
   const staticIndexFile = resolve(staticDir, "index.html");
 
   const node = new LocalNodeService();
-  await node.start();
 
   app.use(cors({ origin: true }));
   app.use(express.json());
@@ -3633,6 +3669,8 @@ export async function main() {
     console.log(`SilicaClaw local-console running: http://localhost:${port}`);
   });
 
+  await node.start();
+
   process.on("SIGINT", async () => {
     await node.stop();
     process.exit(0);

package/openclaw-skills/silicaclaw-broadcast/VERSION

@@ -1 +1 @@
-2026.3.19-beta.27
+2026.3.19-beta.29

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

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

package/scripts/silicaclaw-cli.mjs

@@ -478,10 +478,13 @@ function update() {
     if (hasNewTarget) {
       if (npxRuntime) {
         kv("Update", `next run will use ${targetVersion}`);
-      } else if (tryGlobalUpgrade(targetVersion)) {
-        kv("Update", `installed ${targetVersion}`);
       } else {
-        kv("Update", `install ${targetVersion} 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`);
+        }
       }
     }
 

package/scripts/silicaclaw-gateway.mjs

@@ -186,6 +186,8 @@ function syncManagedRuntime() {
     "apps/public-explorer/dist",
     "apps/public-explorer/package.json",
     "apps/public-explorer/public",
+    "social.md",
+    ".openclaw",
     "package.json",
     "package-lock.json",
     "VERSION",
@@ -637,6 +639,20 @@ async function waitForCurrentAppListener(port, kind, timeoutMs = 5000) {
   return lastListener;
 }
 
+async function waitForLocalConsoleHealth(timeoutMs = 8000) {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < timeoutMs) {
+    try {
+      const response = await fetch(`${LOCAL_CONSOLE_BASE_URL}/api/health`);
+      if (response.ok) return true;
+    } catch {
+      // ignore transient startup failures
+    }
+    await sleep(250);
+  }
+  return false;
+}
+
 async function waitForPortToClear(port, timeoutMs = 5000) {
   const startedAt = Date.now();
   while (Date.now() - startedAt < timeoutMs) {
@@ -867,6 +883,7 @@ async function startAll() {
       NETWORK_MODE: mode,
       WEBRTC_SIGNALING_URL: signalingUrl,
       WEBRTC_ROOM: room,
+      SILICACLAW_APP_DIR: APP_DIR,
       SILICACLAW_WORKSPACE_DIR: WORKSPACE_DIR,
     };
     localPid = spawnBackground(
@@ -996,7 +1013,8 @@ async function main() {
   if (cmd === "start") {
     await startAll();
     const listener = await waitForCurrentAppListener(LOCAL_CONSOLE_PORT, "local-console", 15000);
-    if (!listener || !isCurrentAppListener(listener, "local-console")) {
+    const healthy = listener ? await waitForLocalConsoleHealth(8000) : false;
+    if (!listener || !isCurrentAppListener(listener, "local-console") || !healthy) {
       headline();
       console.log("");
       kv("Status", paint("failed to start", COLOR.red));
@@ -1024,7 +1042,8 @@ async function main() {
   if (cmd === "restart") {
     await restartAll();
     const listener = await waitForCurrentAppListener(LOCAL_CONSOLE_PORT, "local-console", 15000);
-    if (!listener || !isCurrentAppListener(listener, "local-console")) {
+    const healthy = listener ? await waitForLocalConsoleHealth(8000) : false;
+    if (!listener || !isCurrentAppListener(listener, "local-console") || !healthy) {
       headline();
       console.log("");
       kv("Status", paint("failed to restart", COLOR.red));