@silicaclaw/cli 1.0.0-beta.14 → 1.0.0-beta.16

package/CHANGELOG.md

@@ -14,6 +14,8 @@
 - `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/package.json

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

package/scripts/silicaclaw-cli.mjs

@@ -73,6 +73,7 @@ function canWriteGlobalPrefix() {
 }
 
 function showUpdateGuide(current, latest, beta) {
+  const npxRuntime = isNpxRun();
   console.log("SilicaClaw update check");
   console.log(`current: ${current}`);
   console.log(`latest : ${latest || "-"}`);
@@ -86,29 +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 (writableGlobal) {
-    console.log("3) global install mode (optional)");
+  if (!npxRuntime && writableGlobal) {
+    console.log("Optional global install:");
     console.log("   npm i -g @silicaclaw/cli@beta");
     console.log("   silicaclaw version");
     console.log("");
-  } else {
-    console.log("Global install skipped: current npm global directory is not writable (likely EACCES).");
-    console.log("Use npx or alias mode above.");
+  } else if (!npxRuntime) {
+    console.log("Global install skipped: npm global directory is not writable (likely EACCES).");
     console.log("");
   }
-  if (isNpxRun()) {
-    console.log("Detected npx runtime: use npx commands above for immediate update.");
+  if (npxRuntime) {
+    console.log("Detected npx runtime.");
+    console.log("If `silicaclaw` is unavailable in this shell, use the npx one-shot command above.");
   }
 }
 

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";
@@ -193,6 +193,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: cd "${APP_DIR}" && npm run gateway -- status`);
+  console.log(`- logs:   cd "${APP_DIR}" && npm run gateway -- logs local-console`);
+  console.log(`- stop:   cd "${APP_DIR}" && npm run 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: cd "${APP_DIR}" && npm run gateway -- status`);
 }
 
 function tailFile(file, lines = 80) {
@@ -287,18 +355,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 +389,3 @@ main().catch((error) => {
   console.error(error?.message || String(error));
   process.exit(1);
 });
-