@silicaclaw/cli 1.0.0-beta.0

package/packages/network/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}

package/packages/storage/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@silicaclaw/storage",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@silicaclaw/core": "0.1.0"
+  }
+}

package/packages/storage/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./jsonRepo";
+export * from "./repos";
+export * from "./socialRuntimeRepo";

package/packages/storage/src/jsonRepo.ts

@@ -0,0 +1,25 @@
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { dirname } from "path";
+
+export class JsonFileRepo<T> {
+  constructor(
+    private filePath: string,
+    private fallback: () => T
+  ) {}
+
+  async get(): Promise<T> {
+    try {
+      const raw = await readFile(this.filePath, "utf8");
+      return JSON.parse(raw) as T;
+    } catch {
+      const seed = this.fallback();
+      await this.set(seed);
+      return seed;
+    }
+  }
+
+  async set(value: T): Promise<void> {
+    await mkdir(dirname(this.filePath), { recursive: true });
+    await writeFile(this.filePath, JSON.stringify(value, null, 2), "utf8");
+  }
+}

package/packages/storage/src/repos.ts

@@ -0,0 +1,46 @@
+import { resolve } from "path";
+import { AgentIdentity, DirectoryState, PublicProfile, createEmptyDirectoryState } from "@silicaclaw/core";
+import { JsonFileRepo } from "./jsonRepo";
+
+export type LogEntry = {
+  id: string;
+  level: "info" | "warn" | "error";
+  message: string;
+  timestamp: number;
+};
+
+export class IdentityRepo extends JsonFileRepo<AgentIdentity | null> {
+  constructor(rootDir = process.cwd()) {
+    super(resolve(rootDir, "data", "identity.json"), () => null);
+  }
+}
+
+export class ProfileRepo extends JsonFileRepo<PublicProfile | null> {
+  constructor(rootDir = process.cwd()) {
+    super(resolve(rootDir, "data", "profile.json"), () => null);
+  }
+}
+
+export class CacheRepo extends JsonFileRepo<DirectoryState> {
+  constructor(rootDir = process.cwd()) {
+    super(resolve(rootDir, "data", "cache.json"), () => createEmptyDirectoryState());
+  }
+}
+
+export class LogRepo extends JsonFileRepo<LogEntry[]> {
+  constructor(rootDir = process.cwd()) {
+    super(resolve(rootDir, "data", "logs.json"), () => []);
+  }
+
+  async append(entry: Omit<LogEntry, "id">): Promise<void> {
+    const current = await this.get();
+    const next = [
+      {
+        id: `${entry.timestamp}-${Math.random().toString(36).slice(2, 8)}`,
+        ...entry,
+      },
+      ...current,
+    ].slice(0, 50);
+    await this.set(next);
+  }
+}

package/packages/storage/src/socialRuntimeRepo.ts

@@ -0,0 +1,51 @@
+import { resolve } from "path";
+import { SocialRuntimeConfig } from "@silicaclaw/core";
+import { JsonFileRepo } from "./jsonRepo";
+
+function emptyRuntime(): SocialRuntimeConfig {
+  return {
+    enabled: true,
+    public_enabled: false,
+    source_path: null,
+    last_loaded_at: 0,
+    social_found: false,
+    parse_error: null,
+    resolved_identity: null,
+    resolved_profile: null,
+    resolved_network: {
+      mode: "lan",
+      adapter: "real-preview",
+      namespace: "silicaclaw.preview",
+      port: null,
+      signaling_url: "http://localhost:4510",
+      signaling_urls: [],
+      room: "silicaclaw-room",
+      seed_peers: [],
+      bootstrap_hints: [],
+      bootstrap_sources: [],
+    },
+    resolved_discovery: {
+      discoverable: true,
+      allow_profile_broadcast: true,
+      allow_presence_broadcast: true,
+    },
+    visibility: {
+      show_display_name: true,
+      show_bio: true,
+      show_tags: true,
+      show_agent_id: true,
+      show_last_seen: true,
+      show_capabilities_summary: true,
+    },
+    openclaw: {
+      bind_existing_identity: true,
+      use_openclaw_profile_if_available: true,
+    },
+  };
+}
+
+export class SocialRuntimeRepo extends JsonFileRepo<SocialRuntimeConfig> {
+  constructor(rootDir = process.cwd()) {
+    super(resolve(rootDir, ".silicaclaw", "social.runtime.json"), emptyRuntime);
+  }
+}

