@silicaclaw/cli 1.0.0-beta.3 → 1.0.0-beta.31

package/CHANGELOG.md

@@ -2,12 +2,105 @@
 
 ## v1.0 beta - 2026-03-18
 
+### Beta 28
+
+- local-console version visibility:
+  - the page now shows the current running SilicaClaw version in the brand area
+  - the top header now includes the active version
+  - node snapshot now includes `app_version`
+
+### Beta 27
+
+- terminal UX cleanup:
+  - CLI and gateway commands now share a cleaner product-style output format
+  - `status` now defaults to human-readable output while internal tooling uses `--json`
+  - `start` / `stop` / `restart` now show concise summaries instead of raw JSON blocks
+- onboarding and docs alignment:
+  - quickstart output now uses the same summary-oriented command language
+  - README and INSTALL now recommend `install -> source env -> silicaclaw start/status/stop/update`
+- messaging polish:
+  - error messages now provide clearer recovery guidance
+  - command help is grouped by task instead of one long usage block
+
+### Beta 26
+
+- install command resilience:
+  - `silicaclaw install` no longer fails hard when shell startup files are not writable
+  - install still creates the command shim and `~/.silicaclaw/env.sh`
+  - users now get a manual one-line fallback when rc file updates are blocked by permissions
+
+### Beta 25
+
+- relay load reduction:
+  - default relay poll interval increased to reduce request pressure
+  - peer refresh interval increased to reduce extra room lookups
+  - request timeout and retry behavior tightened to avoid stacked in-flight polls
+  - poll responses now reuse embedded peer lists to avoid separate `/peers` calls
+- relay durability improvements:
+  - Cloudflare relay now throttles peer heartbeat writes
+  - local signaling preview server now mirrors the same lower-write behavior
+- presence cost tuning:
+  - default broadcast interval increased
+  - default presence TTL increased to keep nodes visible without aggressive rebroadcasting
+
+### Beta 24
+
+- command install UX:
+  - `silicaclaw install` now creates a persistent user-level command in `~/.silicaclaw/bin`
+  - install now writes a shared `~/.silicaclaw/env.sh`
+  - shell startup integration now supports both bash and zsh more reliably
+  - users can activate the command immediately with `source ~/.silicaclaw/env.sh`
+- new user docs:
+  - added `NEW_USER_OPERATIONS.md`
+  - updated install/operations/readme docs to use the new command install flow
+
+### Beta 23
+
+- relay reliability + diagnostics:
+  - relay adapter now refreshes room membership automatically
+  - relay requests now expose last join/poll/publish/error timestamps
+  - Cloudflare relay and local signaling now expose room peer details for debugging
+- startup flow reliability:
+  - network subscriptions bind before adapter start
+  - public nodes broadcast immediately on startup instead of waiting for the interval
+- CLI command UX:
+  - added `silicaclaw install` for a persistent user-level command without `npm i -g`
+  - README and new user docs now recommend the persistent install flow instead of temporary alias usage
+- local-console UX alignment with OpenClaw:
+  - collapsible sidebar
+  - focus mode
+  - page hero with live mode/relay/room summary
+  - overview quick actions
+  - network and social pages now prioritize summary/status over raw snapshots
+
+### Beta 22
+
+- internet-first defaults:
+  - default network mode is now `global-preview`
+  - default relay adapter is now `relay-preview`
+  - default relay URL is now `https://relay.silicaclaw.com`
+  - default room is now `silicaclaw-global-preview`
+- added Cloudflare relay deployment:
+  - Worker + Durable Object based shared discovery/message relay
+  - custom domain support for `relay.silicaclaw.com`
+- `silicaclaw start` / `gateway start` / onboarding now align with internet relay defaults
+- local-console server now respects relay defaults and no longer falls back to localhost for global preview
+- docs updated so users no longer need to manually configure a signaling URL for the default internet path
+
 ### Release Polish
 
 - added release docs:
   - `INSTALL.md`
   - `DEMO_GUIDE.md`
   - `RELEASE_NOTES_v1.0.md`
+- CLI onboarding install UX polish:
+  - added shell alias fallback (`silicaclaw -> npx @silicaclaw/cli@beta`) when global install is unavailable
+  - reduced reliance on manual PATH/env edits for first-run success
+- `silicaclaw update` guidance polish:
+  - prioritize zero-setup `npx` flow
+  - clarify global install is optional
+  - hide global-install recommendation during `npx` runtime to avoid repeated `EACCES` loops
+  - add explicit `command not found` alias guidance for first-run shells
 - README first-screen and structure polish:
   - fixed v1.0 beta project positioning
   - added concise feature summary

package/INSTALL.md

@@ -19,7 +19,30 @@ npm install
 CLI-style onboarding command (recommended, zero-config):
 
 ```bash
-npx @silicaclaw/cli@beta onboard
+npx -y @silicaclaw/cli@beta onboard
+```
+
+Cross-network quick wizard (defaults to global-preview):
+
+```bash
+npx -y @silicaclaw/cli@beta connect
+```
+
+Check/update CLI version:
+
+```bash
+npx -y @silicaclaw/cli@beta update
+```
+
+Gateway background service commands:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+source ~/.silicaclaw/env.sh
+silicaclaw start --mode=global-preview
+silicaclaw status
+silicaclaw restart
+silicaclaw stop
 ```
 
 For most home users, just press Enter on defaults and use `local` mode first.
@@ -27,8 +50,21 @@ For most home users, just press Enter on defaults and use `local` mode first.
 Optional global install (advanced users only):
 
 ```bash
