@telepath-computer/television 0.1.178 → 0.1.179

package/dist/cli.cjs

@@ -1194,7 +1194,7 @@ var require_command = __commonJS({
   "../../node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter2 = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path15 = require("node:path");
+    var path17 = require("node:path");
     var fs4 = require("node:fs");
     var process3 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -2207,9 +2207,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path15.resolve(baseDir, baseName);
+          const localBin = path17.resolve(baseDir, baseName);
           if (fs4.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path15.extname(baseName))) return void 0;
+          if (sourceExt.includes(path17.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs4.existsSync(`${localBin}${ext}`)
           );
@@ -2227,17 +2227,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path15.resolve(
-            path15.dirname(resolvedScriptPath),
+          executableDir = path17.resolve(
+            path17.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path15.basename(
+            const legacyName = path17.basename(
               this._scriptPath,
-              path15.extname(this._scriptPath)
+              path17.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2248,7 +2248,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path15.extname(executableFile));
+        launchWithNode = sourceExt.includes(path17.extname(executableFile));
         let proc;
         if (process3.platform !== "win32") {
           if (launchWithNode) {
@@ -3163,7 +3163,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path15.basename(filename, path15.extname(filename));
+        this._name = path17.basename(filename, path17.extname(filename));
         return this;
       }
       /**
@@ -3177,9 +3177,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path16) {
-        if (path16 === void 0) return this._executableDir;
-        this._executableDir = path16;
+      executableDir(path18) {
+        if (path18 === void 0) return this._executableDir;
+        this._executableDir = path18;
         return this;
       }
       /**
@@ -21480,11 +21480,11 @@ var require_mime_types = __commonJS({
       }
       return exts[0];
     }
-    function lookup(path15) {
-      if (!path15 || typeof path15 !== "string") {
+    function lookup(path17) {
+      if (!path17 || typeof path17 !== "string") {
         return false;
       }
-      var extension3 = extname("x." + path15).toLowerCase().substr(1);
+      var extension3 = extname("x." + path17).toLowerCase().substr(1);
       if (!extension3) {
         return false;
       }
@@ -24221,7 +24221,7 @@ var require_path_to_regexp = __commonJS({
   "../../node_modules/path-to-regexp/index.js"(exports2, module2) {
     module2.exports = pathToRegexp;
     var MATCHING_GROUP_REGEXP = /\\.|\((?:\?<(.*?)>)?(?!\?)/g;
-    function pathToRegexp(path15, keys, options) {
+    function pathToRegexp(path17, keys, options) {
       options = options || {};
       keys = keys || [];
       var strict = options.strict;
@@ -24235,8 +24235,8 @@ var require_path_to_regexp = __commonJS({
       var pos = 0;
       var backtrack = "";
       var m2;
-      if (path15 instanceof RegExp) {
-        while (m2 = MATCHING_GROUP_REGEXP.exec(path15.source)) {
+      if (path17 instanceof RegExp) {
+        while (m2 = MATCHING_GROUP_REGEXP.exec(path17.source)) {
           if (m2[0][0] === "\\") continue;
           keys.push({
             name: m2[1] || name++,
@@ -24244,18 +24244,18 @@ var require_path_to_regexp = __commonJS({
             offset: m2.index
           });
         }
-        return path15;
+        return path17;
       }
-      if (Array.isArray(path15)) {
-        path15 = path15.map(function(value) {
+      if (Array.isArray(path17)) {
+        path17 = path17.map(function(value) {
           return pathToRegexp(value, keys, options).source;
         });
-        return new RegExp(path15.join("|"), flags);
+        return new RegExp(path17.join("|"), flags);
       }
-      if (typeof path15 !== "string") {
+      if (typeof path17 !== "string") {
         throw new TypeError("path must be a string, array of strings, or regular expression");
       }
-      path15 = path15.replace(
+      path17 = path17.replace(
         /\\.|(\/)?(\.)?:(\w+)(\(.*?\))?(\*)?(\?)?|[.*]|\/\(/g,
         function(match, slash, format, key, capture2, star, optional2, offset) {
           if (match[0] === "\\") {
@@ -24272,7 +24272,7 @@ var require_path_to_regexp = __commonJS({
           if (slash || format) {
             backtrack = "";
           } else {
-            backtrack += path15.slice(pos, offset);
+            backtrack += path17.slice(pos, offset);
           }
           pos = offset + match.length;
           if (match === "*") {
@@ -24302,7 +24302,7 @@ var require_path_to_regexp = __commonJS({
           return result;
         }
       );
-      while (m2 = MATCHING_GROUP_REGEXP.exec(path15)) {
+      while (m2 = MATCHING_GROUP_REGEXP.exec(path17)) {
         if (m2[0][0] === "\\") continue;
         if (keysOffset + i === keys.length || keys[keysOffset + i].offset > m2.index) {
           keys.splice(keysOffset + i, 0, {
@@ -24314,13 +24314,13 @@ var require_path_to_regexp = __commonJS({
         }
         i++;
       }
-      path15 += strict ? "" : path15[path15.length - 1] === "/" ? "?" : "/?";
+      path17 += strict ? "" : path17[path17.length - 1] === "/" ? "?" : "/?";
       if (end) {
-        path15 += "$";
-      } else if (path15[path15.length - 1] !== "/") {
-        path15 += lookahead ? "(?=/|$)" : "(?:/|$)";
+        path17 += "$";
+      } else if (path17[path17.length - 1] !== "/") {
+        path17 += lookahead ? "(?=/|$)" : "(?:/|$)";
       }
-      return new RegExp("^" + path15, flags);
+      return new RegExp("^" + path17, flags);
     }
   }
 });
@@ -24333,19 +24333,19 @@ var require_layer = __commonJS({
     var debug = require_src3()("express:router:layer");
     var hasOwnProperty = Object.prototype.hasOwnProperty;
     module2.exports = Layer;
-    function Layer(path15, options, fn) {
+    function Layer(path17, options, fn) {
       if (!(this instanceof Layer)) {
-        return new Layer(path15, options, fn);
+        return new Layer(path17, options, fn);
       }
-      debug("new %o", path15);
+      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(path15, this.keys = [], opts);
-      this.regexp.fast_star = path15 === "*";
-      this.regexp.fast_slash = path15 === "/" && 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(error48, req, res, next) {
       var fn = this.handle;
@@ -24369,20 +24369,20 @@ var require_layer = __commonJS({
         next(err);
       }
     };
-    Layer.prototype.match = function match(path15) {
+    Layer.prototype.match = function match(path17) {
       var match2;
-      if (path15 != 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(path15) };
-          this.path = path15;
+          this.params = { "0": decode_param(path17) };
+          this.path = path17;
           return true;
         }
-        match2 = this.regexp.exec(path15);
+        match2 = this.regexp.exec(path17);
       }
       if (!match2) {
         this.params = void 0;
@@ -24475,10 +24475,10 @@ var require_route = __commonJS({
     var slice = Array.prototype.slice;
     var toString = Object.prototype.toString;
     module2.exports = Route;
-    function Route(path15) {
-      this.path = path15;
+    function Route(path17) {
+      this.path = path17;
       this.stack = [];
-      debug("new %o", path15);
+      debug("new %o", path17);
       this.methods = {};
     }
     Route.prototype._handles_method = function _handles_method(method) {
@@ -24690,8 +24690,8 @@ var require_router = __commonJS({
         if (++sync > 100) {
           return setImmediate(next, err);
         }
-        var path15 = getPathname(req);
-        if (path15 == null) {
+        var path17 = getPathname(req);
+        if (path17 == null) {
           return done(layerError);
         }
         var layer;
@@ -24699,7 +24699,7 @@ var require_router = __commonJS({
         var route;
         while (match !== true && idx < stack.length) {
           layer = stack[idx++];
-          match = matchLayer(layer, path15);
+          match = matchLayer(layer, path17);
           route = layer.route;
           if (typeof match !== "boolean") {
             layerError = layerError || match;
@@ -24737,18 +24737,18 @@ var require_router = __commonJS({
           } else if (route) {
             layer.handle_request(req, res, next);
           } else {
-            trim_prefix(layer, layerError, layerPath, path15);
+            trim_prefix(layer, layerError, layerPath, path17);
           }
           sync = 0;
         });
       }
-      function trim_prefix(layer, layerError, layerPath, path15) {
+      function trim_prefix(layer, layerError, layerPath, path17) {
         if (layerPath.length !== 0) {
-          if (layerPath !== path15.slice(0, layerPath.length)) {
+          if (layerPath !== path17.slice(0, layerPath.length)) {
             next(layerError);
             return;
           }
-          var c = path15[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;
@@ -24826,7 +24826,7 @@ var require_router = __commonJS({
     };
     proto.use = function use(fn) {
       var offset = 0;
-      var path15 = "/";
+      var path17 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -24834,7 +24834,7 @@ var require_router = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path15 = fn;
+          path17 = fn;
         }
       }
       var callbacks = flatten(slice.call(arguments, offset));
@@ -24846,8 +24846,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", path15, fn.name || "<anonymous>");
-        var layer = new Layer(path15, {
+        debug("use %o %s", path17, fn.name || "<anonymous>");
+        var layer = new Layer(path17, {
           sensitive: this.caseSensitive,
           strict: false,
           end: false
@@ -24857,9 +24857,9 @@ var require_router = __commonJS({
       }
       return this;
     };
-    proto.route = function route(path15) {
-      var route2 = new Route(path15);
-      var layer = new Layer(path15, {
+    proto.route = function route(path17) {
+      var route2 = new Route(path17);
+      var layer = new Layer(path17, {
         sensitive: this.caseSensitive,
         strict: this.strict,
         end: true
@@ -24869,8 +24869,8 @@ var require_router = __commonJS({
       return route2;
     };
     methods.concat("all").forEach(function(method) {
-      proto[method] = function(path15) {
-        var route = this.route(path15);
+      proto[method] = function(path17) {
+        var route = this.route(path17);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
@@ -24906,9 +24906,9 @@ var require_router = __commonJS({
       }
       return toString.call(obj).replace(objectRegExp, "$1");
     }
-    function matchLayer(layer, path15) {
+    function matchLayer(layer, path17) {
       try {
-        return layer.match(path15);
+        return layer.match(path17);
       } catch (err) {
         return err;
       }
@@ -25026,13 +25026,13 @@ var require_view = __commonJS({
   "../../node_modules/express/lib/view.js"(exports2, module2) {
     "use strict";
     var debug = require_src3()("express:view");
-    var path15 = require("path");
+    var path17 = require("path");
     var fs4 = require("fs");
-    var dirname = path15.dirname;
-    var basename = path15.basename;
-    var extname = path15.extname;
-    var join2 = path15.join;
-    var resolve = path15.resolve;
+    var dirname = path17.dirname;
+    var basename = path17.basename;
+    var extname = path17.extname;
+    var join2 = path17.join;
+    var resolve = path17.resolve;
     module2.exports = View;
     function View(name, options) {
       var opts = options || {};
@@ -25061,17 +25061,17 @@ var require_view = __commonJS({
       this.path = this.lookup(fileName);
     }
     View.prototype.lookup = function lookup(name) {
-      var path16;
+      var path18;
       var roots = [].concat(this.root);
       debug('lookup "%s"', name);
-      for (var i = 0; i < roots.length && !path16; i++) {
+      for (var i = 0; i < roots.length && !path18; i++) {
         var root = roots[i];
         var loc = resolve(root, name);
         var dir = dirname(loc);
         var file2 = basename(loc);
-        path16 = this.resolve(dir, file2);
+        path18 = this.resolve(dir, file2);
       }
-      return path16;
+      return path18;
     };
     View.prototype.render = function render(options, callback) {
       debug('render "%s"', this.path);
@@ -25079,21 +25079,21 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve2(dir, file2) {
       var ext = this.ext;
-      var path16 = join2(dir, file2);
-      var stat = tryStat(path16);
+      var path18 = join2(dir, file2);
+      var stat = tryStat(path18);
       if (stat && stat.isFile()) {
-        return path16;
+        return path18;
       }
-      path16 = join2(dir, basename(file2, ext), "index" + ext);
-      stat = tryStat(path16);
+      path18 = join2(dir, basename(file2, ext), "index" + ext);
+      stat = tryStat(path18);
       if (stat && stat.isFile()) {
-        return path16;
+        return path18;
       }
     };
-    function tryStat(path16) {
-      debug('stat "%s"', path16);
+    function tryStat(path18) {
+      debug('stat "%s"', path18);
       try {
-        return fs4.statSync(path16);
+        return fs4.statSync(path18);
       } catch (e) {
         return void 0;
       }
@@ -25871,7 +25871,7 @@ var require_types = __commonJS({
 // ../../node_modules/mime/mime.js
 var require_mime = __commonJS({
   "../../node_modules/mime/mime.js"(exports2, module2) {
-    var path15 = require("path");
+    var path17 = require("path");
     var fs4 = require("fs");
     function Mime() {
       this.types = /* @__PURE__ */ Object.create(null);
@@ -25901,8 +25901,8 @@ var require_mime = __commonJS({
       this.define(map2);
       this._loading = null;
     };
-    Mime.prototype.lookup = function(path16, fallback) {
-      var ext = path16.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) {
@@ -26136,28 +26136,28 @@ var require_send = __commonJS({
     var ms = require_ms5();
     var onFinished = require_on_finished();
     var parseRange = require_range_parser();
-    var path15 = require("path");
+    var path17 = require("path");
     var statuses = require_statuses();
     var Stream = require("stream");
     var util = require("util");
-    var extname = path15.extname;
-    var join2 = path15.join;
-    var normalize = path15.normalize;
-    var resolve = path15.resolve;
-    var sep = path15.sep;
+    var extname = path17.extname;
+    var join2 = path17.join;
+    var normalize = path17.normalize;
+    var resolve = path17.resolve;
+    var sep = path17.sep;
     var BYTES_RANGE_REGEXP = /^ *bytes=/;
     var MAX_MAXAGE = 60 * 60 * 24 * 365 * 1e3;
     var UP_PATH_REGEXP = /(?:^|[\\/])\.\.(?:[\\/]|$)/;
     module2.exports = send2;
     module2.exports.mime = mime;
-    function send2(req, path16, options) {
-      return new SendStream(req, path16, options);
+    function send2(req, path18, options) {
+      return new SendStream(req, path18, options);
     }
-    function SendStream(req, path16, options) {
+    function SendStream(req, path18, options) {
       Stream.call(this);
       var opts = options || {};
       this.options = opts;
-      this.path = path16;
+      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;
@@ -26203,8 +26203,8 @@ var require_send = __commonJS({
       this._index = index2;
       return this;
     }, "send.index: pass index as option");
-    SendStream.prototype.root = function root(path16) {
-      this._root = resolve(String(path16));
+    SendStream.prototype.root = function root(path18) {
+      this._root = resolve(String(path18));
       debug("root %s", this._root);
       return this;
     };
@@ -26317,10 +26317,10 @@ var require_send = __commonJS({
       var lastModified = this.res.getHeader("Last-Modified");
       return parseHttpDate(lastModified) <= parseHttpDate(ifRange);
     };
-    SendStream.prototype.redirect = function redirect(path16) {
+    SendStream.prototype.redirect = function redirect(path18) {
       var res = this.res;
       if (hasListeners(this, "directory")) {
-        this.emit("directory", res, path16);
+        this.emit("directory", res, path18);
         return;
       }
       if (this.hasTrailingSlash()) {
@@ -26340,42 +26340,42 @@ var require_send = __commonJS({
     SendStream.prototype.pipe = function pipe2(res) {
       var root = this._root;
       this.res = res;
-      var path16 = decode3(this.path);
-      if (path16 === -1) {
+      var path18 = decode3(this.path);
+      if (path18 === -1) {
         this.error(400);
         return res;
       }
-      if (~path16.indexOf("\0")) {
+      if (~path18.indexOf("\0")) {
         this.error(400);
         return res;
       }
       var parts;
       if (root !== null) {
-        if (path16) {
-          path16 = normalize("." + sep + path16);
+        if (path18) {
+          path18 = normalize("." + sep + path18);
         }
-        if (UP_PATH_REGEXP.test(path16)) {
-          debug('malicious path "%s"', path16);
+        if (UP_PATH_REGEXP.test(path18)) {
+          debug('malicious path "%s"', path18);
           this.error(403);
           return res;
         }
-        parts = path16.split(sep);
-        path16 = normalize(join2(root, path16));
+        parts = path18.split(sep);
+        path18 = normalize(join2(root, path18));
       } else {
-        if (UP_PATH_REGEXP.test(path16)) {
-          debug('malicious path "%s"', path16);
+        if (UP_PATH_REGEXP.test(path18)) {
+          debug('malicious path "%s"', path18);
           this.error(403);
           return res;
         }
-        parts = normalize(path16).split(sep);
-        path16 = resolve(path16);
+        parts = normalize(path18).split(sep);
+        path18 = resolve(path18);
       }
       if (containsDotFile(parts)) {
         var access2 = this._dotfiles;
         if (access2 === void 0) {
           access2 = parts[parts.length - 1][0] === "." ? this._hidden ? "allow" : "ignore" : "allow";
         }
-        debug('%s dotfile "%s"', access2, path16);
+        debug('%s dotfile "%s"', access2, path18);
         switch (access2) {
           case "allow":
             break;
@@ -26389,13 +26389,13 @@ var require_send = __commonJS({
         }
       }
       if (this._index.length && this.hasTrailingSlash()) {
-        this.sendIndex(path16);
+        this.sendIndex(path18);
         return res;
       }
-      this.sendFile(path16);
+      this.sendFile(path18);
       return res;
     };
-    SendStream.prototype.send = function send3(path16, stat) {
+    SendStream.prototype.send = function send3(path18, stat) {
       var len = stat.size;
       var options = this.options;
       var opts = {};
@@ -26407,9 +26407,9 @@ var require_send = __commonJS({
         this.headersAlreadySent();
         return;
       }
-      debug('pipe "%s"', path16);
-      this.setHeader(path16, stat);
-      this.type(path16);
+      debug('pipe "%s"', path18);
+      this.setHeader(path18, stat);
+      this.type(path18);
       if (this.isConditionalGET()) {
         if (this.isPreconditionFailure()) {
           this.error(412);
@@ -26458,26 +26458,26 @@ var require_send = __commonJS({
         res.end();
         return;
       }
-      this.stream(path16, opts);
+      this.stream(path18, opts);
     };
-    SendStream.prototype.sendFile = function sendFile(path16) {
+    SendStream.prototype.sendFile = function sendFile(path18) {
       var i = 0;
       var self2 = this;
-      debug('stat "%s"', path16);
-      fs4.stat(path16, function onstat(err, stat) {
-        if (err && err.code === "ENOENT" && !extname(path16) && path16[path16.length - 1] !== sep) {
+      debug('stat "%s"', path18);
+      fs4.stat(path18, function onstat(err, stat) {
+        if (err && err.code === "ENOENT" && !extname(path18) && path18[path18.length - 1] !== sep) {
           return next(err);
         }
         if (err) return self2.onStatError(err);
-        if (stat.isDirectory()) return self2.redirect(path16);
-        self2.emit("file", path16, stat);
-        self2.send(path16, stat);
+        if (stat.isDirectory()) return self2.redirect(path18);
+        self2.emit("file", path18, stat);
+        self2.send(path18, stat);
       });
       function next(err) {
         if (self2._extensions.length <= i) {
           return err ? self2.onStatError(err) : self2.error(404);
         }
-        var p = path16 + "." + self2._extensions[i++];
+        var p = path18 + "." + self2._extensions[i++];
         debug('stat "%s"', p);
         fs4.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -26487,7 +26487,7 @@ var require_send = __commonJS({
         });
       }
     };
-    SendStream.prototype.sendIndex = function sendIndex(path16) {
+    SendStream.prototype.sendIndex = function sendIndex(path18) {
       var i = -1;
       var self2 = this;
       function next(err) {
@@ -26495,7 +26495,7 @@ var require_send = __commonJS({
           if (err) return self2.onStatError(err);
           return self2.error(404);
         }
-        var p = join2(path16, self2._index[i]);
+        var p = join2(path18, self2._index[i]);
         debug('stat "%s"', p);
         fs4.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -26506,10 +26506,10 @@ var require_send = __commonJS({
       }
       next();
     };
-    SendStream.prototype.stream = function stream(path16, options) {
+    SendStream.prototype.stream = function stream(path18, options) {
       var self2 = this;
       var res = this.res;
-      var stream2 = fs4.createReadStream(path16, options);
+      var stream2 = fs4.createReadStream(path18, options);
       this.emit("stream", stream2);
       stream2.pipe(res);
       function cleanup() {
@@ -26524,10 +26524,10 @@ var require_send = __commonJS({
         self2.emit("end");
       });
     };
-    SendStream.prototype.type = function type(path16) {
+    SendStream.prototype.type = function type(path18) {
       var res = this.res;
       if (res.getHeader("Content-Type")) return;
-      var type2 = mime.lookup(path16);
+      var type2 = mime.lookup(path18);
       if (!type2) {
         debug("no content-type");
         return;
@@ -26536,9 +26536,9 @@ var require_send = __commonJS({
       debug("content-type %s", type2);
       res.setHeader("Content-Type", type2 + (charset ? "; charset=" + charset : ""));
     };
-    SendStream.prototype.setHeader = function setHeader(path16, stat) {
+    SendStream.prototype.setHeader = function setHeader(path18, stat) {
       var res = this.res;
-      this.emit("headers", res, path16, stat);
+      this.emit("headers", res, path18, stat);
       if (this._acceptRanges && !res.getHeader("Accept-Ranges")) {
         debug("accept ranges");
         res.setHeader("Accept-Ranges", "bytes");
@@ -26597,9 +26597,9 @@ var require_send = __commonJS({
       }
       return err instanceof Error ? createError(status, err, { expose: false }) : createError(status, err);
     }
-    function decode3(path16) {
+    function decode3(path18) {
       try {
-        return decodeURIComponent(path16);
+        return decodeURIComponent(path18);
       } catch (err) {
         return -1;
       }
@@ -27508,10 +27508,10 @@ var require_utils2 = __commonJS({
     var querystring = require("querystring");
     exports2.etag = createETagGenerator({ weak: false });
     exports2.wetag = createETagGenerator({ weak: true });
-    exports2.isAbsolute = function(path15) {
-      if ("/" === path15[0]) return true;
-      if (":" === path15[1] && ("\\" === path15[2] || "/" === path15[2])) return true;
-      if ("\\\\" === path15.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,
@@ -27722,7 +27722,7 @@ var require_application = __commonJS({
     };
     app.use = function use(fn) {
       var offset = 0;
-      var path15 = "/";
+      var path17 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -27730,7 +27730,7 @@ var require_application = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path15 = fn;
+          path17 = fn;
         }
       }
       var fns = flatten(slice.call(arguments, offset));
@@ -27741,12 +27741,12 @@ var require_application = __commonJS({
       var router = this._router;
       fns.forEach(function(fn2) {
         if (!fn2 || !fn2.handle || !fn2.set) {
-          return router.use(path15, fn2);
+          return router.use(path17, fn2);
         }
-        debug(".use app under %s", path15);
-        fn2.mountpath = path15;
+        debug(".use app under %s", path17);
+        fn2.mountpath = path17;
         fn2.parent = this;
-        router.use(path15, 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);
@@ -27758,9 +27758,9 @@ var require_application = __commonJS({
       }, this);
       return this;
     };
-    app.route = function route(path15) {
+    app.route = function route(path17) {
       this.lazyrouter();
-      return this._router.route(path15);
+      return this._router.route(path17);
     };
     app.engine = function engine(ext, fn) {
       if (typeof fn !== "function") {
@@ -27811,7 +27811,7 @@ var require_application = __commonJS({
       }
       return this;
     };
-    app.path = function path15() {
+    app.path = function path17() {
       return this.parent ? this.parent.path() + this.mountpath : "";
     };
     app.enabled = function enabled(setting) {
@@ -27827,19 +27827,19 @@ var require_application = __commonJS({
       return this.set(setting, false);
     };
     methods.forEach(function(method) {
-      app[method] = function(path15) {
+      app[method] = function(path17) {
         if (method === "get" && arguments.length === 1) {
-          return this.set(path15);
+          return this.set(path17);
         }
         this.lazyrouter();
-        var route = this._router.route(path15);
+        var route = this._router.route(path17);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
     });
-    app.all = function all(path15) {
+    app.all = function all(path17) {
       this.lazyrouter();
-      var route = this._router.route(path15);
+      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);
@@ -28598,7 +28598,7 @@ var require_request = __commonJS({
       var subdomains2 = !isIP2(hostname3) ? hostname3.split(".").reverse() : [hostname3];
       return subdomains2.slice(offset);
     });
-    defineGetter(req, "path", function path15() {
+    defineGetter(req, "path", function path17() {
       return parse3(this).pathname;
     });
     defineGetter(req, "hostname", function hostname3() {
@@ -28920,7 +28920,7 @@ var require_response = __commonJS({
     var http2 = require("http");
     var isAbsolute = require_utils2().isAbsolute;
     var onFinished = require_on_finished();
-    var path15 = require("path");
+    var path17 = require("path");
     var statuses = require_statuses();
     var merge2 = require_utils_merge();
     var sign = require_cookie_signature().sign;
@@ -28929,9 +28929,9 @@ var require_response = __commonJS({
     var setCharset = require_utils2().setCharset;
     var cookie = require_cookie();
     var send2 = require_send();
-    var extname = path15.extname;
+    var extname = path17.extname;
     var mime = send2.mime;
-    var resolve = path15.resolve;
+    var resolve = path17.resolve;
     var vary = require_vary();
     var res = Object.create(http2.ServerResponse.prototype);
     module2.exports = res;
@@ -29108,26 +29108,26 @@ var require_response = __commonJS({
       this.type("txt");
       return this.send(body);
     };
-    res.sendFile = function sendFile(path16, 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 (!path16) {
+      if (!path18) {
         throw new TypeError("path argument is required to res.sendFile");
       }
-      if (typeof path16 !== "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 && !isAbsolute(path16)) {
+      if (!opts.root && !isAbsolute(path18)) {
         throw new TypeError("path must be absolute or specify root to res.sendFile");
       }
-      var pathname = encodeURI(path16);
+      var pathname = encodeURI(path18);
       var file2 = send2(req, pathname, opts);
       sendfile(res2, file2, opts, function(err) {
         if (done) return done(err);
@@ -29137,7 +29137,7 @@ var require_response = __commonJS({
         }
       });
     };
-    res.sendfile = function(path16, options, callback) {
+    res.sendfile = function(path18, options, callback) {
       var done = callback;
       var req = this.req;
       var res2 = this;
@@ -29147,7 +29147,7 @@ var require_response = __commonJS({
         done = options;
         opts = {};
       }
-      var file2 = send2(req, path16, opts);
+      var file2 = send2(req, path18, opts);
       sendfile(res2, file2, opts, function(err) {
         if (done) return done(err);
         if (err && err.code === "EISDIR") return next();
@@ -29160,7 +29160,7 @@ var require_response = __commonJS({
       res.sendfile,
       "res.sendfile: Use res.sendFile instead"
     );
-    res.download = function download(path16, filename, options, callback) {
+    res.download = function download(path18, filename, options, callback) {
       var done = callback;
       var name = filename;
       var opts = options || null;
@@ -29177,7 +29177,7 @@ var require_response = __commonJS({
         opts = filename;
       }
       var headers = {
-        "Content-Disposition": contentDisposition(name || path16)
+        "Content-Disposition": contentDisposition(name || path18)
       };
       if (opts && opts.headers) {
         var keys = Object.keys(opts.headers);
@@ -29190,7 +29190,7 @@ var require_response = __commonJS({
       }
       opts = Object.create(opts);
       opts.headers = headers;
-      var fullPath = !opts.root ? resolve(path16) : path16;
+      var fullPath = !opts.root ? resolve(path18) : path18;
       return this.sendFile(fullPath, opts, done);
     };
     res.contentType = res.type = function contentType(type) {
@@ -29491,11 +29491,11 @@ var require_serve_static = __commonJS({
         }
         var forwardError = !fallthrough;
         var originalUrl = parseUrl.original(req);
-        var path15 = parseUrl(req).pathname;
-        if (path15 === "/" && originalUrl.pathname.substr(-1) !== "/") {
-          path15 = "";
+        var path17 = parseUrl(req).pathname;
+        if (path17 === "/" && originalUrl.pathname.substr(-1) !== "/") {
+          path17 = "";
         }
-        var stream = send2(req, path15, opts);
+        var stream = send2(req, path17, opts);
         stream.on("directory", onDirectory);
         if (setHeaders) {
           stream.on("headers", setHeaders);
@@ -33255,17 +33255,17 @@ __export(index_exports, {
   resolveBundledSkillsRoot: () => resolveBundledSkillsRoot,
   resolveBundledViewsPath: () => resolveBundledViewsPath,
   resolveCanonicalDir: () => resolveCanonicalDir,
-  resolveOnboardingArtifactSourcePath: () => resolveOnboardingArtifactSourcePath,
+  resolveOnboardingContentPath: () => resolveOnboardingContentPath,
   resolveStaticDir: () => resolveStaticDir,
   runCLI: () => runCLI
 });
 module.exports = __toCommonJS(index_exports);
 var import_node_child_process3 = require("node:child_process");
-var import_node_fs12 = require("node:fs");
+var import_node_fs14 = require("node:fs");
 var import_node_os5 = __toESM(require("node:os"), 1);
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
 var import_node_module = require("node:module");
-var import_node_url3 = require("node:url");
+var import_node_url2 = require("node:url");
 
 // ../../node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -33416,22 +33416,22 @@ var Daemon = class {
   }
   async install() {
     if (this.platform === "darwin") {
-      const path15 = plistPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path15)) {
-        await this.exec("launchctl", ["unload", "-w", path15]).catch(() => void 0);
+      const path17 = plistPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path17)) {
+        await this.exec("launchctl", ["unload", "-w", path17]).catch(() => void 0);
       }
       await (0, import_promises.mkdir)((0, import_node_path.join)(this.home, "Library", "LaunchAgents"), { recursive: true });
-      await (0, import_promises.writeFile)(path15, renderPlist(this.name, this.programArgs, this.env), "utf8");
-      await this.exec("launchctl", ["load", "-w", path15]);
+      await (0, import_promises.writeFile)(path17, renderPlist(this.name, this.programArgs, this.env), "utf8");
+      await this.exec("launchctl", ["load", "-w", path17]);
       return;
     }
     if (this.platform === "linux") {
-      const path15 = unitPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path15)) {
+      const path17 = unitPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path17)) {
         await this.exec("systemctl", ["--user", "disable", "--now", `${this.name}.service`]).catch(() => void 0);
       }
       await (0, import_promises.mkdir)((0, import_node_path.join)(this.home, ".config", "systemd", "user"), { recursive: true });
-      await (0, import_promises.writeFile)(path15, renderUnit(this.description, this.programArgs, this.env), "utf8");
+      await (0, import_promises.writeFile)(path17, renderUnit(this.description, this.programArgs, this.env), "utf8");
       await this.exec("systemctl", ["--user", "daemon-reload"]);
       await this.exec("systemctl", ["--user", "enable", "--now", `${this.name}.service`]);
       return;
@@ -33440,17 +33440,17 @@ var Daemon = class {
   }
   async uninstall() {
     if (this.platform === "darwin") {
-      const path15 = plistPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path15)) {
-        await this.exec("launchctl", ["unload", "-w", path15]).catch(() => void 0);
-        await (0, import_promises.rm)(path15, { force: true });
+      const path17 = plistPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path17)) {
+        await this.exec("launchctl", ["unload", "-w", path17]).catch(() => void 0);
+        await (0, import_promises.rm)(path17, { force: true });
       }
       return;
     }
     if (this.platform === "linux") {
-      const path15 = unitPath(this.home, this.name);
+      const path17 = unitPath(this.home, this.name);
       await this.exec("systemctl", ["--user", "disable", "--now", `${this.name}.service`]).catch(() => void 0);
-      await (0, import_promises.rm)(path15, { force: true });
+      await (0, import_promises.rm)(path17, { force: true });
       await this.exec("systemctl", ["--user", "daemon-reload"]);
       return;
     }
@@ -33458,8 +33458,8 @@ var Daemon = class {
   }
   async status() {
     if (this.platform === "darwin") {
-      const path15 = plistPath(this.home, this.name);
-      if (!(0, import_node_fs.existsSync)(path15))
+      const path17 = plistPath(this.home, this.name);
+      if (!(0, import_node_fs.existsSync)(path17))
         return { installed: false, running: false };
       try {
         await this.exec("launchctl", ["list", this.name]);
@@ -33469,8 +33469,8 @@ var Daemon = class {
       }
     }
     if (this.platform === "linux") {
-      const path15 = unitPath(this.home, this.name);
-      if (!(0, import_node_fs.existsSync)(path15))
+      const path17 = unitPath(this.home, this.name);
+      if (!(0, import_node_fs.existsSync)(path17))
         return { installed: false, running: false };
       try {
         const result = await this.exec("systemctl", [
@@ -33746,6 +33746,7 @@ function cloneStackChild(node) {
 // ../shared/src/types.ts
 var TELEVISION_CLIENT_META_HEADER = "X-Television-Client-Meta";
 var TELEMETRY_ACTIVITY_MESSAGE_TYPE = "telemetry-activity";
+var TELEMETRY_SIGNAL_MESSAGE_TYPE = "telemetry-signal";
 function createCardNode(artifactID, overrides = {}) {
   return {
     type: "card",
@@ -34185,6 +34186,22 @@ function buildConnectURL(serverURL, token) {
   return clean.toString();
 }
 
+// ../shared/src/version.ts
+var DEV_VERSION = "0.0.0";
+var RELEASE_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+var TRIPLE_COMPONENTS = 3;
+function isReleaseVersion(value) {
+  return RELEASE_VERSION_PATTERN.test(value);
+}
+function isNewerVersion(candidate, baseline) {
+  const a = candidate.split(".").map(Number);
+  const b2 = baseline.split(".").map(Number);
+  for (let i = 0; i < TRIPLE_COMPONENTS; i++) {
+    if (a[i] !== b2[i]) return a[i] > b2[i];
+  }
+  return false;
+}
+
 // ../server/src/server.ts
 var import_express2 = __toESM(require_express2(), 1);
 var import_node_fs9 = require("node:fs");
@@ -34208,6 +34225,10 @@ var TELEMETRY_CONTROL_ENV_VARS = [
   "TV_TELEMETRY_DEV",
   "TELEVISION_TELEMETRY_BUILD"
 ];
+var UPDATE_CHANNEL_ENV_VARS = [
+  "TV_UPDATE_CHANNEL_URL",
+  "TV_UPDATE_CHANNEL_POLL_INTERVAL_MS"
+];
 var ACP_AGENT_PROFILES = {
   openclaw: {
     agent: "openclaw",
@@ -34265,7 +34286,8 @@ function buildPersistedACPEnvironment(env, options = {}) {
   const snapshot = { PATH: pathValue };
   const developerHome = options.developerHome ?? import_node_os2.default.homedir();
   if (developerHome !== "") snapshot[TELEVISION_DEVELOPER_HOME_ENV] = developerHome;
-  copyTelemetryControlEnvironment(env, snapshot);
+  copyEnvironmentAllowlist(env, snapshot, TELEMETRY_CONTROL_ENV_VARS);
+  copyEnvironmentAllowlist(env, snapshot, UPDATE_CHANNEL_ENV_VARS);
   const profile = resolveACPAgentProfile(env);
   if (!profile) {
     return snapshot;
@@ -34278,8 +34300,8 @@ function buildPersistedACPEnvironment(env, options = {}) {
   }
   return snapshot;
 }
-function copyTelemetryControlEnvironment(env, snapshot) {
-  for (const key of TELEMETRY_CONTROL_ENV_VARS) {
+function copyEnvironmentAllowlist(env, snapshot, keys) {
+  for (const key of keys) {
     const value = env[key];
     if (value !== void 0 && value !== "") snapshot[key] = value;
   }
@@ -35072,10 +35094,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path15) {
-  if (!path15)
+function getElementAtPath(obj, path17) {
+  if (!path17)
     return obj;
-  return path15.reduce((acc, key) => acc?.[key], obj);
+  return path17.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -35458,11 +35480,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path15, issues) {
+function prefixIssues(path17, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path15);
+    iss.path.unshift(path17);
     return iss;
   });
 }
@@ -35645,7 +35667,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path15 = []) => {
+  const processError = (error49, path17 = []) => {
     var _a2, _b;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -35655,7 +35677,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path15, ...issue2.path];
+        const fullpath = [...path17, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -35687,8 +35709,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path15 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path15) {
+  const path17 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path17) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -47665,13 +47687,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path15 = ref.slice(1).split("/").filter(Boolean);
-  if (path15.length === 0) {
+  const path17 = ref.slice(1).split("/").filter(Boolean);
+  if (path17.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path15[0] === defsKey) {
-    const key = path15[1];
+  if (path17[0] === defsKey) {
+    const key = path17[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -50728,7 +50750,11 @@ var stackNodeSchema = external_exports.object({
 var layoutNodeSchema = external_exports.union([cardNodeSchema, rowNodeSchema, stackNodeSchema]);
 var patchScreenSchema = external_exports.object({
   name: external_exports.string().optional(),
-  layout: external_exports.array(layoutNodeSchema).optional()
+  layout: external_exports.array(layoutNodeSchema).optional(),
+  // Accepted but never read: the onboarding marker is installer-only and a
+  // stray `onboarding` field must not fail an otherwise-valid request
+  // (specs/arch/onboarding/tab-promotion.md#^marker-api-readonly).
+  onboarding: external_exports.unknown().optional()
 }).strict().refine(
   (value) => value.name !== void 0 || value.layout !== void 0,
   { message: "At least one of name or layout must be provided" }
@@ -50775,7 +50801,10 @@ var HTTP_CONFLICT = 409;
 var CORS_HEADERS = {
   "Access-Control-Allow-Origin": "*",
   "Access-Control-Allow-Methods": "GET, POST, PUT, PATCH, DELETE, OPTIONS",
-  "Access-Control-Allow-Headers": `Authorization, Content-Type, ${TELEVISION_CLIENT_META_HEADER}`
+  "Access-Control-Allow-Headers": `Authorization, Content-Type, ${TELEVISION_CLIENT_META_HEADER}`,
+  // Cross-origin clients can read the version advertisement header
+  // (specs/arch/updates/version-advertisement.md ^version-header).
+  "Access-Control-Expose-Headers": "X-TV-Version"
 };
 function applyCorsHeaders(res) {
   for (const [name, value] of Object.entries(CORS_HEADERS)) {
@@ -50898,7 +50927,10 @@ function registerRoutes(app, store, options) {
     try {
       const screen = store.updateScreen({
         screenID: req.params.id,
-        fields: { ...parsed.data, layout: parsed.data.layout }
+        fields: {
+          ...parsed.data.name !== void 0 ? { name: parsed.data.name } : {},
+          layout: parsed.data.layout
+        }
       }, telemetryContext(req));
       res.json({ screen });
     } catch (error48) {
@@ -51023,6 +51055,36 @@ function isAuthorizedQueryToken(requestURL, expectedToken) {
   return token === expectedToken;
 }
 
+// ../server/src/telemetry/client-signals.ts
+var RELEASE_VERSION = /^\d+\.\d+\.\d+$/;
+var CLIENT_SIGNAL_REGISTRY = {
+  client_autoreloaded: { from_version: RELEASE_VERSION, to_version: RELEASE_VERSION },
+  update_toast_shown: { server_version: RELEASE_VERSION, channel_version: RELEASE_VERSION },
+  update_prompt_copy_clicked: { server_version: RELEASE_VERSION, channel_version: RELEASE_VERSION },
+  desktop_upgrade_gate_shown: { desktop_app_version: RELEASE_VERSION, required_desktop_version: RELEASE_VERSION }
+};
+function validateClientSignal(message, expectedClientId) {
+  if (!message || typeof message !== "object" || Array.isArray(message)) return null;
+  const record2 = message;
+  if (record2.type !== TELEMETRY_SIGNAL_MESSAGE_TYPE) return null;
+  if (record2.clientId !== expectedClientId) return null;
+  if (typeof record2.event !== "string" || !Object.hasOwn(CLIENT_SIGNAL_REGISTRY, record2.event)) return null;
+  const patterns = CLIENT_SIGNAL_REGISTRY[record2.event];
+  const rawProperties = record2.properties === void 0 ? {} : record2.properties;
+  if (!rawProperties || typeof rawProperties !== "object" || Array.isArray(rawProperties)) return null;
+  const properties = {};
+  for (const [key, value] of Object.entries(rawProperties)) {
+    if (!Object.hasOwn(patterns, key)) return null;
+    const pattern = patterns[key];
+    if (typeof value !== "string" || !pattern.test(value)) return null;
+    properties[key] = telemetryVersion(value);
+  }
+  return {
+    name: record2.event,
+    properties
+  };
+}
+
 // ../server/src/event-stream.ts
 var AUTH_FAILED_CLOSE_CODE = 4401;
 var EventStreamServer = class extends withDisposable(class {
@@ -51030,27 +51092,54 @@ var EventStreamServer = class extends withDisposable(class {
   wsServer;
   store;
   authRequired;
+  buildServerStatus;
   recordTelemetryActivity;
+  recordTelemetryClientSignal;
   unsubscribe = [];
   constructor(options) {
     super();
     this.store = options.store;
     this.authRequired = options.authRequired;
+    this.buildServerStatus = options.buildServerStatus;
     this.recordTelemetryActivity = options.recordTelemetryActivity;
+    this.recordTelemetryClientSignal = options.recordTelemetryClientSignal;
     this.wsServer = new import_websocket_server.default({ noServer: true });
     this.wsServer.on("connection", (socket, request) => {
       if (this.authRequired && !isAuthorizedQueryToken(request.url, this.store.authToken)) {
         socket.close(AUTH_FAILED_CLOSE_CODE, "Authentication failed");
         return;
       }
+      if (this.buildServerStatus) {
+        socket.send(JSON.stringify(this.buildServerStatus()));
+      }
       const clientContext = parseClientTelemetryMetaFromRequest(request);
       socket.on("message", (data) => {
-        if (!isTelemetryActivityMessage(data, clientContext?.clientId ?? null)) return;
-        if (clientContext) this.recordTelemetryActivity?.(clientContext);
+        if (!clientContext) return;
+        const parsed = parseJSONMessage(data);
+        if (parsed === null) return;
+        if (isTelemetryActivityMessage(parsed, clientContext.clientId)) {
+          this.recordTelemetryActivity?.(clientContext);
+          return;
+        }
+        const signal = validateClientSignal(parsed, clientContext.clientId);
+        if (signal) this.recordTelemetryClientSignal?.(clientContext, signal);
       });
     });
     this.subscribeStore();
   }
+  /**
+   * Re-broadcast the current server-status to every connected client — the
+   * update-state-change relay (specs/arch/updates/update-channel.md ^relay).
+   */
+  broadcastServerStatus() {
+    if (!this.buildServerStatus) return;
+    const payload = JSON.stringify(this.buildServerStatus());
+    for (const socket of this.wsServer.clients) {
+      if (socket.readyState === import_websocket.default.OPEN) {
+        socket.send(payload);
+      }
+    }
+  }
   /** Number of currently-open `/events` sockets. */
   getConnectedClientCount() {
     let count = 0;
@@ -51144,14 +51233,14 @@ var EventStreamServer = class extends withDisposable(class {
     }
   }
 };
-function isTelemetryActivityMessage(data, expectedClientId) {
-  if (!expectedClientId) return false;
-  let parsed;
+function parseJSONMessage(data) {
   try {
-    parsed = JSON.parse(data.toString());
+    return JSON.parse(data.toString());
   } catch {
-    return false;
+    return null;
   }
+}
+function isTelemetryActivityMessage(parsed, expectedClientId) {
   if (!parsed || typeof parsed !== "object") return false;
   const record2 = parsed;
   return record2.type === TELEMETRY_ACTIVITY_MESSAGE_TYPE && record2.clientId === expectedClientId && Object.keys(record2).length === 2;
@@ -51829,6 +51918,9 @@ function getTelemetryStatePath(storagePath) {
 function getTokenPath(storagePath) {
   return import_node_path8.default.join(getStateDir(storagePath), "token");
 }
+function getOnboardingStatePath(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "onboarding.json");
+}
 function getOnboardingArtifactSentinelPath(storagePath) {
   return import_node_path8.default.join(getStateDir(storagePath), "onboarding-artifact.json");
 }
@@ -52395,6 +52487,171 @@ function disabledTelemetryRuntime() {
   };
 }
 
+// ../server/src/updates/version.ts
+function readVersionStamp() {
+  if ("0.1.179".length > 0) return "0.1.179";
+  return void 0;
+}
+function resolveUpdateReleaseVersion(env = process.env, stamp = readVersionStamp()) {
+  if (stamp !== void 0) return stamp;
+  const hook = env.TV_TEST_VERSION;
+  if (hook !== void 0 && isReleaseVersion(hook)) return hook;
+  return DEV_VERSION;
+}
+function resolveRequiredDesktopVersion(baked, env = process.env, stamp = readVersionStamp()) {
+  if (stamp !== void 0) return baked;
+  const hook = env.TV_TEST_REQUIRED_DESKTOP_VERSION;
+  if (hook !== void 0 && isReleaseVersion(hook)) return hook;
+  return baked;
+}
+
+// ../server/src/required-desktop-version.ts
+var REQUIRED_DESKTOP_VERSION = "0.1.177";
+
+// ../server/src/updates/server-status.ts
+function buildServerStatus(env = process.env, stamp = readVersionStamp(), baked = REQUIRED_DESKTOP_VERSION, update = null) {
+  const version2 = resolveUpdateReleaseVersion(env, stamp);
+  const requiredDesktopVersion = version2 === DEV_VERSION ? null : resolveRequiredDesktopVersion(baked, env, stamp);
+  return { type: "server-status", version: version2, requiredDesktopVersion, update };
+}
+
+// ../server/src/updates/update-channel.ts
+var PRODUCTION_UPDATE_CHANNEL_URL = "https://television.run/update-channel.json";
+var MINUTES_PER_HOUR3 = 60;
+var SECONDS_PER_MINUTE3 = 60;
+var MILLISECONDS_PER_SECOND2 = 1e3;
+var HOURLY_POLL_INTERVAL_MS = MINUTES_PER_HOUR3 * SECONDS_PER_MINUTE3 * MILLISECONDS_PER_SECOND2;
+var JITTER_MAX_MINUTES = 10;
+var POLL_JITTER_MAX_MS = JITTER_MAX_MINUTES * SECONDS_PER_MINUTE3 * MILLISECONDS_PER_SECOND2;
+var FETCH_TIMEOUT_MS = 1e4;
+function parseUpdateChannelDocument(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record2 = value;
+  if (typeof record2.schemaVersion !== "number" || !Number.isInteger(record2.schemaVersion) || record2.schemaVersion < 1) return null;
+  if (typeof record2.version !== "string" || !isReleaseVersion(record2.version)) return null;
+  const toast = record2.toast;
+  if (!toast || typeof toast !== "object" || Array.isArray(toast)) return null;
+  const toastRecord = toast;
+  if (typeof toastRecord.markdown !== "string" || toastRecord.markdown.length === 0) return null;
+  if (toastRecord.prompt !== void 0 && typeof toastRecord.prompt !== "string") return null;
+  if (toastRecord.promptButtonLabel !== void 0 && typeof toastRecord.promptButtonLabel !== "string") return null;
+  let desktop;
+  if (record2.desktop !== void 0) {
+    if (!record2.desktop || typeof record2.desktop !== "object" || Array.isArray(record2.desktop)) return null;
+    const desktopRecord = record2.desktop;
+    if (typeof desktopRecord.upgradeMarkdown !== "string" || desktopRecord.upgradeMarkdown.length === 0) return null;
+    desktop = { upgradeMarkdown: desktopRecord.upgradeMarkdown };
+  }
+  return {
+    schemaVersion: record2.schemaVersion,
+    version: record2.version,
+    toast: {
+      markdown: toastRecord.markdown,
+      ...toastRecord.prompt === void 0 ? {} : { prompt: toastRecord.prompt },
+      ...toastRecord.promptButtonLabel === void 0 ? {} : { promptButtonLabel: toastRecord.promptButtonLabel }
+    },
+    ...desktop === void 0 ? {} : { desktop }
+  };
+}
+function deriveUpdateState(document2, serverVersion) {
+  if (document2 === null) return null;
+  return {
+    toast: isNewerVersion(document2.version, serverVersion) ? {
+      version: document2.version,
+      markdown: document2.toast.markdown,
+      ...document2.toast.prompt === void 0 ? {} : { prompt: document2.toast.prompt },
+      ...document2.toast.promptButtonLabel === void 0 ? {} : { promptButtonLabel: document2.toast.promptButtonLabel }
+    } : null,
+    desktop: document2.desktop === void 0 ? null : { upgradeMarkdown: document2.desktop.upgradeMarkdown }
+  };
+}
+function createUpdateChannelPoller(options) {
+  const env = options.env ?? process.env;
+  const fetchImpl = options.fetchImpl ?? ((url2, init) => fetch(url2, init));
+  const setTimeoutImpl = options.setTimeoutImpl ?? ((callback, delayMs) => setTimeout(callback, delayMs));
+  const clearTimeoutImpl = options.clearTimeoutImpl ?? ((handle) => clearTimeout(handle));
+  const random = options.random ?? Math.random;
+  const nowSeconds = options.nowSeconds ?? (() => Math.floor(Date.now() / MILLISECONDS_PER_SECOND2));
+  const urlOverride = env.TV_UPDATE_CHANNEL_URL;
+  const hasURLOverride = typeof urlOverride === "string" && urlOverride.length > 0;
+  const pollingEnabled = hasURLOverride || options.serverVersion !== DEV_VERSION;
+  const channelURL = hasURLOverride ? urlOverride : PRODUCTION_UPDATE_CHANNEL_URL;
+  const intervalOverrideMs = hasURLOverride ? parseIntervalOverride(env.TV_UPDATE_CHANNEL_POLL_INTERVAL_MS) : null;
+  let stopped = false;
+  let started = false;
+  let timer = null;
+  let inFlight = null;
+  let lastKnownGood = null;
+  let lastKnownGoodKey = null;
+  function cacheBustedURL() {
+    const url2 = new URL(channelURL);
+    url2.searchParams.set("t", String(nowSeconds()));
+    return url2.toString();
+  }
+  function nextDelayMs() {
+    if (intervalOverrideMs !== null) return intervalOverrideMs;
+    return HOURLY_POLL_INTERVAL_MS + Math.floor(random() * POLL_JITTER_MAX_MS);
+  }
+  function scheduleNext() {
+    if (stopped) return;
+    timer = setTimeoutImpl(() => {
+      timer = null;
+      void pollOnce();
+    }, nextDelayMs());
+  }
+  function adopt(document2) {
+    const key = JSON.stringify(document2);
+    if (key === lastKnownGoodKey) return;
+    lastKnownGood = document2;
+    lastKnownGoodKey = key;
+    options.onStateChange?.();
+  }
+  async function pollOnce() {
+    const controller = new AbortController();
+    inFlight = controller;
+    const timeoutHandle = setTimeoutImpl(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+      const response = await fetchImpl(cacheBustedURL(), {
+        headers: { "cache-control": "no-cache" },
+        signal: controller.signal
+      });
+      if (response.ok) {
+        const document2 = parseUpdateChannelDocument(await response.json());
+        if (document2 !== null) adopt(document2);
+      }
+    } catch {
+    } finally {
+      clearTimeoutImpl(timeoutHandle);
+      inFlight = null;
+      scheduleNext();
+    }
+  }
+  return {
+    start() {
+      if (started || stopped || !pollingEnabled) return;
+      started = true;
+      void pollOnce();
+    },
+    stop() {
+      stopped = true;
+      if (timer !== null) {
+        clearTimeoutImpl(timer);
+        timer = null;
+      }
+      inFlight?.abort();
+    },
+    getState() {
+      return deriveUpdateState(lastKnownGood, options.serverVersion);
+    }
+  };
+}
+function parseIntervalOverride(value) {
+  if (value === void 0 || value.length === 0) return null;
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed <= 0) return null;
+  return parsed;
+}
+
 // ../server/src/server.ts
 var import_meta = {};
 var HTTP_UNAUTHORIZED_STATUS = 401;
@@ -52413,6 +52670,7 @@ var Server = class {
   telemetryOptions;
   bindFailures = [];
   telemetryRuntime = null;
+  updateChannel = null;
   listeningPort;
   baseURLs;
   disposed = false;
@@ -52428,9 +52686,17 @@ var Server = class {
     this.app = (0, import_express2.default)();
     this.httpServers = this.bindAddresses.map(() => import_node_http.default.createServer(this.app));
     this.httpServer = this.httpServers[0];
+    const updateReleaseVersion = resolveUpdateReleaseVersion();
+    this.app.use((_req, res, next) => {
+      res.setHeader("X-TV-Version", updateReleaseVersion);
+      next();
+    });
     this.app.get("/health", (_req, res) => {
       res.json({
         status: "ok",
+        // ^health-version: the unauthenticated liveness probe carries the
+        // release version; a release version is not sensitive.
+        version: updateReleaseVersion,
         bindAddresses: this.bindAddresses,
         port: this.getListeningPort()
       });
@@ -52439,7 +52705,14 @@ var Server = class {
     this.events = new EventStreamServer({
       store: this.store,
       authRequired: this.authRequired,
-      recordTelemetryActivity: (clientContext) => this.telemetryRuntime?.recordClientActivity(clientContext)
+      buildServerStatus: () => buildServerStatus(void 0, void 0, void 0, this.updateChannel?.getState() ?? null),
+      recordTelemetryActivity: (clientContext) => this.telemetryRuntime?.recordClientActivity(clientContext),
+      // Validated client signals forward through the ordinary chokepoint with
+      // completely normal handling — $session_id attribution (which bumps
+      // session activity like any client-attributed request) and the
+      // suppression gate (specs/arch/telemetry/client-signals.md
+      // ^signal-forwarding).
+      recordTelemetryClientSignal: (clientContext, event) => this.telemetryRuntime?.capture(event, clientContext)
     });
     this.acp = options.acpProfile ? new ACPServer({
       authToken: this.store.authToken,
@@ -52480,7 +52753,12 @@ var Server = class {
     if (options.staticDir) {
       this.app.use(import_express2.default.static(options.staticDir, {
         setHeaders: (res, filePath) => {
-          if (filePath.endsWith(".html") || filePath.endsWith(".htm")) res.setHeader("Referrer-Policy", "no-referrer");
+          if (filePath.endsWith(".html") || filePath.endsWith(".htm")) {
+            res.setHeader("Referrer-Policy", "no-referrer");
+            res.setHeader("Cache-Control", "no-cache");
+          } else if (filePath.includes(`${import_node_path11.default.sep}assets${import_node_path11.default.sep}`)) {
+            res.setHeader("Cache-Control", "public, max-age=31536000, immutable");
+          }
         }
       }));
     }
@@ -52522,6 +52800,7 @@ var Server = class {
       throw new Error(message);
     }
     await this.startTelemetry();
+    this.startUpdateChannel();
     log(this.store.storagePath, "server started", { snapshot: this.configurationSnapshot() });
     if (!this.authRequired) {
       log(this.store.storagePath, "server running without bearer-token enforcement", { authMode: this.authMode });
@@ -52562,6 +52841,8 @@ var Server = class {
   async dispose(signal) {
     if (this.disposed) return;
     this.disposed = true;
+    this.updateChannel?.stop();
+    this.updateChannel = null;
     let disposalError;
     try {
       await Promise.all([
@@ -52618,6 +52899,18 @@ var Server = class {
   getNonLoopbackBoundAddresses() {
     return this.baseURLs.map((url2) => new URL(url2).hostname).filter((address) => address !== LOOPBACK_IPV4);
   }
+  /**
+   * Update-channel poller lifecycle (specs/arch/updates/update-channel.md):
+   * owned by the Server — started here, stopped in dispose() with its timer
+   * cleared and any in-flight fetch aborted.
+   */
+  startUpdateChannel() {
+    this.updateChannel = createUpdateChannelPoller({
+      serverVersion: resolveUpdateReleaseVersion(),
+      onStateChange: () => this.events.broadcastServerStatus()
+    });
+    this.updateChannel.start();
+  }
   async startTelemetry() {
     const version2 = this.telemetryOptions.version ?? readServerPackageVersion();
     const launchMode = this.telemetryOptions.launchMode ?? "cli";
@@ -52627,7 +52920,9 @@ var Server = class {
       dataDirCreated: this.store.dataDirCreated,
       ...this.telemetryOptions.env === void 0 ? {} : { env: this.telemetryOptions.env },
       ...this.telemetryOptions.sink === void 0 ? {} : { sink: this.telemetryOptions.sink },
-      ...this.telemetryOptions.developerHost === void 0 ? {} : { developerHost: this.telemetryOptions.developerHost }
+      ...this.telemetryOptions.developerHost === void 0 ? {} : { developerHost: this.telemetryOptions.developerHost },
+      ...this.telemetryOptions.sessions === void 0 ? {} : { sessions: this.telemetryOptions.sessions },
+      ...this.telemetryOptions.nowMs === void 0 ? {} : { nowMs: this.telemetryOptions.nowMs }
     });
     this.telemetryRuntime = runtime;
     this.store.setTelemetryHooks(createServerStoreTelemetryHooks(this.store, runtime.capture));
@@ -52695,8 +52990,8 @@ var Server = class {
   };
 };
 function readServerPackageVersion() {
-  if ("0.1.178".length > 0) {
-    return telemetryVersion("0.1.178");
+  if ("0.1.179".length > 0) {
+    return telemetryVersion("0.1.179");
   }
   const packageJsonPath = import_node_path11.default.resolve(import_node_path11.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url)), "..", "package.json");
   if (!(0, import_node_fs9.existsSync)(packageJsonPath)) return telemetryVersion("0.0.0");
@@ -52704,8 +52999,8 @@ function readServerPackageVersion() {
 }
 
 // ../server/src/server-store.ts
-var import_node_fs11 = require("node:fs");
-var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_fs13 = require("node:fs");
+var import_node_path16 = __toESM(require("node:path"), 1);
 
 // ../server/src/file-watcher.ts
 var import_node_events = require("node:events");
@@ -52880,31 +53175,524 @@ var defaultWatchContentFile = (filePath, onChange, basenames, options) => {
   return new ReArmingContentWatcher(filePath, onChange, basenames, options);
 };
 
-// ../server/src/onboarding.ts
+// ../server/src/onboarding-installer.ts
+var import_node_fs12 = require("node:fs");
+var import_node_path15 = __toESM(require("node:path"), 1);
+
+// ../server/src/onboarding-content.ts
 var import_node_fs10 = require("node:fs");
 var import_node_path13 = __toESM(require("node:path"), 1);
-var import_node_url2 = require("node:url");
-var import_meta2 = {};
+var ONBOARDING_CONFIG_FILENAME = "onboarding-screens.json";
+var ONBOARDING_ARTIFACT_ID_PREFIX = "television-onboarding";
+function onboardingArtifactID(screenSlug, artifactSlug) {
+  return `${ONBOARDING_ARTIFACT_ID_PREFIX}--${screenSlug}--${artifactSlug}`;
+}
+function buildOnboardingScreenLayout(screenSlug, layout) {
+  const substituteCard = (card) => createCardNode(onboardingArtifactID(screenSlug, card.slug), {
+    ...card.width !== void 0 ? { width: card.width } : {},
+    ...card.height !== void 0 ? { height: card.height } : {}
+  });
+  return layout.map((node) => {
+    switch (node.type) {
+      case "card":
+        return substituteCard(node);
+      case "row":
+        return { id: node.id, type: "row", height: node.height, children: node.children.map(substituteCard) };
+      case "stack":
+        return {
+          id: node.id,
+          type: "stack",
+          children: node.children.map(
+            (child) => child.type === "card" ? substituteCard(child) : { id: child.id, type: "row", height: child.height, children: child.children.map(substituteCard) }
+          )
+        };
+    }
+  });
+}
+var ONBOARDING_SLUG_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+function isValidOnboardingSlug(slug) {
+  return ONBOARDING_SLUG_PATTERN.test(slug) && !slug.includes("--");
+}
+function loadOnboardingConfig(contentRoot) {
+  const configPath = import_node_path13.default.join(contentRoot, ONBOARDING_CONFIG_FILENAME);
+  let raw;
+  try {
+    raw = (0, import_node_fs10.readFileSync)(configPath, "utf8");
+  } catch (error48) {
+    return { errors: [`cannot read ${ONBOARDING_CONFIG_FILENAME}: ${describeError(error48)}`] };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error48) {
+    return { errors: [`failed to parse ${ONBOARDING_CONFIG_FILENAME}: ${describeError(error48)}`] };
+  }
+  const errors = validateConfigSchema(parsed);
+  if (errors.length > 0) {
+    return { errors };
+  }
+  return { config: parsed, errors: [] };
+}
+function resolveOnboardingArtifactSource(contentRoot, screenSlug, artifactSlug) {
+  const label = `artifact "${artifactSlug}" in screen "${screenSlug}"`;
+  const screenDir = import_node_path13.default.join(contentRoot, screenSlug);
+  const shapes = [];
+  for (const extension2 of [".html", ".md"]) {
+    const candidate = import_node_path13.default.join(screenDir, `${artifactSlug}${extension2}`);
+    if (isFile(candidate)) {
+      shapes.push({ kind: "file", path: candidate, display: `${artifactSlug}${extension2}` });
+    }
+  }
+  const dirPath = import_node_path13.default.join(screenDir, artifactSlug);
+  if (isDirectory(dirPath)) {
+    shapes.push({ kind: "directory", path: dirPath, display: `${artifactSlug}/` });
+  }
+  if (shapes.length > 1) {
+    return {
+      ok: false,
+      error: `${label} is ambiguous: more than one source shape exists (${shapes.map((shape2) => shape2.display).join(", ")})`
+    };
+  }
+  const shape = shapes[0];
+  if (shape === void 0) {
+    return {
+      ok: false,
+      error: `${label} has no source: expected ${artifactSlug}.html, ${artifactSlug}.md, or ${artifactSlug}/`
+    };
+  }
+  if (shape.kind === "directory" && !isFile(import_node_path13.default.join(shape.path, "index.html"))) {
+    return { ok: false, error: `${label} is a directory artifact missing index.html at its root` };
+  }
+  return { ok: true, source: { kind: shape.kind, path: shape.path } };
+}
+function validateConfigSchema(parsed) {
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return [`${ONBOARDING_CONFIG_FILENAME} must be a JSON object`];
+  }
+  const config2 = parsed;
+  const errors = [];
+  if (config2.version !== 1) {
+    errors.push(`config version must be 1, got ${JSON.stringify(config2.version)}`);
+  }
+  if (typeof config2.focusScreen !== "string") {
+    errors.push("focusScreen must be a screen slug string");
+  }
+  if (!Array.isArray(config2.screens) || config2.screens.length === 0) {
+    errors.push("screens must be a non-empty array");
+    return errors;
+  }
+  const screenSlugs = /* @__PURE__ */ new Set();
+  for (const [index, rawScreen] of config2.screens.entries()) {
+    errors.push(...validateScreenSchema(rawScreen, index, screenSlugs));
+  }
+  if (typeof config2.focusScreen === "string" && !screenSlugs.has(config2.focusScreen)) {
+    errors.push(`focusScreen "${config2.focusScreen}" does not name a configured screen`);
+  }
+  return errors;
+}
+function validateScreenSchema(rawScreen, index, screenSlugs) {
+  if (typeof rawScreen !== "object" || rawScreen === null) {
+    return [`screens[${index}] must be an object`];
+  }
+  const screen = rawScreen;
+  const errors = [];
+  const slugLabel = typeof screen.slug === "string" ? `"${screen.slug}"` : `at index ${index}`;
+  if (typeof screen.slug !== "string" || !isValidOnboardingSlug(screen.slug)) {
+    errors.push(
+      `screen ${slugLabel} has an invalid slug: must match ${ONBOARDING_SLUG_PATTERN} with no "--"`
+    );
+  } else if (screenSlugs.has(screen.slug)) {
+    errors.push(`duplicate screen slug "${screen.slug}"`);
+  } else {
+    screenSlugs.add(screen.slug);
+  }
+  if (typeof screen.name !== "string" || screen.name.trim().length === 0) {
+    errors.push(`screen ${slugLabel} must have a non-empty name`);
+  }
+  if (!Array.isArray(screen.artifacts)) {
+    errors.push(`screen ${slugLabel} must have an artifacts array`);
+    return errors;
+  }
+  const artifactSlugs = /* @__PURE__ */ new Set();
+  for (const [artifactIndex, rawArtifact] of screen.artifacts.entries()) {
+    errors.push(...validateArtifactSchema(rawArtifact, slugLabel, artifactIndex, artifactSlugs));
+  }
+  errors.push(...validateScreenLayoutSchema(screen, slugLabel, artifactSlugs));
+  return errors;
+}
+function validateScreenLayoutSchema(screen, slugLabel, artifactSlugs) {
+  if (!Array.isArray(screen.layout)) {
+    return [`screen ${slugLabel} must have a layout array`];
+  }
+  const errors = [];
+  const placedSlugs = [];
+  for (const rawNode of screen.layout) {
+    errors.push(...validateLayoutNodeShape(rawNode, slugLabel, placedSlugs));
+  }
+  if (errors.length > 0) {
+    return errors;
+  }
+  const screenSlug = typeof screen.slug === "string" ? screen.slug : "";
+  const substituted = buildOnboardingScreenLayout(screenSlug, screen.layout);
+  const layoutValidation = validateLayout(substituted);
+  errors.push(...layoutValidation.errors.map((error48) => `screen ${slugLabel} layout is invalid: ${error48}`));
+  const placed = new Set(placedSlugs);
+  for (const slug of placed) {
+    if (!artifactSlugs.has(slug)) {
+      errors.push(`screen ${slugLabel} layout card references unconfigured artifact "${slug}"`);
+    }
+  }
+  for (const slug of artifactSlugs) {
+    if (!placed.has(slug)) {
+      errors.push(`screen ${slugLabel} artifact "${slug}" is absent from the layout`);
+    }
+  }
+  return errors;
+}
+function validateLayoutNodeShape(rawNode, slugLabel, placedSlugs) {
+  if (typeof rawNode !== "object" || rawNode === null || Array.isArray(rawNode)) {
+    return [`screen ${slugLabel} layout contains a non-object node`];
+  }
+  const node = rawNode;
+  switch (node.type) {
+    case "card":
+      return validateCardNodeShape(node, slugLabel, placedSlugs);
+    case "row":
+      return validateRowNodeShape(node, slugLabel, placedSlugs);
+    case "stack": {
+      const errors = checkNodeKeys(node, ["id", "type", "children"], `screen ${slugLabel} layout stack`);
+      if (!Array.isArray(node.children)) {
+        errors.push(`screen ${slugLabel} layout stack must have a children array`);
+        return errors;
+      }
+      for (const child of node.children) {
+        const childNode = typeof child === "object" && child !== null ? child : void 0;
+        if (childNode?.type === "card") {
+          errors.push(...validateCardNodeShape(childNode, slugLabel, placedSlugs));
+        } else if (childNode?.type === "row") {
+          errors.push(...validateRowNodeShape(childNode, slugLabel, placedSlugs));
+        } else {
+          errors.push(`screen ${slugLabel} layout stack children must be card or row nodes`);
+        }
+      }
+      return errors;
+    }
+    default:
+      return [`screen ${slugLabel} layout node has unknown type ${JSON.stringify(node.type)}`];
+  }
+}
+function validateCardNodeShape(node, slugLabel, placedSlugs) {
+  const errors = checkNodeKeys(node, ["type", "slug", "width", "height"], `screen ${slugLabel} layout card`);
+  if (typeof node.slug !== "string" || node.slug.length === 0) {
+    errors.push(`screen ${slugLabel} layout card must reference an artifact slug`);
+  } else {
+    placedSlugs.push(node.slug);
+  }
+  return errors;
+}
+function validateRowNodeShape(node, slugLabel, placedSlugs) {
+  const errors = checkNodeKeys(node, ["id", "type", "height", "children"], `screen ${slugLabel} layout row`);
+  if (!Array.isArray(node.children)) {
+    errors.push(`screen ${slugLabel} layout row must have a children array`);
+    return errors;
+  }
+  for (const child of node.children) {
+    const childNode = typeof child === "object" && child !== null ? child : void 0;
+    if (childNode?.type === "card") {
+      errors.push(...validateCardNodeShape(childNode, slugLabel, placedSlugs));
+    } else {
+      errors.push(`screen ${slugLabel} layout row children must be card nodes`);
+    }
+  }
+  return errors;
+}
+function checkNodeKeys(node, allowed, label) {
+  const unknownKeys = Object.keys(node).filter((key) => !allowed.includes(key));
+  if (unknownKeys.length > 0) {
+    return [`${label} has unknown fields: ${unknownKeys.join(", ")} (only ${allowed.join("/")} are allowed)`];
+  }
+  return [];
+}
+function validateArtifactSchema(rawArtifact, screenLabel, index, artifactSlugs) {
+  if (typeof rawArtifact !== "object" || rawArtifact === null) {
+    return [`artifact at index ${index} in screen ${screenLabel} must be an object`];
+  }
+  const artifact = rawArtifact;
+  const errors = [];
+  const slugLabel = typeof artifact.slug === "string" ? `"${artifact.slug}"` : `at index ${index}`;
+  const label = `artifact ${slugLabel} in screen ${screenLabel}`;
+  if (typeof artifact.slug !== "string" || !isValidOnboardingSlug(artifact.slug)) {
+    errors.push(`${label} has an invalid slug: must match ${ONBOARDING_SLUG_PATTERN} with no "--"`);
+  } else if (artifactSlugs.has(artifact.slug)) {
+    errors.push(`duplicate artifact slug "${artifact.slug}" in screen ${screenLabel}`);
+  } else {
+    artifactSlugs.add(artifact.slug);
+  }
+  if (typeof artifact.title !== "string" || artifact.title.trim().length === 0) {
+    errors.push(`${label} must have a non-empty title`);
+  }
+  return errors;
+}
+function isFile(candidate) {
+  return (0, import_node_fs10.existsSync)(candidate) && (0, import_node_fs10.statSync)(candidate).isFile();
+}
+function isDirectory(candidate) {
+  return (0, import_node_fs10.existsSync)(candidate) && (0, import_node_fs10.statSync)(candidate).isDirectory();
+}
+function describeError(error48) {
+  return error48 instanceof Error ? error48.message : String(error48);
+}
+
+// ../server/src/onboarding-state.ts
+var import_node_fs11 = require("node:fs");
+var import_node_path14 = __toESM(require("node:path"), 1);
+
+// ../server/src/onboarding.ts
 var ONBOARDING_ARTIFACT_ID = "television-onboarding";
-var ONBOARDING_SCREEN_NAME = "TV Guide";
-var ONBOARDING_ARTIFACT_TITLE = "Welcome to Television";
-var ONBOARDING_ARTIFACT_DIRNAME = "television-onboarding";
-var ONBOARDING_ARTIFACT_SENTINEL_VERSION = 1;
-function getDefaultOnboardingArtifactSourcePath() {
-  const moduleURL = import_meta2.url;
-  if (typeof moduleURL !== "string") {
+
+// ../server/src/onboarding-state.ts
+var JSON_INDENT_SPACES = 2;
+function readOnboardingStateFile(storagePath) {
+  const statePath = getOnboardingStatePath(storagePath);
+  if (!(0, import_node_fs11.existsSync)(statePath)) {
+    return { status: "absent" };
+  }
+  const parsed = parseJSONFile(statePath);
+  if (!parsed.ok) {
+    return { status: "invalid", error: parsed.error };
+  }
+  const state = parseV2State(parsed.value);
+  return state !== void 0 ? { status: "ok", state } : { status: "invalid", error: `not a version 2 onboarding state payload: ${statePath}` };
+}
+function readLegacyOnboardingFile(storagePath) {
+  const legacyPath = getOnboardingArtifactSentinelPath(storagePath);
+  if (!(0, import_node_fs11.existsSync)(legacyPath)) {
+    return { status: "absent" };
+  }
+  const parsed = parseJSONFile(legacyPath);
+  if (!parsed.ok) {
+    return { status: "invalid", error: parsed.error };
+  }
+  const v2 = parseV2State(parsed.value);
+  if (v2 !== void 0) {
+    return { status: "v2", state: v2 };
+  }
+  const value = parsed.value;
+  if (typeof value === "object" && value !== null && value.version === 1) {
+    if (value.artifactID !== ONBOARDING_ARTIFACT_ID) {
+      return { status: "invalid", error: `not a recognized onboarding payload: ${legacyPath}` };
+    }
+    const installedAt = value.installedAt;
+    return {
+      status: "v1",
+      installedAt: isUsableTimestamp(installedAt) ? installedAt : void 0
+    };
+  }
+  return { status: "invalid", error: `not a recognized onboarding payload: ${legacyPath}` };
+}
+function getOnboardingStateTempPath(storagePath) {
+  const statePath = getOnboardingStatePath(storagePath);
+  return import_node_path14.default.join(import_node_path14.default.dirname(statePath), `.${import_node_path14.default.basename(statePath)}.tmp-${process.pid}`);
+}
+function writeOnboardingStateFile(storagePath, state) {
+  const statePath = getOnboardingStatePath(storagePath);
+  const tempPath = getOnboardingStateTempPath(storagePath);
+  try {
+    (0, import_node_fs11.writeFileSync)(tempPath, JSON.stringify(state, null, JSON_INDENT_SPACES));
+    (0, import_node_fs11.renameSync)(tempPath, statePath);
+  } catch (error48) {
+    try {
+      (0, import_node_fs11.rmSync)(tempPath, { force: true });
+    } catch {
+    }
+    throw error48;
+  }
+}
+function parseJSONFile(filePath) {
+  let raw;
+  try {
+    raw = (0, import_node_fs11.readFileSync)(filePath, "utf8");
+  } catch (error48) {
+    return { ok: false, error: `cannot read ${filePath}: ${describeError2(error48)}` };
+  }
+  try {
+    return { ok: true, value: JSON.parse(raw) };
+  } catch (error48) {
+    return { ok: false, error: `cannot parse ${filePath}: ${describeError2(error48)}` };
+  }
+}
+function parseV2State(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return void 0;
   }
-  const sourcePath = import_node_path13.default.resolve(
-    import_node_path13.default.dirname((0, import_node_url2.fileURLToPath)(moduleURL)),
-    "../assets",
-    ONBOARDING_ARTIFACT_DIRNAME
-  );
-  return (0, import_node_fs10.existsSync)(sourcePath) ? sourcePath : void 0;
+  const candidate = value;
+  if (candidate.version !== 2) {
+    return void 0;
+  }
+  if (typeof candidate.screens !== "object" || candidate.screens === null || Array.isArray(candidate.screens)) {
+    return void 0;
+  }
+  const screens = {};
+  for (const [slug, record2] of Object.entries(candidate.screens)) {
+    if (!isValidOnboardingSlug(slug)) {
+      return void 0;
+    }
+    if (typeof record2 !== "object" || record2 === null || !isUsableTimestamp(record2.installedAt)) {
+      return void 0;
+    }
+    screens[slug] = { installedAt: record2.installedAt };
+  }
+  return { version: 2, screens };
+}
+function isUsableTimestamp(value) {
+  return typeof value === "string" && !Number.isNaN(Date.parse(value));
+}
+function describeError2(error48) {
+  return error48 instanceof Error ? error48.message : String(error48);
+}
+
+// ../server/src/onboarding-installer.ts
+var MIGRATED_TV_GUIDE_SLUG = "tv-guide";
+function runOnboardingBootstrap(target, contentPath) {
+  let state;
+  try {
+    const migrated = migrateOnboardingState(target);
+    if (migrated === void 0) {
+      return { focusScreenID: void 0 };
+    }
+    state = migrated;
+  } catch (error48) {
+    console.warn("Onboarding state migration failed; skipping onboarding install for this boot.", error48);
+    return { focusScreenID: void 0 };
+  }
+  if (contentPath === void 0) {
+    return { focusScreenID: void 0 };
+  }
+  const { config: config2, errors } = loadOnboardingConfig(contentPath);
+  if (!config2) {
+    console.warn(
+      `Onboarding config at ${contentPath} is unusable; skipping onboarding install for this boot.
+` + errors.map((error48) => `  - ${error48}`).join("\n")
+    );
+    return { focusScreenID: void 0 };
+  }
+  const completed = /* @__PURE__ */ new Map();
+  for (const [index, screenConfig] of config2.screens.entries()) {
+    if (state.screens[screenConfig.slug] !== void 0) {
+      continue;
+    }
+    try {
+      const screenID = installScreen(target, contentPath, screenConfig, index);
+      const nextState = {
+        version: 2,
+        screens: {
+          ...state.screens,
+          [screenConfig.slug]: { installedAt: (/* @__PURE__ */ new Date()).toISOString() }
+        }
+      };
+      writeOnboardingStateFile(target.storagePath, nextState);
+      state = nextState;
+      completed.set(screenConfig.slug, screenID);
+    } catch (error48) {
+      console.warn(
+        `Failed to install onboarding screen "${screenConfig.slug}"; it will retry on the next boot.`,
+        error48
+      );
+    }
+  }
+  return { focusScreenID: completed.get(config2.focusScreen) };
+}
+function migrateOnboardingState(target) {
+  const existing = readOnboardingStateFile(target.storagePath);
+  if (existing.status === "ok") {
+    return existing.state;
+  }
+  if (existing.status === "invalid") {
+    console.warn(
+      `Onboarding state file is unreadable; skipping onboarding install for this boot rather than risking a duplicate install. ${existing.error}`
+    );
+    return void 0;
+  }
+  const legacy = readLegacyOnboardingFile(target.storagePath);
+  switch (legacy.status) {
+    case "v1": {
+      const state = {
+        version: 2,
+        screens: {
+          [MIGRATED_TV_GUIDE_SLUG]: { installedAt: legacy.installedAt ?? (/* @__PURE__ */ new Date()).toISOString() }
+        }
+      };
+      writeOnboardingStateFile(target.storagePath, state);
+      return state;
+    }
+    case "v2": {
+      writeOnboardingStateFile(target.storagePath, legacy.state);
+      return legacy.state;
+    }
+    case "invalid":
+      console.warn(
+        `Legacy onboarding sentinel is unreadable; skipping onboarding install for this boot rather than risking a duplicate install. ${legacy.error}`
+      );
+      return void 0;
+    case "absent": {
+      if (target.hasArtifact(ONBOARDING_ARTIFACT_ID)) {
+        const state = {
+          version: 2,
+          screens: { [MIGRATED_TV_GUIDE_SLUG]: { installedAt: (/* @__PURE__ */ new Date()).toISOString() } }
+        };
+        writeOnboardingStateFile(target.storagePath, state);
+        return state;
+      }
+      return { version: 2, screens: {} };
+    }
+  }
+}
+function installScreen(target, contentPath, screenConfig, configIndex) {
+  const existing = target.listScreens().find((screen2) => screen2.onboarding?.slug === screenConfig.slug);
+  const screen = existing ?? target.createScreen({
+    name: screenConfig.name,
+    onboarding: { slug: screenConfig.slug, order: configIndex }
+  });
+  const copies = [];
+  for (const artifactConfig of screenConfig.artifacts) {
+    const resolved = resolveOnboardingArtifactSource(contentPath, screenConfig.slug, artifactConfig.slug);
+    if (!resolved.ok) {
+      throw new Error(resolved.error);
+    }
+    const artifactID = onboardingArtifactID(screenConfig.slug, artifactConfig.slug);
+    const artifactsDir = getAgentArtifactsDir(target.storagePath);
+    if (resolved.source.kind === "file") {
+      const destination = import_node_path15.default.join(artifactsDir, `${artifactID}${import_node_path15.default.extname(resolved.source.path)}`);
+      (0, import_node_fs12.rmSync)(destination, { recursive: true, force: true });
+      (0, import_node_fs12.cpSync)(resolved.source.path, destination);
+      copies.push({ artifactConfig, artifactID, destination });
+    } else {
+      const destinationDir = import_node_path15.default.join(artifactsDir, artifactID);
+      if ((0, import_node_fs12.existsSync)(destinationDir)) {
+        (0, import_node_fs12.rmSync)(destinationDir, { recursive: true, force: true });
+      }
+      (0, import_node_fs12.cpSync)(resolved.source.path, destinationDir, { recursive: true });
+      copies.push({ artifactConfig, artifactID, destination: destinationDir + import_node_path15.default.sep });
+    }
+  }
+  for (const { artifactConfig, artifactID, destination } of copies) {
+    if (target.hasArtifact(artifactID)) {
+      continue;
+    }
+    target.createArtifact({
+      id: artifactID,
+      kind: "path",
+      title: artifactConfig.title,
+      screenID: screen.id,
+      path: destination
+    });
+  }
+  target.setScreenLayout(screen.id, buildOnboardingScreenLayout(screenConfig.slug, screenConfig.layout));
+  return screen.id;
 }
 
 // ../server/src/server-store.ts
-var JSON_INDENT_SPACES = 2;
+var JSON_INDENT_SPACES2 = 2;
 var CONTENT_WATCH_DEBOUNCE_MS = 100;
 var JSON_FILE_SUFFIX = ".json";
 var DIRECTORY_INDEX_BASENAMES = ["index.html", "index.htm"];
@@ -52916,12 +53704,13 @@ function hasExistingTelevisionDataStructure(storagePath) {
   return [
     getDisplayStatePath(storagePath),
     getTokenPath(storagePath),
+    getOnboardingStatePath(storagePath),
     getOnboardingArtifactSentinelPath(storagePath),
     getScreensDir(storagePath),
     getArtifactsMetadataDir(storagePath),
     getThemesDir(storagePath),
     getAgentArtifactsDir(storagePath)
-  ].some((markerPath) => (0, import_node_fs11.existsSync)(markerPath));
+  ].some((markerPath) => (0, import_node_fs13.existsSync)(markerPath));
 }
 function artifactWatchTarget(artifact) {
   if (artifact.kind === "url") {
@@ -52951,30 +53740,55 @@ var ServerStore = class extends EventTarget {
   themeWatchDebounceTimer = null;
   watchContentFile;
   bundledViewsPath;
-  onboardingArtifactSourcePath;
+  onboardingContentPath;
+  serving;
+  // True only while the constructor's install phase runs: content watchers
+  // must not start before the final bootstrap step
+  // (specs/arch/onboarding/installer.md#^bootstrap-sequence step 7).
+  inBootstrapInstall = false;
   telemetryHooks = null;
+  // The serving bootstrap sequence and the token-only cutoff are spec'd:
+  // specs/arch/onboarding/installer.md#^bootstrap-sequence, #^token-only-boot.
   constructor(options) {
     super();
-    this.storagePath = options.storagePath;
+    this.storagePath = import_node_path16.default.resolve(options.storagePath);
     this.dataDirCreated = !hasExistingTelevisionDataStructure(options.storagePath);
     this.watchContentFile = options.watchContentFile ?? defaultWatchContentFile;
     this.bundledViewsPath = options.bundledViewsPath;
-    this.onboardingArtifactSourcePath = options.onboardingArtifactSourcePath ?? getDefaultOnboardingArtifactSourcePath();
+    this.onboardingContentPath = options.onboardingContentPath;
+    this.serving = options.installOnboardingScreens === true;
     this.ensureDirectories();
     this.authToken = this.loadOrCreateAuthToken();
     this.load();
     this.rebuildArtifactScreens();
-    const installOnboardingArtifact = options.installOnboardingArtifact === true;
+    if (!this.serving) {
+      return;
+    }
+    const noContentAtBoot = this._artifacts.size === 0 && [...this.screens.values()].every((screen) => screen.layout.length === 0);
+    this.inBootstrapInstall = true;
+    const onboarding = runOnboardingBootstrap(
+      {
+        storagePath: this.storagePath,
+        listScreens: () => this.listScreens(),
+        hasArtifact: (id) => this._artifacts.has(id),
+        createScreen: (input) => this.createScreen(input),
+        createArtifact: (input) => this.createArtifact(input),
+        setScreenLayout: (screenID, layout) => this.setScreenLayoutForInstall(screenID, layout)
+      },
+      this.onboardingContentPath
+    );
+    this.inBootstrapInstall = false;
     if (this.screens.size === 0) {
-      this.createDefaultScreen({
-        name: installOnboardingArtifact && this.canInstallOnboardingArtifact() ? ONBOARDING_SCREEN_NAME : "Default"
-      });
+      this.createScreen({ name: "Default" });
     }
     if (!this.loadDisplayState()) {
       this.initializeDisplayState();
     }
-    if (installOnboardingArtifact) {
-      this.installOnboardingArtifactIfNeeded();
+    if (noContentAtBoot && onboarding.focusScreenID !== void 0 && this.screens.has(onboarding.focusScreenID)) {
+      this.patchDisplay({ activeScreenID: onboarding.focusScreenID });
+    }
+    for (const artifact of this._artifacts.values()) {
+      this.startWatchingArtifactContent(artifact);
     }
     this.startWatchingActiveTheme();
   }
@@ -52988,8 +53802,8 @@ var ServerStore = class extends EventTarget {
     if (!isBundledViewID(id) || this.bundledViewsPath === void 0) {
       return null;
     }
-    const viewPath = import_node_path14.default.join(this.bundledViewsPath, id);
-    return (0, import_node_fs11.existsSync)(import_node_path14.default.join(viewPath, "index.html")) ? viewPath : null;
+    const viewPath = import_node_path16.default.join(this.bundledViewsPath, id);
+    return (0, import_node_fs13.existsSync)(import_node_path16.default.join(viewPath, "index.html")) ? viewPath : null;
   }
   getScreen(id) {
     const screen = this.screens.get(id);
@@ -53021,7 +53835,7 @@ var ServerStore = class extends EventTarget {
       this.persistScreen(screen);
     } catch (error48) {
       screen.layout = previousLayout;
-      (0, import_node_fs11.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), { force: true });
+      (0, import_node_fs13.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), { force: true });
       throw error48;
     }
     this._artifacts.set(artifact.id, artifact);
@@ -53102,18 +53916,21 @@ var ServerStore = class extends EventTarget {
     }
     this.stopWatchingArtifactContent(artifactID);
     this._artifacts.delete(artifactID);
-    (0, import_node_fs11.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifactID), { force: true });
+    (0, import_node_fs13.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifactID), { force: true });
     if (screenID !== void 0) {
       this.dispatchEvent(new ArtifactRemovedEvent("artifact-removed", { artifactID, screenID }));
     }
     this.emitTelemetry((hooks) => hooks.artifactDeleted(artifact, telemetryContext));
     return artifact.kind === "path" ? { outcome: "deleted", kind: "path", artifactID, path: artifact.path } : { outcome: "deleted", kind: "url", artifactID, url: artifact.url };
   }
+  // `onboarding` is installer-only: routes never forward the field from
+  // public request bodies (specs/arch/onboarding/tab-promotion.md#^marker-api-readonly).
   createScreen(input, telemetryContext) {
     const screen = {
       id: input.id ?? ulid3(),
       name: input.name,
-      layout: []
+      layout: [],
+      ...input.onboarding ? { onboarding: input.onboarding } : {}
     };
     this.screens.set(screen.id, screen);
     this.persistScreen(screen);
@@ -53239,8 +54056,8 @@ var ServerStore = class extends EventTarget {
     const previousActiveScreenID = this.getActiveScreenID();
     const artifactIDs = [...new Set(getScreenArtifactIDs(screen))];
     const artifactResults = artifactIDs.map((artifactID) => this.deleteArtifact(artifactID, telemetryContext));
-    const metadataPath = import_node_path14.default.join(this.screensDir, `${screen.id}.json`);
-    (0, import_node_fs11.rmSync)(metadataPath, { force: true });
+    const metadataPath = import_node_path16.default.join(this.screensDir, `${screen.id}.json`);
+    (0, import_node_fs13.rmSync)(metadataPath, { force: true });
     this.screens.delete(screen.id);
     this.dispatchEvent(new ScreenRemovedEvent("screen-removed", { screenID }));
     this.emitTelemetry((hooks) => hooks.screenDeleted(screen, telemetryContext));
@@ -53267,13 +54084,13 @@ var ServerStore = class extends EventTarget {
     }
   }
   load() {
-    if ((0, import_node_fs11.existsSync)(this.screensDir)) {
-      for (const file2 of (0, import_node_fs11.readdirSync)(this.screensDir)) {
+    if ((0, import_node_fs13.existsSync)(this.screensDir)) {
+      for (const file2 of (0, import_node_fs13.readdirSync)(this.screensDir)) {
         if (!file2.endsWith(JSON_FILE_SUFFIX)) continue;
-        const filePath = import_node_path14.default.join(this.screensDir, file2);
+        const filePath = import_node_path16.default.join(this.screensDir, file2);
         let raw;
         try {
-          raw = JSON.parse((0, import_node_fs11.readFileSync)(filePath, "utf8"));
+          raw = JSON.parse((0, import_node_fs13.readFileSync)(filePath, "utf8"));
         } catch (error48) {
           console.warn(`Skipping malformed JSON file: ${filePath}`, error48);
           continue;
@@ -53282,28 +54099,32 @@ var ServerStore = class extends EventTarget {
           console.warn(`Skipping malformed screen file: ${filePath}`);
           continue;
         }
+        const onboarding = parseOnboardingMarker(raw.onboarding);
         this.screens.set(raw.id, {
           id: raw.id,
           name: raw.name,
-          layout: raw.layout
+          layout: raw.layout,
+          ...onboarding ? { onboarding } : {}
         });
       }
     }
-    if (!(0, import_node_fs11.existsSync)(this.artifactsDir)) {
+    if (!(0, import_node_fs13.existsSync)(this.artifactsDir)) {
       return;
     }
-    for (const file2 of (0, import_node_fs11.readdirSync)(this.artifactsDir)) {
+    for (const file2 of (0, import_node_fs13.readdirSync)(this.artifactsDir)) {
       if (!file2.endsWith(JSON_FILE_SUFFIX)) {
         continue;
       }
       const id = file2.slice(0, -JSON_FILE_SUFFIX.length);
-      const metadataPath = import_node_path14.default.join(this.artifactsDir, file2);
+      const metadataPath = import_node_path16.default.join(this.artifactsDir, file2);
       const metadata = this.readArtifactFile(metadataPath, id);
       this._artifacts.set(id, metadata);
-      this.startWatchingArtifactContent(metadata);
     }
   }
   startWatchingArtifactContent(artifact) {
+    if (this.inBootstrapInstall) {
+      return;
+    }
     this.stopWatchingArtifactContent(artifact.id);
     const target = artifactWatchTarget(artifact);
     if (target === null) {
@@ -53466,20 +54287,20 @@ var ServerStore = class extends EventTarget {
    * without statting.
    */
   normalizeArtifactPath(artifactPath) {
-    if (!import_node_path14.default.isAbsolute(artifactPath)) {
+    if (!import_node_path16.default.isAbsolute(artifactPath)) {
       throw new InvalidRequestError("path must be absolute");
     }
     const stripped = stripTrailingSeparators(artifactPath);
     let stat;
     try {
-      (0, import_node_fs11.accessSync)(stripped, import_node_fs11.constants.R_OK);
-      stat = (0, import_node_fs11.statSync)(stripped);
+      (0, import_node_fs13.accessSync)(stripped, import_node_fs13.constants.R_OK);
+      stat = (0, import_node_fs13.statSync)(stripped);
     } catch {
       throw new InvalidRequestError(`path does not exist or is not readable: ${artifactPath}`);
     }
     if (stat.isDirectory()) {
-      const canonical = hasTrailingSeparator(stripped) ? stripped : `${stripped}${import_node_path14.default.sep}`;
-      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs11.existsSync)(import_node_path14.default.join(canonical, basename)))) {
+      const canonical = hasTrailingSeparator(stripped) ? stripped : `${stripped}${import_node_path16.default.sep}`;
+      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs13.existsSync)(import_node_path16.default.join(canonical, basename)))) {
         throw new InvalidRequestError(`directory artifact must contain index.html or index.htm: ${canonical}`);
       }
       return canonical;
@@ -53492,52 +54313,18 @@ var ServerStore = class extends EventTarget {
     }
     return stripped;
   }
-  canInstallOnboardingArtifact() {
-    return !(0, import_node_fs11.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath)) && !this._artifacts.has(ONBOARDING_ARTIFACT_ID) && this.onboardingArtifactSourcePath !== void 0;
-  }
-  installOnboardingArtifactIfNeeded() {
-    try {
-      if ((0, import_node_fs11.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath))) {
-        return;
-      }
-      if (this._artifacts.has(ONBOARDING_ARTIFACT_ID)) {
-        this.writeOnboardingArtifactSentinel();
-        return;
-      }
-      if (!this.onboardingArtifactSourcePath) {
-        console.warn("Skipping onboarding artifact install: bundled onboarding artifact was not found.");
-        return;
-      }
-      const screenID = this.resolveActiveScreenID(this.activeScreenID) ?? this.pickPreferredScreenID();
-      const onboardingPath = import_node_path14.default.join(getAgentArtifactsDir(this.storagePath), ONBOARDING_ARTIFACT_DIRNAME) + import_node_path14.default.sep;
-      if (!(0, import_node_fs11.existsSync)(onboardingPath)) {
-        (0, import_node_fs11.cpSync)(this.onboardingArtifactSourcePath, onboardingPath, { recursive: true });
-      }
-      this.createArtifact({
-        id: ONBOARDING_ARTIFACT_ID,
-        kind: "path",
-        title: ONBOARDING_ARTIFACT_TITLE,
-        screenID,
-        path: onboardingPath,
-        card: { width: 5 }
-      });
-      this.writeOnboardingArtifactSentinel();
-    } catch (error48) {
-      console.warn("Failed to install onboarding artifact; continuing startup.", error48);
-    }
-  }
-  writeOnboardingArtifactSentinel() {
-    (0, import_node_fs11.writeFileSync)(
-      getOnboardingArtifactSentinelPath(this.storagePath),
-      JSON.stringify({
-        version: ONBOARDING_ARTIFACT_SENTINEL_VERSION,
-        artifactID: ONBOARDING_ARTIFACT_ID,
-        installedAt: (/* @__PURE__ */ new Date()).toISOString()
-      }, null, JSON_INDENT_SPACES)
-    );
-  }
-  createDefaultScreen(input) {
-    this.createScreen({ name: input.name });
+  /**
+   * Installer-only whole-layout write: an unmarked slug's screen layout is
+   * always written whole from the configured tree, healing partial or missing
+   * arrangements on retry
+   * (specs/arch/onboarding/installer.md#^layout-write-unmarked). Not reachable
+   * from the public API, which validates layouts at the route boundary.
+   */
+  setScreenLayoutForInstall(screenID, layout) {
+    const screen = this.requireScreen(screenID);
+    screen.layout = layout;
+    this.persistScreen(screen);
+    this.rebuildArtifactScreensForScreen(screen);
   }
   initializeDisplayState() {
     this.activeScreenID = this.pickPreferredScreenID();
@@ -53545,11 +54332,11 @@ var ServerStore = class extends EventTarget {
     this.persistDisplayState();
   }
   ensureDirectories() {
-    (0, import_node_fs11.mkdirSync)(import_node_path14.default.join(this.storagePath, "state"), { recursive: true });
-    (0, import_node_fs11.mkdirSync)(this.screensDir, { recursive: true });
-    (0, import_node_fs11.mkdirSync)(this.artifactsDir, { recursive: true });
-    (0, import_node_fs11.mkdirSync)(getThemesDir(this.storagePath), { recursive: true });
-    (0, import_node_fs11.mkdirSync)(getAgentArtifactsDir(this.storagePath), { recursive: true });
+    (0, import_node_fs13.mkdirSync)(import_node_path16.default.join(this.storagePath, "state"), { recursive: true });
+    (0, import_node_fs13.mkdirSync)(this.screensDir, { recursive: true });
+    (0, import_node_fs13.mkdirSync)(this.artifactsDir, { recursive: true });
+    (0, import_node_fs13.mkdirSync)(getThemesDir(this.storagePath), { recursive: true });
+    (0, import_node_fs13.mkdirSync)(getAgentArtifactsDir(this.storagePath), { recursive: true });
   }
   rebuildArtifactScreens() {
     this.artifactScreens.clear();
@@ -53568,12 +54355,12 @@ var ServerStore = class extends EventTarget {
     }
   }
   loadDisplayState() {
-    if (!(0, import_node_fs11.existsSync)(this.displayStatePath)) {
+    if (!(0, import_node_fs13.existsSync)(this.displayStatePath)) {
       return false;
     }
     let raw;
     try {
-      raw = (0, import_node_fs11.readFileSync)(this.displayStatePath, "utf8");
+      raw = (0, import_node_fs13.readFileSync)(this.displayStatePath, "utf8");
     } catch {
       return false;
     }
@@ -53591,9 +54378,9 @@ var ServerStore = class extends EventTarget {
     return false;
   }
   persistDisplayState() {
-    (0, import_node_fs11.writeFileSync)(
+    (0, import_node_fs13.writeFileSync)(
       this.displayStatePath,
-      JSON.stringify(this.getDisplayState(), null, JSON_INDENT_SPACES)
+      JSON.stringify(this.getDisplayState(), null, JSON_INDENT_SPACES2)
     );
   }
   get displayStatePath() {
@@ -53613,11 +54400,11 @@ var ServerStore = class extends EventTarget {
     return firstScreen.id;
   }
   loadOrCreateAuthToken() {
-    if ((0, import_node_fs11.existsSync)(this.tokenPath)) {
-      return (0, import_node_fs11.readFileSync)(this.tokenPath, "utf8").trim();
+    if ((0, import_node_fs13.existsSync)(this.tokenPath)) {
+      return (0, import_node_fs13.readFileSync)(this.tokenPath, "utf8").trim();
     }
     const token = createToken();
-    (0, import_node_fs11.writeFileSync)(this.tokenPath, `${token}
+    (0, import_node_fs13.writeFileSync)(this.tokenPath, `${token}
 `);
     return token;
   }
@@ -53625,12 +54412,12 @@ var ServerStore = class extends EventTarget {
     if (!this.screens.has(screen.id)) {
       throw new Error(`Cannot persist screen ${screen.id}: not in live map`);
     }
-    (0, import_node_fs11.writeFileSync)(import_node_path14.default.join(this.screensDir, `${screen.id}.json`), JSON.stringify(screen, null, JSON_INDENT_SPACES));
+    (0, import_node_fs13.writeFileSync)(import_node_path16.default.join(this.screensDir, `${screen.id}.json`), JSON.stringify(screen, null, JSON_INDENT_SPACES2));
   }
   readArtifactFile(filePath, expectedID) {
     let raw;
     try {
-      raw = (0, import_node_fs11.readFileSync)(filePath, "utf8");
+      raw = (0, import_node_fs13.readFileSync)(filePath, "utf8");
     } catch (error48) {
       throw this.invalidMetadataFile(filePath, "unreadable", error48);
     }
@@ -53652,7 +54439,7 @@ var ServerStore = class extends EventTarget {
         `id ${result.data.id} does not match filename ${expectedID}`
       );
     }
-    if (result.data.kind === "path" && !import_node_path14.default.isAbsolute(result.data.path)) {
+    if (result.data.kind === "path" && !import_node_path16.default.isAbsolute(result.data.path)) {
       throw this.invalidMetadataFile(filePath, "path must be absolute");
     }
     return result.data;
@@ -53669,7 +54456,7 @@ Review docs/storage.md for the current schema, and either update the file to mat
     return cause !== void 0 ? new Error(message, { cause }) : new Error(message);
   }
   writeArtifact(artifact) {
-    (0, import_node_fs11.writeFileSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), JSON.stringify(artifact, null, JSON_INDENT_SPACES));
+    (0, import_node_fs13.writeFileSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), JSON.stringify(artifact, null, JSON_INDENT_SPACES2));
   }
   get screensDir() {
     return getScreensDir(this.storagePath);
@@ -53681,6 +54468,12 @@ Review docs/storage.md for the current schema, and either update the file to mat
     return getTokenPath(this.storagePath);
   }
 };
+function parseOnboardingMarker(raw) {
+  if (typeof raw === "object" && raw !== null && typeof raw.slug === "string" && typeof raw.order === "number") {
+    return { slug: raw.slug, order: raw.order };
+  }
+  return void 0;
+}
 function assertSameArtifactIDSet(existing, proposed, screenID) {
   const before = new Set(existing.flatMap(collectLayoutArtifactIDs));
   const after = new Set(proposed.flatMap(collectLayoutArtifactIDs));
@@ -53705,7 +54498,7 @@ function collectLayoutArtifactIDs(node) {
 }
 
 // src/index.ts
-var import_meta3 = {};
+var import_meta2 = {};
 var DAEMON_NAME = "com.television.server";
 var TELEMETRY_LAUNCH_MODE_ENV = "TELEVISION_LAUNCH_MODE";
 var SKILL_INSTALL_TELEMETRY_TIMEOUT_MS2 = 1e3;
@@ -53759,24 +54552,24 @@ function createDirectiveError(message) {
   return new CLIDirectiveError(ensureHelpPointer(message));
 }
 function getDevPackageDir() {
-  return import_node_path15.default.resolve(import_node_path15.default.dirname((0, import_node_url3.fileURLToPath)(import_meta3.url)), "..");
+  return import_node_path17.default.resolve(import_node_path17.default.dirname((0, import_node_url2.fileURLToPath)(import_meta2.url)), "..");
 }
 function resolveVercelSkillsInstallerBin() {
   if (typeof require === "function" && typeof require.resolve === "function") {
     return require.resolve("skills/bin/cli.mjs");
   }
-  const localRequire = (0, import_node_module.createRequire)(import_node_path15.default.join(getDevPackageDir(), "package.json"));
+  const localRequire = (0, import_node_module.createRequire)(import_node_path17.default.join(getDevPackageDir(), "package.json"));
   return localRequire.resolve("skills/bin/cli.mjs");
 }
 function readCLIVersion() {
-  if ("0.1.178".length > 0) {
-    return "0.1.178";
+  if ("0.1.179".length > 0) {
+    return "0.1.179";
   }
-  const devPackageJsonPath = import_node_path15.default.join(getDevPackageDir(), "package.json");
-  if (!(0, import_node_fs12.existsSync)(devPackageJsonPath)) {
+  const devPackageJsonPath = import_node_path17.default.join(getDevPackageDir(), "package.json");
+  if (!(0, import_node_fs14.existsSync)(devPackageJsonPath)) {
     throw new Error("Could not resolve package.json for repo-local CLI version.");
   }
-  return JSON.parse((0, import_node_fs12.readFileSync)(devPackageJsonPath, "utf8")).version;
+  return JSON.parse((0, import_node_fs14.readFileSync)(devPackageJsonPath, "utf8")).version;
 }
 function inspectTelemetryBuildConfig(env = {}, options = {}) {
   const project = resolvePostHogProject(env, options);
@@ -53841,7 +54634,7 @@ function formatCLIError(error48, argv = []) {
     const status = typeof error48.status === "number" ? Number(error48.status) : void 0;
     if (status === HTTP_UNAUTHORIZED_STATUS2) {
       return ensureHelpPointer(
-        `Television server at ${serverURL} rejected the request as unauthorized. Check the token in ${import_node_path15.default.join(storagePathFromArgv(argv) ?? getTelevisionStoragePath(), "state", "token")}.`
+        `Television server at ${serverURL} rejected the request as unauthorized. Check the token in ${import_node_path17.default.join(storagePathFromArgv(argv) ?? getTelevisionStoragePath(), "state", "token")}.`
       );
     }
     if (status !== void 0) {
@@ -53884,63 +54677,63 @@ function resolveStaticDir() {
   if (!process.argv[1]) {
     return void 0;
   }
-  const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
-  const resolved = import_node_path15.default.resolve(entryDir, "./web");
-  return (0, import_node_fs12.existsSync)(import_node_path15.default.join(resolved, "index.html")) ? resolved : void 0;
+  const entryDir = import_node_path17.default.dirname((0, import_node_fs14.realpathSync)(process.argv[1]));
+  const resolved = import_node_path17.default.resolve(entryDir, "./web");
+  return (0, import_node_fs14.existsSync)(import_node_path17.default.join(resolved, "index.html")) ? resolved : void 0;
 }
 function resolveBundledViewsPath() {
   if (process.argv[1]) {
-    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
-    const resolved = import_node_path15.default.resolve(entryDir, "./views");
-    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path17.default.dirname((0, import_node_fs14.realpathSync)(process.argv[1]));
+    const resolved = import_node_path17.default.resolve(entryDir, "./views");
+    return (0, import_node_fs14.existsSync)(resolved) ? resolved : void 0;
   }
-  const devViewsPath = import_node_path15.default.join(getDevPackageDir(), "dist/views");
-  return (0, import_node_fs12.existsSync)(devViewsPath) ? devViewsPath : void 0;
+  const devViewsPath = import_node_path17.default.join(getDevPackageDir(), "dist/views");
+  return (0, import_node_fs14.existsSync)(devViewsPath) ? devViewsPath : void 0;
 }
 function resolveCanonicalDir() {
   if (process.argv[1]) {
-    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
-    const resolved = import_node_path15.default.resolve(entryDir, "./canonical/v1");
-    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path17.default.dirname((0, import_node_fs14.realpathSync)(process.argv[1]));
+    const resolved = import_node_path17.default.resolve(entryDir, "./canonical/v1");
+    return (0, import_node_fs14.existsSync)(resolved) ? resolved : void 0;
   }
-  const devCanonicalPath = import_node_path15.default.resolve(
+  const devCanonicalPath = import_node_path17.default.resolve(
     getDevPackageDir(),
     "../server/dist/canonical/v1"
   );
-  return (0, import_node_fs12.existsSync)(devCanonicalPath) ? devCanonicalPath : void 0;
+  return (0, import_node_fs14.existsSync)(devCanonicalPath) ? devCanonicalPath : void 0;
 }
-function resolveOnboardingArtifactSourcePath() {
+function resolveOnboardingContentPath() {
   if (process.argv[1]) {
-    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
-    const resolved = import_node_path15.default.resolve(entryDir, "./onboarding/television-onboarding");
-    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path17.default.dirname((0, import_node_fs14.realpathSync)(process.argv[1]));
+    const resolved = import_node_path17.default.resolve(entryDir, "./onboarding");
+    return (0, import_node_fs14.existsSync)(resolved) ? resolved : void 0;
   }
-  const devPath = import_node_path15.default.resolve(
+  const devPath = import_node_path17.default.resolve(
     getDevPackageDir(),
-    "../server/assets/television-onboarding"
+    "../server/assets/onboarding-screens"
   );
-  return (0, import_node_fs12.existsSync)(devPath) ? devPath : void 0;
+  return (0, import_node_fs14.existsSync)(devPath) ? devPath : void 0;
 }
 function resolveBundledSkillsRoot() {
-  const builtPath = typeof process.argv[1] === "string" ? import_node_path15.default.resolve(import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1])), "./skills") : void 0;
-  if (builtPath && (0, import_node_fs12.existsSync)(builtPath)) {
+  const builtPath = typeof process.argv[1] === "string" ? import_node_path17.default.resolve(import_node_path17.default.dirname((0, import_node_fs14.realpathSync)(process.argv[1])), "./skills") : void 0;
+  if (builtPath && (0, import_node_fs14.existsSync)(builtPath)) {
     return builtPath;
   }
-  const devPath = import_node_path15.default.resolve(getDevPackageDir(), "../skills/dist");
-  return (0, import_node_fs12.existsSync)(devPath) ? devPath : void 0;
+  const devPath = import_node_path17.default.resolve(getDevPackageDir(), "../skills/dist");
+  return (0, import_node_fs14.existsSync)(devPath) ? devPath : void 0;
 }
 function copyBundledSkillsToDestination(bundledSkillsRoot, destinationRoot) {
-  if ((0, import_node_fs12.existsSync)(destinationRoot) && !(0, import_node_fs12.statSync)(destinationRoot).isDirectory()) {
+  if ((0, import_node_fs14.existsSync)(destinationRoot) && !(0, import_node_fs14.statSync)(destinationRoot).isDirectory()) {
     throw new Error(`Skills destination is not a directory: ${destinationRoot}`);
   }
-  (0, import_node_fs12.mkdirSync)(destinationRoot, { recursive: true });
+  (0, import_node_fs14.mkdirSync)(destinationRoot, { recursive: true });
   const copied = [];
-  const entries = (0, import_node_fs12.readdirSync)(bundledSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).sort((a, b2) => a.name.localeCompare(b2.name));
+  const entries = (0, import_node_fs14.readdirSync)(bundledSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).sort((a, b2) => a.name.localeCompare(b2.name));
   for (const entry of entries) {
-    const sourcePath = import_node_path15.default.join(bundledSkillsRoot, entry.name);
-    const destinationPath = import_node_path15.default.join(destinationRoot, entry.name);
-    (0, import_node_fs12.rmSync)(destinationPath, { recursive: true, force: true });
-    (0, import_node_fs12.cpSync)(sourcePath, destinationPath, { recursive: true });
+    const sourcePath = import_node_path17.default.join(bundledSkillsRoot, entry.name);
+    const destinationPath = import_node_path17.default.join(destinationRoot, entry.name);
+    (0, import_node_fs14.rmSync)(destinationPath, { recursive: true, force: true });
+    (0, import_node_fs14.cpSync)(sourcePath, destinationPath, { recursive: true });
     copied.push({ name: entry.name, sourcePath, destinationPath });
   }
   return copied;
@@ -54022,19 +54815,17 @@ function formatCommanderError(argv, error48) {
   return null;
 }
 function readAuthToken(storagePath) {
-  const tokenPath = import_node_path15.default.join(storagePath, "state", "token");
-  if (!(0, import_node_fs12.existsSync)(tokenPath)) {
+  const tokenPath = import_node_path17.default.join(storagePath, "state", "token");
+  if (!(0, import_node_fs14.existsSync)(tokenPath)) {
     return void 0;
   }
-  const token = (0, import_node_fs12.readFileSync)(tokenPath, "utf8").trim();
+  const token = (0, import_node_fs14.readFileSync)(tokenPath, "utf8").trim();
   return token.length > 0 ? token : void 0;
 }
 function readOrCreateAuthToken(storagePath) {
-  const onboardingArtifactSourcePath = resolveOnboardingArtifactSourcePath();
   return new ServerStore({
     storagePath,
-    installOnboardingArtifact: false,
-    ...onboardingArtifactSourcePath ? { onboardingArtifactSourcePath } : {}
+    installOnboardingScreens: false
   }).authToken;
 }
 function buildDaemonServeArgs(options = {}) {
@@ -54067,11 +54858,14 @@ function createEnvironment(environment) {
     stderr: environment.stderr ?? process.stderr,
     createClient: environment.createClient ?? ((serverURL, token) => new TelevisionClient(serverURL, { token })),
     createServer: environment.createServer ?? ((options) => new Server({
+      // `tv serve` always enables the onboarding installer, passing the
+      // resolved content root when one resolved
+      // (specs/arch/onboarding/content.md CLI path resolution).
       store: new ServerStore({
         storagePath: options.storagePath ?? getTelevisionStoragePath(),
         ...options.bundledViewsPath ? { bundledViewsPath: options.bundledViewsPath } : {},
-        ...options.onboardingArtifactSourcePath ? { onboardingArtifactSourcePath: options.onboardingArtifactSourcePath } : {},
-        installOnboardingArtifact: options.onboardingArtifactSourcePath !== void 0
+        ...options.onboardingContentPath ? { onboardingContentPath: options.onboardingContentPath } : {},
+        installOnboardingScreens: true
       }),
       listen: options.listen,
       port: options.port,
@@ -54097,7 +54891,7 @@ function createEnvironment(environment) {
     resolveStaticDir: environment.resolveStaticDir ?? (() => resolveStaticDir()),
     resolveCanonicalDir: environment.resolveCanonicalDir ?? (() => resolveCanonicalDir()),
     resolveBundledViewsPath: environment.resolveBundledViewsPath ?? (() => resolveBundledViewsPath()),
-    resolveOnboardingArtifactSourcePath: environment.resolveOnboardingArtifactSourcePath ?? (() => resolveOnboardingArtifactSourcePath()),
+    resolveOnboardingContentPath: environment.resolveOnboardingContentPath ?? (() => resolveOnboardingContentPath()),
     resolveBundledSkillsRoot: environment.resolveBundledSkillsRoot ?? (() => resolveBundledSkillsRoot()),
     resolveHomeDir: environment.resolveHomeDir ?? (() => import_node_os5.default.homedir()),
     runSkillsInstaller: environment.runSkillsInstaller ?? (async (args) => {
@@ -54168,7 +54962,7 @@ function createProgram(env, argv = []) {
       throw error48;
     }
     if (opts.persist) {
-      const storagePath = opts.storagePath ?? getTelevisionStoragePath();
+      const storagePath = import_node_path17.default.resolve(opts.storagePath ?? getTelevisionStoragePath());
       const profile2 = resolveACPAgentProfile(process.env);
       const daemonEnv = buildPersistedACPEnvironment(process.env, { developerHome: env.resolveHomeDir() });
       if (process.env.TELEVISION_PORT !== void 0) daemonEnv.TELEVISION_PORT = process.env.TELEVISION_PORT;
@@ -54229,6 +55023,7 @@ function createProgram(env, argv = []) {
       log(storagePathForLogs, "server startup refused before binding", { argv, error: error48 });
       throw error48;
     }
+    const onboardingContentPath = env.resolveOnboardingContentPath();
     const server = env.createServer({
       listen: opts.listen,
       auth,
@@ -54237,7 +55032,7 @@ function createProgram(env, argv = []) {
       staticDir: env.resolveStaticDir(),
       canonicalDir: env.resolveCanonicalDir(),
       bundledViewsPath: env.resolveBundledViewsPath(),
-      onboardingArtifactSourcePath: env.resolveOnboardingArtifactSourcePath(),
+      ...onboardingContentPath !== void 0 ? { onboardingContentPath } : {},
       launchMode: resolveTelemetryLaunchMode(process.env),
       ...opts.installedByAgent === void 0 ? {} : { installedByAgent: opts.installedByAgent },
       ...profile ? { acpProfile: profile } : {}
@@ -54441,7 +55236,7 @@ function createProgram(env, argv = []) {
     if (!bundledTelevisionSkillsCollectionRoot) {
       throw new Error("Could not resolve the bundled Television skills root.");
     }
-    const destinationRoot = import_node_path15.default.resolve(inputPath);
+    const destinationRoot = import_node_path17.default.resolve(inputPath);
     const copied = copyBundledSkillsToDestination(bundledTelevisionSkillsCollectionRoot, destinationRoot);
     writeLine(env.stdout, `Copied ${copied.length} bundled Television skill(s):`);
     for (const skill of copied) {
@@ -54535,7 +55330,7 @@ if (!isVitestRuntime()) {
   resolveBundledSkillsRoot,
   resolveBundledViewsPath,
   resolveCanonicalDir,
-  resolveOnboardingArtifactSourcePath,
+  resolveOnboardingContentPath,
   resolveStaticDir,
   runCLI
 });