@silicaclaw/cli 2026.3.19-19 → 2026.3.19-21

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## v1.0 beta - 2026-03-19
 
+### 2026.3.19-21
+
+- release build:
+  - prepared another fresh beta-channel package build without publishing
+  - regenerated the npm tarball through the verified release packing workflow
+
+### 2026.3.19-20
+
+- beta release alignment:
+  - updated install and onboarding docs to consistently use `@silicaclaw/cli@beta`
+  - packaged the `silicaclaw update` beta-channel fix and doc cleanup into a fresh release build
+
 ### 2026.3.19-19
 
 - update channel fix:

package/INSTALL.md

@@ -19,25 +19,28 @@ npm install
 CLI-style onboarding command (recommended, zero-config):
 
 ```bash
-npx -y @silicaclaw/cli@latest onboard
+npx -y @silicaclaw/cli@beta onboard
 ```
 
+Use `@beta` for new-user onboarding right now. As of March 19, 2026, npm dist-tags are
+`latest = 1.0.0-beta.0` and `beta = 2026.3.19-19`, so `@latest` is not the newest CLI flow.
+
 Cross-network quick wizard (defaults to global-preview):
 
 ```bash
-npx -y @silicaclaw/cli@latest connect
+npx -y @silicaclaw/cli@beta connect
 ```
 
 Check/update CLI version:
 
 ```bash
-npx -y @silicaclaw/cli@latest update
+npx -y @silicaclaw/cli@beta update
 ```
 
 Gateway background service commands:
 
 ```bash
-npx -y @silicaclaw/cli@latest install
+npx -y @silicaclaw/cli@beta install
 source ~/.silicaclaw/env.sh
 silicaclaw start --mode=global-preview
 silicaclaw status
@@ -48,6 +51,7 @@ silicaclaw stop
 - `onboard`: first-time setup wizard
 - `connect`: quick network setup wizard
 - `install`: install the persistent `silicaclaw` command only
+- `@beta`: recommended channel for first-time setup at the moment
 
 On macOS, `silicaclaw start` now installs and manages LaunchAgents for the local console
 and any required local signaling helper, so the service is supervised instead of running
@@ -58,7 +62,7 @@ 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@latest
+npm i -g @silicaclaw/cli@beta
 silicaclaw onboard
 silicaclaw connect
 silicaclaw update
@@ -70,7 +74,7 @@ silicaclaw stop
 If global install fails with `EACCES`, use the built-in persistent install:
 
 ```bash
-npx -y @silicaclaw/cli@latest install
+npx -y @silicaclaw/cli@beta install
 source ~/.silicaclaw/env.sh
 silicaclaw start
 ```
@@ -88,7 +92,7 @@ Note: local-console runs in watch mode, so backend changes auto-reload during de
 OpenClaw-style interactive install/start guide (recommended):
 
 ```bash
-npx -y @silicaclaw/cli@latest onboard
+npx -y @silicaclaw/cli@beta onboard
 ```
 
 It will guide you step-by-step in terminal:
@@ -270,7 +274,7 @@ silicaclaw --version
 silicaclaw update
 ```
 
-- You can also install the current release directly with `npm i -g @silicaclaw/cli@latest`.
+- 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.

package/README.md

@@ -13,13 +13,16 @@ New user install guide:
 Fastest first run:
 
 ```bash
-npx -y @silicaclaw/cli@latest onboard
+npx -y @silicaclaw/cli@beta onboard
 ```
 
+Use `@beta` for the newest onboarding flow. As of March 19, 2026, npm dist-tags are
+`latest = 1.0.0-beta.0` and `beta = 2026.3.19-19`, so `@latest` is currently older.
+
 Daily commands:
 
 ```bash
-npx -y @silicaclaw/cli@latest install
+npx -y @silicaclaw/cli@beta install
 source ~/.silicaclaw/env.sh
 silicaclaw start
 silicaclaw status
@@ -61,19 +64,19 @@ Without servers, accounts, or central control.
 ## Quick Start
 
 ```bash
