@silicaclaw/cli 1.0.0-beta.15 → 1.0.0-beta.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "1.0.0-beta.15",
+  "version": "1.0.0-beta.17",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/silicaclaw-cli.mjs

@@ -87,31 +87,28 @@ function showUpdateGuide(current, latest, beta) {
     console.log("Update available.");
   }
   console.log("");
-  console.log("Recommended commands:");
-  console.log("1) npx mode (recommended, zero setup)");
-  console.log("   npx @silicaclaw/cli@beta onboard");
-  console.log("   npx @silicaclaw/cli@beta connect");
-  console.log("   npx @silicaclaw/cli@beta update");
-  console.log("");
-  console.log("2) shell alias mode (no global install / no PATH edits)");
-  console.log("   alias silicaclaw='npx -y @silicaclaw/cli@beta'");
-  console.log("   silicaclaw version");
+  console.log("Quick next commands:");
+  console.log("1) Start local gateway");
+  console.log("   silicaclaw gateway start --mode=local");
+  console.log("2) Check gateway status");
+  console.log("   silicaclaw gateway status");
+  console.log("3) npx one-shot (no alias/global install)");
+  console.log("   npx -y @silicaclaw/cli@beta gateway start --mode=local");
   console.log("");
+
   const writableGlobal = canWriteGlobalPrefix();
   if (!npxRuntime && writableGlobal) {
-    console.log("3) global install mode (optional)");
+    console.log("Optional global install:");
     console.log("   npm i -g @silicaclaw/cli@beta");
     console.log("   silicaclaw version");
     console.log("");
   } else if (!npxRuntime) {
-    console.log("Global install skipped: current npm global directory is not writable (likely EACCES).");
-    console.log("Use npx or alias mode above.");
+    console.log("Global install skipped: npm global directory is not writable (likely EACCES).");
     console.log("");
   }
   if (npxRuntime) {
-    console.log("Detected npx runtime: use npx commands above for immediate update.");
-    console.log("If `silicaclaw: command not found`, run:");
-    console.log("alias silicaclaw='npx -y @silicaclaw/cli@beta'");
+    console.log("Detected npx runtime.");
+    console.log("If `silicaclaw` is unavailable in this shell, use the npx one-shot command above.");
   }
 }
 
@@ -146,6 +143,11 @@ Usage:
   silicaclaw onboard
   silicaclaw connect
   silicaclaw update
+  silicaclaw start [--mode=local|lan|global-preview]
+  silicaclaw stop
+  silicaclaw restart [--mode=local|lan|global-preview]
+  silicaclaw status
+  silicaclaw logs [local-console|signaling]
   silicaclaw gateway <start|stop|restart|status|logs>
   silicaclaw local-console
   silicaclaw explorer
@@ -158,6 +160,11 @@ Commands:
   onboard        Interactive step-by-step onboarding (recommended)
   connect        Cross-network connect wizard (global-preview first)
   update         Check latest npm version and show upgrade commands
