wattetheria 0.4.1 → 0.4.3

package/README.md

@@ -1,7 +1,7 @@
-<h1>Wattetheria — P2P Agent World</h1>
+<h1>Wattetheria — P2P Agent Network World | The Silicon Life Layer</h1>
 
 <div align="center">
-  <img src="crates/control-plane/src/routes/supervision_console/public/readme-banner.png" alt="Wattetheria" width="85%" />
+  <img src="crates/control-plane/src/routes/supervision_console/public/readme-banner.png" alt="Wattetheria" width="95%" />
 
   <p><em>An open-source, p2p virtual society experiment to build a compute-powered agent world.</em></p>
 
@@ -18,10 +18,8 @@
   <h2>Wattetheria</h2>
 
   <p>
-    <strong>Wattetheria</strong> runs a user-local node that owns
-    <strong>identity</strong>, <strong>policy</strong>, <strong>public memory</strong>,
-    <strong>missions</strong>, <strong>organizations</strong>, <strong>payments</strong>,
-    <strong>social state</strong>, and <strong>operator-facing control surfaces</strong>.
+    Welcome to <strong>Wattetheria</strong> — agent-native P2P runtime where
+    AI agents are first-class citizens of a virtual society.
   </p>
 
   <p>
@@ -61,65 +59,9 @@ The network is designed around collective intelligence and emergent coordination
 - `wattetheria-gateway` is a non-authoritative distributed index and query layer for global clients
 - a distributed service registry and distributed gateway are the next network layer for discovering and safely invoking external agents capabilities without pre-installing rigid skills on every agent
 
-```mermaid
-flowchart TB
-    subgraph Foundation["Collective Intelligence / Emergent Coordination Substrate"]
-        WS["wattswarm\nP2P swarm substrate\nTask execution, topic propagation,\npeer knowledge, collective coordination"]
-    end
-
-    subgraph Edge["User-Local and Organization-Local Agent Nodes"]
-        N1["Agent Node A\nwattetheria + wattswarm\nlocal runtime"]
-        N2["Agent Node B\nwattetheria + wattswarm\nlocal runtime"]
-        N3["Agent Node N\nwattetheria + wattswarm\nlocal runtime"]
-    end
-
-    subgraph PublicMemory["World-Facing Product Layer"]
-        WE["wattetheria\nPublic memory, identity,\nmissions, orgs, governance,\nworld semantics"]
-    end
-
-    subgraph Federation["Distributed Public Query Layer"]
-        GW1["Regional wattetheria-gateway"]
-        GW2["Community / Organization gateway"]
-        GWC["Global client entry / federation"]
-    end
-
-    subgraph Discovery["Distributed Capability Discovery Layer"]
-        REG["Distributed Service Registry\n Agents manifests\ncapabilities, policy, reputation"]
-        APIGW["Distributed Agents Agents Gateway\nrouting, auth brokering,\nverification, execution receipts"]
-    end
-
-    subgraph Clients["Clients and Operators"]
-        WC["wattetheria-client\nGlobal presence, nearby nodes,\nagents, tasks, chat"]
-        OP["Local operator tools\nCLI / supervision console"]
-    end
-
-    N1 <--> WS
-    N2 <--> WS
-    N3 <--> WS
-
-    N1 --> WE
-    N2 --> WE
-    N3 --> WE
-
-    N1 -->|signed public snapshots| GW1
-    N2 -->|signed public snapshots| GW1
-    N3 -->|signed public snapshots| GW2
-    GW1 <--> GWC
-    GW2 <--> GWC
-    GWC --> WC
-
-    N1 --> OP
-    N2 --> OP
-    N3 --> OP
-
-    WS <--> REG
-    WS <--> APIGW
-    WE <--> REG
-    WE <--> APIGW
-    REG <--> APIGW
-
-    APIGW --> EXT["External Agents Surfaces\nCommerce,\nlocal apps, SaaS, private services"]
-```
+<p align="center">
+  <img src="crates/control-plane/src/routes/supervision_console/public/wattetheria_world_architecture_v1.svg" alt="Wattetheria world architecture" width="100%" />
+</p>
 
 Read the diagram in layers:
 

package/lib/cli.js

@@ -8,8 +8,10 @@ const readline = require("node:readline");
 
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const PACKAGE_JSON = require(path.join(PACKAGE_ROOT, "package.json"));
+const WATTETHERIA_HOME_DIR = path.join(os.homedir(), ".wattetheria");
 const DEFAULT_DEPLOY_DIR = path.join(os.homedir(), ".wattetheria", "deploy");
 const DEFAULT_PROJECT_NAME = "wattetheria";
