@cryptiklemur/lattice 1.38.0 → 1.40.0

package/client/src/components/sidebar/ProjectRail.tsx

@@ -31,7 +31,7 @@ function groupProjectsBySlug(projects: ProjectInfo[], nodes: NodeInfo[]): Projec
     var nodeEntry = {
       nodeId: p.nodeId,
       nodeName: p.nodeName,
-      online: node ? node.online : false,
+      online: node ? node.online : (p.online ?? !p.isRemote),
       path: p.path,
     };
     if (existing) {

package/client/src/components/ui/NodeDisconnectedOverlay.tsx

@@ -0,0 +1,35 @@
+import { WifiOff, Loader2 } from "lucide-react";
+import { useProjects } from "../../hooks/useProjects";
+import { useMesh } from "../../hooks/useMesh";
+import { useSidebar } from "../../hooks/useSidebar";
+
+export function NodeDisconnectedOverlay() {
+  var { activeProject } = useProjects();
+  var { nodes } = useMesh();
+  var sidebar = useSidebar();
+
+  if (!activeProject || !activeProject.isRemote) return null;
+  if (sidebar.activeView.type !== "chat") return null;
+
+  var remoteNode = nodes.find(function (n) { return n.id === activeProject!.nodeId; });
+  if (!remoteNode || remoteNode.online) return null;
+
+  return (
+    <div className="absolute inset-0 z-40 flex items-center justify-center bg-base-100/80 backdrop-blur-sm">
+      <div className="bg-base-300 border border-base-content/15 rounded-2xl shadow-2xl px-8 py-6 max-w-sm text-center">
+        <WifiOff size={28} className="text-warning mx-auto mb-3" />
+        <h3 className="text-[15px] font-mono font-bold text-base-content mb-1">Node Disconnected</h3>
+        <p className="text-[13px] text-base-content/50 mb-3">
+          <span className="font-semibold text-base-content/70">{remoteNode.name}</span> is unreachable.
+        </p>
+        <div className="flex items-center justify-center gap-2 text-[12px] text-base-content/40">
+          <Loader2 size={12} className="animate-spin" />
+          Attempting to reconnect...
+        </div>
+        <p className="text-[11px] text-base-content/25 mt-3">
+          Session state preserved. Operations will resume on reconnect.
+        </p>
+      </div>
+    </div>
+  );
+}

package/client/src/hooks/useProjects.ts

@@ -22,14 +22,30 @@ export function useProjects(): UseProjectsResult {
   useEffect(function () {
     handleRef.current = function (msg: ServerMessage) {
       if (msg.type === "projects:list") {
-        var list = (msg as ProjectsListMessage).projects;
-        setProjects(list);
+        var incoming = (msg as ProjectsListMessage).projects;
+        setProjects(function (prev) {
+          var incomingKeys = new Set(incoming.map(function (p) { return p.slug + "@" + p.nodeId; }));
+          var kept = prev.filter(function (p) {
+            if (!p.isRemote) return false;
+            return !incomingKeys.has(p.slug + "@" + p.nodeId);
+          });
+          for (var i = 0; i < kept.length; i++) {
+            (kept[i] as any).online = false;
+          }
+          return incoming.concat(kept);
+        });
         var storeState = getSidebarStore().state;
         var currentSlug = storeState.activeProjectSlug;
         if (currentSlug !== null) {
-          var found = list.find(function (p: typeof list[number]) { return p.slug === currentSlug; });
-          if (!found && list.length > 0) {
-            setActiveProjectSlug(list[0].slug);
+          var found = incoming.find(function (p: typeof incoming[number]) { return p.slug === currentSlug; });
+          if (!found) {
+            setProjects(function (current) {
+              var stillExists = current.find(function (p) { return p.slug === currentSlug; });
+              if (!stillExists && current.length > 0) {
+                setActiveProjectSlug(current[0].slug);
+              }
+              return current;
+            });
           }
         }
       }

package/client/src/router.tsx

@@ -16,6 +16,7 @@ import { useSidebar } from "./hooks/useSidebar";
 import { useWorkspace } from "./hooks/useWorkspace";
 import { useWebSocket } from "./hooks/useWebSocket";
 import { UpdateBanner } from "./components/ui/UpdateBanner";
+import { NodeDisconnectedOverlay } from "./components/ui/NodeDisconnectedOverlay";
 import { useSwipeDrawer } from "./hooks/useSwipeDrawer";
 import { exitSettings, getSidebarStore, handlePopState, closeDrawer, toggleDrawer } from "./stores/sidebar";
 
@@ -422,9 +423,10 @@ function RootLayout() {
           readOnly
         />
 
-        <main id="main-content" className="drawer-content flex flex-col h-full min-w-0 overflow-hidden">
+        <main id="main-content" className="drawer-content flex flex-col h-full min-w-0 overflow-hidden relative">
           <UpdateBanner />
           <Outlet />
+          <NodeDisconnectedOverlay />
         </main>
 
         <div ref={drawerSideRef} className="drawer-side z-50 h-full">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cryptiklemur/lattice",
-  "version": "1.38.0",
+  "version": "1.40.0",
   "description": "Multi-machine agentic dashboard for Claude Code. Monitor sessions, manage MCP servers and skills, orchestrate across mesh-networked nodes.",
   "license": "MIT",
   "author": "Aaron Scherer <me@aaronscherer.me>",

package/server/src/daemon.ts

@@ -401,7 +401,7 @@ export async function startDaemon(portOverride?: number | null): Promise<void> {
     var remoteProjects = getAllRemoteProjects(currentIdentity.id);
     broadcast({
       type: "projects:list",
-      projects: localProjects.concat(remoteProjects as typeof localProjects),
+      projects: localProjects.concat(remoteProjects as unknown as typeof localProjects),
     });
     var updateInfo = getCachedUpdateInfo();
     if (updateInfo && updateInfo.updateAvailable) {

package/server/src/handlers/mesh.ts

@@ -1,4 +1,5 @@
 import type { ClientMessage, MeshPairMessage, MeshUnpairMessage, NodeInfo } from "@lattice/shared";
+import { log } from "../logger";
 import { registerHandler } from "../ws/router";
 import { sendTo, broadcast } from "../ws/broadcast";
 import { loadConfig } from "../config";
@@ -122,6 +123,8 @@ export function buildNodesMessage(): NodeInfo[] {
 }
 
 registerHandler("mesh", function (clientId: string, message: ClientMessage) {
+  log.meshHello("mesh message: %s from %s", (message as any).type, clientId.slice(0, 8));
+
   if (message.type === "mesh:generate_invite") {
     var genMsg = message as any as { type: "mesh:generate_invite"; address?: string };
     var config = loadConfig();
@@ -232,14 +235,17 @@ registerHandler("mesh", function (clientId: string, message: ClientMessage) {
     var hello = message as any as { type: "mesh:hello"; nodeId: string; name: string; publicKey?: string; token?: string; port?: number; addresses?: string[]; projects: Array<{ slug: string; title: string }> };
 
     var knownPeer = hello.nodeId ? getPeer(hello.nodeId) : undefined;
+    log.meshHello("mesh:hello from nodeId=%s name=%s known=%s", hello.nodeId?.slice(0, 8), hello.name, !!knownPeer);
 
     if (knownPeer) {
       if (knownPeer.publicKey && hello.publicKey && knownPeer.publicKey !== hello.publicKey) {
+        log.meshHello("  ✗ public key mismatch for %s", hello.name);
         sendTo(clientId, { type: "mesh:hello_rejected" as any, error: "Public key mismatch — possible impersonation" });
         return;
       }
 
       var inboundWs = getClientWebSocket(clientId);
+      log.meshHello("  registering inbound connection for %s (ws=%s)", hello.name, !!inboundWs);
       if (inboundWs) {
         registerInboundPeer(hello.nodeId, inboundWs as any);
       }

package/server/src/index.ts

@@ -224,6 +224,9 @@ function runHelp(): void {
   console.log("  Environment:");
   console.log("    LATTICE_HOME   Data directory (default: ~/.lattice)");
   console.log("    LATTICE_PORT   Server port (default: 7654)");
+  console.log("    DEBUG          Enable debug logging (e.g. DEBUG=lattice:*)");
+  console.log("                   Scopes: server,ws,router,mesh,mesh:connect,mesh:hello,");
+  console.log("                   mesh:proxy,broadcast,chat,session,plugins,update");
   console.log("");
 }
 

package/server/src/logger.ts

@@ -6,7 +6,16 @@ export var log = {
   chat: createDebug("lattice:chat"),
   session: createDebug("lattice:session"),
   mesh: createDebug("lattice:mesh"),
+  meshConnect: createDebug("lattice:mesh:connect"),
+  meshHello: createDebug("lattice:mesh:hello"),
+  meshProxy: createDebug("lattice:mesh:proxy"),
+  router: createDebug("lattice:router"),
+  broadcast: createDebug("lattice:broadcast"),
   auth: createDebug("lattice:auth"),
   fs: createDebug("lattice:fs"),
   analytics: createDebug("lattice:analytics"),
+  plugins: createDebug("lattice:plugins"),
+  update: createDebug("lattice:update"),
+  terminal: createDebug("lattice:terminal"),
+  settings: createDebug("lattice:settings"),
 };

package/server/src/mesh/connector.ts

@@ -17,6 +17,7 @@ interface PeerConnection {
 }
 
 var connections = new Map<string, PeerConnection>();
+var lastKnownProjects = new Map<string, Array<{ slug: string; title: string }>>();
 var connectedCallbacks: Array<(nodeId: string) => void> = [];
 var disconnectedCallbacks: Array<(nodeId: string) => void> = [];
 var messageCallbacks: Array<(nodeId: string, msg: MeshMessage) => void> = [];
@@ -46,11 +47,18 @@ function reconcilePeers(): void {
   var peers = loadPeers();
   for (var i = 0; i < peers.length; i++) {
     var peer = peers[i];
-    if (!peer.addresses || peer.addresses.length === 0) continue;
+    if (!peer.addresses || peer.addresses.length === 0) {
+      log.meshConnect("skip %s — no addresses", peer.name);
+      continue;
+    }
     var existing = connections.get(peer.id);
     if (existing && !existing.dead && existing.ws.readyState === WebSocket.OPEN) continue;
-    if (existing && !existing.dead && existing.retryTimer !== null) continue;
+    if (existing && !existing.dead && existing.retryTimer !== null) {
+      log.meshConnect("skip %s — retry pending", peer.name);
+      continue;
+    }
     if (!existing || existing.dead) {
+      log.meshConnect("connecting to %s at %s", peer.name, peer.addresses[0]);
       connections.delete(peer.id);
       connectToPeer(peer.id, peer.addresses[0]);
     }
@@ -103,6 +111,7 @@ function openConnection(conn: PeerConnection, url: string): void {
   var circuit = circuitBreakers.get(conn.nodeId);
   if (circuit && circuit.failures >= CIRCUIT_BREAKER_THRESHOLD && !circuit.halfOpen) {
     if (Date.now() < circuit.openUntil) {
+      log.meshConnect("circuit breaker open for %s, retry in %dms", conn.nodeId.slice(0, 8), circuit.openUntil - Date.now());
       conn.retryTimer = setTimeout(function () {
         if (conn.dead) return;
         conn.retryTimer = null;
@@ -114,12 +123,13 @@ function openConnection(conn: PeerConnection, url: string): void {
     circuit.halfOpen = true;
   }
 
+  log.meshConnect("opening WebSocket to %s", url);
   var ws = new WebSocket(url);
   conn.ws = ws;
 
   var connectionTimer = setTimeout(function () {
     if (ws.readyState !== WebSocket.OPEN) {
-      log.mesh("Connection timeout for peer: %s", conn.nodeId);
+      log.meshConnect("connection timeout for %s at %s", conn.nodeId.slice(0, 8), url);
       ws.close();
     }
   }, CONNECTION_TIMEOUT_MS);
@@ -167,6 +177,9 @@ function openConnection(conn: PeerConnection, url: string): void {
 
       if (msg.type === "mesh:hello") {
         conn.projects = msg.projects;
+        if (msg.projects.length > 0) {
+          lastKnownProjects.set(conn.nodeId, msg.projects);
+        }
       } else if (msg.type === "mesh:session_sync") {
         handleSessionSync(conn.nodeId, msg as MeshSessionSyncMessage);
       } else if (msg.type === "mesh:session_request") {
@@ -242,8 +255,10 @@ export function getPeerConnection(nodeId: string): WebSocket | undefined {
 export function registerInboundPeer(nodeId: string, ws: { send: (data: string) => void; readyState: number }): void {
   var existing = connections.get(nodeId);
   if (existing && !existing.dead && existing.ws.readyState === WebSocket.OPEN) {
+    log.meshConnect("inbound peer %s already connected, skipping", nodeId.slice(0, 8));
     return;
   }
+  log.meshConnect("registering inbound peer %s", nodeId.slice(0, 8));
 
   if (existing) {
     existing.dead = true;
@@ -347,21 +362,33 @@ export function getConnectedPeerProjects(nodeId: string): Array<{ slug: string;
   return conn.projects;
 }
 
-export function getAllRemoteProjects(localNodeId: string): Array<{ slug: string; path: string; title: string; nodeId: string; nodeName: string; isRemote: boolean }> {
-  var results: Array<{ slug: string; path: string; title: string; nodeId: string; nodeName: string; isRemote: boolean }> = [];
-  for (var [nodeId, conn] of connections) {
-    if (conn.ws.readyState !== WebSocket.OPEN) continue;
-    var peers = require("./peers") as typeof import("./peers");
-    var peer = peers.getPeer(nodeId);
-    var peerName = peer ? peer.name : nodeId;
-    for (var i = 0; i < conn.projects.length; i++) {
+export function getAllRemoteProjects(localNodeId: string): Array<{ slug: string; path: string; title: string; nodeId: string; nodeName: string; isRemote: boolean; online: boolean }> {
+  var peersModule = require("./peers") as typeof import("./peers");
+  var allPeers = peersModule.loadPeers();
+  var connectedIds = new Set(getConnectedPeerIds());
+  var results: Array<{ slug: string; path: string; title: string; nodeId: string; nodeName: string; isRemote: boolean; online: boolean }> = [];
+
+  for (var p = 0; p < allPeers.length; p++) {
+    var peer = allPeers[p];
+    var isOnline = connectedIds.has(peer.id);
+    var projects: Array<{ slug: string; title: string }> = [];
+
+    var conn = connections.get(peer.id);
+    if (conn && conn.projects.length > 0) {
+      projects = conn.projects;
+    } else if (lastKnownProjects.has(peer.id)) {
+      projects = lastKnownProjects.get(peer.id)!;
+    }
+
+    for (var i = 0; i < projects.length; i++) {
       results.push({
-        slug: conn.projects[i].slug,
+        slug: projects[i].slug,
         path: "",
-        title: conn.projects[i].title,
-        nodeId: nodeId,
-        nodeName: peerName,
+        title: projects[i].title,
+        nodeId: peer.id,
+        nodeName: peer.name,
         isRemote: true,
+        online: isOnline,
       });
     }
   }

package/server/src/mesh/proxy.ts

@@ -3,19 +3,22 @@ import type { ClientMessage, MeshProxyRequestMessage, MeshProxyResponseMessage,
 import { getPeerConnection } from "./connector";
 import { sendTo, broadcast, registerVirtualClient, removeVirtualClient } from "../ws/broadcast";
 import { routeMessage } from "../ws/router";
+import { log } from "../logger";
 
 var pendingRequests = new Map<string, string>();
 
 export function proxyToRemoteNode(nodeId: string, projectSlug: string, clientId: string, message: ClientMessage): void {
+  log.meshProxy("→ proxy %s to node %s for project %s", (message as any).type, nodeId.slice(0, 8), projectSlug);
   var ws = getPeerConnection(nodeId);
   if (!ws) {
-    console.warn("[mesh/proxy] No connection to peer: " + nodeId);
-    sendTo(clientId, { type: "chat:error", message: "Remote node " + nodeId + " is not connected" });
+    log.meshProxy("  ✗ no connection to node %s", nodeId.slice(0, 8));
+    sendTo(clientId, { type: "chat:error", message: "Remote node is not connected" });
     return;
   }
 
   var requestId = randomUUID();
   pendingRequests.set(requestId, clientId);
+  log.meshProxy("  envelope requestId=%s", requestId.slice(0, 8));
 
   var envelope: MeshProxyRequestMessage = {
     type: "mesh:proxy_request",
@@ -29,8 +32,10 @@ export function proxyToRemoteNode(nodeId: string, projectSlug: string, clientId:
 
 export function handleProxyRequest(sourceNodeId: string, msg: MeshProxyRequestMessage): void {
   var proxyClientId = "mesh-proxy:" + sourceNodeId + ":" + msg.requestId;
+  log.meshProxy("← proxy_request from %s: %s for %s (reqId=%s)", sourceNodeId.slice(0, 8), (msg.payload as any).type, msg.projectSlug, msg.requestId.slice(0, 8));
 
   registerVirtualClient(proxyClientId, function (response: object) {
+    log.meshProxy("  → proxy_response %s back to %s", (response as any).type, sourceNodeId.slice(0, 8));
     var ws = getPeerConnection(sourceNodeId);
     if (!ws) {
       console.warn("[mesh/proxy] Cannot send response, no connection to: " + sourceNodeId);
@@ -53,9 +58,10 @@ export function handleProxyRequest(sourceNodeId: string, msg: MeshProxyRequestMe
 }
 
 export function handleProxyResponse(msg: MeshProxyResponseMessage): void {
+  log.meshProxy("← proxy_response %s (reqId=%s)", (msg.payload as any).type, msg.requestId.slice(0, 8));
   var clientId = pendingRequests.get(msg.requestId);
   if (!clientId) {
-    console.warn("[mesh/proxy] No pending request for id: " + msg.requestId);
+    log.meshProxy("  ✗ no pending request for %s", msg.requestId.slice(0, 8));
     return;
   }
 

package/server/src/ws/broadcast.ts

@@ -37,6 +37,11 @@ export function sendTo(id: string, message: object): void {
   var virtualHandler = virtualSendHandlers.get(id);
   if (virtualHandler) {
     virtualHandler(message);
+    return;
+  }
+  if (id.startsWith("mesh-proxy:")) {
+    var { log } = require("../logger");
+    log.broadcast("  ✗ sendTo %s but no virtual handler registered (msg=%s)", id.slice(0, 30), (message as any).type);
   }
 }
 

package/server/src/ws/router.ts

@@ -53,6 +53,8 @@ export function getClientRemoteNode(clientId: string): { nodeId: string; project
 export function routeMessage(clientId: string, message: ClientMessage): void {
   var prefix = message.type.split(":")[0];
 
+  log.router("→ %s from client %s (prefix=%s)", message.type, clientId.slice(0, 8), prefix);
+
   if (PROXIED_PREFIXES.has(prefix)) {
     var remote = clientRemoteNode.get(clientId);
 
@@ -60,17 +62,21 @@ export function routeMessage(clientId: string, message: ClientMessage): void {
 
     if (msgSlug) {
       var localProject = getLocalProject(msgSlug);
+      log.router("  slug=%s local=%s", msgSlug, localProject);
       if (!localProject) {
         var remoteEntry = getRemoteNodeForProject(msgSlug);
         if (remoteEntry) {
+          log.router("  → proxying to remote node %s for project %s", remoteEntry.nodeId.slice(0, 8), msgSlug);
           setClientRemoteNode(clientId, remoteEntry.nodeId, msgSlug);
           proxyMessage(clientId, remoteEntry.nodeId, msgSlug, message);
           return;
         }
+        log.router("  ✗ no remote node found for slug %s", msgSlug);
       } else if (message.type === "session:activate" || message.type === "session:list_request") {
         clearClientRemoteNode(clientId);
       }
     } else if (remote) {
+      log.router("  → proxying via cached remote node %s", remote.nodeId.slice(0, 8));
       proxyMessage(clientId, remote.nodeId, remote.projectSlug, message);
       return;
     }
@@ -78,6 +84,7 @@ export function routeMessage(clientId: string, message: ClientMessage): void {
 
   var handler = handlers.get(prefix);
   if (handler) {
+    log.router("  → dispatching to %s handler", prefix);
     try {
       var result = handler(clientId, message);
       if (result && typeof result.then === "function") {
@@ -94,7 +101,7 @@ export function routeMessage(clientId: string, message: ClientMessage): void {
     }
     return;
   }
-  log.ws("No handler for message type: %s", message.type);
+  log.router("  ✗ no handler for %s", message.type);
   sendTo(clientId, { type: "error", message: `Unknown message type: ${message.type}` });
 }
 

package/shared/src/models.ts

@@ -21,6 +21,7 @@ export interface ProjectSummary {
 export interface ProjectInfo extends ProjectSummary {
   nodeName: string;
   isRemote: boolean;
+  online?: boolean;
   ideProjectName?: string;
 }