+  start          Start gateway-managed background services
+  stop           Stop gateway-managed background services
+  restart        Restart gateway-managed background services
+  status         Show gateway-managed service status
+  logs           Show gateway-managed service logs
   gateway        Manage background services (start/stop/restart/status/logs)
   local-console  Start local console (http://localhost:4310)
   explorer       Start public explorer (http://localhost:4311)
@@ -191,6 +198,15 @@ switch (cmd) {
       cwd: process.cwd(),
     });
     break;
+  case "start":
+  case "stop":
+  case "restart":
+  case "status":
+  case "logs":
+    run("node", [resolve(ROOT_DIR, "scripts", "silicaclaw-gateway.mjs"), cmd, ...process.argv.slice(3)], {
+      cwd: process.cwd(),
+    });
+    break;
   case "local-console":
   case "console":
     run("npm", ["run", "local-console"]);

package/scripts/silicaclaw-gateway.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
@@ -13,6 +13,25 @@ const ROOT_DIR = resolve(__dirname, "..");
 const argv = process.argv.slice(2);
 const cmd = String(argv[0] || "help").toLowerCase();
 
+function readJson(file) {
+  try {
+    return JSON.parse(String(readFileSync(file, "utf8")));
+  } catch {
+    return null;
+  }
+}
+
+function isSilicaClawDir(dir) {
+  const pkgPath = join(dir, "package.json");
+  if (!existsSync(pkgPath)) return false;
+  const pkg = readJson(pkgPath);
+  if (!pkg || typeof pkg !== "object") return false;
+  const name = String(pkg.name || "");
+  if (name === "@silicaclaw/cli" || name === "silicaclaw") return true;
+  const scripts = pkg.scripts && typeof pkg.scripts === "object" ? pkg.scripts : {};
+  return Boolean(scripts.gateway || scripts["local-console"] || scripts["public-explorer"]);
+}
+
 function parseFlag(name, fallback = "") {
   const prefix = `--${name}=`;
   for (const item of argv) {
@@ -27,17 +46,17 @@ function hasFlag(name) {
 
 function detectAppDir() {
   const envDir = process.env.SILICACLAW_APP_DIR;
-  if (envDir && existsSync(join(envDir, "package.json"))) {
+  if (envDir && isSilicaClawDir(envDir)) {
     return resolve(envDir);
   }
 
   const cwd = process.cwd();
-  if (existsSync(join(cwd, "package.json"))) {
+  if (isSilicaClawDir(cwd)) {
     return resolve(cwd);
   }
 
   const homeCandidate = join(homedir(), "silicaclaw");
-  if (existsSync(join(homeCandidate, "package.json"))) {
+  if (isSilicaClawDir(homeCandidate)) {
     return resolve(homeCandidate);
   }
 
@@ -193,6 +212,74 @@ function showStatus() {
     updated_at: state?.updated_at || null,
   };
   console.log(JSON.stringify(payload, null, 2));
+  return payload;
+}
+
+function printConnectionSummary(status) {
+  if (!status?.local_console?.running) return;
+  console.log("");
+  console.log("Gateway connection summary:");
+  console.log(`- local-console: http://localhost:4310`);
+  console.log(`- mode: ${status.mode}`);
+  console.log(`- adapter: ${status.adapter}`);
+  if (status.mode === "global-preview") {
+    const signalingUrl = status?.signaling?.url || "http://localhost:4510";
+    const room = status?.signaling?.room || "silicaclaw-demo";
+    console.log(`- signaling: ${signalingUrl} (room=${room})`);
+  }
+  console.log(`- local-console log: ${status?.local_console?.log_file || CONSOLE_LOG_FILE}`);
+  console.log(`- status: silicaclaw gateway status`);
+  console.log(`- logs:   silicaclaw gateway logs local-console`);
+  console.log(`- stop:   silicaclaw gateway stop`);
+}
+
+function listeningProcessOnPort(port) {
+  try {
+    const pidRes = spawnSync("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
+    const pid = String(pidRes.stdout || "")
+      .split(/\r?\n/)
+      .map((s) => s.trim())
+      .find(Boolean);
+    if (!pid) return null;
+
+    const cmdRes = spawnSync("ps", ["-p", pid, "-o", "command="], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
+    const command = String(cmdRes.stdout || "").trim() || "unknown";
+    return { pid, command };
+  } catch {
+    return null;
+  }
+}
+
+function printStopSummary() {
+  const localListener = listeningProcessOnPort(4310);
+  const signalingListener = listeningProcessOnPort(4510);
+  console.log("");
+  console.log("Gateway stop summary:");
+  if (!localListener) {
+    console.log("- local-console port 4310: stopped");
+  } else {
+    console.log(`- local-console port 4310: still in use by pid=${localListener.pid}`);
+    console.log(`  command: ${localListener.command}`);
+    console.log("  this is likely another process not started by gateway");
+    console.log(`  inspect: lsof -nP -iTCP:4310 -sTCP:LISTEN`);
+    console.log(`  stop it: kill ${localListener.pid}`);
+  }
+  if (!signalingListener) {
+    console.log("- signaling port 4510: stopped");
+  } else {
+    console.log(`- signaling port 4510: still in use by pid=${signalingListener.pid}`);
+    console.log(`  command: ${signalingListener.command}`);
+    console.log("  this is likely another process not started by gateway");
+    console.log(`  inspect: lsof -nP -iTCP:4510 -sTCP:LISTEN`);
+    console.log(`  stop it: kill ${signalingListener.pid}`);
+  }
+  console.log(`- check status: silicaclaw gateway status`);
 }
 
 function tailFile(file, lines = 80) {
@@ -287,18 +374,21 @@ async function main() {
   }
   if (cmd === "start") {
     startAll();
-    showStatus();
+    const status = showStatus();
+    printConnectionSummary(status);
     return;
   }
   if (cmd === "stop") {
     await stopAll();
     showStatus();
+    printStopSummary();
     return;
   }
   if (cmd === "restart") {
     await stopAll();
     startAll();
-    showStatus();
+    const status = showStatus();
+    printConnectionSummary(status);
     return;
   }
   if (cmd === "logs") {
@@ -318,4 +408,3 @@ main().catch((error) => {
   console.error(error?.message || String(error));
   process.exit(1);
 });
-