claudemesh-cli 0.1.3 → 0.1.5

package/dist/index.js

@@ -54990,6 +54990,7 @@ class BrokerClient {
   outbound = [];
   pushHandlers = new Set;
   pushBuffer = [];
+  listPeersResolvers = [];
   closed = false;
   reconnectAttempt = 0;
   helloTimer = null;
@@ -55013,7 +55014,7 @@ class BrokerClient {
   async connect() {
     if (this.closed)
       throw new Error("client is closed");
-    this.setStatus("connecting");
+    this.setConnStatus("connecting");
     const ws = new wrapper_default(this.mesh.brokerUrl);
     this.ws = ws;
     return new Promise((resolve, reject) => {
@@ -55053,7 +55054,7 @@ class BrokerClient {
           if (this.helloTimer)
             clearTimeout(this.helloTimer);
           this.helloTimer = null;
-          this.setStatus("open");
+          this.setConnStatus("open");
           this.reconnectAttempt = 0;
           this.flushOutbound();
           resolve();
@@ -55072,7 +55073,7 @@ class BrokerClient {
         if (!this.closed)
           this.scheduleReconnect();
         else
-          this.setStatus("closed");
+          this.setConnStatus("closed");
       };
       const onError = (err) => {
         this.debug(`ws error: ${err.message}`);
@@ -55152,6 +55153,26 @@ class BrokerClient {
       return;
     this.ws.send(JSON.stringify({ type: "set_status", status }));
   }
+  async listPeers() {
+    if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+      return [];
+    return new Promise((resolve) => {
+      this.listPeersResolvers.push(resolve);
+      this.ws.send(JSON.stringify({ type: "list_peers" }));
+      setTimeout(() => {
+        const idx = this.listPeersResolvers.indexOf(resolve);
+        if (idx !== -1) {
+          this.listPeersResolvers.splice(idx, 1);
+          resolve([]);
+        }
+      }, 5000);
+    });
+  }
+  async setSummary(summary) {
+    if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+      return;
+    this.ws.send(JSON.stringify({ type: "set_summary", summary }));
+  }
   close() {
     this.closed = true;
     if (this.helloTimer)
@@ -55163,7 +55184,7 @@ class BrokerClient {
         this.ws.close();
       } catch {}
     }
-    this.setStatus("closed");
+    this.setConnStatus("closed");
   }
   handleServerMessage(msg) {
     if (msg.type === "ack") {
@@ -55177,6 +55198,13 @@ class BrokerClient {
       }
       return;
     }
+    if (msg.type === "peers_list") {
+      const peers = msg.peers ?? [];
+      const resolver = this.listPeersResolvers.shift();
+      if (resolver)
+        resolver(peers);
+      return;
+    }
     if (msg.type === "push") {
       const nonce = String(msg.nonce ?? "");
       const ciphertext = String(msg.ciphertext ?? "");
@@ -55239,7 +55267,7 @@ class BrokerClient {
       send();
   }
   scheduleReconnect() {
-    this.setStatus("reconnecting");
+    this.setConnStatus("reconnecting");
     const delay = BACKOFF_CAPS[Math.min(this.reconnectAttempt, BACKOFF_CAPS.length - 1)];
     this.reconnectAttempt += 1;
     this.debug(`reconnect in ${delay}ms (attempt ${this.reconnectAttempt})`);
@@ -55251,7 +55279,7 @@ class BrokerClient {
       });
     }, delay);
   }
-  setStatus(s) {
+  setConnStatus(s) {
     if (this._status === s)
       return;
     this._status = s;
@@ -55344,7 +55372,7 @@ ${body}`;
 }
 async function startMcpServer() {
   const config2 = loadConfig();
-  const server = new Server({ name: "claudemesh", version: "0.1.3" }, {
+  const server = new Server({ name: "claudemesh", version: "0.1.4" }, {
     capabilities: {
       experimental: { "claude/channel": {} },
       tools: {}
@@ -55395,12 +55423,26 @@ If you have multiple joined meshes, prefix the \`to\` argument of send_message w
         const clients2 = mesh_slug ? [findClient(mesh_slug)].filter(Boolean) : allClients();
         if (clients2.length === 0)
           return text(mesh_slug ? `list_peers: no joined mesh "${mesh_slug}"` : "list_peers: no joined meshes", true);
-        const lines = clients2.map((c) => `- ${c.meshSlug} (${c.status}, mesh ${c.meshId.slice(0, 8)}…)`);
-        return text(`Connected meshes:
-${lines.join(`
-`)}
+        const sections = [];
+        for (const c of clients2) {
+          const peers = await c.listPeers();
+          const header = `## ${c.meshSlug} (${c.status}, mesh ${c.meshId.slice(0, 8)}…)`;
+          if (peers.length === 0) {
+            sections.push(`${header}
+No peers connected.`);
+          } else {
+            const peerLines = peers.map((p) => {
+              const summary = p.summary ? ` — "${p.summary}"` : "";
+              return `- **${p.displayName}** [${p.status}] (${p.pubkey.slice(0, 12)}…)${summary}`;
+            });
+            sections.push(`${header}
+${peerLines.join(`
+`)}`);
+          }
+        }
+        return text(sections.join(`
 
-(list_peers WS protocol lands in Step 16; only mesh status is shown for now.)`);
+`));
       }
       case "check_messages": {
         const drained = [];
@@ -55423,7 +55465,9 @@ ${drained.join(`
         const { summary } = args ?? {};
         if (!summary)
           return text("set_summary: `summary` required", true);
-        return text(`set_summary: summary recorded locally ("${summary}"). (Broker WS protocol for summaries lands in Step 16.)`);
+        for (const c of allClients())
+          await c.setSummary(summary);
+        return text(`Summary set: "${summary}" (visible to ${allClients().length} mesh(es)).`);
       }
       case "set_status": {
         const { status } = args ?? {};
@@ -55477,6 +55521,7 @@ ${drained.join(`
 // src/commands/install.ts
 import {
   chmodSync as chmodSync2,
+  copyFileSync,
   existsSync as existsSync2,
   mkdirSync as mkdirSync2,
   readFileSync as readFileSync2,
@@ -55504,7 +55549,49 @@ function readClaudeConfig() {
     throw new Error(`failed to parse ${CLAUDE_CONFIG}: ${e instanceof Error ? e.message : String(e)}`);
   }
 }
-function writeClaudeConfig(obj) {
+function backupClaudeConfig() {
+  if (!existsSync2(CLAUDE_CONFIG))
+    return;
+  const backupDir = join2(dirname2(CLAUDE_CONFIG), ".claude", "backups");
+  mkdirSync2(backupDir, { recursive: true });
+  const ts = Date.now();
+  const dest = join2(backupDir, `.claude.json.pre-claudemesh.${ts}`);
+  copyFileSync(CLAUDE_CONFIG, dest);
+}
+function patchMcpServer(entry) {
+  backupClaudeConfig();
+  const cfg = readClaudeConfig();
+  const servers = cfg.mcpServers ?? {};
+  if (!cfg.mcpServers)
+    cfg.mcpServers = servers;
+  const existing = servers[MCP_NAME];
+  let action;
+  if (!existing) {
+    servers[MCP_NAME] = entry;
+    action = "added";
+  } else if (entriesEqual(existing, entry)) {
+    return "unchanged";
+  } else {
+    servers[MCP_NAME] = entry;
+    action = "updated";
+  }
+  flushClaudeConfig(cfg);
+  return action;
+}
+function removeMcpServer() {
+  if (!existsSync2(CLAUDE_CONFIG))
+    return false;
+  backupClaudeConfig();
+  const cfg = readClaudeConfig();
+  const servers = cfg.mcpServers;
+  if (!servers || !(MCP_NAME in servers))
+    return false;
+  delete servers[MCP_NAME];
+  cfg.mcpServers = servers;
+  flushClaudeConfig(cfg);
+  return true;
+}
+function flushClaudeConfig(obj) {
   mkdirSync2(dirname2(CLAUDE_CONFIG), { recursive: true });
   writeFileSync2(CLAUDE_CONFIG, JSON.stringify(obj, null, 2) + `
 `, "utf-8");
@@ -55616,22 +55703,8 @@ function runInstall(args = []) {
     console.error(`✗ MCP entry not found at ${entry}`);
     process.exit(1);
   }
-  const cfg = readClaudeConfig();
-  const servers = (cfg.mcpServers ??= {}) ?? {};
   const desired = buildMcpEntry(entry);
-  const existing = servers[MCP_NAME];
-  let action;
-  if (!existing) {
-    servers[MCP_NAME] = desired;
-    action = "added";
-  } else if (entriesEqual(existing, desired)) {
-    action = "unchanged";
-  } else {
-    servers[MCP_NAME] = desired;
-    action = "updated";
-  }
-  cfg.mcpServers = servers;
-  writeClaudeConfig(cfg);
+  const action = patchMcpServer(desired);
   const verify = readClaudeConfig();
   const verifyServers = verify.mcpServers ?? {};
   const stored = verifyServers[MCP_NAME];
@@ -55674,19 +55747,10 @@ function runInstall(args = []) {
 function runUninstall() {
   console.log("claudemesh uninstall");
   console.log("--------------------");
-  if (existsSync2(CLAUDE_CONFIG)) {
-    const cfg = readClaudeConfig();
-    const servers = cfg.mcpServers;
-    if (servers && MCP_NAME in servers) {
-      delete servers[MCP_NAME];
-      cfg.mcpServers = servers;
-      writeClaudeConfig(cfg);
-      console.log(`✓ MCP server "${MCP_NAME}" removed`);
-    } else {
-      console.log(`· MCP server "${MCP_NAME}" not present`);
-    }
+  if (removeMcpServer()) {
+    console.log(`✓ MCP server "${MCP_NAME}" removed`);
   } else {
-    console.log(`· no ${CLAUDE_CONFIG} — MCP entry skipped`);
+    console.log(`· MCP server "${MCP_NAME}" not present`);
   }
   try {
     const removed = uninstallHooks();
@@ -56086,7 +56150,7 @@ import { statSync, existsSync as existsSync3 } from "node:fs";
 // package.json
 var package_default = {
   name: "claudemesh-cli",
-  version: "0.1.3",
+  version: "0.1.5",
   description: "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   keywords: [
     "claude-code",
@@ -56414,6 +56478,83 @@ async function runDoctor() {
   }
 }
 
+// src/commands/welcome.ts
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { join as join4 } from "node:path";
+function detectState() {
+  const claudeConfig = join4(homedir4(), ".claude.json");
+  let mcpRegistered = false;
+  if (existsSync5(claudeConfig)) {
+    try {
+      const cfg = JSON.parse(readFileSync4(claudeConfig, "utf-8"));
+      mcpRegistered = Boolean(cfg.mcpServers?.["claudemesh"]);
+    } catch {}
+  }
+  if (!mcpRegistered)
+    return "no-install";
+  try {
+    const cfg = loadConfig();
+    return cfg.meshes.length === 0 ? "no-meshes" : "ready";
+  } catch {
+    return "broken-config";
+  }
+}
+function runWelcome() {
+  const useColor = !process.env.NO_COLOR && process.env.TERM !== "dumb" && process.stdout.isTTY;
+  const bold = (s) => useColor ? `\x1B[1m${s}\x1B[22m` : s;
+  const dim = (s) => useColor ? `\x1B[2m${s}\x1B[22m` : s;
+  const green = (s) => useColor ? `\x1B[32m${s}\x1B[39m` : s;
+  const yellow = (s) => useColor ? `\x1B[33m${s}\x1B[39m` : s;
+  console.log(bold(`claudemesh v${VERSION}`) + dim(" — peer mesh for Claude Code"));
+  console.log("─".repeat(60));
+  const state = detectState();
+  switch (state) {
+    case "no-install":
+      console.log("Welcome. Let's get you set up.");
+      console.log("");
+      console.log(bold("Step 1:") + " register the MCP server + status hooks");
+      console.log(`  ${green("$")} claudemesh install`);
+      console.log("");
+      console.log(dim("Step 2 (after restart): claudemesh join <invite-url>"));
+      console.log(dim("Step 3:                 claudemesh launch"));
+      break;
+    case "no-meshes":
+      console.log(green("✓") + " MCP registered. Now join a mesh.");
+      console.log("");
+      console.log(bold("Step 2:") + " join a mesh");
+      console.log(`  ${green("$")} claudemesh join https://claudemesh.com/join/<token>`);
+      console.log("");
+      console.log(dim("  Don't have an invite? Create one at ") + bold("https://claudemesh.com") + dim(" or ask a mesh owner."));
+      console.log("");
+      console.log(dim("Step 3 (after joining): claudemesh launch"));
+      break;
+    case "ready": {
+      const cfg = loadConfig();
+      const meshNames = cfg.meshes.map((m) => m.slug).join(", ");
+      console.log(green("✓") + " MCP registered.");
+      console.log(green("✓") + ` ${cfg.meshes.length} mesh(es) joined: ${meshNames}`);
+      console.log("");
+      console.log(bold("You're ready.") + " Launch Claude Code with real-time peer messages:");
+      console.log(`  ${green("$")} claudemesh launch`);
+      console.log("");
+      console.log(dim("  (Plain `claude` works too — messages pull-only via check_messages.)"));
+      console.log("");
+      console.log(dim("Health check:  claudemesh status"));
+      console.log(dim("Diagnostics:   claudemesh doctor"));
+      console.log(dim("All commands:  claudemesh --help"));
+      break;
+    }
+    case "broken-config":
+      console.log(yellow("⚠") + "  Your ~/.claudemesh/config.json is unreadable.");
+      console.log("");
+      console.log("Run diagnostics to see what's wrong:");
+      console.log(`  ${green("$")} claudemesh doctor`);
+      break;
+  }
+  console.log("");
+}
+
 // src/index.ts
 var HELP = `claudemesh v${VERSION} — peer mesh for Claude Code sessions
 
@@ -56487,9 +56628,11 @@ async function main() {
     case "--help":
     case "-h":
     case "help":
-    case undefined:
       console.log(HELP);
       return;
+    case undefined:
+      runWelcome();
+      return;
     default:
       console.error(`Unknown command: ${cmd}`);
       console.error("Run `claudemesh --help` for usage.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudemesh-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   "keywords": [
     "claude-code",