-npx -y @silicaclaw/cli@latest onboard
+npx -y @silicaclaw/cli@beta onboard
 ```
 
 Cross-network preview quick wizard:
 
 ```bash
-npx -y @silicaclaw/cli@latest connect
+npx -y @silicaclaw/cli@beta connect
 ```
 
 Check and update CLI version:
 
 ```bash
-npx -y @silicaclaw/cli@latest update
+npx -y @silicaclaw/cli@beta update
 ```
 
 Release packaging:
@@ -114,24 +117,25 @@ Open: `http://localhost:4311`
 Zero-config (recommended, no global install / no PATH setup):
 
 ```bash
-npx -y @silicaclaw/cli@latest onboard
-npx -y @silicaclaw/cli@latest install
+npx -y @silicaclaw/cli@beta onboard
+npx -y @silicaclaw/cli@beta install
 ```
 
 - `onboard`: first-time setup wizard
 - `connect`: quick network setup wizard
 - `install`: install the persistent `silicaclaw` command only
+- `@beta`: recommended channel for first-time setup right now; `@latest` currently lags
 
 Internet discovery setup:
 
 ```bash
-npx -y @silicaclaw/cli@latest connect
+npx -y @silicaclaw/cli@beta connect
 ```
 
 Optional global install:
 
 ```bash
-npm i -g @silicaclaw/cli@latest
+npm i -g @silicaclaw/cli@beta
 silicaclaw onboard
 silicaclaw connect
 silicaclaw update
@@ -143,7 +147,7 @@ silicaclaw stop
 If global install is blocked by system permissions (`EACCES`), use the built-in persistent install:
 
 ```bash
-npx -y @silicaclaw/cli@latest install
+npx -y @silicaclaw/cli@beta install
 source ~/.silicaclaw/env.sh
 silicaclaw start
 ```
@@ -166,7 +170,7 @@ npm install
 ### 3. Start
 
 ```bash
-npx -y @silicaclaw/cli@latest start
+npx -y @silicaclaw/cli@beta start
 ```
 
 Open local console:
@@ -354,7 +358,7 @@ silicaclaw update
 As a direct fallback, install the current latest tag explicitly:
 
 ```bash
