impactus-swarm 0.1.0

package/bin/cli.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+import { fork, execSync, spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Version check
+const [major, minor] = process.versions.node.split(".").map(Number);
+if (major < 22 || (major === 22 && minor < 5)) {
+  console.error(
+    `Error: impactus-swarm requires Node.js >= 22.5.0 (current: ${process.version})\n` +
+    `Please upgrade Node.js: https://nodejs.org/`
+  );
+  process.exit(1);
+}
+
+// Parse CLI args
+const args = process.argv.slice(2);
+let port = 3773;
+let noOpen = false;
+let relayUrl = null;
+let allowedIps = [];
+
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case "--port":
+      port = parseInt(args[++i], 10);
+      if (isNaN(port)) {
+        console.error("Error: --port requires a valid number");
+        process.exit(1);
+      }
+      break;
+    case "--no-open":
+      noOpen = true;
+      break;
+    case "--relay":
+      relayUrl = args[++i];
+      if (!relayUrl) {
+        console.error("Error: --relay requires a URL");
+        process.exit(1);
+      }
+      break;
+    case "--ip":
+      const ip = args[++i];
+      if (!ip) {
+        console.error("Error: --ip requires an IP address");
+        process.exit(1);
+      }
+      allowedIps.push(ip);
+      break;
+    case "--version":
+      console.log("impactus-swarm v0.1.0");
+      process.exit(0);
+    case "--help":
+      console.log(`
+impactus-swarm - AI-powered terminal swarm orchestration platform
+
+Usage: impactus-swarm [options]
+
+Options:
+  --port <number>   Port to run the server on (default: 3773)
+  --relay <url>     Connect to a relay server for remote access
+  --ip <address>    Allow only this IP to connect via relay (can be repeated)
+  --no-open         Don't open the browser automatically
+  --version         Show version number
+  --help            Show this help message
+
+Examples:
+  impactus-swarm
+  impactus-swarm --port 8080
+  impactus-swarm --relay wss://relay.impactus.ai
+  impactus-swarm --relay wss://relay.impactus.ai --ip 189.40.23.100
+`);
+      process.exit(0);
+  }
+}
+
+// Resolve paths
+const serverEntry = join(__dirname, "..", "server", "main.js");
+const webDir = join(__dirname, "..", "web");
+
+if (!existsSync(serverEntry)) {
+  console.error(
+    `Error: Server bundle not found at ${serverEntry}\n` +
+    `Run 'pnpm build' in the npx package directory first.`
+  );
+  process.exit(1);
+}
+
+if (!existsSync(webDir)) {
+  console.error(
+    `Error: Web assets not found at ${webDir}\n` +
+    `Run 'pnpm build' in the npx package directory first.`
+  );
+  process.exit(1);
+}
+
+// Set env vars
+process.env.IMPACTUS_WEB_DIR = webDir;
+process.env.PORT = String(port);
+
+// Fork the server
+const serverArgs = [];
+if (!noOpen) serverArgs.push("--open");
+
+const child = fork(serverEntry, serverArgs, {
+  stdio: ["inherit", "pipe", "inherit", "ipc"],
+  env: {
+    ...process.env,
+    IMPACTUS_WEB_DIR: webDir,
+    PORT: String(port),
+    ...(relayUrl ? { RELAY_URL: relayUrl } : {}),
+    ...(allowedIps.length > 0 ? { RELAY_ALLOWED_IPS: allowedIps.join(',') } : {}),
+  },
+});
+
+child.stdout.on("data", (data) => {
+  const output = data.toString();
+  process.stdout.write(output);
+
+  // Detect relay code
+  const codeMatch = output.match(/\[relay\] Code: ([A-Fa-f0-9]{6})/);
+  if (codeMatch) {
+    const code = codeMatch[1].toUpperCase();
+    console.log("\n╔══════════════════════════════════════╗");
+    console.log(`║  Your connection code:  ${code}      ║`);
+    console.log("║  Enter this code in the web app      ║");
+    console.log("╚══════════════════════════════════════╝\n");
+  }
+
+  if (output.includes("running on")) {
+    // Server is ready, run optional dependency setup in background
+    setupOptionalDeps();
+  }
+});
+
+// Forward signals to child
+function shutdown() {
+  child.kill("SIGTERM");
+  setTimeout(() => process.exit(0), 3000);
+}
+
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+
+child.on("exit", (code) => {
+  process.exit(code ?? 0);
+});
+
+// Optional dependency setup (non-blocking)
+async function setupOptionalDeps() {
+  console.log("\n[setup] Checking optional dependencies...");
+
+  // Check playwright chromium
+  try {
+    const playwrightCheck = spawn("npx", ["playwright", "install", "chromium"], {
+      stdio: "ignore",
+      detached: true,
+      shell: true,
+    });
+    playwrightCheck.unref();
+    console.log("[setup] Installing Playwright Chromium in background...");
+  } catch {
+    console.log("[setup] Playwright Chromium: skipped (install manually with: npx playwright install chromium)");
+  }
+
+  // Check cloudflared
+  try {
+    const which = process.platform === "win32" ? "where" : "which";
+    execSync(`${which} cloudflared`, { stdio: "ignore" });
+    console.log("[setup] cloudflared: available");
+  } catch {
+    console.log("[setup] cloudflared: not found");
+    if (process.platform === "darwin") {
+      console.log("[setup]   Install with: brew install cloudflared");
+    } else if (process.platform === "linux") {
+      const arch = process.arch === "arm64" ? "arm64" : "amd64";
+      console.log(
+        `[setup]   Download from: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-${arch}`
+      );
+    } else if (process.platform === "win32") {
+      console.log("[setup]   Download from: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/");
+    }
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "impactus-swarm",
+  "version": "0.1.0",
+  "description": "AI-powered terminal swarm orchestration platform",
+  "type": "module",
+  "bin": {
+    "impactus-swarm": "./bin/cli.js"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "files": [
+    "bin/",
+    "server/",
+    "web/"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.89",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "node-pty": "1.2.0-beta.12",
+    "open": "^10",
+    "ws": "^8",
+    "zod": "^4.3.6"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.4"
+  },
+  "keywords": [
+    "terminal",
+    "swarm",
+    "ai",
+    "orchestration",
+    "claude"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "node build.mjs"
+  }
+}