package/packages/storage/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}

package/scripts/functional-check.mjs

@@ -0,0 +1,165 @@
+import { readFileSync, existsSync } from 'node:fs';
+import vm from 'node:vm';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function checkJson(filePath) {
+  const raw = readFileSync(filePath, 'utf8');
+  JSON.parse(raw);
+}
+
+function checkInlineScriptSyntax(htmlPath) {
+  const html = readFileSync(htmlPath, 'utf8');
+  const start = html.indexOf('<script>');
+  const end = html.lastIndexOf('</script>');
+  assert(start >= 0 && end > start, `Missing inline script in ${htmlPath}`);
+  const js = html.slice(start + '<script>'.length, end);
+  new vm.Script(js, { filename: htmlPath });
+}
+
+class InMemoryLoopbackTransport {
+  constructor() {
+    this.handlers = new Set();
+    this.started = false;
+  }
+  async start() { this.started = true; }
+  async stop() { this.started = false; }
+  async send(data) {
+    if (!this.started) return;
+    for (const h of this.handlers) {
+      h(data, { remote_address: '127.0.0.1', remote_port: 0, transport: 'in-memory' });
+    }
+  }
+  onMessage(handler) {
+    this.handlers.add(handler);
+    return () => this.handlers.delete(handler);
+  }
+  inject(data) {
+    for (const h of this.handlers) {
+      h(data, { remote_address: '192.168.1.88', remote_port: 44123, transport: 'in-memory' });
+    }
+  }
+}
+
+async function main() {
+  const root = process.cwd();
+
+  const criticalFiles = [
+    'README.md',
+    'ARCHITECTURE.md',
+    'ROADMAP.md',
+    'CHANGELOG.md',
+    'VERSION',
+    'apps/local-console/public/index.html',
+    'apps/public-explorer/public/index.html',
+    'data/cache.json',
+    'data/profile.json',
+    'data/identity.json',
+    'data/logs.json',
+  ];
+
+  for (const rel of criticalFiles) {
+    const abs = path.resolve(root, rel);
+    assert(existsSync(abs), `Missing required file: ${rel}`);
+  }
+
+  // JSON file sanity
+  checkJson(path.resolve(root, 'data/cache.json'));
+  checkJson(path.resolve(root, 'data/logs.json'));
+  checkJson(path.resolve(root, 'data/profile.json'));
+  checkJson(path.resolve(root, 'data/identity.json'));
+
+  // Browser script syntax sanity
+  checkInlineScriptSyntax(path.resolve(root, 'apps/local-console/public/index.html'));
+  checkInlineScriptSyntax(path.resolve(root, 'apps/public-explorer/public/index.html'));
+
+  // Import built modules (requires npm run build)
+  const core = await import(pathToFileURL(path.resolve(root, 'packages/core/dist/index.js')).href);
+  const network = await import(pathToFileURL(path.resolve(root, 'packages/network/dist/index.js')).href);
+
+  // Core smoke: identity/profile/presence
+  const identity = core.createIdentity();
+  assert(identity.agent_id && identity.public_key && identity.private_key, 'Identity generation failed');
+
+  const profile = core.signProfile({
+    agent_id: identity.agent_id,
+    display_name: 'demo-agent',
+    bio: 'smoke',
+    tags: ['ai', 'lan'],
+    avatar_url: '',
+    public_enabled: true,
+  }, identity);
+  assert(core.verifyProfile(profile, identity.public_key), 'Profile signature verification failed');
+
+  const presence = core.signPresence(identity);
+  assert(core.verifyPresence(presence, identity.public_key), 'Presence signature verification failed');
+
+  // Core smoke: index + search + TTL
+  let state = core.createEmptyDirectoryState();
+  state = core.ingestProfileRecord(state, { type: 'profile', profile });
+  state = core.ingestPresenceRecord(state, presence);
+  const searchHit = core.searchDirectory(state, 'ai');
+  assert(searchHit.length >= 1, 'Directory search failed for tag index');
+
+  const cleaned = core.cleanupExpiredPresence(state, Date.now() + 999_999, 1000);
+  assert(cleaned.removed >= 1, 'Presence cleanup failed');
+
+  // Real preview adapter smoke with in-memory transport
+  const transport = new InMemoryLoopbackTransport();
+  const adapter = new network.RealNetworkAdapterPreview({
+    transport,
+    namespace: 'smoke.ns',
+    maxMessageBytes: 4 * 1024,
+    dedupeWindowMs: 60_000,
+  });
+
+  let receivedCount = 0;
+  adapter.subscribe('profile', () => {
+    receivedCount += 1;
+  });
+
+  await adapter.start();
+
+  // Self publish should not deliver (self-message filter)
+  await adapter.publish('profile', { hello: 'self' });
+
+  // Inject remote envelope
+  const codec = new network.JsonMessageEnvelopeCodec();
+  const remoteEnvelope = {
+    version: 1,
+    message_id: 'msg-1',
+    topic: 'smoke.ns:profile',
+    source_peer_id: 'remote-peer-1',
+    timestamp: Date.now(),
+    payload: { hello: 'remote' },
+  };
+  transport.inject(codec.encode(remoteEnvelope));
+  transport.inject(codec.encode(remoteEnvelope)); // duplicate
+
+  // Namespace mismatch should be dropped
+  transport.inject(codec.encode({ ...remoteEnvelope, message_id: 'msg-2', topic: 'other.ns:profile' }));
+
+  // Malformed should be dropped
+  transport.inject(Buffer.from('{not-json'));
+
+  await new Promise((r) => setTimeout(r, 20));
+
+  const diagnostics = adapter.getDiagnostics();
+  assert(receivedCount === 1, 'Dedup/self filter behavior unexpected');
+  assert(diagnostics.stats.dropped_duplicate >= 1, 'Expected duplicate drop counter');
+  assert(diagnostics.stats.dropped_namespace_mismatch >= 1, 'Expected namespace mismatch drop counter');
+  assert(diagnostics.stats.dropped_malformed >= 1, 'Expected malformed drop counter');
+
+  await adapter.stop();
+
+  console.log('Functional check passed: core + network preview + UI script syntax + data sanity');
+}
+
+main().catch((error) => {
+  console.error('Functional check failed:', error.message);
+  process.exit(1);
+});