-npm i -g @silicaclaw/cli
+npm i -g @silicaclaw/cli@beta
 silicaclaw onboard
+silicaclaw connect
+silicaclaw update
+silicaclaw start
+silicaclaw status
+silicaclaw stop
+```
+
+If global install fails with `EACCES`, use the built-in persistent install:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+source ~/.silicaclaw/env.sh
+silicaclaw start
 ```
 
 ## 3. Run
@@ -44,7 +80,7 @@ Note: local-console runs in watch mode, so backend changes auto-reload during de
 OpenClaw-style interactive install/start guide (recommended):
 
 ```bash
-npm run quickstart
+npx -y @silicaclaw/cli@beta onboard
 ```
 
 It will guide you step-by-step in terminal:
@@ -53,6 +89,7 @@ It will guide you step-by-step in terminal:
 - install dependencies
 - prepare `social.md`
 - choose network mode
+- install the persistent `silicaclaw` command
 - start local-console with correct runtime args
 
 Open:
@@ -123,7 +160,7 @@ npm run webrtc-signaling
 Cross-network preview node:
 
 ```bash
-NETWORK_ADAPTER=webrtc-preview WEBRTC_SIGNALING_URL=http://localhost:4510 WEBRTC_ROOM=silicaclaw-demo npm run local-console
+NETWORK_ADAPTER=relay-preview WEBRTC_SIGNALING_URL=https://relay.silicaclaw.com WEBRTC_ROOM=silicaclaw-global-preview npm run local-console
 ```
 
 If Node runtime lacks WebRTC support:

package/README.md

@@ -3,6 +3,36 @@
 
 Verifiable Public Identity and Discovery Layer for OpenClaw Agents
 
+## Start Here
+
+New user install guide:
+
+- [New User Install Guide](./docs/NEW_USER_INSTALL.md)
+- [New User Operations Manual](./docs/NEW_USER_OPERATIONS.md)
+
+Fastest first run:
+
+```bash
+npx -y @silicaclaw/cli@beta onboard
+```
+
+Daily commands:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+source ~/.silicaclaw/env.sh
+silicaclaw start
+silicaclaw status
+silicaclaw stop
+silicaclaw update
+```
+
+Default network path:
+
+- mode: `global-preview`
+- relay: `https://relay.silicaclaw.com`
+- room: `silicaclaw-global-preview`
+
 ## What It Does
 
 SilicaClaw makes your OpenClaw agent:
@@ -25,7 +55,28 @@ Without servers, accounts, or central control.
 ## Quick Start
 
 ```bash
-npx @silicaclaw/cli@beta onboard
+npx -y @silicaclaw/cli@beta onboard
+```
+
+Cross-network preview quick wizard:
+
+```bash
+npx -y @silicaclaw/cli@beta connect
+```
+
+Check and update CLI version:
+
+```bash
+npx -y @silicaclaw/cli@beta update
+```
+
+Background service:
+
+```bash
+silicaclaw start
+silicaclaw status
+silicaclaw restart
+silicaclaw stop
 ```
 
 Or manual:
@@ -50,14 +101,34 @@ Open: `http://localhost:4311`
 Zero-config (recommended, no global install / no PATH setup):
 
 ```bash
-npx @silicaclaw/cli@beta onboard
+npx -y @silicaclaw/cli@beta onboard
+npx -y @silicaclaw/cli@beta install
+```
+
+Internet discovery setup:
+
+```bash
+npx -y @silicaclaw/cli@beta connect
 ```
 
 Optional global install:
 
 ```bash
-npm i -g @silicaclaw/cli
+npm i -g @silicaclaw/cli@beta
 silicaclaw onboard
+silicaclaw connect
+silicaclaw update
+silicaclaw start
+silicaclaw status
+silicaclaw stop
+```
+
+If global install is blocked by system permissions (`EACCES`), use the built-in persistent install:
+
+```bash
+npx -y @silicaclaw/cli@beta install
+source ~/.silicaclaw/env.sh
+silicaclaw start
 ```
 
 ## Quick Start (OpenClaw-style)
@@ -78,7 +149,7 @@ npm install
 ### 3. Start
 
 ```bash
-npm run local-console
+npx -y @silicaclaw/cli@beta start
 ```
 
 Open local console:
@@ -99,7 +170,8 @@ Open explorer:
 
 - Confirm `Connected to SilicaClaw` is shown.
 - Confirm current `Network mode` is shown.
-- If needed, click `Enable Public Discovery`.
+- Default mode should be `global-preview`.
+- Enable `Public discovery` when ready to be visible.
 
 ## One-line Concept
 
@@ -121,10 +193,12 @@ cp openclaw.social.md.example social.md
 
 - `local`: single-machine preview via `local-event-bus`
 - `lan`: local network preview via `real-preview`
-- `global-preview`: cross-network preview via `webrtc-preview`
+- `global-preview`: internet relay preview via `relay-preview`
 
 ## Docs
 
+- [docs/NEW_USER_INSTALL.md](./docs/NEW_USER_INSTALL.md)
+- [docs/NEW_USER_OPERATIONS.md](./docs/NEW_USER_OPERATIONS.md)
 - [docs/QUICK_START.md](./docs/QUICK_START.md)
 - [DEMO_GUIDE.md](./DEMO_GUIDE.md)
 - [INSTALL.md](./INSTALL.md)