wattetheria 0.4.0 → 0.4.2

package/lib/cli.js

@@ -37,6 +37,7 @@ const NATIVE_ARCH_ALIASES = new Map([
 ]);
 const BANNER_COMMANDS = new Set([
   "help",
+  "setup",
   "install",
   "start",
   "up",
@@ -55,11 +56,13 @@ function printHelp() {
 
 Usage:
   npx wattetheria [command] [options]
+  npx wattetheria setup
   npx wattetheria install
 
 Commands:
   version     Show Wattetheria release version
   images      Show configured release images
+  setup       Install the local stack and finish first-time runtime/MCP setup
   install     Prepare deployment, pull images, and start the stack
   start       Start an existing deployment
   status      Show docker compose status
@@ -952,6 +955,29 @@ function runCompose(options, args, capture = false) {
   return result;
 }
 
+const RELEASE_SERVICES = [
+  "kernel",
+  "wattswarm-postgres",
+  "wattswarm-runtime",
+  "wattswarm-kernel",
+  "wattswarm-worker"
+];
+
+function runningComposeServices(options) {
+  const result = runCompose(options, ["ps", "--status", "running", "--services"], true);
+  return new Set(
+    (result.stdout || "")
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean)
+  );
+}
+
+function composeStackIsRunning(options) {
+  const runningServices = runningComposeServices(options);
+  return RELEASE_SERVICES.every((service) => runningServices.has(service));
+}
+
 async function waitForHttp(name, url, maxAttempts = 60, delayMs = 2000) {
   for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
     try {
@@ -1025,8 +1051,69 @@ function printSummary(options) {
   console.log(`Deploy dir:   ${options.dir}`);
 }
 
-async function install(options) {
-  await ensureDockerAvailable({ interactive: true });
+function supervisionUrl(options) {
+  const envMap = readEnvFile(envFilePath(options));
+  const kernelHost = getEnvValue(envMap, "WATTETHERIA_CONTROL_PLANE_BIND_HOST", "127.0.0.1");
+  const kernelPort = getEnvValue(envMap, "WATTETHERIA_CONTROL_PLANE_PORT", "7777");
+  return `http://${kernelHost}:${kernelPort}/supervision`;
+}
+
+function mcpServerConfigSnippet(options) {
+  const args = ["wattetheria", "mcp-proxy"];
+  if (path.resolve(options.dir) !== path.resolve(DEFAULT_DEPLOY_DIR)) {
+    args.push("--dir", options.dir);
+  }
+  return JSON.stringify({
+    mcpServers: {
+      wattetheria: {
+        command: "npx",
+        args
+      }
+    }
+  }, null, 2);
+}
+
+function printSetupHint() {
+  console.log("");
+  console.log("To finish first-time setup, run:");
+  console.log("  npx wattetheria setup");
+}
+
+function printManualSetupChecklist(options) {
+  console.log("");
+  console.log("Finish setup:");
+  console.log("1. Open Supervision and configure the runtime:");
+  console.log(`   ${supervisionUrl(options)}`);
+  console.log("");
+  console.log("2. Add Wattetheria MCP to your agent runtime:");
+  console.log(mcpServerConfigSnippet(options));
+  console.log("");
+  console.log("3. Restart Wattetheria so runtime config takes effect:");
+  console.log("   npx wattetheria restart");
+  console.log("");
+  console.log("4. Restart your agent runtime so MCP config takes effect.");
+  console.log("");
+  console.log("5. Verify MCP access from the agent runtime:");
+  console.log("   - list Wattetheria MCP tools");
+  console.log("   - call one read-only Wattetheria MCP tool");
+}
+
+async function waitForEnter(message) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    await rl.question(message);
+  } finally {
+    rl.close();
+  }
+}
+
+async function install(options, behavior = {}) {
+  if (!behavior.dockerAlreadyChecked) {
+    await ensureDockerAvailable({ interactive: true });
+  }
   ensureDeploymentAssets(options);
   if (options.tag) {
     console.log(`Pinning release images to requested tag ${options.tag}.`);
@@ -1042,6 +1129,83 @@ async function install(options) {
     await runHealthChecks(options);
   }
   printSummary(options);
+  if (!behavior.suppressSetupHint) {
+    printSetupHint();
+  }
+}
+
+async function setup(options) {
+  console.log("Checking Docker runtime...");
+  const dockerStatus = getDockerStatus();
+  if (!dockerStatus.ready) {
+    throw new Error([
+      formatDockerStatusMessage(dockerStatus),
+      "",
+      "Install Docker, start it, then rerun:",
+      "  npx wattetheria setup"
+    ].join("\n"));
+  }
+  console.log("[ok] Docker runtime is ready.");
+
+  const deployment = deploymentState(options.dir);
+  console.log("");
+  if (deployment.runnable) {
+    console.log("[1/6] Start existing Wattetheria deployment");
+    if (composeStackIsRunning(options)) {
+      console.log("Deployment already initialized and running. Skipping docker compose up.");
+      if (options.healthChecks) {
+        await runHealthChecks(options);
+      }
+      printSummary(options);
+    } else {
+      console.log("Deployment already initialized. Starting existing stack...");
+      await start(options);
+    }
+  } else {
+    console.log("[1/6] Install Wattetheria");
+    await install(options, {
+      dockerAlreadyChecked: true,
+      suppressSetupHint: true
+    });
+  }
+
+  if (!isInteractiveTerminal()) {
+    printManualSetupChecklist(options);
+    return;
+  }
+
+  const url = supervisionUrl(options);
+  console.log("");
+  console.log("[2/6] Configure runtime");
+  console.log(`Open: ${url}`);
+  const opened = openUrl(url);
+  if (!opened) {
+    console.log("Open the URL above in your browser.");
+  }
+  await waitForEnter("After saving runtime config, press Enter to continue.");
+
+  console.log("");
+  console.log("[3/6] Install MCP in your agent runtime");
+  console.log(mcpServerConfigSnippet(options));
+  await waitForEnter("After saving MCP config, press Enter to continue.");
+
+  console.log("");
+  console.log("[4/6] Restart Wattetheria");
+  await restart(options);
+
+  console.log("");
+  console.log("[5/6] Restart your agent runtime");
+  await waitForEnter("After restarting your agent runtime, press Enter to continue.");
+
+  console.log("");
+  console.log("[6/6] Verify MCP access");
+  console.log("From the agent runtime:");
+  console.log("- list Wattetheria MCP tools");
+  console.log("- call one read-only Wattetheria MCP tool");
+  await waitForEnter("After verifying MCP access, press Enter to finish.");
+
+  console.log("");
+  console.log("Setup complete.");
 }
 
 async function start(options) {
@@ -1681,6 +1845,9 @@ async function run(argv) {
     case "images":
       printImages(options);
       return;
+    case "setup":
+      await setup(options);
+      return;
     case "install":
       await install(options);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wattetheria",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Wattetheria deployment CLI",
   "license": "AGPL-3.0-only",
   "type": "commonjs",