package/scripts/install-logo.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ "${1:-}" = "" ]; then
+  echo "Usage: npm run logo -- /absolute/path/to/logo.png"
+  exit 1
+fi
+
+SRC="$1"
+if [ ! -f "$SRC" ]; then
+  echo "Logo file not found: $SRC"
+  exit 1
+fi
+
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+TARGETS=(
+  "$ROOT_DIR/apps/local-console/public/assets/silicaclaw-logo.png"
+  "$ROOT_DIR/apps/public-explorer/public/assets/silicaclaw-logo.png"
+  "$ROOT_DIR/docs/assets/silicaclaw-logo.png"
+)
+OG_TARGET="$ROOT_DIR/docs/assets/silicaclaw-og.png"
+
+mkdir -p \
+  "$ROOT_DIR/apps/local-console/public/assets" \
+  "$ROOT_DIR/apps/public-explorer/public/assets" \
+  "$ROOT_DIR/docs/assets"
+
+for t in "${TARGETS[@]}"; do
+  if [ "$SRC" -ef "$t" ] 2>/dev/null; then
+    echo "Skipped (same file) -> $t"
+    continue
+  fi
+  if [ -f "$t" ] && cmp -s "$SRC" "$t"; then
+    echo "Skipped (identical content) -> $t"
+    continue
+  fi
+  cp "$SRC" "$t"
+  echo "Copied logo -> $t"
+done
+
+if command -v sips >/dev/null 2>&1; then
+  if sips -z 630 1200 "$SRC" --out "$OG_TARGET" >/dev/null 2>&1; then
+    echo "Generated OG image -> $OG_TARGET (1200x630)"
+  else
+    cp "$SRC" "$OG_TARGET"
+    echo "OG resize failed, copied source -> $OG_TARGET"
+  fi
+else
+  cp "$SRC" "$OG_TARGET"
+  echo "sips not found, copied source as OG -> $OG_TARGET"
+fi
+
+echo "Done. Refresh local-console/public-explorer pages to see the new logo + favicon."