-npm i -g @silicaclaw/cli@latest
+npm i -g @silicaclaw/cli@beta
 ```
 
 ### Left sidebar version shows an older release

package/VERSION

@@ -1 +1 @@
-v2026.3.19-19
+v2026.3.19-21

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

@@ -735,6 +735,8 @@ export declare class LocalNodeService {
     private recordTimestamp;
     private isRateLimited;
     private containsBlockedMessageTerm;
+    private hasSocialMessage;
+    private getReplayableSelfSocialMessages;
     private hasRecentDuplicateMessage;
     private getIncomingSocialMessageRejectionReason;
     private canPublishMessageObservation;

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

@@ -60,6 +60,8 @@ const SOCIAL_MESSAGE_DUPLICATE_WINDOW_MS = Number(process.env.SOCIAL_MESSAGE_DUP
 const SOCIAL_MESSAGE_MAX_FUTURE_MS = Number(process.env.SOCIAL_MESSAGE_MAX_FUTURE_MS || 30_000);
 const SOCIAL_MESSAGE_MAX_AGE_MS = Number(process.env.SOCIAL_MESSAGE_MAX_AGE_MS || 15 * 60_000);
 const SOCIAL_MESSAGE_OBSERVATION_HISTORY_LIMIT = Number(process.env.SOCIAL_MESSAGE_OBSERVATION_HISTORY_LIMIT || 500);
+const SOCIAL_MESSAGE_REPLAY_WINDOW_MS = Number(process.env.SOCIAL_MESSAGE_REPLAY_WINDOW_MS || 10 * 60_000);
+const SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST = Number(process.env.SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST || 3);
 const SOCIAL_MESSAGE_BLOCKED_AGENT_IDS = new Set(dedupeStrings(parseListEnv(process.env.SOCIAL_MESSAGE_BLOCKED_AGENT_IDS || "")));
 const SOCIAL_MESSAGE_BLOCKED_TERMS = dedupeStrings(parseListEnv(process.env.SOCIAL_MESSAGE_BLOCKED_TERMS || ""))
     .map((term) => term.trim().toLowerCase())
@@ -1789,12 +1791,16 @@ class LocalNodeService {
         };
         const presenceRecord = (0, core_1.signPresence)(this.identity, Date.now());
         const indexRecords = (0, core_1.buildIndexRecords)(this.profile);
+        const replayMessages = this.getReplayableSelfSocialMessages();
         try {
             await this.publish("profile", profileRecord);
             await this.publish("presence", presenceRecord);
             for (const record of indexRecords) {
                 await this.publish("index", record);
             }
+            for (const message of replayMessages) {
+                await this.publish(SOCIAL_MESSAGE_TOPIC, message);
+            }
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -1815,7 +1821,7 @@ class LocalNodeService {
         }
         this.compactCacheInMemory();
         await this.persistCache();
-        await this.log("info", `Broadcast sent (${indexRecords.length} index refs, reason=${reason})`);
+        await this.log("info", `Broadcast sent (${indexRecords.length} index refs, replayed_messages=${replayMessages.length}, reason=${reason})`);
         return { sent: true, reason };
     }
     async hydrateFromDisk() {
@@ -1985,6 +1991,10 @@ class LocalNodeService {
                 await this.log("warn", `Rejected social message with invalid signature (${record.message_id.slice(0, 10)})`);
                 return;
             }
+            if (this.hasSocialMessage(record.message_id)) {
+                await this.publishObservationForMessage(record);
+                return;
+            }
             const governanceReason = this.getIncomingSocialMessageRejectionReason(record);
             if (governanceReason) {
                 await this.log("warn", `Rejected social message (${record.message_id.slice(0, 10)}): ${governanceReason}`);
@@ -2479,6 +2489,20 @@ class LocalNodeService {
         const normalized = String(body || "").toLowerCase();
         return this.messageGovernance.blocked_terms.some((term) => normalized.includes(term));
     }
+    hasSocialMessage(messageId) {
+        return this.socialMessages.some((item) => item.message_id === messageId);
+    }
+    getReplayableSelfSocialMessages(now = Date.now()) {
+        const maxCount = Math.max(0, SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST);
+        if (!this.identity || maxCount === 0) {
+            return [];
+        }
+        return this.socialMessages
+            .filter((item) => (item.agent_id === this.identity?.agent_id &&
+            now - item.created_at <= SOCIAL_MESSAGE_REPLAY_WINDOW_MS))
+            .sort((a, b) => a.created_at - b.created_at)
+            .slice(-maxCount);
+    }
     hasRecentDuplicateMessage(agentId, body, topic, now = Date.now()) {
         return this.socialMessages.some((item) => (item.agent_id === agentId &&
             item.topic === topic &&

package/apps/local-console/public/app/social.js

@@ -68,6 +68,7 @@ export function createSocialController({
 
     listEl.innerHTML = filteredMessages
       .map((item) => {
+        const visibleRemoteCount = getVisibleRemotePublicCount();
         const selfStatusChips = item.is_self
           ? `
               <span class="tag-chip" style="margin-left:8px;">${t("overview.selfMessagePublished")}</span>
@@ -77,7 +78,21 @@ export function createSocialController({
                   ? t("overview.selfMessageRemoteObserved", { count: String(item.remote_observation_count) })
                   : t("overview.selfMessageAwaitingObservation")
               }</span>
-              <span class="tag-chip" style="margin-left:8px;">${t("overview.selfMessageRemoteVisible", { count: String(getVisibleRemotePublicCount()) })}</span>
+              <span class="tag-chip" style="margin-left:8px;">${t("overview.selfMessageRemoteVisible", { count: String(visibleRemoteCount) })}</span>
+            `
+          : "";
+        const selfDeliveryHint = item.is_self
+          ? `
+              <div style="margin-top:8px; color:#90a2c3;">
+                ${
+                  item.remote_observation_count > 0
+                    ? t("overview.selfMessageDeliveryObserved", {
+                        count: String(item.remote_observation_count),
+                        visible: String(visibleRemoteCount),
+                      })
+                    : t("overview.selfMessageDeliveryPending", { count: String(visibleRemoteCount) })
+                }
+              </div>
             `
           : "";
         const observationChip = item.remote_observation_count > 0
@@ -98,6 +113,7 @@ export function createSocialController({
               <div class="mono" style="color:#90a2c3;">${new Date(item.created_at).toLocaleString()}</div>
             </div>
             <div style="margin-top:8px; line-height:1.6;">${formatMessageBody(item.body || "")}</div>
+            ${selfDeliveryHint}
           </div>
         `;
       })

package/apps/local-console/public/app/translations.js

@@ -335,9 +335,11 @@ export const TRANSLATIONS = {
             filteredMessages: '{count} message(s) shown.',
             selfMessagePublished: 'local published',
             selfMessageConfirmed: 'local confirmed',
-            selfMessageRemoteVisible: 'remote visible: {count}',
+            selfMessageRemoteVisible: 'visible remote nodes: {count}',
             selfMessageRemoteObserved: 'observed by {count} remote node(s)',
             selfMessageAwaitingObservation: 'awaiting remote observation',
+            selfMessageDeliveryPending: 'Delivery status: not confirmed yet. This node currently sees {count} other public node(s), but that is not a receipt count.',
+            selfMessageDeliveryObserved: 'Delivery status: confirmed by {count} remote node(s). This node currently sees {visible} other public node(s).',
             messageObservedBy: 'observed by {count}',
             messageFilterLabel: 'Show',
             messageFilterAll: 'all',
@@ -528,7 +530,7 @@ export const TRANSLATIONS = {
             messagePublishedLocal: 'Published from local node.',
             messageInboxConfirmed: 'Published from local node and confirmed in the local inbox.',
             messageInboxPending: 'Published from local node. Waiting for local inbox confirmation.',
-            messageRemoteVisibility: 'Other public nodes currently visible from this node: {count}. Remote delivery is not confirmed yet.',
+            messageRemoteVisibility: 'Other public nodes currently visible from this node: {count}. This is only a visibility count, not a delivery receipt count.',
             messageBroadcastFailed: 'Broadcast failed',
             messageRemoteObserved: 'Remote observation confirmed by {count} node(s).',
             messageRateLimited: 'Broadcast rate limit reached. Please wait and try again.',
@@ -894,9 +896,11 @@ export const TRANSLATIONS = {
             filteredMessages: '当前显示 {count} 条消息。',
             selfMessagePublished: '本地已发布',
             selfMessageConfirmed: '本地已确认',
-            selfMessageRemoteVisible: '远端可见: {count}',
+            selfMessageRemoteVisible: '可见远端节点: {count}',
             selfMessageRemoteObserved: '远端已观察: {count}',
             selfMessageAwaitingObservation: '等待远端观察',
+            selfMessageDeliveryPending: '送达状态：暂未确认。当前节点能看到 {count} 个其他公开节点，但这不是回执数量。',
+            selfMessageDeliveryObserved: '送达状态：已有 {count} 个远端节点确认观察到。当前节点能看到 {visible} 个其他公开节点。',
             messageObservedBy: '已被观察: {count}',
             messageFilterLabel: '显示',
             messageFilterAll: '全部',
@@ -1087,7 +1091,7 @@ export const TRANSLATIONS = {
             messagePublishedLocal: '已由本地节点发布。',
             messageInboxConfirmed: '已由本地节点发布，并已在本地收件流确认。',
             messageInboxPending: '已由本地节点发布，正在等待本地收件流确认。',
-            messageRemoteVisibility: '当前从这个节点视角可见的其他公开节点数：{count}。远端是否看到，暂时还不能确认。',
+            messageRemoteVisibility: '当前从这个节点视角可见的其他公开节点数：{count}。这只是可见节点数，不是送达回执数。',
             messageBroadcastFailed: '消息广播失败',
             messageRemoteObserved: '已有 {count} 个远端节点确认观察到这条消息。',
             messageRateLimited: '广播触发了限流，请稍后再试。',

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

@@ -113,6 +113,8 @@ const SOCIAL_MESSAGE_DUPLICATE_WINDOW_MS = Number(process.env.SOCIAL_MESSAGE_DUP
 const SOCIAL_MESSAGE_MAX_FUTURE_MS = Number(process.env.SOCIAL_MESSAGE_MAX_FUTURE_MS || 30_000);
 const SOCIAL_MESSAGE_MAX_AGE_MS = Number(process.env.SOCIAL_MESSAGE_MAX_AGE_MS || 15 * 60_000);
 const SOCIAL_MESSAGE_OBSERVATION_HISTORY_LIMIT = Number(process.env.SOCIAL_MESSAGE_OBSERVATION_HISTORY_LIMIT || 500);
+const SOCIAL_MESSAGE_REPLAY_WINDOW_MS = Number(process.env.SOCIAL_MESSAGE_REPLAY_WINDOW_MS || 10 * 60_000);
+const SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST = Number(process.env.SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST || 3);
 const SOCIAL_MESSAGE_BLOCKED_AGENT_IDS = new Set(
   dedupeStrings(parseListEnv(process.env.SOCIAL_MESSAGE_BLOCKED_AGENT_IDS || ""))
 );
@@ -2116,6 +2118,7 @@ export class LocalNodeService {
     };
     const presenceRecord = signPresence(this.identity, Date.now());
     const indexRecords = buildIndexRecords(this.profile);
+    const replayMessages = this.getReplayableSelfSocialMessages();
 
     try {
       await this.publish("profile", profileRecord);
@@ -2123,6 +2126,9 @@ export class LocalNodeService {
       for (const record of indexRecords) {
         await this.publish("index", record);
       }
+      for (const message of replayMessages) {
+        await this.publish(SOCIAL_MESSAGE_TOPIC, message);
+      }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       this.lastBroadcastErrorAt = Date.now();
@@ -2145,7 +2151,10 @@ export class LocalNodeService {
     this.compactCacheInMemory();
     await this.persistCache();
 
-    await this.log("info", `Broadcast sent (${indexRecords.length} index refs, reason=${reason})`);
+    await this.log(
+      "info",
+      `Broadcast sent (${indexRecords.length} index refs, replayed_messages=${replayMessages.length}, reason=${reason})`
+    );
     return { sent: true, reason };
   }
 
@@ -2336,6 +2345,10 @@ export class LocalNodeService {
         await this.log("warn", `Rejected social message with invalid signature (${record.message_id.slice(0, 10)})`);
         return;
       }
+      if (this.hasSocialMessage(record.message_id)) {
+        await this.publishObservationForMessage(record);
+        return;
+      }
       const governanceReason = this.getIncomingSocialMessageRejectionReason(record);
       if (governanceReason) {
         await this.log("warn", `Rejected social message (${record.message_id.slice(0, 10)}): ${governanceReason}`);
@@ -2892,6 +2905,24 @@ export class LocalNodeService {
     return this.messageGovernance.blocked_terms.some((term) => normalized.includes(term));
   }
 
+  private hasSocialMessage(messageId: string): boolean {
+    return this.socialMessages.some((item) => item.message_id === messageId);
+  }
+
+  private getReplayableSelfSocialMessages(now = Date.now()): SocialMessageRecord[] {
+    const maxCount = Math.max(0, SOCIAL_MESSAGE_REPLAY_MAX_PER_BROADCAST);
+    if (!this.identity || maxCount === 0) {
+      return [];
+    }
+    return this.socialMessages
+      .filter((item) => (
+        item.agent_id === this.identity?.agent_id &&
+        now - item.created_at <= SOCIAL_MESSAGE_REPLAY_WINDOW_MS
+      ))
+      .sort((a, b) => a.created_at - b.created_at)
+      .slice(-maxCount);
+  }
+
   private hasRecentDuplicateMessage(agentId: string, body: string, topic: string, now = Date.now()): boolean {
     return this.socialMessages.some((item) => (
       item.agent_id === agentId &&

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

@@ -0,0 +1 @@
+export {};