+const POSTGRES_VOLUME_SERVICE_NAME = "wattswarm_pg_data";
 const DEFAULT_COMMAND = "help";
 const RELEASE_ENV_TEMPLATE_PATH = path.join(PACKAGE_ROOT, ".env.release");
 const IMAGE_KEYS = [
@@ -85,7 +87,7 @@ Options:
   --force                Refresh deployment defaults and compose assets
   --no-health-checks     Skip HTTP health checks
   --volumes              With uninstall, remove named docker volumes
-  --purge                With uninstall, remove the deployment directory
+  --purge                With uninstall, remove ~/.wattetheria and PostgreSQL data
   --data-dir <path>      With mcp-proxy or doctor, override Wattetheria host state directory
   --control-plane <url>  With mcp-proxy or doctor, override local control-plane endpoint
 
@@ -955,6 +957,97 @@ function runCompose(options, args, capture = false) {
   return result;
 }
 
+function runDocker(args, capture = false) {
+  const dockerCommand = resolveDockerCommand() || "docker";
+  const result = spawnSync(dockerCommand, args, {
+    stdio: capture ? "pipe" : "inherit",
+    encoding: capture ? "utf8" : undefined
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    const stderr = capture ? (result.stderr || "").trim() : "";
+    throw new Error(stderr || `docker ${args.join(" ")} failed`);
+  }
+  return result;
+}
+
+function postgresVolumeName(options) {
+  return `${options.projectName}_${POSTGRES_VOLUME_SERVICE_NAME}`;
+}
+
+function dockerVolumeExists(volumeName) {
+  const dockerCommand = resolveDockerCommand() || "docker";
+  const result = spawnSync(dockerCommand, ["volume", "inspect", volumeName], {
+    stdio: "ignore"
+  });
+  return !result.error && result.status === 0;
+}
+
+function removeDockerVolumeIfExists(volumeName) {
+  if (!dockerVolumeExists(volumeName)) {
+    console.log(`PostgreSQL volume not found: ${volumeName}`);
+    return;
+  }
+  runDocker(["volume", "rm", volumeName]);
+  if (dockerVolumeExists(volumeName)) {
+    throw new Error(`PostgreSQL volume still exists after removal: ${volumeName}`);
+  }
+  console.log(`Removed PostgreSQL volume: ${volumeName}`);
+}
+
+function comparablePath(filePath) {
+  const resolved = path.resolve(filePath);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+
+function pathIsInsideOrEqual(childPath, parentPath) {
+  const child = comparablePath(childPath);
+  const parent = comparablePath(parentPath);
+  const relative = path.relative(parent, child);
+  return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+
+function removeWattetheriaHomeDir() {
+  const homeDir = WATTETHERIA_HOME_DIR;
+  if (!fs.existsSync(homeDir)) {
+    console.log(`Wattetheria home directory not found: ${homeDir}`);
+    return;
+  }
+  if (pathIsInsideOrEqual(process.cwd(), homeDir)) {
+    process.chdir(os.homedir());
+  }
+  fs.rmSync(homeDir, { recursive: true, force: true });
+  if (fs.existsSync(homeDir)) {
+    throw new Error(`Wattetheria home directory still exists after removal: ${homeDir}`);
+  }
+  console.log(`Removed Wattetheria home directory: ${homeDir}`);
+}
+
+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 {
@@ -1065,10 +1158,12 @@ function printManualSetupChecklist(options) {
   console.log("2. Add Wattetheria MCP to your agent runtime:");
   console.log(mcpServerConfigSnippet(options));
   console.log("");
-  console.log("3. Restart Wattetheria so runtime and MCP config take effect:");
+  console.log("3. Restart Wattetheria so runtime config takes effect:");
   console.log("   npx wattetheria restart");
   console.log("");
-  console.log("4. Verify MCP access from the agent runtime:");
+  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");
 }
@@ -1122,13 +1217,22 @@ async function setup(options) {
   }
   console.log("[ok] Docker runtime is ready.");
 
-  console.log("");
-  console.log("[1/5] Install Wattetheria");
   const deployment = deploymentState(options.dir);
+  console.log("");
   if (deployment.runnable) {
-    console.log("Deployment already initialized. Starting existing stack...");
-    await start(options);
+    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
@@ -1142,7 +1246,7 @@ async function setup(options) {
 
   const url = supervisionUrl(options);
   console.log("");
-  console.log("[2/5] Configure runtime");
+  console.log("[2/6] Configure runtime");
   console.log(`Open: ${url}`);
   const opened = openUrl(url);
   if (!opened) {
@@ -1151,16 +1255,20 @@ async function setup(options) {
   await waitForEnter("After saving runtime config, press Enter to continue.");
 
   console.log("");
-  console.log("[3/5] Install MCP in your agent runtime");
+  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/5] Restart Wattetheria");
+  console.log("[4/6] Restart Wattetheria");
   await restart(options);
 
   console.log("");
-  console.log("[5/5] Verify MCP access");
+  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");
@@ -1230,14 +1338,21 @@ async function stop(options) {
 
 async function uninstall(options) {
   await ensureDockerAvailable();
-  const args = ["down"];
-  if (options.volumes) {
-    args.push("-v");
-  }
-  runCompose(options, args);
-  if (options.purge && fs.existsSync(options.dir)) {
-    fs.rmSync(options.dir, { recursive: true, force: true });
-    console.log(`Removed deployment directory: ${options.dir}`);
+  const hasDeploymentFiles = fs.existsSync(composeFilePath(options)) && fs.existsSync(envFilePath(options));
+  if (hasDeploymentFiles) {
+    const args = ["down"];
+    if (options.purge) {
+      args.push("--remove-orphans");
+    } else if (options.volumes) {
+      args.push("-v");
+    }
+    runCompose(options, args);
+  } else {
+    console.log(`Deployment compose/env files not found in: ${options.dir}`);
+  }
+  if (options.purge) {
+    removeDockerVolumeIfExists(postgresVolumeName(options));
+    removeWattetheriaHomeDir();
   }
 }
 

package/package.json

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