package/scripts/quickstart.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT_DIR"
+
+STEP=1
+
+line() {
+  printf '\n%s\n' "------------------------------------------------------------"
+}
+
+title() {
+  line
+  printf '[Step %s] %s\n' "$STEP" "$1"
+  STEP=$((STEP + 1))
+}
+
+run_cmd() {
+  local cmd="$1"
+  printf '→ %s\n' "$cmd"
+  eval "$cmd"
+}
+
+ask_yes_no() {
+  local prompt="$1"
+  local default="${2:-Y}"
+  local answer
+  if [ "$default" = "Y" ]; then
+    read -r -p "$prompt [Y/n]: " answer || true
+    answer="${answer:-Y}"
+  else
+    read -r -p "$prompt [y/N]: " answer || true
+    answer="${answer:-N}"
+  fi
+  case "$answer" in
+    Y|y) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+pause_continue() {
+  read -r -p "按回车继续..." _ || true
+}
+
+title "SilicaClaw Quick Start 启动"
+echo "目录: $ROOT_DIR"
+echo "目标: 用终端一步步完成安装与启动（类似 OpenClaw Quick Start）"
+pause_continue
+
+title "检查 Node.js / npm"
+if ! command -v node >/dev/null 2>&1; then
+  echo "未找到 node，请先安装 Node.js 18+"
+  exit 1
+fi
+if ! command -v npm >/dev/null 2>&1; then
+  echo "未找到 npm，请先安装 npm 9+"
+  exit 1
+fi
+
+NODE_VER="$(node -p "process.versions.node")"
+NPM_VER="$(npm -v)"
+echo "node: $NODE_VER"
+echo "npm : $NPM_VER"
+
+if ! node -e "const v=process.versions.node.split('.').map(Number); if (v[0] < 18) process.exit(1)"; then
+  echo "Node.js 版本过低，请升级到 18+"
+  exit 1
+fi
+
+title "安装依赖"
+if [ ! -d "$ROOT_DIR/node_modules" ]; then
+  run_cmd "npm install"
+else
+  if ask_yes_no "检测到 node_modules，是否仍执行 npm install 同步依赖？" "N"; then
+    run_cmd "npm install"
+  else
+    echo "跳过 npm install"
+  fi
+fi
+
+title "准备 social.md"
+if [ -f "$ROOT_DIR/social.md" ]; then
+  echo "已存在 social.md，保留现有配置。"
+else
+  if ask_yes_no "未找到 social.md，是否自动从 social.md.example 生成？" "Y"; then
+    run_cmd "cp social.md.example social.md"
+    echo "已生成: $ROOT_DIR/social.md"
+  else
+    echo "跳过生成 social.md（local-console 首启也会自动生成最小模板）"
+  fi
+fi
+
+title "选择网络模式"
+echo "1) local           单机预览（最快）"
+echo "2) lan             局域网预览（A/B 双机）"
+echo "3) global-preview  非局域网预览（WebRTC）"
+read -r -p "请输入模式编号 [1/2/3] (默认 1): " MODE_PICK || true
+MODE_PICK="${MODE_PICK:-1}"
+
+NETWORK_MODE="local"
+NETWORK_ADAPTER="local-event-bus"
+WEBRTC_SIGNALING_URL_VALUE=""
+WEBRTC_ROOM_VALUE="silicaclaw-demo"
+
+case "$MODE_PICK" in
+  2)
+    NETWORK_MODE="lan"
+    NETWORK_ADAPTER="real-preview"
+    ;;
+  3)
+    NETWORK_MODE="global-preview"
+    NETWORK_ADAPTER="webrtc-preview"
+    read -r -p "请输入 signaling URL（例如 http://your-server:4510）: " WEBRTC_SIGNALING_URL_VALUE
+    if [ -z "${WEBRTC_SIGNALING_URL_VALUE:-}" ]; then
+      echo "global-preview 必须提供 signaling URL"
+      exit 1
+    fi
+    read -r -p "请输入 room（默认 silicaclaw-demo）: " WEBRTC_ROOM_VALUE_INPUT || true
+    WEBRTC_ROOM_VALUE="${WEBRTC_ROOM_VALUE_INPUT:-silicaclaw-demo}"
+    ;;
+  *)
+    NETWORK_MODE="local"
+    NETWORK_ADAPTER="local-event-bus"
+    ;;
+esac
+
+echo "已选择: $NETWORK_MODE ($NETWORK_ADAPTER)"
+
+title "启动 local-console"
+if [ "$NETWORK_MODE" = "global-preview" ]; then
+  echo "将使用以下参数启动："
+  echo "NETWORK_ADAPTER=$NETWORK_ADAPTER"
+  echo "WEBRTC_SIGNALING_URL=$WEBRTC_SIGNALING_URL_VALUE"
+  echo "WEBRTC_ROOM=$WEBRTC_ROOM_VALUE"
+  pause_continue
+  run_cmd "NETWORK_ADAPTER=$NETWORK_ADAPTER WEBRTC_SIGNALING_URL=$WEBRTC_SIGNALING_URL_VALUE WEBRTC_ROOM=$WEBRTC_ROOM_VALUE npm run local-console"
+else
+  echo "将使用以下参数启动："
+  echo "NETWORK_ADAPTER=$NETWORK_ADAPTER"
+  pause_continue
+  run_cmd "NETWORK_ADAPTER=$NETWORK_ADAPTER npm run local-console"
+fi
+

