meshy-node 0.0.7 → 0.0.9

package/main.cjs

@@ -14251,11 +14251,11 @@ var require_mime_types = __commonJS({
       }
       return exts[0];
     }
-    function lookup(path16) {
-      if (!path16 || typeof path16 !== "string") {
+    function lookup(path17) {
+      if (!path17 || typeof path17 !== "string") {
         return false;
       }
-      var extension2 = extname3("x." + path16).toLowerCase().substr(1);
+      var extension2 = extname3("x." + path17).toLowerCase().substr(1);
       if (!extension2) {
         return false;
       }
@@ -17773,7 +17773,7 @@ var require_path_to_regexp = __commonJS({
     "use strict";
     module2.exports = pathToRegexp;
     var MATCHING_GROUP_REGEXP = /\\.|\((?:\?<(.*?)>)?(?!\?)/g;
-    function pathToRegexp(path16, keys, options) {
+    function pathToRegexp(path17, keys, options) {
       options = options || {};
       keys = keys || [];
       var strict = options.strict;
@@ -17787,8 +17787,8 @@ var require_path_to_regexp = __commonJS({
       var pos = 0;
       var backtrack = "";
       var m;
-      if (path16 instanceof RegExp) {
-        while (m = MATCHING_GROUP_REGEXP.exec(path16.source)) {
+      if (path17 instanceof RegExp) {
+        while (m = MATCHING_GROUP_REGEXP.exec(path17.source)) {
           if (m[0][0] === "\\") continue;
           keys.push({
             name: m[1] || name++,
@@ -17796,18 +17796,18 @@ var require_path_to_regexp = __commonJS({
             offset: m.index
           });
         }
-        return path16;
+        return path17;
       }
-      if (Array.isArray(path16)) {
-        path16 = path16.map(function(value) {
+      if (Array.isArray(path17)) {
+        path17 = path17.map(function(value) {
           return pathToRegexp(value, keys, options).source;
         });
-        return new RegExp(path16.join("|"), flags);
+        return new RegExp(path17.join("|"), flags);
       }
-      if (typeof path16 !== "string") {
+      if (typeof path17 !== "string") {
         throw new TypeError("path must be a string, array of strings, or regular expression");
       }
-      path16 = path16.replace(
+      path17 = path17.replace(
         /\\.|(\/)?(\.)?:(\w+)(\(.*?\))?(\*)?(\?)?|[.*]|\/\(/g,
         function(match, slash, format, key, capture, star, optional, offset) {
           if (match[0] === "\\") {
@@ -17824,7 +17824,7 @@ var require_path_to_regexp = __commonJS({
           if (slash || format) {
             backtrack = "";
           } else {
-            backtrack += path16.slice(pos, offset);
+            backtrack += path17.slice(pos, offset);
           }
           pos = offset + match.length;
           if (match === "*") {
@@ -17854,7 +17854,7 @@ var require_path_to_regexp = __commonJS({
           return result;
         }
       );
-      while (m = MATCHING_GROUP_REGEXP.exec(path16)) {
+      while (m = MATCHING_GROUP_REGEXP.exec(path17)) {
         if (m[0][0] === "\\") continue;
         if (keysOffset + i === keys.length || keys[keysOffset + i].offset > m.index) {
           keys.splice(keysOffset + i, 0, {
@@ -17866,13 +17866,13 @@ var require_path_to_regexp = __commonJS({
         }
         i++;
       }
-      path16 += strict ? "" : path16[path16.length - 1] === "/" ? "?" : "/?";
+      path17 += strict ? "" : path17[path17.length - 1] === "/" ? "?" : "/?";
       if (end) {
-        path16 += "$";
-      } else if (path16[path16.length - 1] !== "/") {
-        path16 += lookahead ? "(?=/|$)" : "(?:/|$)";
+        path17 += "$";
+      } else if (path17[path17.length - 1] !== "/") {
+        path17 += lookahead ? "(?=/|$)" : "(?:/|$)";
       }
-      return new RegExp("^" + path16, flags);
+      return new RegExp("^" + path17, flags);
     }
   }
 });
@@ -17885,19 +17885,19 @@ var require_layer = __commonJS({
     var debug = require_src()("express:router:layer");
     var hasOwnProperty = Object.prototype.hasOwnProperty;
     module2.exports = Layer;
-    function Layer(path16, options, fn) {
+    function Layer(path17, options, fn) {
       if (!(this instanceof Layer)) {
-        return new Layer(path16, options, fn);
+        return new Layer(path17, options, fn);
       }
-      debug("new %o", path16);
+      debug("new %o", path17);
       var opts = options || {};
       this.handle = fn;
       this.name = fn.name || "<anonymous>";
       this.params = void 0;
       this.path = void 0;
-      this.regexp = pathRegexp(path16, this.keys = [], opts);
-      this.regexp.fast_star = path16 === "*";
-      this.regexp.fast_slash = path16 === "/" && opts.end === false;
+      this.regexp = pathRegexp(path17, this.keys = [], opts);
+      this.regexp.fast_star = path17 === "*";
+      this.regexp.fast_slash = path17 === "/" && opts.end === false;
     }
     Layer.prototype.handle_error = function handle_error(error, req, res, next) {
       var fn = this.handle;
@@ -17921,20 +17921,20 @@ var require_layer = __commonJS({
         next(err);
       }
     };
-    Layer.prototype.match = function match(path16) {
+    Layer.prototype.match = function match(path17) {
       var match2;
-      if (path16 != null) {
+      if (path17 != null) {
         if (this.regexp.fast_slash) {
           this.params = {};
           this.path = "";
           return true;
         }
         if (this.regexp.fast_star) {
-          this.params = { "0": decode_param(path16) };
-          this.path = path16;
+          this.params = { "0": decode_param(path17) };
+          this.path = path17;
           return true;
         }
-        match2 = this.regexp.exec(path16);
+        match2 = this.regexp.exec(path17);
       }
       if (!match2) {
         this.params = void 0;
@@ -18027,10 +18027,10 @@ var require_route = __commonJS({
     var slice = Array.prototype.slice;
     var toString = Object.prototype.toString;
     module2.exports = Route;
-    function Route(path16) {
-      this.path = path16;
+    function Route(path17) {
+      this.path = path17;
       this.stack = [];
-      debug("new %o", path16);
+      debug("new %o", path17);
       this.methods = {};
     }
     Route.prototype._handles_method = function _handles_method(method) {
@@ -18243,8 +18243,8 @@ var require_router = __commonJS({
         if (++sync > 100) {
           return setImmediate(next, err);
         }
-        var path16 = getPathname(req);
-        if (path16 == null) {
+        var path17 = getPathname(req);
+        if (path17 == null) {
           return done(layerError);
         }
         var layer;
@@ -18252,7 +18252,7 @@ var require_router = __commonJS({
         var route;
         while (match !== true && idx < stack.length) {
           layer = stack[idx++];
-          match = matchLayer(layer, path16);
+          match = matchLayer(layer, path17);
           route = layer.route;
           if (typeof match !== "boolean") {
             layerError = layerError || match;
@@ -18290,18 +18290,18 @@ var require_router = __commonJS({
           } else if (route) {
             layer.handle_request(req, res, next);
           } else {
-            trim_prefix(layer, layerError, layerPath, path16);
+            trim_prefix(layer, layerError, layerPath, path17);
           }
           sync = 0;
         });
       }
-      function trim_prefix(layer, layerError, layerPath, path16) {
+      function trim_prefix(layer, layerError, layerPath, path17) {
         if (layerPath.length !== 0) {
-          if (layerPath !== path16.slice(0, layerPath.length)) {
+          if (layerPath !== path17.slice(0, layerPath.length)) {
             next(layerError);
             return;
           }
-          var c = path16[layerPath.length];
+          var c = path17[layerPath.length];
           if (c && c !== "/" && c !== ".") return next(layerError);
           debug("trim prefix (%s) from url %s", layerPath, req.url);
           removed = layerPath;
@@ -18379,7 +18379,7 @@ var require_router = __commonJS({
     };
     proto.use = function use(fn) {
       var offset = 0;
-      var path16 = "/";
+      var path17 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -18387,7 +18387,7 @@ var require_router = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path16 = fn;
+          path17 = fn;
         }
       }
       var callbacks = flatten(slice.call(arguments, offset));
@@ -18399,8 +18399,8 @@ var require_router = __commonJS({
         if (typeof fn !== "function") {
           throw new TypeError("Router.use() requires a middleware function but got a " + gettype(fn));
         }
-        debug("use %o %s", path16, fn.name || "<anonymous>");
-        var layer = new Layer(path16, {
+        debug("use %o %s", path17, fn.name || "<anonymous>");
+        var layer = new Layer(path17, {
           sensitive: this.caseSensitive,
           strict: false,
           end: false
@@ -18410,9 +18410,9 @@ var require_router = __commonJS({
       }
       return this;
     };
-    proto.route = function route(path16) {
-      var route2 = new Route(path16);
-      var layer = new Layer(path16, {
+    proto.route = function route(path17) {
+      var route2 = new Route(path17);
+      var layer = new Layer(path17, {
         sensitive: this.caseSensitive,
         strict: this.strict,
         end: true
@@ -18422,8 +18422,8 @@ var require_router = __commonJS({
       return route2;
     };
     methods.concat("all").forEach(function(method) {
-      proto[method] = function(path16) {
-        var route = this.route(path16);
+      proto[method] = function(path17) {
+        var route = this.route(path17);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
@@ -18459,9 +18459,9 @@ var require_router = __commonJS({
       }
       return toString.call(obj).replace(objectRegExp, "$1");
     }
-    function matchLayer(layer, path16) {
+    function matchLayer(layer, path17) {
       try {
-        return layer.match(path16);
+        return layer.match(path17);
       } catch (err) {
         return err;
       }
@@ -18579,13 +18579,13 @@ var require_view = __commonJS({
   "../../node_modules/.pnpm/express@4.22.1/node_modules/express/lib/view.js"(exports2, module2) {
     "use strict";
     var debug = require_src()("express:view");
-    var path16 = require("path");
+    var path17 = require("path");
     var fs17 = require("fs");
-    var dirname3 = path16.dirname;
-    var basename4 = path16.basename;
-    var extname3 = path16.extname;
-    var join12 = path16.join;
-    var resolve10 = path16.resolve;
+    var dirname3 = path17.dirname;
+    var basename4 = path17.basename;
+    var extname3 = path17.extname;
+    var join13 = path17.join;
+    var resolve10 = path17.resolve;
     module2.exports = View;
     function View(name, options) {
       var opts = options || {};
@@ -18614,17 +18614,17 @@ var require_view = __commonJS({
       this.path = this.lookup(fileName);
     }
     View.prototype.lookup = function lookup(name) {
-      var path17;
+      var path18;
       var roots = [].concat(this.root);
       debug('lookup "%s"', name);
-      for (var i = 0; i < roots.length && !path17; i++) {
+      for (var i = 0; i < roots.length && !path18; i++) {
         var root = roots[i];
         var loc = resolve10(root, name);
         var dir = dirname3(loc);
         var file = basename4(loc);
-        path17 = this.resolve(dir, file);
+        path18 = this.resolve(dir, file);
       }
-      return path17;
+      return path18;
     };
     View.prototype.render = function render(options, callback) {
       debug('render "%s"', this.path);
@@ -18632,21 +18632,21 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve11(dir, file) {
       var ext = this.ext;
-      var path17 = join12(dir, file);
-      var stat = tryStat(path17);
+      var path18 = join13(dir, file);
+      var stat = tryStat(path18);
       if (stat && stat.isFile()) {
-        return path17;
+        return path18;
       }
-      path17 = join12(dir, basename4(file, ext), "index" + ext);
-      stat = tryStat(path17);
+      path18 = join13(dir, basename4(file, ext), "index" + ext);
+      stat = tryStat(path18);
       if (stat && stat.isFile()) {
-        return path17;
+        return path18;
       }
     };
-    function tryStat(path17) {
-      debug('stat "%s"', path17);
+    function tryStat(path18) {
+      debug('stat "%s"', path18);
       try {
-        return fs17.statSync(path17);
+        return fs17.statSync(path18);
       } catch (e) {
         return void 0;
       }
@@ -19002,7 +19002,7 @@ var require_types = __commonJS({
 var require_mime = __commonJS({
   "../../node_modules/.pnpm/mime@1.6.0/node_modules/mime/mime.js"(exports2, module2) {
     "use strict";
-    var path16 = require("path");
+    var path17 = require("path");
     var fs17 = require("fs");
     function Mime() {
       this.types = /* @__PURE__ */ Object.create(null);
@@ -19032,8 +19032,8 @@ var require_mime = __commonJS({
       this.define(map);
       this._loading = null;
     };
-    Mime.prototype.lookup = function(path17, fallback) {
-      var ext = path17.replace(/^.*[\.\/\\]/, "").toLowerCase();
+    Mime.prototype.lookup = function(path18, fallback) {
+      var ext = path18.replace(/^.*[\.\/\\]/, "").toLowerCase();
       return this.types[ext] || fallback || this.default_type;
     };
     Mime.prototype.extension = function(mimeType) {
@@ -19268,28 +19268,28 @@ var require_send = __commonJS({
     var ms = require_ms2();
     var onFinished = require_on_finished();
     var parseRange = require_range_parser();
-    var path16 = require("path");
+    var path17 = require("path");
     var statuses = require_statuses();
     var Stream = require("stream");
     var util2 = require("util");
-    var extname3 = path16.extname;
-    var join12 = path16.join;
-    var normalize = path16.normalize;
-    var resolve10 = path16.resolve;
-    var sep3 = path16.sep;
+    var extname3 = path17.extname;
+    var join13 = path17.join;
+    var normalize = path17.normalize;
+    var resolve10 = path17.resolve;
+    var sep3 = path17.sep;
     var BYTES_RANGE_REGEXP = /^ *bytes=/;
     var MAX_MAXAGE = 60 * 60 * 24 * 365 * 1e3;
     var UP_PATH_REGEXP = /(?:^|[\\/])\.\.(?:[\\/]|$)/;
     module2.exports = send;
     module2.exports.mime = mime;
-    function send(req, path17, options) {
-      return new SendStream(req, path17, options);
+    function send(req, path18, options) {
+      return new SendStream(req, path18, options);
     }
-    function SendStream(req, path17, options) {
+    function SendStream(req, path18, options) {
       Stream.call(this);
       var opts = options || {};
       this.options = opts;
-      this.path = path17;
+      this.path = path18;
       this.req = req;
       this._acceptRanges = opts.acceptRanges !== void 0 ? Boolean(opts.acceptRanges) : true;
       this._cacheControl = opts.cacheControl !== void 0 ? Boolean(opts.cacheControl) : true;
@@ -19335,8 +19335,8 @@ var require_send = __commonJS({
       this._index = index2;
       return this;
     }, "send.index: pass index as option");
-    SendStream.prototype.root = function root(path17) {
-      this._root = resolve10(String(path17));
+    SendStream.prototype.root = function root(path18) {
+      this._root = resolve10(String(path18));
       debug("root %s", this._root);
       return this;
     };
@@ -19449,10 +19449,10 @@ var require_send = __commonJS({
       var lastModified = this.res.getHeader("Last-Modified");
       return parseHttpDate(lastModified) <= parseHttpDate(ifRange);
     };
-    SendStream.prototype.redirect = function redirect(path17) {
+    SendStream.prototype.redirect = function redirect(path18) {
       var res = this.res;
       if (hasListeners(this, "directory")) {
-        this.emit("directory", res, path17);
+        this.emit("directory", res, path18);
         return;
       }
       if (this.hasTrailingSlash()) {
@@ -19472,42 +19472,42 @@ var require_send = __commonJS({
     SendStream.prototype.pipe = function pipe(res) {
       var root = this._root;
       this.res = res;
-      var path17 = decode(this.path);
-      if (path17 === -1) {
+      var path18 = decode(this.path);
+      if (path18 === -1) {
         this.error(400);
         return res;
       }
-      if (~path17.indexOf("\0")) {
+      if (~path18.indexOf("\0")) {
         this.error(400);
         return res;
       }
       var parts;
       if (root !== null) {
-        if (path17) {
-          path17 = normalize("." + sep3 + path17);
+        if (path18) {
+          path18 = normalize("." + sep3 + path18);
         }
-        if (UP_PATH_REGEXP.test(path17)) {
-          debug('malicious path "%s"', path17);
+        if (UP_PATH_REGEXP.test(path18)) {
+          debug('malicious path "%s"', path18);
           this.error(403);
           return res;
         }
-        parts = path17.split(sep3);
-        path17 = normalize(join12(root, path17));
+        parts = path18.split(sep3);
+        path18 = normalize(join13(root, path18));
       } else {
-        if (UP_PATH_REGEXP.test(path17)) {
-          debug('malicious path "%s"', path17);
+        if (UP_PATH_REGEXP.test(path18)) {
+          debug('malicious path "%s"', path18);
           this.error(403);
           return res;
         }
-        parts = normalize(path17).split(sep3);
-        path17 = resolve10(path17);
+        parts = normalize(path18).split(sep3);
+        path18 = resolve10(path18);
       }
       if (containsDotFile(parts)) {
         var access = this._dotfiles;
         if (access === void 0) {
           access = parts[parts.length - 1][0] === "." ? this._hidden ? "allow" : "ignore" : "allow";
         }
-        debug('%s dotfile "%s"', access, path17);
+        debug('%s dotfile "%s"', access, path18);
         switch (access) {
           case "allow":
             break;
@@ -19521,13 +19521,13 @@ var require_send = __commonJS({
         }
       }
       if (this._index.length && this.hasTrailingSlash()) {
-        this.sendIndex(path17);
+        this.sendIndex(path18);
         return res;
       }
-      this.sendFile(path17);
+      this.sendFile(path18);
       return res;
     };
-    SendStream.prototype.send = function send2(path17, stat) {
+    SendStream.prototype.send = function send2(path18, stat) {
       var len = stat.size;
       var options = this.options;
       var opts = {};
@@ -19539,9 +19539,9 @@ var require_send = __commonJS({
         this.headersAlreadySent();
         return;
       }
-      debug('pipe "%s"', path17);
-      this.setHeader(path17, stat);
-      this.type(path17);
+      debug('pipe "%s"', path18);
+      this.setHeader(path18, stat);
+      this.type(path18);
       if (this.isConditionalGET()) {
         if (this.isPreconditionFailure()) {
           this.error(412);
@@ -19590,26 +19590,26 @@ var require_send = __commonJS({
         res.end();
         return;
       }
-      this.stream(path17, opts);
+      this.stream(path18, opts);
     };
-    SendStream.prototype.sendFile = function sendFile(path17) {
+    SendStream.prototype.sendFile = function sendFile(path18) {
       var i = 0;
       var self = this;
-      debug('stat "%s"', path17);
-      fs17.stat(path17, function onstat(err, stat) {
-        if (err && err.code === "ENOENT" && !extname3(path17) && path17[path17.length - 1] !== sep3) {
+      debug('stat "%s"', path18);
+      fs17.stat(path18, function onstat(err, stat) {
+        if (err && err.code === "ENOENT" && !extname3(path18) && path18[path18.length - 1] !== sep3) {
           return next(err);
         }
         if (err) return self.onStatError(err);
-        if (stat.isDirectory()) return self.redirect(path17);
-        self.emit("file", path17, stat);
-        self.send(path17, stat);
+        if (stat.isDirectory()) return self.redirect(path18);
+        self.emit("file", path18, stat);
+        self.send(path18, stat);
       });
       function next(err) {
         if (self._extensions.length <= i) {
           return err ? self.onStatError(err) : self.error(404);
         }
-        var p = path17 + "." + self._extensions[i++];
+        var p = path18 + "." + self._extensions[i++];
         debug('stat "%s"', p);
         fs17.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -19619,7 +19619,7 @@ var require_send = __commonJS({
         });
       }
     };
-    SendStream.prototype.sendIndex = function sendIndex(path17) {
+    SendStream.prototype.sendIndex = function sendIndex(path18) {
       var i = -1;
       var self = this;
       function next(err) {
@@ -19627,7 +19627,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join12(path17, self._index[i]);
+        var p = join13(path18, self._index[i]);
         debug('stat "%s"', p);
         fs17.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -19638,10 +19638,10 @@ var require_send = __commonJS({
       }
       next();
     };
-    SendStream.prototype.stream = function stream(path17, options) {
+    SendStream.prototype.stream = function stream(path18, options) {
       var self = this;
       var res = this.res;
-      var stream2 = fs17.createReadStream(path17, options);
+      var stream2 = fs17.createReadStream(path18, options);
       this.emit("stream", stream2);
       stream2.pipe(res);
       function cleanup() {
@@ -19656,10 +19656,10 @@ var require_send = __commonJS({
         self.emit("end");
       });
     };
-    SendStream.prototype.type = function type(path17) {
+    SendStream.prototype.type = function type(path18) {
       var res = this.res;
       if (res.getHeader("Content-Type")) return;
-      var type2 = mime.lookup(path17);
+      var type2 = mime.lookup(path18);
       if (!type2) {
         debug("no content-type");
         return;
@@ -19668,9 +19668,9 @@ var require_send = __commonJS({
       debug("content-type %s", type2);
       res.setHeader("Content-Type", type2 + (charset ? "; charset=" + charset : ""));
     };
-    SendStream.prototype.setHeader = function setHeader(path17, stat) {
+    SendStream.prototype.setHeader = function setHeader(path18, stat) {
       var res = this.res;
-      this.emit("headers", res, path17, stat);
+      this.emit("headers", res, path18, stat);
       if (this._acceptRanges && !res.getHeader("Accept-Ranges")) {
         debug("accept ranges");
         res.setHeader("Accept-Ranges", "bytes");
@@ -19729,9 +19729,9 @@ var require_send = __commonJS({
       }
       return err instanceof Error ? createError(status, err, { expose: false }) : createError(status, err);
     }
-    function decode(path17) {
+    function decode(path18) {
       try {
-        return decodeURIComponent(path17);
+        return decodeURIComponent(path18);
       } catch (err) {
         return -1;
       }
@@ -20641,10 +20641,10 @@ var require_utils2 = __commonJS({
     var querystring = require("querystring");
     exports2.etag = createETagGenerator({ weak: false });
     exports2.wetag = createETagGenerator({ weak: true });
-    exports2.isAbsolute = function(path16) {
-      if ("/" === path16[0]) return true;
-      if (":" === path16[1] && ("\\" === path16[2] || "/" === path16[2])) return true;
-      if ("\\\\" === path16.substring(0, 2)) return true;
+    exports2.isAbsolute = function(path17) {
+      if ("/" === path17[0]) return true;
+      if (":" === path17[1] && ("\\" === path17[2] || "/" === path17[2])) return true;
+      if ("\\\\" === path17.substring(0, 2)) return true;
     };
     exports2.flatten = deprecate.function(
       flatten,
@@ -20855,7 +20855,7 @@ var require_application = __commonJS({
     };
     app.use = function use(fn) {
       var offset = 0;
-      var path16 = "/";
+      var path17 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -20863,7 +20863,7 @@ var require_application = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path16 = fn;
+          path17 = fn;
         }
       }
       var fns = flatten(slice.call(arguments, offset));
@@ -20874,12 +20874,12 @@ var require_application = __commonJS({
       var router = this._router;
       fns.forEach(function(fn2) {
         if (!fn2 || !fn2.handle || !fn2.set) {
-          return router.use(path16, fn2);
+          return router.use(path17, fn2);
         }
-        debug(".use app under %s", path16);
-        fn2.mountpath = path16;
+        debug(".use app under %s", path17);
+        fn2.mountpath = path17;
         fn2.parent = this;
-        router.use(path16, function mounted_app(req, res, next) {
+        router.use(path17, function mounted_app(req, res, next) {
           var orig = req.app;
           fn2.handle(req, res, function(err) {
             setPrototypeOf(req, orig.request);
@@ -20891,9 +20891,9 @@ var require_application = __commonJS({
       }, this);
       return this;
     };
-    app.route = function route(path16) {
+    app.route = function route(path17) {
       this.lazyrouter();
-      return this._router.route(path16);
+      return this._router.route(path17);
     };
     app.engine = function engine(ext, fn) {
       if (typeof fn !== "function") {
@@ -20944,7 +20944,7 @@ var require_application = __commonJS({
       }
       return this;
     };
-    app.path = function path16() {
+    app.path = function path17() {
       return this.parent ? this.parent.path() + this.mountpath : "";
     };
     app.enabled = function enabled(setting) {
@@ -20960,19 +20960,19 @@ var require_application = __commonJS({
       return this.set(setting, false);
     };
     methods.forEach(function(method) {
-      app[method] = function(path16) {
+      app[method] = function(path17) {
         if (method === "get" && arguments.length === 1) {
-          return this.set(path16);
+          return this.set(path17);
         }
         this.lazyrouter();
-        var route = this._router.route(path16);
+        var route = this._router.route(path17);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
     });
-    app.all = function all(path16) {
+    app.all = function all(path17) {
       this.lazyrouter();
-      var route = this._router.route(path16);
+      var route = this._router.route(path17);
       var args = slice.call(arguments, 1);
       for (var i = 0; i < methods.length; i++) {
         route[methods[i]].apply(route, args);
@@ -21731,7 +21731,7 @@ var require_request = __commonJS({
       var subdomains2 = !isIP(hostname2) ? hostname2.split(".").reverse() : [hostname2];
       return subdomains2.slice(offset);
     });
-    defineGetter(req, "path", function path16() {
+    defineGetter(req, "path", function path17() {
       return parse(this).pathname;
     });
     defineGetter(req, "hostname", function hostname2() {
@@ -22054,7 +22054,7 @@ var require_response = __commonJS({
     var http2 = require("http");
     var isAbsolute2 = require_utils2().isAbsolute;
     var onFinished = require_on_finished();
-    var path16 = require("path");
+    var path17 = require("path");
     var statuses = require_statuses();
     var merge = require_utils_merge();
     var sign = require_cookie_signature().sign;
@@ -22063,9 +22063,9 @@ var require_response = __commonJS({
     var setCharset = require_utils2().setCharset;
     var cookie = require_cookie();
     var send = require_send();
-    var extname3 = path16.extname;
+    var extname3 = path17.extname;
     var mime = send.mime;
-    var resolve10 = path16.resolve;
+    var resolve10 = path17.resolve;
     var vary = require_vary();
     var res = Object.create(http2.ServerResponse.prototype);
     module2.exports = res;
@@ -22242,26 +22242,26 @@ var require_response = __commonJS({
       this.type("txt");
       return this.send(body);
     };
-    res.sendFile = function sendFile(path17, options, callback) {
+    res.sendFile = function sendFile(path18, options, callback) {
       var done = callback;
       var req = this.req;
       var res2 = this;
       var next = req.next;
       var opts = options || {};
-      if (!path17) {
+      if (!path18) {
         throw new TypeError("path argument is required to res.sendFile");
       }
-      if (typeof path17 !== "string") {
+      if (typeof path18 !== "string") {
         throw new TypeError("path must be a string to res.sendFile");
       }
       if (typeof options === "function") {
         done = options;
         opts = {};
       }
-      if (!opts.root && !isAbsolute2(path17)) {
+      if (!opts.root && !isAbsolute2(path18)) {
         throw new TypeError("path must be absolute or specify root to res.sendFile");
       }
-      var pathname = encodeURI(path17);
+      var pathname = encodeURI(path18);
       var file = send(req, pathname, opts);
       sendfile(res2, file, opts, function(err) {
         if (done) return done(err);
@@ -22271,7 +22271,7 @@ var require_response = __commonJS({
         }
       });
     };
-    res.sendfile = function(path17, options, callback) {
+    res.sendfile = function(path18, options, callback) {
       var done = callback;
       var req = this.req;
       var res2 = this;
@@ -22281,7 +22281,7 @@ var require_response = __commonJS({
         done = options;
         opts = {};
       }
-      var file = send(req, path17, opts);
+      var file = send(req, path18, opts);
       sendfile(res2, file, opts, function(err) {
         if (done) return done(err);
         if (err && err.code === "EISDIR") return next();
@@ -22294,7 +22294,7 @@ var require_response = __commonJS({
       res.sendfile,
       "res.sendfile: Use res.sendFile instead"
     );
-    res.download = function download(path17, filename, options, callback) {
+    res.download = function download(path18, filename, options, callback) {
       var done = callback;
       var name = filename;
       var opts = options || null;
@@ -22311,7 +22311,7 @@ var require_response = __commonJS({
         opts = filename;
       }
       var headers = {
-        "Content-Disposition": contentDisposition(name || path17)
+        "Content-Disposition": contentDisposition(name || path18)
       };
       if (opts && opts.headers) {
         var keys = Object.keys(opts.headers);
@@ -22324,7 +22324,7 @@ var require_response = __commonJS({
       }
       opts = Object.create(opts);
       opts.headers = headers;
-      var fullPath = !opts.root ? resolve10(path17) : path17;
+      var fullPath = !opts.root ? resolve10(path18) : path18;
       return this.sendFile(fullPath, opts, done);
     };
     res.contentType = res.type = function contentType(type) {
@@ -22625,11 +22625,11 @@ var require_serve_static = __commonJS({
         }
         var forwardError = !fallthrough;
         var originalUrl = parseUrl.original(req);
-        var path16 = parseUrl(req).pathname;
-        if (path16 === "/" && originalUrl.pathname.substr(-1) !== "/") {
-          path16 = "";
+        var path17 = parseUrl(req).pathname;
+        if (path17 === "/" && originalUrl.pathname.substr(-1) !== "/") {
+          path17 = "";
         }
-        var stream = send(req, path16, opts);
+        var stream = send(req, path17, opts);
         stream.on("directory", onDirectory);
         if (setHeaders) {
           stream.on("headers", setHeaders);
@@ -22774,6 +22774,7 @@ __export(main_exports, {
   applyStartMetadata: () => applyStartMetadata,
   createDefaultConfig: () => createDefaultConfig,
   createRuntimeDefaultConfig: () => createRuntimeDefaultConfig,
+  ensureStartupRequirements: () => ensureStartupRequirements,
   formatBanner: () => formatBanner,
   formatLoadedStartMetadata: () => formatLoadedStartMetadata,
   getDefaultNodeName: () => getDefaultNodeName,
@@ -22784,8 +22785,10 @@ __export(main_exports, {
   parseArgs: () => parseArgs,
   promptStartOptions: () => promptStartOptions,
   resolveRuntimeAuthMetadata: () => resolveRuntimeAuthMetadata,
+  resolveStartupRequirementsMetadata: () => resolveStartupRequirementsMetadata,
   shouldCollectStartOptions: () => shouldCollectStartOptions,
-  shouldPromptForStartOptions: () => shouldPromptForStartOptions
+  shouldPromptForStartOptions: () => shouldPromptForStartOptions,
+  shouldSkipStartupRequirementsCheck: () => shouldSkipStartupRequirementsCheck
 });
 module.exports = __toCommonJS(main_exports);
 var nodePath = __toESM(require("path"), 1);
@@ -24010,14 +24013,19 @@ async function fetchWithTimeout(url, init, timeoutMs = DEFAULT_NODE_REQUEST_TIME
     cleanup();
   }
 }
-async function fetchNodeWithFallback(node, path16, init, timeoutMs = DEFAULT_NODE_REQUEST_TIMEOUT_MS) {
+async function fetchNodeWithFallback(node, path17, init, timeoutMs = DEFAULT_NODE_REQUEST_TIMEOUT_MS, trace) {
   let lastError;
-  for (const endpoint of getNodeRequestEndpoints(node)) {
+  const endpoints = getNodeRequestEndpoints(node);
+  for (const [index, endpoint] of endpoints.entries()) {
+    const attempt = index + 1;
+    trace?.onAttempt?.({ attempt, endpoint, path: path17, timeoutMs, totalEndpoints: endpoints.length });
     try {
-      const response = await fetchWithTimeout(`${endpoint}${path16}`, init, timeoutMs);
+      const response = await fetchWithTimeout(`${endpoint}${path17}`, init, timeoutMs);
+      trace?.onResponse?.({ attempt, endpoint, path: path17, response, timeoutMs, totalEndpoints: endpoints.length });
       return { endpoint, response };
     } catch (error) {
       lastError = error;
+      trace?.onError?.({ attempt, endpoint, error, path: path17, timeoutMs, totalEndpoints: endpoints.length });
     }
   }
   throw lastError instanceof Error ? lastError : new Error("No reachable node endpoint");
@@ -24332,15 +24340,18 @@ var LeaderElection = class {
     if (announce.term < this.currentTerm) {
       return;
     }
-    if (announce.term > this.currentTerm) {
-      this.currentTerm = announce.term;
-    }
-    this.leader = false;
-    this.nodeRegistry.setLeader(announce.leaderId, announce.term);
-    this.eventBus.emit("election.complete", {
-      leaderId: announce.leaderId,
-      term: announce.term
-    });
+    this.adoptLeader(announce);
+  }
+  /**
+   * Explicit cluster joins are operator-driven reconfiguration, not normal
+   * election traffic. Force the local node to follow the joined leader even
+   * if this node previously incremented its term while detached.
+   */
+  adoptLeaderFromJoin(announce) {
+    this.currentTerm = announce.term;
+    this.votedForTerm = announce.term;
+    this.votedForCandidate = announce.leaderId;
+    this.adoptLeader(announce);
   }
   // ── Leader Lease ─────────────────────────────────────────────────────
   isLeader() {
@@ -24352,6 +24363,18 @@ var LeaderElection = class {
   stepDown() {
     this.leader = false;
   }
+  /**
+   * Adopt local leadership without running an election.
+   * Used when a follower explicitly detaches from a leader and becomes
+   * a solo node immediately.
+   */
+  assumeLeadership() {
+    const self = this.nodeRegistry.getSelf();
+    this.currentTerm = Math.max(this.currentTerm, 1);
+    this.votedForTerm = this.currentTerm;
+    this.votedForCandidate = self.id;
+    this.becomeLeader();
+  }
   /** Manually promote this node to leader. */
   async promote() {
     const self = this.nodeRegistry.getSelf();
@@ -24389,6 +24412,15 @@ var LeaderElection = class {
       term: this.currentTerm
     });
   }
+  adoptLeader(announce) {
+    this.currentTerm = announce.term;
+    this.leader = false;
+    this.nodeRegistry.setLeader(announce.leaderId, announce.term);
+    this.eventBus.emit("election.complete", {
+      leaderId: announce.leaderId,
+      term: announce.term
+    });
+  }
   async broadcastAnnounce(leaderId, term) {
     const self = this.nodeRegistry.getSelf();
     const onlineNodes = this.nodeRegistry.getOnlineNodes().filter(
@@ -24990,6 +25022,24 @@ function listWorkDirFolders(workDir) {
 
 // ../../packages/core/src/heartbeat.ts
 var MISSED_HEARTBEAT_THRESHOLD = 3;
+var DEFAULT_KEEPALIVE_INTERVAL_MS = 3e3;
+var HEARTBEAT_SUCCESS_LOG_INTERVAL_MS = 6e4;
+var HEARTBEAT_FAILURE_LOG_INTERVAL_MS = 1e4;
+function formatError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function truncateForLog(value, max = 240) {
+  return !value || value.length <= max ? value : `${value.slice(0, max - 3)}...`;
+}
+function describeControlRequest(request) {
+  return {
+    requestId: request.requestId,
+    kind: request.kind,
+    taskId: request.taskId,
+    path: request.path,
+    enabled: request.enabled
+  };
+}
 var HeartbeatMonitor = class {
   constructor(nodeRegistry, election, eventBus, config, logger) {
     this.nodeRegistry = nodeRegistry;
@@ -25042,6 +25092,8 @@ var HeartbeatMonitor = class {
   pendingControlResponses = /* @__PURE__ */ new Map();
   /** Follower-side callback for executing keepalive-delivered control requests. */
   controlRequestHandler;
+  /** Throttle repetitive heartbeat / keepalive logs while preserving periodic visibility. */
+  throttledLogs = /* @__PURE__ */ new Map();
   /** Set the callback used to query tasks assigned to a follower for pull-based dispatch. */
   setGetAssignedTasks(fn) {
     this.getAssignedTasks = fn;
@@ -25082,10 +25134,9 @@ var HeartbeatMonitor = class {
     const queued = this.queuedControlRequests.get(nodeId) ?? [];
     queued.push(fullRequest);
     this.queuedControlRequests.set(nodeId, queued);
-    this.log.info("queued control request for keepalive delivery", {
+    this.log.info("queued keepalive control request", {
       nodeId,
-      requestId: fullRequest.requestId,
-      kind: fullRequest.kind
+      ...describeControlRequest(fullRequest)
     });
     return new Promise((resolve10, reject) => {
       const timeoutId = setTimeout(() => {
@@ -25094,6 +25145,7 @@ var HeartbeatMonitor = class {
       }, timeoutMs);
       this.pendingControlResponses.set(fullRequest.requestId, {
         nodeId,
+        kind: fullRequest.kind,
         resolve: resolve10,
         reject,
         timeoutId
@@ -25111,6 +25163,13 @@ var HeartbeatMonitor = class {
     }
     clearTimeout(pending.timeoutId);
     this.pendingControlResponses.delete(response.requestId);
+    this.log.info("received keepalive control response", {
+      requestId: response.requestId,
+      nodeId: pending.nodeId,
+      kind: pending.kind,
+      ok: response.ok,
+      statusCode: response.statusCode
+    });
     pending.resolve(response);
     return true;
   }
@@ -25167,10 +25226,46 @@ var HeartbeatMonitor = class {
     };
     const promises2 = followers.map(async (node) => {
       try {
-        const { response } = await fetchNodeWithFallback(node, "/api/worker/heartbeat", {
+        const { endpoint, response } = await fetchNodeWithFallback(node, "/api/worker/heartbeat", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(request)
+        }, void 0, {
+          onAttempt: ({ attempt, endpoint: targetEndpoint, totalEndpoints, timeoutMs }) => {
+            this.log.debug("sending heartbeat request", {
+              nodeId: node.id,
+              endpoint: targetEndpoint,
+              attempt,
+              totalEndpoints,
+              timeoutMs,
+              term: request.term
+            });
+          },
+          onError: ({ attempt, endpoint: targetEndpoint, error, totalEndpoints }) => {
+            this.logWithThrottle(
+              "warn",
+              `heartbeat-attempt-failure:${node.id}`,
+              HEARTBEAT_FAILURE_LOG_INTERVAL_MS,
+              "heartbeat request attempt failed",
+              {
+                nodeId: node.id,
+                endpoint: targetEndpoint,
+                attempt,
+                totalEndpoints,
+                error: formatError(error)
+              }
+            );
+          },
+          onResponse: ({ attempt, endpoint: targetEndpoint, response: heartbeatResponse, totalEndpoints }) => {
+            this.log.debug("heartbeat response received", {
+              nodeId: node.id,
+              endpoint: targetEndpoint,
+              attempt,
+              totalEndpoints,
+              ok: heartbeatResponse.ok,
+              statusCode: heartbeatResponse.status
+            });
+          }
         });
         if (response.ok) {
           const result = await response.json();
@@ -25187,11 +25282,33 @@ var HeartbeatMonitor = class {
           if (result.status !== node.status) {
             this.nodeRegistry.updateStatus(node.id, result.status);
           }
+          this.logWithThrottle(
+            "info",
+            `heartbeat-success:${node.id}`,
+            HEARTBEAT_SUCCESS_LOG_INTERVAL_MS,
+            "heartbeat response applied",
+            {
+              nodeId: node.id,
+              endpoint,
+              reportedStatus: result.status,
+              load: result.load,
+              workDirFolders: result.workDirFolders?.length ?? 0
+            }
+          );
           return;
         }
-        this.recordFollowerMiss(node);
-      } catch {
-        this.recordFollowerMiss(node);
+        const body = truncateForLog(await response.text().catch(() => void 0));
+        this.recordFollowerMiss(node, {
+          endpoint,
+          reason: "non-ok heartbeat response",
+          statusCode: response.status,
+          body
+        });
+      } catch (error) {
+        this.recordFollowerMiss(node, {
+          reason: "heartbeat request threw",
+          error: formatError(error)
+        });
       }
     });
     await Promise.all(promises2);
@@ -25215,7 +25332,7 @@ var HeartbeatMonitor = class {
       term: req.term,
       nodeCount: req.clusterState.nodes.length
     });
-    return {
+    const response = {
       nodeId: self.id,
       status: self.status,
       runningTasks: [],
@@ -25227,6 +25344,7 @@ var HeartbeatMonitor = class {
       previewOrigin: self.previewOrigin,
       workDirFolders: self.workDir ? listWorkDirFolders(self.workDir) : void 0
     };
+    return response;
   }
   // ── Leader: handle keepalive from follower ──────────────────────────
   handleKeepalive(req) {
@@ -25250,7 +25368,6 @@ var HeartbeatMonitor = class {
     const normalizedEndpoint = endpoint ?? existingNode?.endpoint ?? devtunnelEndpoint ?? "";
     const normalizedCapabilities = capabilities ?? existingNode?.capabilities ?? [];
     const currentCapabilities = existingNode?.capabilities ?? [];
-    this.log.debug("keepalive received", { nodeId, status });
     this.followerMissedMap.set(nodeId, 0);
     let node = existingNode;
     const now = Date.now();
@@ -25317,7 +25434,16 @@ var HeartbeatMonitor = class {
     if (controlRequests.length > 0) {
       this.queuedControlRequests.delete(nodeId);
     }
-    return {
+    if (dispatchedTasks.length > 0 || followUpMessages.length > 0 || controlRequests.length > 0) {
+      this.log.info("keepalive delivering queued work", {
+        nodeId,
+        dispatchedTaskCount: dispatchedTasks.length,
+        followUpCount: followUpMessages.length,
+        controlRequestCount: controlRequests.length,
+        controlRequestKinds: controlRequests.map((request) => request.kind)
+      });
+    }
+    const response = {
       leaderId: self.id,
       term: this.election.getCurrentTerm(),
       timestamp: Date.now(),
@@ -25329,6 +25455,7 @@ var HeartbeatMonitor = class {
       followUpMessages: followUpMessages.length > 0 ? followUpMessages : void 0,
       controlRequests: controlRequests.length > 0 ? controlRequests : void 0
     };
+    return response;
   }
   // ── Follower: send keepalive to leader ──────────────────────────────
   async sendKeepalive() {
@@ -25353,6 +25480,13 @@ var HeartbeatMonitor = class {
       previewOrigin: self.previewOrigin,
       workDirFolders: self.workDir ? listWorkDirFolders(self.workDir) : void 0
     };
+    this.log.debug("sending keepalive request", {
+      nodeId: self.id,
+      leaderEndpoint,
+      status: self.status,
+      workDirFolders: request.workDirFolders?.length ?? 0,
+      devtunnelEnabled: request.devtunnelEnabled
+    });
     try {
       const response = await fetch(`${leaderEndpoint}/api/worker/keepalive`, applyRequestAuthHeaders({
         method: "POST",
@@ -25361,7 +25495,22 @@ var HeartbeatMonitor = class {
       }));
       if (response.ok) {
         const result = await response.json();
-        this.log.debug("keepalive ok", { nodes: result.clusterState.nodes.length });
+        const hasQueuedWork = (result.dispatchedTasks?.length ?? 0) > 0 || (result.followUpMessages?.length ?? 0) > 0 || (result.controlRequests?.length ?? 0) > 0;
+        this.logWithThrottle(
+          "info",
+          `keepalive-success:${leaderEndpoint}`,
+          HEARTBEAT_SUCCESS_LOG_INTERVAL_MS,
+          "keepalive response received",
+          {
+            leaderId: result.leaderId,
+            term: result.term,
+            nodeCount: result.clusterState.nodes.length,
+            dispatchedTaskCount: result.dispatchedTasks?.length ?? 0,
+            followUpCount: result.followUpMessages?.length ?? 0,
+            controlRequestCount: result.controlRequests?.length ?? 0
+          },
+          hasQueuedWork
+        );
         this.lastHeartbeatTime = Date.now();
         this.missedCount = 0;
         this.nodeRegistry.setLeader(result.leaderId, result.term);
@@ -25386,15 +25535,39 @@ var HeartbeatMonitor = class {
           }
         }
         if (result.controlRequests && result.controlRequests.length > 0) {
+          this.log.info("processing keepalive control requests", {
+            leaderEndpoint,
+            controlRequestCount: result.controlRequests.length,
+            controlRequestKinds: result.controlRequests.map((request2) => request2.kind)
+          });
           await Promise.all(result.controlRequests.map(
             (request2) => this.processControlRequest(leaderEndpoint, request2)
           ));
         }
       } else {
-        this.log.warn("keepalive failed", { status: response.status, leaderEndpoint });
+        this.logWithThrottle(
+          "warn",
+          `keepalive-failure:${leaderEndpoint}`,
+          HEARTBEAT_FAILURE_LOG_INTERVAL_MS,
+          "keepalive request returned non-ok response",
+          {
+            leaderEndpoint,
+            statusCode: response.status,
+            body: truncateForLog(await response.text().catch(() => void 0))
+          }
+        );
       }
     } catch (err) {
-      this.log.warn("keepalive error", { error: err instanceof Error ? err.message : String(err) });
+      this.logWithThrottle(
+        "warn",
+        `keepalive-failure:${leaderEndpoint}`,
+        HEARTBEAT_FAILURE_LOG_INTERVAL_MS,
+        "keepalive request failed",
+        {
+          leaderEndpoint,
+          error: formatError(err)
+        }
+      );
     }
   }
   // ── Accessors ───────────────────────────────────────────────────────
@@ -25407,13 +25580,30 @@ var HeartbeatMonitor = class {
   canPushToNode(nodeId) {
     const node = this.nodeRegistry.getNode(nodeId);
     if (!node) return false;
-    if (node.devtunnelEndpoint) return true;
-    return this.followerEverReachedMap.get(nodeId) ?? false;
+    if (node.status === "offline") return false;
+    return !!(node.devtunnelEndpoint || node.endpoint);
   }
   // ── Private helpers ─────────────────────────────────────────────────
   startLeaderMode() {
     this.heartbeatTimer = setInterval(() => {
-      void this.sendHeartbeat();
+      const self = this.nodeRegistry.getSelf();
+      if (self.workDir) {
+        this.nodeRegistry.updateFolders(self.id, listWorkDirFolders(self.workDir));
+      }
+      const now = Date.now();
+      const followers = this.nodeRegistry.getAllNodes().filter((node) => node.id !== self.id);
+      for (const node of followers) {
+        if (node.status === "offline") continue;
+        const elapsed = now - node.lastHeartbeat;
+        if (elapsed >= this.config.electionTimeout) {
+          this.log.warn("marking node offline from stale follower keepalive", {
+            nodeId: node.id,
+            lastHeartbeat: node.lastHeartbeat,
+            elapsed
+          });
+          this.nodeRegistry.updateStatus(node.id, "offline");
+        }
+      }
     }, this.config.heartbeatInterval);
   }
   startFollowerMode() {
@@ -25424,9 +25614,10 @@ var HeartbeatMonitor = class {
     this.startKeepalive();
   }
   startKeepalive() {
+    const keepaliveInterval = Math.min(this.config.heartbeatInterval, DEFAULT_KEEPALIVE_INTERVAL_MS);
     this.keepaliveTimer = setInterval(() => {
       void this.sendKeepalive();
-    }, this.config.heartbeatInterval);
+    }, keepaliveInterval);
   }
   resetFollowerTimer() {
     if (this.followerTimer !== null) {
@@ -25447,10 +25638,27 @@ var HeartbeatMonitor = class {
       }
     }, this.config.electionTimeout);
   }
-  recordFollowerMiss(node) {
+  recordFollowerMiss(node, details) {
     const current = this.followerMissedMap.get(node.id) ?? 0;
     const newCount = current + 1;
     this.followerMissedMap.set(node.id, newCount);
+    const everReached = this.followerEverReachedMap.get(node.id) ?? false;
+    this.logWithThrottle(
+      "warn",
+      `heartbeat-miss:${node.id}`,
+      HEARTBEAT_FAILURE_LOG_INTERVAL_MS,
+      "recorded heartbeat miss",
+      {
+        nodeId: node.id,
+        misses: newCount,
+        everReached,
+        endpoint: details.endpoint,
+        statusCode: details.statusCode,
+        reason: details.reason,
+        error: details.error,
+        body: details.body
+      }
+    );
     if (newCount >= MISSED_HEARTBEAT_THRESHOLD) {
       const freshNode = this.nodeRegistry.getNode(node.id);
       if (freshNode) {
@@ -25459,13 +25667,20 @@ var HeartbeatMonitor = class {
           this.log.debug("miss threshold but lastHeartbeat recent \u2014 skip offline", {
             nodeId: node.id,
             elapsed,
-            everReached: this.followerEverReachedMap.get(node.id) ?? false
+            everReached
           });
           return;
         }
       }
-      const everReached = this.followerEverReachedMap.get(node.id) ?? false;
-      this.log.warn("marking node offline", { nodeId: node.id, everReached, misses: newCount });
+      this.log.warn("marking node offline", {
+        nodeId: node.id,
+        everReached,
+        misses: newCount,
+        endpoint: details.endpoint,
+        statusCode: details.statusCode,
+        reason: details.reason,
+        error: details.error
+      });
       this.nodeRegistry.updateStatus(node.id, "offline");
     }
   }
@@ -25493,6 +25708,10 @@ var HeartbeatMonitor = class {
     }
   }
   async processControlRequest(leaderEndpoint, request) {
+    this.log.info("processing keepalive control request", {
+      leaderEndpoint,
+      ...describeControlRequest(request)
+    });
     let response;
     if (!this.controlRequestHandler) {
       response = {
@@ -25527,6 +25746,12 @@ var HeartbeatMonitor = class {
         };
       }
     }
+    this.log.info("completed keepalive control request", {
+      leaderEndpoint,
+      ...describeControlRequest(request),
+      ok: response.ok,
+      statusCode: response.statusCode
+    });
     try {
       const res = await fetch(`${leaderEndpoint}/api/worker/control-response`, applyRequestAuthHeaders({
         method: "POST",
@@ -25550,6 +25775,21 @@ var HeartbeatMonitor = class {
       });
     }
   }
+  logWithThrottle(level, key, intervalMs, message, data, force = false) {
+    const now = Date.now();
+    const existing = this.throttledLogs.get(key);
+    if (existing && !force && now - existing.lastLoggedAt < intervalMs) {
+      existing.suppressedCount += 1;
+      return;
+    }
+    const mergedData = existing && existing.suppressedCount > 0 ? { ...data, suppressedCount: existing.suppressedCount } : data;
+    this.throttledLogs.set(key, { lastLoggedAt: now, suppressedCount: 0 });
+    if (level === "info") {
+      this.log.info(message, mergedData);
+      return;
+    }
+    this.log.warn(message, mergedData);
+  }
 };
 
 // ../../packages/core/src/data-router.ts
@@ -25577,9 +25817,9 @@ var DataRouter = class {
   /**
    * Returns true if the request should be proxied to the leader.
    */
-  shouldProxy(method, path16) {
+  shouldProxy(method, path17) {
     if (this.election.isLeader()) return false;
-    if (this.isExcludedPath(path16)) return false;
+    if (this.isExcludedPath(path17)) return false;
     if (method.toUpperCase() === "GET") return false;
     return WRITE_METHODS.has(method.toUpperCase());
   }
@@ -25680,8 +25920,8 @@ var DataRouter = class {
     };
   }
   // ── Helpers ───────────────────────────────────────────────────────────
-  isExcludedPath(path16) {
-    return EXCLUDED_PATH_PREFIXES.some((prefix) => path16.startsWith(prefix)) || EXCLUDED_PATH_SUFFIXES.some((suffix) => path16.endsWith(suffix));
+  isExcludedPath(path17) {
+    return EXCLUDED_PATH_PREFIXES.some((prefix) => path17.startsWith(prefix)) || EXCLUDED_PATH_SUFFIXES.some((suffix) => path17.endsWith(suffix));
   }
 };
 
@@ -26693,23 +26933,53 @@ ${joinErrors.map((e) => `  - ${e}`).join("\n")}`
     this.started = true;
   }
   async joinCluster(seedUrl) {
+    const log = this.logger.child("node/join-cluster");
+    const tasks = this.taskEngine.listTasks().tasks;
     const joinBody = {
       id: this.selfInfo.id,
       endpoint: this.selfInfo.endpoint,
       name: this.config.node.name,
       capabilities: [],
-      tasks: this.taskEngine.listTasks().tasks
+      tasks
     };
     if (this.selfInfo.devtunnelEndpoint) {
       joinBody.devtunnelEndpoint = this.selfInfo.devtunnelEndpoint;
     }
-    const response = await fetch(`${seedUrl}/api/cluster/join`, applyRequestAuthHeaders({
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(joinBody)
-    }));
+    log.info("sending cluster join request", {
+      seedUrl,
+      nodeId: this.selfInfo.id,
+      endpoint: this.selfInfo.endpoint,
+      taskCount: tasks.length,
+      hasDevTunnel: !!this.selfInfo.devtunnelEndpoint
+    });
+    let response;
+    try {
+      response = await fetch(`${seedUrl}/api/cluster/join`, applyRequestAuthHeaders({
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(joinBody)
+      }));
+    } catch (error) {
+      log.warn("cluster join request failed", {
+        seedUrl,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    }
+    log.info("received cluster join response", {
+      seedUrl,
+      ok: response.ok,
+      statusCode: response.status
+    });
     if (!response.ok) {
       const body = await response.json?.().catch(() => null);
+      log.warn("cluster join request rejected", {
+        seedUrl,
+        statusCode: response.status,
+        code: body?.error?.code,
+        message: body?.error?.message,
+        leaderEndpoint: body?.error?.leaderEndpoint
+      });
       if (body?.error?.code === "NOT_LEADER") {
         const leader = body.error.leaderEndpoint;
         throw new Error(
@@ -26719,22 +26989,51 @@ ${joinErrors.map((e) => `  - ${e}`).join("\n")}`
       throw new Error(`Failed to join cluster via ${seedUrl}: ${response.status}`);
     }
     const data = await response.json();
+    log.info("applied joined cluster state", {
+      seedUrl,
+      leaderId: data.leaderId,
+      term: data.term,
+      nodeCount: data.nodes.length
+    });
     this.applyClusterState(data.nodes, data.leaderId, data.term);
   }
   async leaveCluster() {
+    const log = this.logger.child("node/leave-cluster");
     const leader = this.nodeRegistry.getLeader();
     const leaderEndpoint = this.nodeRegistry.getLeaderEndpoint();
     const self = this.nodeRegistry.getSelf();
     if (!leader || !leaderEndpoint || leader.id === self.id) {
+      log.info("skipping cluster leave request", {
+        hasLeader: !!leader,
+        leaderEndpoint,
+        selfId: self.id
+      });
       return;
     }
     try {
-      await fetch(`${leaderEndpoint}/api/cluster/leave`, applyRequestAuthHeaders({
+      log.info("sending cluster leave request", {
+        leaderId: leader.id,
+        leaderEndpoint,
+        nodeId: self.id
+      });
+      const response = await fetch(`${leaderEndpoint}/api/cluster/leave`, applyRequestAuthHeaders({
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ nodeId: self.id })
       }));
-    } catch {
+      log.info("received cluster leave response", {
+        leaderId: leader.id,
+        leaderEndpoint,
+        ok: response.ok,
+        statusCode: response.status
+      });
+    } catch (error) {
+      log.warn("cluster leave request failed", {
+        leaderId: leader.id,
+        leaderEndpoint,
+        nodeId: self.id,
+        error: error instanceof Error ? error.message : String(error)
+      });
     }
     const refreshedSelf = {
       ...self,
@@ -26747,8 +27046,13 @@ ${joinErrors.map((e) => `  - ${e}`).join("\n")}`
     this.nodeRegistry.setSelf(refreshedSelf);
     this.nodeRegistry.syncFromHeartbeat([refreshedSelf]);
     this.nodeRegistry.clearLeader();
-    this.election.stepDown();
-    await this.election.startElection();
+    this.election.assumeLeadership();
+    this.syncSelfInfoFromRegistry();
+    log.info("detached from leader and assumed solo leadership", {
+      previousLeaderId: leader.id,
+      nodeId: refreshedSelf.id,
+      term: this.election.getCurrentTerm()
+    });
   }
   async stop() {
     if (!this.started) return;
@@ -26758,13 +27062,26 @@ ${joinErrors.map((e) => `  - ${e}`).join("\n")}`
     try {
       const leaderEndpoint = this.nodeRegistry.getLeaderEndpoint();
       if (leaderEndpoint) {
-        await fetch(`${leaderEndpoint}/api/cluster/leave`, applyRequestAuthHeaders({
+        this.logger.info("sending shutdown cluster leave request", {
+          leaderEndpoint,
+          nodeId: this.selfInfo.id
+        });
+        const response = await fetch(`${leaderEndpoint}/api/cluster/leave`, applyRequestAuthHeaders({
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ nodeId: this.selfInfo.id })
         }));
+        this.logger.info("received shutdown cluster leave response", {
+          leaderEndpoint,
+          ok: response.ok,
+          statusCode: response.status
+        });
       }
-    } catch {
+    } catch (error) {
+      this.logger.warn("shutdown cluster leave request failed", {
+        nodeId: this.selfInfo.id,
+        error: error instanceof Error ? error.message : String(error)
+      });
     }
     if (this.devtunnelTransport) {
       await this.devtunnelTransport.stop();
@@ -26925,7 +27242,7 @@ ${joinErrors.map((e) => `  - ${e}`).join("\n")}`
     this.selfInfo = nextSelf;
     this.nodeRegistry.setSelf(nextSelf);
     this.nodeRegistry.syncFromHeartbeat(nodes);
-    this.election.handleLeaderAnnounce({ leaderId, term });
+    this.election.adoptLeaderFromJoin({ leaderId, term });
   }
   cloneTransportConfig(config) {
     return {
@@ -27564,8 +27881,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path16, errorMaps, issueData } = params;
-  const fullPath = [...path16, ...issueData.path || []];
+  const { data, path: path17, errorMaps, issueData } = params;
+  const fullPath = [...path17, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -27681,11 +27998,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path16, key) {
+  constructor(parent, value, path17, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path16;
+    this._path = path17;
     this._key = key;
   }
   get path() {
@@ -31560,19 +31877,31 @@ function createErrorMiddleware() {
 // ../../packages/api/src/routes/cluster.ts
 var import_express = __toESM(require_express2(), 1);
 var CONNECTIVITY_TIMEOUT_MS = 8e3;
-async function verifyHealth(endpoint) {
+function formatError2(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function verifyHealth(endpoint, log) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), CONNECTIVITY_TIMEOUT_MS);
+  const url = `${endpoint}/api/system/health`;
   try {
-    const response = await fetch(`${endpoint}/api/system/health`, {
+    log.info("sending leader health check", { endpoint, url, timeoutMs: CONNECTIVITY_TIMEOUT_MS });
+    const response = await fetch(url, {
       signal: controller.signal
     });
+    log.info("received leader health check response", {
+      endpoint,
+      url,
+      ok: response.ok,
+      statusCode: response.status
+    });
     if (!response.ok) {
       throw new Error(`health check returned ${response.status}`);
     }
   } catch (err) {
+    log.warn("leader health check failed", { endpoint, url, error: formatError2(err) });
     throw new Error(
-      `Failed to verify connectivity for ${endpoint}: ${err instanceof Error ? err.message : String(err)}`
+      `Failed to verify connectivity for ${endpoint}: ${formatError2(err)}`
     );
   } finally {
     clearTimeout(timer);
@@ -31584,9 +31913,11 @@ function asyncHandler(fn) {
 function createClusterRoutes() {
   const router = (0, import_express.Router)();
   router.post("/join", asyncHandler(async (req, res) => {
-    const { nodeRegistry, election, taskEngine } = req.app.locals.deps;
+    const { nodeRegistry, election, taskEngine, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("cluster/join");
     if (!election.isLeader()) {
       const leaderEndpoint = nodeRegistry.getLeaderEndpoint();
+      log.warn("rejected cluster join because node is not leader", { leaderEndpoint });
       res.status(421).json({
         error: {
           code: "NOT_LEADER",
@@ -31597,10 +31928,19 @@ function createClusterRoutes() {
       return;
     }
     const body = JoinClusterBody.parse(req.body);
+    log.info("received cluster join request", {
+      nodeId: body.id,
+      name: body.name,
+      endpoint: body.endpoint,
+      taskCount: body.tasks?.length ?? 0,
+      hasDevTunnel: !!body.devtunnelEndpoint
+    });
     const existingNodes = nodeRegistry.getAllNodes();
+    let removedCount = 0;
     for (const existing of existingNodes) {
       if (existing.id === body.id || existing.endpoint === body.endpoint || existing.name === body.name) {
         nodeRegistry.removeNode(existing.id);
+        removedCount++;
       }
     }
     const node = {
@@ -31616,6 +31956,12 @@ function createClusterRoutes() {
     };
     nodeRegistry.addNode(node);
     taskEngine.importTasks(body.tasks ?? []);
+    log.info("accepted cluster join request", {
+      nodeId: node.id,
+      endpoint: node.endpoint,
+      removedCount,
+      importedTaskCount: body.tasks?.length ?? 0
+    });
     const clusterState = nodeRegistry.getClusterState();
     res.status(201).json({
       clusterId: clusterState.clusterId ?? nanoid(),
@@ -31627,14 +31973,22 @@ function createClusterRoutes() {
   router.post("/connect", asyncHandler(async (req, res) => {
     const {
       nodeRegistry,
-      joinCurrentNodeToCluster
+      joinCurrentNodeToCluster,
+      logger: rootLogger
     } = req.app.locals.deps;
+    const log = rootLogger.child("cluster/connect");
     const body = ConnectClusterBody.parse(req.body);
+    log.info("received cluster connect request", {
+      leaderEndpoint: body.leaderEndpoint,
+      transport: body.transport
+    });
     if (!joinCurrentNodeToCluster) {
       throw new MeshyError("VALIDATION_ERROR", "Join flow is not available on this node", 501);
     }
-    await verifyHealth(body.leaderEndpoint);
+    await verifyHealth(body.leaderEndpoint, log);
+    log.info("leader health check succeeded", { leaderEndpoint: body.leaderEndpoint });
     await joinCurrentNodeToCluster(body.leaderEndpoint);
+    log.info("completed cluster connect request", { leaderEndpoint: body.leaderEndpoint });
     const self = nodeRegistry.getSelf();
     const clusterState = nodeRegistry.getClusterState();
     res.json({
@@ -31647,17 +32001,22 @@ function createClusterRoutes() {
     });
   }));
   router.post("/leave", asyncHandler(async (req, res) => {
-    const { nodeRegistry } = req.app.locals.deps;
+    const { nodeRegistry, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("cluster/leave");
     const { nodeId } = req.body;
+    log.info("received cluster leave request", { nodeId });
     nodeRegistry.removeNode(nodeId);
     res.json({ ok: true });
   }));
   router.post("/disconnect", asyncHandler(async (req, res) => {
-    const { leaveCurrentCluster, nodeRegistry } = req.app.locals.deps;
+    const { leaveCurrentCluster, nodeRegistry, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("cluster/disconnect");
+    log.info("received cluster disconnect request");
     if (!leaveCurrentCluster) {
       throw new MeshyError("VALIDATION_ERROR", "Leave flow is not available on this node", 501);
     }
     await leaveCurrentCluster();
+    log.info("completed cluster disconnect request");
     const self = nodeRegistry.getSelf();
     const clusterState = nodeRegistry.getClusterState();
     res.json({
@@ -32334,7 +32693,16 @@ async function createPreviewSessionPayload(deps, taskId, entryPath) {
   };
 }
 async function executeWorkerControlRequest(deps, request) {
+  const log = deps.logger.child("worker-control");
+  log.info("received worker control request", {
+    requestId: request.requestId,
+    kind: request.kind,
+    taskId: request.taskId,
+    path: request.path,
+    enabled: request.enabled
+  });
   try {
+    let response;
     switch (request.kind) {
       case "devtunnel": {
         assertCanChangeNodeDevTunnel(deps.taskEngine, deps.nodeRegistry.getSelf().id);
@@ -32343,22 +32711,24 @@ async function executeWorkerControlRequest(deps, request) {
             throw new MeshyError("VALIDATION_ERROR", "DevTunnel control not available", 501);
           }
           const devtunnelEndpoint = await deps.enableDevTunnel();
-          return jsonResponse(request.requestId, 200, {
+          response = jsonResponse(request.requestId, 200, {
             ok: true,
             enabled: true,
             devtunnelEndpoint,
             dashboardOrigin: deps.nodeRegistry.getSelf().dashboardOrigin
           });
+          break;
         }
         if (!deps.disableDevTunnel) {
           throw new MeshyError("VALIDATION_ERROR", "DevTunnel control not available", 501);
         }
         await deps.disableDevTunnel();
-        return jsonResponse(request.requestId, 200, {
+        response = jsonResponse(request.requestId, 200, {
           ok: true,
           enabled: false,
           dashboardOrigin: deps.nodeRegistry.getSelf().dashboardOrigin
         });
+        break;
       }
       case "task-cancel": {
         const taskId = request.taskId ?? "";
@@ -32370,7 +32740,7 @@ async function executeWorkerControlRequest(deps, request) {
           missingOk: true,
           terminalOk: true
         });
-        return jsonResponse(request.requestId, 200, {
+        response = jsonResponse(request.requestId, 200, {
           ok: true,
           taskId,
           cancelled: result.cancelled,
@@ -32378,11 +32748,12 @@ async function executeWorkerControlRequest(deps, request) {
           missing: result.missing,
           terminal: result.terminal
         });
+        break;
       }
       case "task-output-summary": {
         const task = getTask(deps.taskEngine, request.taskId ?? "");
         if (!task.effectiveProjectPath) {
-          return jsonResponse(request.requestId, 200, {
+          response = jsonResponse(request.requestId, 200, {
             taskId: task.id,
             requestedProject: task.project,
             effectiveProjectPath: null,
@@ -32390,8 +32761,9 @@ async function executeWorkerControlRequest(deps, request) {
             available: false,
             summary: null
           });
+          break;
         }
-        return jsonResponse(request.requestId, 200, {
+        response = jsonResponse(request.requestId, 200, {
           taskId: task.id,
           requestedProject: task.project,
           effectiveProjectPath: task.effectiveProjectPath,
@@ -32399,15 +32771,17 @@ async function executeWorkerControlRequest(deps, request) {
           available: true,
           summary: getOutputSummary(task.effectiveProjectPath)
         });
+        break;
       }
       case "task-output-tree": {
         const rootPath = getTaskOutputRoot(deps.taskEngine, request.taskId ?? "");
         try {
-          return jsonResponse(request.requestId, 200, {
+          response = jsonResponse(request.requestId, 200, {
             rootPath,
             currentPath: request.path ?? ".",
             entries: listDirectory(rootPath, request.path ?? ".")
           });
+          break;
         } catch (err) {
           if (err instanceof Error && err.message === "Path traversal detected") {
             throw new MeshyError("VALIDATION_ERROR", "Invalid directory path", 400);
@@ -32419,10 +32793,11 @@ async function executeWorkerControlRequest(deps, request) {
         const rootPath = getTaskOutputRoot(deps.taskEngine, request.taskId ?? "");
         try {
           const filePath = request.path ?? "";
-          return jsonResponse(request.requestId, 200, {
+          response = jsonResponse(request.requestId, 200, {
             ...readFileContent(rootPath, filePath),
             downloadUrl: `/api/tasks/${request.taskId}/output/download?path=${encodeURIComponent(filePath)}`
           });
+          break;
         } catch (err) {
           if (err instanceof Error && err.message === "Path traversal detected") {
             throw new MeshyError("VALIDATION_ERROR", "Invalid file path", 400);
@@ -32442,11 +32817,12 @@ async function executeWorkerControlRequest(deps, request) {
           }
           const { mimeType } = classifyFile(absolutePath);
           const fileName = path13.basename(absolutePath).replace(/"/g, "");
-          return binaryResponse(request.requestId, 200, fs12.readFileSync(absolutePath), {
+          response = binaryResponse(request.requestId, 200, fs12.readFileSync(absolutePath), {
             "Content-Type": mimeType,
             "Content-Disposition": `inline; filename="${fileName}"`,
             "Cache-Control": "no-cache"
           });
+          break;
         } catch (err) {
           if (err instanceof MeshyError) throw err;
           if (err instanceof Error && err.message === "Path traversal detected") {
@@ -32457,18 +32833,41 @@ async function executeWorkerControlRequest(deps, request) {
       }
       case "task-output-diff": {
         const rootPath = getTaskOutputRoot(deps.taskEngine, request.taskId ?? "");
-        return jsonResponse(request.requestId, 200, getGitDiff(rootPath));
+        response = jsonResponse(request.requestId, 200, getGitDiff(rootPath));
+        break;
       }
       case "task-preview-session": {
-        return jsonResponse(
+        response = jsonResponse(
           request.requestId,
           200,
           await createPreviewSessionPayload(deps, request.taskId ?? "", request.path)
         );
+        break;
       }
     }
+    log.info("completed worker control request", {
+      requestId: request.requestId,
+      kind: request.kind,
+      taskId: request.taskId,
+      path: request.path,
+      enabled: request.enabled,
+      ok: response.ok,
+      statusCode: response.statusCode
+    });
+    return response;
   } catch (err) {
-    return errorResponse(request.requestId, err);
+    const response = errorResponse(request.requestId, err);
+    log.warn("worker control request failed", {
+      requestId: request.requestId,
+      kind: request.kind,
+      taskId: request.taskId,
+      path: request.path,
+      enabled: request.enabled,
+      ok: response.ok,
+      statusCode: response.statusCode,
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return response;
   }
 }
 function sendWorkerControlResponse(res, response) {
@@ -33543,13 +33942,40 @@ function createWorkerRoutes() {
     res.json({ ok: true });
   }));
   router.post("/heartbeat", asyncHandler4(async (req, res) => {
-    const { heartbeat } = req.app.locals.deps;
-    const response = heartbeat.handleHeartbeat(req.body);
+    const { heartbeat, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("worker/heartbeat");
+    const body = req.body;
+    log.debug("received worker heartbeat API call", {
+      leaderId: body.leaderId,
+      term: body.term,
+      nodeCount: body.clusterState?.nodes?.length ?? 0
+    });
+    const response = heartbeat.handleHeartbeat(body);
+    log.debug("completed worker heartbeat API call", {
+      nodeId: response.nodeId,
+      status: response.status,
+      load: response.load
+    });
     res.json(response);
   }));
   router.post("/keepalive", asyncHandler4(async (req, res) => {
-    const { heartbeat } = req.app.locals.deps;
-    const response = heartbeat.handleKeepalive(req.body);
+    const { heartbeat, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("worker/keepalive");
+    const body = req.body;
+    log.debug("received worker keepalive API call", {
+      nodeId: body.nodeId,
+      status: body.status,
+      endpoint: body.endpoint
+    });
+    const response = heartbeat.handleKeepalive(body);
+    log.debug("completed worker keepalive API call", {
+      leaderId: response.leaderId,
+      term: response.term,
+      nodeCount: response.clusterState.nodes.length,
+      dispatchedTaskCount: response.dispatchedTasks?.length ?? 0,
+      followUpCount: response.followUpMessages?.length ?? 0,
+      controlRequestCount: response.controlRequests?.length ?? 0
+    });
     res.json(response);
   }));
   router.post("/vote", asyncHandler4(async (req, res) => {
@@ -33573,8 +33999,19 @@ function createWorkerRoutes() {
     res.json(payload);
   }));
   router.post("/control-response", asyncHandler4(async (req, res) => {
-    const { heartbeat } = req.app.locals.deps;
-    const handled = heartbeat.handleWorkerControlResponse?.(req.body) ?? false;
+    const { heartbeat, logger: rootLogger } = req.app.locals.deps;
+    const log = rootLogger.child("worker/control-response");
+    const body = req.body;
+    log.info("received worker control response API call", {
+      requestId: body.requestId,
+      ok: body.ok,
+      statusCode: body.statusCode
+    });
+    const handled = heartbeat.handleWorkerControlResponse?.(body) ?? false;
+    log.info("completed worker control response API call", {
+      requestId: body.requestId,
+      handled
+    });
     res.json({ ok: true, handled });
   }));
   return router;
@@ -33587,7 +34024,13 @@ function asyncHandler5(fn) {
 }
 function createSystemRoutes() {
   const router = (0, import_express5.Router)();
-  router.get("/health", asyncHandler5(async (_req, res) => {
+  router.get("/health", asyncHandler5(async (req, res) => {
+    const { logger: rootLogger } = req.app.locals.deps;
+    rootLogger.child("system/health").info("received system health API call", {
+      method: req.method,
+      path: req.originalUrl || req.url,
+      remoteAddress: req.ip || req.socket.remoteAddress
+    });
     res.json({ status: "ok", timestamp: Date.now() });
   }));
   router.get("/info", asyncHandler5(async (req, res) => {
@@ -34149,18 +34592,21 @@ function createTransport(config) {
 
 // src/startup.ts
 var fs16 = __toESM(require("fs"), 1);
+var path16 = __toESM(require("path"), 1);
 var readline = __toESM(require("readline/promises"), 1);
+var import_node_child_process6 = require("child_process");
 function getDefaultNodeName() {
   return getDeviceNodeName();
 }
 var DEFAULT_NODE_NAME = getDefaultNodeName();
 var DEFAULT_NODE_PORT = 12345;
 var SUPPORTED_TRANSPORTS = ["direct", "devtunnel", "tailscale"];
+var STARTUP_REQUIREMENTS = ["az", "devtunnel", "claude", "codex"];
 function createDefaultConfig(storagePath = resolveDefaultStoragePath(), nodeName = DEFAULT_NODE_NAME) {
   return {
     node: { name: nodeName, port: DEFAULT_NODE_PORT },
     transport: { type: "direct" },
-    cluster: { seeds: [], heartbeatInterval: 3e3, electionTimeout: 9e3, apiKey: "" },
+    cluster: { seeds: [], heartbeatInterval: 3e3, electionTimeout: 36e3, apiKey: "" },
     storage: { path: storagePath }
   };
 }
@@ -34170,6 +34616,257 @@ function createRuntimeDefaultConfig(fileConfig, options = {}) {
   const nodeName = options.ignorePersistedName ? getDeviceNodeName() : resolveDefaultNodeName(storagePath);
   return createDefaultConfig(storagePath, nodeName);
 }
+function writeLine(stream, message = "") {
+  stream.write(`${message}
+`);
+}
+function createPromptSession(prompt) {
+  if (prompt) {
+    return {
+      ask: prompt,
+      close: async () => void 0
+    };
+  }
+  if (!shouldPromptForStartOptions()) {
+    return void 0;
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return {
+    ask: (question) => rl.question(question),
+    close: async () => rl.close()
+  };
+}
+function createDefaultCommandRunner(platform) {
+  return (command, args, interactive = false) => {
+    const result = (0, import_node_child_process6.spawnSync)(command, args, {
+      encoding: "utf-8",
+      shell: platform === "win32",
+      stdio: interactive ? "inherit" : "pipe"
+    });
+    return {
+      ok: result.status === 0 && !result.error,
+      status: result.status,
+      stdout: typeof result.stdout === "string" ? result.stdout : "",
+      stderr: typeof result.stderr === "string" ? result.stderr : "",
+      error: result.error?.message
+    };
+  };
+}
+function getNodeMetadataPath2(storagePath) {
+  return path16.join(storagePath, "metadata.json");
+}
+function readStartupMetadataFile(storagePath) {
+  try {
+    const raw = JSON.parse(fs16.readFileSync(getNodeMetadataPath2(storagePath), "utf-8"));
+    return typeof raw === "object" && raw !== null ? raw : {};
+  } catch {
+    return {};
+  }
+}
+function writeStartupMetadataFile(storagePath, metadata) {
+  fs16.mkdirSync(storagePath, { recursive: true });
+  fs16.writeFileSync(getNodeMetadataPath2(storagePath), JSON.stringify(metadata, null, 2) + "\n", "utf-8");
+}
+function formatLocalDate(now) {
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function isYesAnswer(value) {
+  const normalized = value.trim().toLowerCase();
+  return normalized === "y" || normalized === "yes";
+}
+async function confirm(ask, question) {
+  const answer = await ask(`${question} [y/N]: `);
+  return isYesAnswer(answer);
+}
+function isCommandAvailable(commandRunner, platform, command) {
+  const lookupCommand = platform === "win32" ? "where" : "which";
+  return commandRunner(lookupCommand, [command], false).ok;
+}
+function buildInstallCommand(requirement, platform) {
+  switch (requirement) {
+    case "az":
+      if (platform === "darwin") {
+        return { command: "brew", args: ["install", "azure-cli"] };
+      }
+      if (platform === "win32") {
+        return { command: "winget", args: ["install", "--exact", "--id", "Microsoft.AzureCLI"] };
+      }
+      return void 0;
+    case "devtunnel":
+      if (platform === "darwin") {
+        return { command: "brew", args: ["install", "--cask", "devtunnel"] };
+      }
+      if (platform === "win32") {
+        return { command: "winget", args: ["install", "--exact", "--id", "Microsoft.devtunnel"] };
+      }
+      return void 0;
+    case "claude":
+      if (platform === "darwin") {
+        return { command: "bash", args: ["-lc", "curl -fsSL https://claude.ai/install.sh | bash"] };
+      }
+      if (platform === "win32") {
+        return {
+          command: "powershell",
+          args: ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", "irm https://claude.ai/install.ps1 | iex"]
+        };
+      }
+      return void 0;
+    case "codex":
+      return { command: "npm", args: ["install", "-g", "@openai/codex"] };
+  }
+}
+function buildLoginCommand(requirement) {
+  if (requirement === "az") {
+    return { command: "az", args: ["login"] };
+  }
+  return { command: "devtunnel", args: ["user", "login"] };
+}
+function isAuthenticated(requirement, commandRunner) {
+  const command = requirement === "az" ? { command: "az", args: ["account", "show"] } : { command: "devtunnel", args: ["user", "show"] };
+  return commandRunner(command.command, command.args, false).ok;
+}
+function isRequirementSatisfied(requirement, status) {
+  if (!status || status.installed !== true || status.status !== "ok") {
+    return false;
+  }
+  if (requirement === "az" || requirement === "devtunnel") {
+    return status.authenticated === true;
+  }
+  return true;
+}
+function resolveStartupRequirementsMetadata(storagePath) {
+  const metadata = readStartupMetadataFile(storagePath).startupRequirements;
+  return metadata && typeof metadata === "object" ? metadata : {};
+}
+function shouldSkipStartupRequirementsCheck(storagePath, now = /* @__PURE__ */ new Date()) {
+  const metadata = resolveStartupRequirementsMetadata(storagePath);
+  if (metadata.lastCheckedOn !== formatLocalDate(now)) {
+    return false;
+  }
+  return STARTUP_REQUIREMENTS.every((requirement) => isRequirementSatisfied(requirement, metadata.components?.[requirement]));
+}
+async function ensureRequirementInstalled(requirement, platform, ask, commandRunner, stdout, stderr) {
+  if (isCommandAvailable(commandRunner, platform, requirement)) {
+    return { installed: true, status: "ok" };
+  }
+  if (!ask) {
+    writeLine(stderr, `Missing required component "${requirement}". Start in a TTY to install it automatically.`);
+    return { installed: false, status: "missing" };
+  }
+  const install = buildInstallCommand(requirement, platform);
+  if (!install) {
+    writeLine(stderr, `Missing required component "${requirement}", and automatic install is not supported on ${platform}.`);
+    return { installed: false, status: "unsupported-platform" };
+  }
+  if (!await confirm(ask, `Required component "${requirement}" is missing. Install it now?`)) {
+    return { installed: false, status: "missing" };
+  }
+  writeLine(stdout, `Installing ${requirement}...`);
+  const result = commandRunner(install.command, install.args, true);
+  if (!result.ok) {
+    writeLine(stderr, `Failed to install ${requirement}.`);
+    return { installed: false, status: "install-failed" };
+  }
+  return isCommandAvailable(commandRunner, platform, requirement) ? { installed: true, status: "ok" } : { installed: false, status: "install-failed" };
+}
+async function ensureRequirementAuthenticated(requirement, ask, commandRunner, stdout, stderr) {
+  if (isAuthenticated(requirement, commandRunner)) {
+    return { authenticated: true, status: "ok" };
+  }
+  if (!ask) {
+    writeLine(stderr, `${requirement} is installed but not logged in. Start in a TTY to log in automatically.`);
+    return { authenticated: false, status: "not-authenticated" };
+  }
+  if (!await confirm(ask, `"${requirement}" is installed but not logged in. Log in now?`)) {
+    return { authenticated: false, status: "not-authenticated" };
+  }
+  writeLine(stdout, `Opening ${requirement} login...`);
+  const login = buildLoginCommand(requirement);
+  const result = commandRunner(login.command, login.args, true);
+  if (!result.ok) {
+    writeLine(stderr, `Failed to complete ${requirement} login.`);
+    return { authenticated: false, status: "login-failed" };
+  }
+  return isAuthenticated(requirement, commandRunner) ? { authenticated: true, status: "ok" } : { authenticated: false, status: "login-failed" };
+}
+async function ensureStartupRequirements(storagePath, options = {}) {
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  if (shouldSkipStartupRequirementsCheck(storagePath, now)) {
+    return {
+      skipped: true,
+      metadata: resolveStartupRequirementsMetadata(storagePath)
+    };
+  }
+  const platform = options.platform ?? process.platform;
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+  const commandRunner = options.commandRunner ?? createDefaultCommandRunner(platform);
+  const promptSession = createPromptSession(options.prompt);
+  const checkedAt = now.toISOString();
+  const checkedOn = formatLocalDate(now);
+  const components = {};
+  try {
+    for (const requirement of STARTUP_REQUIREMENTS) {
+      const installResult = await ensureRequirementInstalled(
+        requirement,
+        platform,
+        promptSession?.ask,
+        commandRunner,
+        stdout,
+        stderr
+      );
+      if (!installResult.installed) {
+        components[requirement] = {
+          installed: false,
+          status: installResult.status,
+          checkedAt
+        };
+        continue;
+      }
+      if (requirement === "az" || requirement === "devtunnel") {
+        const authResult = await ensureRequirementAuthenticated(
+          requirement,
+          promptSession?.ask,
+          commandRunner,
+          stdout,
+          stderr
+        );
+        components[requirement] = {
+          installed: true,
+          authenticated: authResult.authenticated,
+          status: authResult.status,
+          checkedAt
+        };
+        continue;
+      }
+      components[requirement] = {
+        installed: true,
+        status: "ok",
+        checkedAt
+      };
+    }
+  } finally {
+    await promptSession?.close();
+  }
+  const metadataFile = readStartupMetadataFile(storagePath);
+  const metadata = {
+    lastCheckedAt: checkedAt,
+    lastCheckedOn: checkedOn,
+    components
+  };
+  metadataFile.startupRequirements = metadata;
+  writeStartupMetadataFile(storagePath, metadataFile);
+  return {
+    skipped: false,
+    metadata
+  };
+}
 function parseArgs(argv) {
   const result = {};
   for (let i = 0; i < argv.length; i++) {
@@ -34216,9 +34913,9 @@ function parseArgs(argv) {
   }
   return result;
 }
-function loadConfigFile(path16) {
+function loadConfigFile(path17) {
   try {
-    const raw = fs16.readFileSync(path16, "utf-8");
+    const raw = fs16.readFileSync(path17, "utf-8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -34435,6 +35132,11 @@ async function main() {
   if (!resolvedArgs.disableAuth) {
     persistNodeAuthMetadata(config.storage.path, authMetadata);
   }
+  console.log("Checking startup requirements (az, devtunnel, claude, codex)...");
+  const startupRequirements = await ensureStartupRequirements(config.storage.path);
+  console.log(
+    startupRequirements.skipped ? "Startup requirements already verified today; skipping checks." : "Startup requirements check complete."
+  );
   const logDir = nodePath.join(config.storage.path, "logs");
   const logger = createLogger({
     component: "node",
@@ -34763,6 +35465,7 @@ if (isDirectRun) {
   applyStartMetadata,
   createDefaultConfig,
   createRuntimeDefaultConfig,
+  ensureStartupRequirements,
   formatBanner,
   formatLoadedStartMetadata,
   getDefaultNodeName,
@@ -34773,8 +35476,10 @@ if (isDirectRun) {
   parseArgs,
   promptStartOptions,
   resolveRuntimeAuthMetadata,
+  resolveStartupRequirementsMetadata,
   shouldCollectStartOptions,
-  shouldPromptForStartOptions
+  shouldPromptForStartOptions,
+  shouldSkipStartupRequirementsCheck
 });
 /*! Bundled license information: