wattetheria 0.4.1 → 0.4.2

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

@@ -955,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 {
@@ -1065,10 +1088,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 +1147,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 +1176,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 +1185,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");

package/package.json

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