package/scripts/silicaclaw-cli.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT_DIR = resolve(__dirname, "..");
+
+function run(cmd, args, extra = {}) {
+  const result = spawnSync(cmd, args, {
+    cwd: ROOT_DIR,
+    stdio: "inherit",
+    env: process.env,
+    ...extra,
+  });
+  if (result.error) {
+    console.error(`[silicaclaw] failed to run ${cmd}: ${result.error.message}`);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 0);
+}
+
+function readVersion() {
+  const versionFile = resolve(ROOT_DIR, "VERSION");
+  if (!existsSync(versionFile)) return "unknown";
+  return readFileSync(versionFile, "utf8").trim() || "unknown";
+}
+
+function help() {
+  console.log(`
+SilicaClaw CLI
+
+Usage:
+  silicaclaw onboard
+  silicaclaw local-console
+  silicaclaw explorer
+  silicaclaw signaling
+  silicaclaw doctor
+  silicaclaw version
+  silicaclaw help
+
+Commands:
+  onboard        Interactive step-by-step onboarding (recommended)
+  local-console  Start local console (http://localhost:4310)
+  explorer       Start public explorer (http://localhost:4311)
+  signaling      Start WebRTC signaling preview server
+  doctor         Run project checks (npm run health)
+  version        Print SilicaClaw version
+  help           Show this help
+`.trim());
+}
+
+const cmd = String(process.argv[2] || "help").trim().toLowerCase();
+
+switch (cmd) {
+  case "onboard":
+    run("bash", [resolve(ROOT_DIR, "scripts", "quickstart.sh")]);
+    break;
+  case "local-console":
+  case "console":
+    run("npm", ["run", "local-console"]);
+    break;
+  case "explorer":
+  case "public-explorer":
+    run("npm", ["run", "public-explorer"]);
+    break;
+  case "signaling":
+  case "webrtc-signaling":
+    run("npm", ["run", "webrtc-signaling"]);
+    break;
+  case "doctor":
+    run("npm", ["run", "health"]);
+    break;
+  case "version":
+  case "-v":
+  case "--version":
+    console.log(readVersion());
+    break;
+  case "help":
+  case "-h":
+  case "--help":
+  default:
+    help();
+    break;
+}