ryugi-artifacts 1.49.5 → 1.51.1

package/dist/cli.cjs

@@ -5185,7 +5185,7 @@ var require_canvas = __commonJS({
 });
 
 // src/cli/main.ts
-var import_node_child_process7 = require("node:child_process");
+var import_node_child_process6 = require("node:child_process");
 
 // src/cli/command.ts
 var import_node_util = require("node:util");
@@ -5342,9 +5342,48 @@ function rootHelp(commands, browseOptions = {}) {
   ].join("\n");
 }
 
+// src/server/machine.ts
+var import_node_fs2 = __toESM(require("node:fs"), 1);
+var import_node_os2 = __toESM(require("node:os"), 1);
+var import_node_path2 = __toESM(require("node:path"), 1);
+var DORMANT_AFTER_MS = 7 * 24 * 60 * 60 * 1e3;
+function machinePaths(env = process.env, homedir = import_node_os2.default.homedir()) {
+  const home = env.RYUGI_SERVER_HOME || import_node_path2.default.join(homedir, ".ryugi", "server");
+  return {
+    home,
+    pid: import_node_path2.default.join(home, "server.pid"),
+    serverId: import_node_path2.default.join(home, "server-instance-id"),
+    info: import_node_path2.default.join(home, "server-info"),
+    log: import_node_path2.default.join(home, "server.log"),
+    version: import_node_path2.default.join(home, "server-version"),
+    lock: import_node_path2.default.join(home, "start.lock"),
+    key: import_node_path2.default.join(home, "key"),
+    projects: import_node_path2.default.join(home, "projects.json"),
+    settings: import_node_path2.default.join(home, "settings.json"),
+    stopped: import_node_path2.default.join(home, "server-stopped")
+  };
+}
+function ensureHome(home) {
+  import_node_fs2.default.mkdirSync(home, { recursive: true, mode: 448 });
+  import_node_fs2.default.chmodSync(home, 448);
+}
+var validEntry = (value) => {
+  const entry = value;
+  return !!entry && typeof entry.dir === "string" && import_node_path2.default.isAbsolute(entry.dir) && Number.isFinite(entry.registeredAt) && Number.isFinite(entry.lastUsedAt);
+};
+function readProjects(file) {
+  try {
+    const value = JSON.parse(import_node_fs2.default.readFileSync(file, "utf8"));
+    return Array.isArray(value.projects) ? value.projects.filter(validEntry) : [];
+  } catch {
+    return [];
+  }
+}
+var artifactsRootOf = (projectDir) => import_node_path2.default.join(projectDir, ".ryugi", "artifacts");
+
 // src/cli/process.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs2 = __toESM(require("node:fs"), 1);
+var import_node_fs3 = __toESM(require("node:fs"), 1);
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function alive(pid) {
   try {
@@ -5356,7 +5395,7 @@ function alive(pid) {
 }
 function commandLine(pid) {
   try {
-    return import_node_fs2.default.readFileSync(`/proc/${pid}/cmdline`, "utf8").split("\0");
+    return import_node_fs3.default.readFileSync(`/proc/${pid}/cmdline`, "utf8").split("\0");
   } catch {
   }
   const direct = (0, import_node_child_process.spawnSync)("ps", ["-ww", "-p", String(pid), "-o", "command="], {
@@ -5381,19 +5420,13 @@ function hasServerId(pid, id) {
   if (process.platform === "win32") return windowsNodeAt(pid);
   return commandLine(pid)?.includes(`--artifacts-server-id=${id}`) ?? false;
 }
-function parentOf(pid) {
-  if (process.platform === "win32") return null;
-  const result = (0, import_node_child_process.spawnSync)("ps", ["-o", "ppid=", "-p", String(pid)], { encoding: "utf8" });
-  const parent = Number(result.stdout.trim());
-  return Number.isInteger(parent) && parent > 1 ? parent : null;
-}
 async function waitForExit(pid, ms) {
   for (let waited = 0; waited < ms && alive(pid); waited += 100) await sleep(100);
   return !alive(pid);
 }
 var readText = (file) => {
   try {
-    return import_node_fs2.default.readFileSync(file, "utf8").replace(/[\r\n]+$/, "");
+    return import_node_fs3.default.readFileSync(file, "utf8").replace(/[\r\n]+$/, "");
   } catch {
     return null;
   }
@@ -5401,15 +5434,28 @@ var readText = (file) => {
 
 // src/cli/server.ts
 var notRunning = (project) => `No artifacts server is running for this project. Start it with \`${invocation()} start --project-dir ${project}\`, then run this again.`;
-function serverClient(projectDir) {
-  const paths = projectPaths(projectDir);
-  let info;
+var readUrl = (file) => {
   try {
-    info = JSON.parse(readText(paths.info) ?? "");
+    const { url } = JSON.parse(readText(file) ?? "");
+    return typeof url === "string" ? url : null;
   } catch {
-    throw new CliError(notRunning(paths.project));
+    return null;
   }
-  const base = new URL(info.url);
+};
+function serverUrl(project, projectInfo) {
+  const machine = machinePaths();
+  const machineUrl = readUrl(machine.info);
+  if (machineUrl) {
+    const registered = readProjects(machine.projects).some((entry) => entry.dir === project);
+    return registered ? machineUrl : null;
+  }
+  return readUrl(projectInfo);
+}
+function serverClient(projectDir) {
+  const paths = projectPaths(projectDir);
+  const url = serverUrl(paths.project, paths.info);
+  if (!url) throw new CliError(notRunning(paths.project));
+  const base = new URL(url);
   const key2 = base.searchParams.get("key") ?? "";
   if (base.hostname === "localhost") base.hostname = "127.0.0.1";
   return {
@@ -5419,7 +5465,10 @@ function serverClient(projectDir) {
       try {
         res = await fetch(`${base.origin}${route}?key=${encodeURIComponent(key2)}`, {
           method,
-          headers: body ? { "Content-Type": "application/json" } : {},
+          headers: {
+            "X-Ryugi-Project": encodeURIComponent(paths.project),
+            ...body ? { "Content-Type": "application/json" } : {}
+          },
           body: body ? JSON.stringify(body) : void 0
         });
       } catch {
@@ -5480,7 +5529,7 @@ var checkCommand = {
 };
 
 // src/cli/comment.ts
-var import_node_fs3 = __toESM(require("node:fs"), 1);
+var import_node_fs4 = __toESM(require("node:fs"), 1);
 
 // src/server/agent.ts
 var NAMES = {
@@ -5568,17 +5617,18 @@ function detectAgent(env) {
 }
 
 // src/cli/comment.ts
-var COMMENT_ACTIONS = ["list", "add", "reply", "resolve"];
+var COMMENT_ACTIONS = ["list", "add", "reply", "resolve", "choose", "submit"];
 var ARTIFACT = /^(?:document|artboard)\/[a-z0-9][a-z0-9-]*$/;
 var WRITTEN = {
   add: "comment-added",
   reply: "comment-replied",
   resolve: "comment-resolved"
 };
+var RECORDED = { choose: "choice-recorded", submit: "round-submitted" };
 function readStdin() {
   if (process.stdin.isTTY) return "";
   try {
-    return import_node_fs3.default.readFileSync(0, "utf8");
+    return import_node_fs4.default.readFileSync(0, "utf8");
   } catch {
     return "";
   }
@@ -5596,6 +5646,18 @@ function coordinate(value, flag) {
 }
 function requestOf(options, action, type) {
   if (action === "list") return { op: "list", all: !!options.all };
+  if ((action === "choose" || action === "submit") && type !== "artboard")
+    throw new CliError(`comment ${action} works on artboards only`);
+  if (action === "choose") {
+    if (!options.group) throw new CliError("comment choose needs --group <groupId>");
+    if (!options.clear && !options.board)
+      throw new CliError("comment choose needs --board <boardId>, or --clear");
+    return { op: "choose", group: options.group, board: options.clear ? null : options.board };
+  }
+  if (action === "submit") {
+    if (!options.round) throw new CliError("comment submit needs --round <roundId>");
+    return { op: "submit", round: options.round, submit: !options.withdraw };
+  }
   if (action === "add" && type === "artboard") {
     if (!options.board) throw new CliError("comment add on an artboard needs --board <boardId>");
     const x = coordinate(options.x, "--x");
@@ -5622,7 +5684,8 @@ function requestOf(options, action, type) {
 }
 async function comment(options, emit) {
   const action = COMMENT_ACTIONS.find((name) => name === options.action);
-  if (!action) throw new CliError("comment needs an action: list, add, reply or resolve");
+  if (!action)
+    throw new CliError("comment needs an action: list, add, reply, resolve, choose or submit");
   if (!options.artifact || !ARTIFACT.test(options.artifact))
     throw new CliError("--artifact must be document/<id> or artboard/<id>");
   const [type, id] = options.artifact.split("/");
@@ -5645,8 +5708,25 @@ async function comment(options, emit) {
       artifact: options.artifact,
       threads: json.threads,
       ...json.groups ? { groups: json.groups } : {},
+      ...json.rounds ? { rounds: json.rounds } : {},
       ...options.all ? { all: true } : {}
     });
+  else if (action === "choose")
+    emit({
+      type: RECORDED.choose,
+      artifact: options.artifact,
+      group: request.group,
+      board: request.board,
+      threadId: json.threadId
+    });
+  else if (action === "submit")
+    emit({
+      type: RECORDED.submit,
+      artifact: options.artifact,
+      round: request.round,
+      submitted: request.submit,
+      threadId: json.threadId
+    });
   else
     emit({
       type: WRITTEN[action],
@@ -5656,6 +5736,15 @@ async function comment(options, emit) {
     });
   return 0;
 }
+function choiceText(group) {
+  const answer = group.choice ? `${group.choice}${group.byRecommendation ? " by recommendation" : ""}` : "no choice";
+  const comments = group.threads ? ` (${plural(group.threads, "comment")})` : "";
+  return `  ${group.id} \u2192 ${answer}${comments}`;
+}
+function roundText(round) {
+  const state = round.state === "submitted" && round.submitted ? `submitted ${round.submitted}` : round.state;
+  return `  ${round.id}${round.title ? ` (${round.title})` : ""}: ${state}`;
+}
 var VERDICT_TEXT = { pass: "passed", reject: "rejected", pending: "waiting for a verdict" };
 var plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
 function groupText(group) {
@@ -5705,18 +5794,30 @@ function threadText(thread) {
 function commentText(value) {
   if (value.type === "comments") {
     const threads = value.threads ?? [];
-    const groups = value.groups ?? [];
+    const all = value.groups ?? [];
+    const groups = all.filter((g) => g.kind !== "choose");
+    const choices = all.filter((g) => g.kind === "choose");
+    const rounds = value.rounds ?? [];
     const head = threads.length ? threads.map(threadText).join("\n\n") : value.all ? `No comments on ${value.artifact}.` : `No new comments on ${value.artifact}.`;
-    return groups.length ? `${head}
-
-Verify groups:
-${groups.map(groupText).join("\n")}` : head;
+    return [
+      head,
+      groups.length ? `Verify groups:
+${groups.map(groupText).join("\n")}` : "",
+      choices.length ? `Choice groups:
+${choices.map(choiceText).join("\n")}` : "",
+      rounds.length ? `Rounds:
+${rounds.map(roundText).join("\n")}` : ""
+    ].filter(Boolean).join("\n\n");
   }
   if (value.type === "comment-added")
     return `Added thread ${value.threadId} (message ${value.messageId})`;
   if (value.type === "comment-replied")
     return `Replied in thread ${value.threadId} (message ${value.messageId})`;
   if (value.type === "comment-resolved") return `Resolved thread ${value.threadId}`;
+  if (value.type === "choice-recorded")
+    return value.board ? `Recorded ${value.board} for ${value.group}` : `Cleared the choice in ${value.group}`;
+  if (value.type === "round-submitted")
+    return `${value.submitted ? "Submitted" : "Withdrew"} round ${value.round}`;
   return null;
 }
 var commentCommand = {
@@ -5727,7 +5828,9 @@ var commentCommand = {
     "add     --artifact document/<id> --block <blockId> [--quote <text>] [--text <text>]",
     "add     --artifact artboard/<id> --board <boardId> [--x <px> --y <px>] [--text <text>]",
     "reply   --artifact <document|artboard>/<id> --thread <threadId> [--text <text>]",
-    "resolve --artifact <document|artboard>/<id> --thread <threadId>"
+    "resolve --artifact <document|artboard>/<id> --thread <threadId>",
+    "choose  --artifact artboard/<id> --group <groupId> (--board <boardId> | --clear)",
+    "submit  --artifact artboard/<id> --round <roundId> [--withdraw]"
   ],
   details: "list prints what changed since you last listed. Without --text, add and reply read the message from stdin.",
   options: {
@@ -5743,7 +5846,11 @@ var commentCommand = {
     x: { type: "string", value: "<px>", help: "add: horizontal position on the board" },
     y: { type: "string", value: "<px>", help: "add: vertical position on the board" },
     thread: { type: "string", value: "<threadId>", help: "reply, resolve: the thread" },
-    text: { type: "string", value: "<text>", help: "add, reply: the message" }
+    text: { type: "string", value: "<text>", help: "add, reply: the message" },
+    group: { type: "string", value: "<groupId>", help: "choose: the choice group" },
+    clear: { type: "boolean", help: "choose: clear the choice instead of naming a board" },
+    round: { type: "string", value: "<roundId>", help: "submit: the round" },
+    withdraw: { type: "boolean", help: "submit: withdraw the submission" }
   },
   positionals: 1,
   run: ({ values, positionals, projectDir }, emit) => comment(
@@ -5757,6 +5864,10 @@ var commentCommand = {
       thread: values.thread,
       text: values.text,
       board: values.board,
+      group: values.group,
+      clear: values.clear,
+      round: values.round,
+      withdraw: values.withdraw,
       x: values.x,
       y: values.y
     },
@@ -5766,19 +5877,19 @@ var commentCommand = {
 };
 
 // src/cli/config.ts
-var import_node_os2 = __toESM(require("node:os"), 1);
-var import_node_path6 = __toESM(require("node:path"), 1);
+var import_node_os3 = __toESM(require("node:os"), 1);
+var import_node_path7 = __toESM(require("node:path"), 1);
 
 // src/server/config.ts
-var import_node_fs5 = __toESM(require("node:fs"), 1);
-var import_node_path3 = __toESM(require("node:path"), 1);
+var import_node_fs6 = __toESM(require("node:fs"), 1);
+var import_node_path4 = __toESM(require("node:path"), 1);
 
 // src/shared/cloud.ts
 var isVisibility = (value) => value === "private" || value === "public";
 
 // src/server/state.ts
-var import_node_fs4 = __toESM(require("node:fs"), 1);
-var import_node_path2 = __toESM(require("node:path"), 1);
+var import_node_fs5 = __toESM(require("node:fs"), 1);
+var import_node_path3 = __toESM(require("node:path"), 1);
 
 // src/shared/types.ts
 var ARTIFACT_TYPES = ["artboard", "document", "html"];
@@ -5790,11 +5901,11 @@ var MEDIA_REQUIRED = ["src", "page", ...BOARD_NUMBERS];
 
 // src/server/state.ts
 function writeJsonAtomic(file, value) {
-  import_node_fs4.default.mkdirSync(import_node_path2.default.dirname(file), { recursive: true });
+  import_node_fs5.default.mkdirSync(import_node_path3.default.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.tmp`;
-  import_node_fs4.default.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}
+  import_node_fs5.default.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}
 `, { mode: 384 });
-  import_node_fs4.default.renameSync(tmp, file);
+  import_node_fs5.default.renameSync(tmp, file);
 }
 
 // src/server/config.ts
@@ -5835,7 +5946,7 @@ function normalize(raw) {
 function readConfig(file) {
   let text2;
   try {
-    text2 = import_node_fs5.default.readFileSync(file, "utf8");
+    text2 = import_node_fs6.default.readFileSync(file, "utf8");
   } catch {
     return { config: defaults() };
   }
@@ -5855,47 +5966,47 @@ var IGNORED = [
   "artifacts/document/*/.artifact-id"
 ];
 function ensureGitignore(dir) {
-  const file = import_node_path3.default.join(dir, ".gitignore");
+  const file = import_node_path4.default.join(dir, ".gitignore");
   let current = "";
   try {
-    current = import_node_fs5.default.readFileSync(file, "utf8");
+    current = import_node_fs6.default.readFileSync(file, "utf8");
   } catch {
   }
   const present = new Set(current.split(/\r?\n/).map((line) => line.trim()));
   const missing = IGNORED.filter((line) => !present.has(line));
   if (missing.length === 0) return;
-  import_node_fs5.default.writeFileSync(
+  import_node_fs6.default.writeFileSync(
     file,
     `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}${missing.join("\n")}
 `
   );
 }
 function ensureConfig(file) {
-  import_node_fs5.default.mkdirSync(import_node_path3.default.dirname(file), { recursive: true });
-  ensureGitignore(import_node_path3.default.dirname(file));
-  if (!import_node_fs5.default.existsSync(file)) writeJsonAtomic(file, defaults());
+  import_node_fs6.default.mkdirSync(import_node_path4.default.dirname(file), { recursive: true });
+  ensureGitignore(import_node_path4.default.dirname(file));
+  if (!import_node_fs6.default.existsSync(file)) writeJsonAtomic(file, defaults());
 }
 function setProjectAutoPublish(file, value) {
   const { config: config2, warning } = readConfig(file);
   if (warning) throw new Error(warning);
   if (value === null) delete config2.autoPublish;
   else config2.autoPublish = value;
-  import_node_fs5.default.mkdirSync(import_node_path3.default.dirname(file), { recursive: true });
+  import_node_fs6.default.mkdirSync(import_node_path4.default.dirname(file), { recursive: true });
   writeJsonAtomic(file, config2);
 }
 
 // src/server/credentials.ts
-var import_node_fs6 = __toESM(require("node:fs"), 1);
-var import_node_path4 = __toESM(require("node:path"), 1);
+var import_node_fs7 = __toESM(require("node:fs"), 1);
+var import_node_path5 = __toESM(require("node:path"), 1);
 function credentialsFile(env, platform, home) {
   if (platform === "win32" && env.APPDATA)
-    return import_node_path4.default.join(env.APPDATA, "ryugi", "credentials.json");
-  return import_node_path4.default.join(env.XDG_CONFIG_HOME || import_node_path4.default.join(home, ".config"), "ryugi", "credentials.json");
+    return import_node_path5.default.join(env.APPDATA, "ryugi", "credentials.json");
+  return import_node_path5.default.join(env.XDG_CONFIG_HOME || import_node_path5.default.join(home, ".config"), "ryugi", "credentials.json");
 }
 function readCredentials(file, origin) {
   let raw;
   try {
-    raw = JSON.parse(import_node_fs6.default.readFileSync(file, "utf8"));
+    raw = JSON.parse(import_node_fs7.default.readFileSync(file, "utf8"));
   } catch {
     return null;
   }
@@ -5908,12 +6019,12 @@ function readCredentials(file, origin) {
 }
 
 // src/server/settings.ts
-var import_node_fs7 = __toESM(require("node:fs"), 1);
-var import_node_path5 = __toESM(require("node:path"), 1);
-var settingsFileFor = (credentialsFile2) => import_node_path5.default.join(import_node_path5.default.dirname(credentialsFile2), "config.json");
+var import_node_fs8 = __toESM(require("node:fs"), 1);
+var import_node_path6 = __toESM(require("node:path"), 1);
+var settingsFileFor = (credentialsFile2) => import_node_path6.default.join(import_node_path6.default.dirname(credentialsFile2), "config.json");
 function readSettings(file) {
   try {
-    const raw = JSON.parse(import_node_fs7.default.readFileSync(file, "utf8"));
+    const raw = JSON.parse(import_node_fs8.default.readFileSync(file, "utf8"));
     return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   } catch {
     return {};
@@ -5924,15 +6035,15 @@ function readGlobalAutoPublish(file) {
   return typeof value === "boolean" ? value : void 0;
 }
 function writeGlobalAutoPublish(file, value) {
-  import_node_fs7.default.mkdirSync(import_node_path5.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs8.default.mkdirSync(import_node_path6.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...readSettings(file), autoPublish: value });
 }
 
 // src/cli/config.ts
 var VALUES = { on: true, off: false, inherit: null };
 function config(options, emit) {
-  const globalFile = settingsFileFor(credentialsFile(process.env, process.platform, import_node_os2.default.homedir()));
-  const projectFile = import_node_path6.default.join(import_node_path6.default.dirname(projectPaths(options.projectDir).root), "config.json");
+  const globalFile = settingsFileFor(credentialsFile(process.env, process.platform, import_node_os3.default.homedir()));
+  const projectFile = import_node_path7.default.join(import_node_path7.default.dirname(projectPaths(options.projectDir).root), "config.json");
   if (options.autoPublish !== void 0) {
     const value = VALUES[options.autoPublish];
     if (value === void 0)
@@ -5975,9 +6086,9 @@ var configCommand = {
 };
 
 // src/cli/get.ts
-var import_node_fs8 = __toESM(require("node:fs"), 1);
-var import_node_os3 = __toESM(require("node:os"), 1);
-var import_node_path7 = __toESM(require("node:path"), 1);
+var import_node_fs9 = __toESM(require("node:fs"), 1);
+var import_node_os4 = __toESM(require("node:os"), 1);
+var import_node_path8 = __toESM(require("node:path"), 1);
 
 // node_modules/.pnpm/nanoid@6.0.2/node_modules/nanoid/url-alphabet/index.js
 var urlAlphabet = "57X6y3wQZNzYjJB2L_10pxbackgroundhimselfUTF-8DEMOGRAPHICSVqvt4KW9";
@@ -6554,10 +6665,10 @@ function registerCustomReaders(registry2) {
     };
   });
   registry2.registerReader("grid", (el, ctx) => {
-    const cells2 = [];
+    const cells = [];
     for (const child of el.children) if (child.tagName.toLowerCase() === "cell") {
       const children = ctx.parseChildren(child);
-      cells2.push({ root: {
+      cells.push({ root: {
         type: "root",
         children,
         direction: "ltr",
@@ -6571,7 +6682,7 @@ function registerCustomReaders(registry2) {
       ...extractBlockId(el),
       cols: numAttr(el, "cols") ?? 2,
       gap: el.getAttribute("gap") ?? "16px",
-      cells: cells2,
+      cells,
       version: 1
     };
   });
@@ -7017,7 +7128,7 @@ function registerCustomWriters(registry2) {
   });
   registry2.registerWriter("grid-container", (node, ctx) => {
     const n = node;
-    const cells2 = (n.cells ?? []).map((cellState) => ({
+    const cells = (n.cells ?? []).map((cellState) => ({
       tag: "cell",
       children: ctx.serializeNestedState(cellState)
     }));
@@ -7028,7 +7139,7 @@ function registerCustomWriters(registry2) {
         cols: n.cols != null ? String(n.cols) : void 0,
         gap: n.gap
       }),
-      children: cells2
+      children: cells
     };
   });
   registry2.registerWriter("agent-diff", (node) => {
@@ -18154,15 +18265,15 @@ var ID = /^[\w-]{1,64}$/;
 var LINK_PATH = /^\/a\/([\w-]{1,64})(?:\/(?:view|preview))?\/?$/;
 var TARGET_ERROR = "Expected a Ryugi Cloud link (https://<host>/a/<id>) or an artifact id.";
 var LOGIN_MESSAGE = "Not found, or private and you are not signed in. Sign in once with `ryugi-artifacts start` then `ryugi-artifacts publish --login` in any project, then run this command again.";
-var safePath = (file) => !file.includes("\\") && !file.includes("\0") && !import_node_path7.default.posix.isAbsolute(file) && file.split("/").every((part) => part !== "" && part !== "." && part !== "..");
+var safePath = (file) => !file.includes("\\") && !file.includes("\0") && !import_node_path8.default.posix.isAbsolute(file) && file.split("/").every((part) => part !== "" && part !== "." && part !== "..");
 async function download(contentBase, files, dir, fresh) {
   const unsafe = files.find((file) => !safePath(file));
   if (unsafe !== void 0)
     throw new CliError(
       `Refusing to write ${unsafe}: it is not a path inside the download directory.`
     );
-  if (fresh) import_node_fs8.default.rmSync(dir, { recursive: true, force: true });
-  import_node_fs8.default.mkdirSync(dir, { recursive: true });
+  if (fresh) import_node_fs9.default.rmSync(dir, { recursive: true, force: true });
+  import_node_fs9.default.mkdirSync(dir, { recursive: true });
   for (const file of files) {
     const res = await fetch(
       `${contentBase}${file.split("/").map(encodeURIComponent).join("/")}`
@@ -18170,10 +18281,10 @@ async function download(contentBase, files, dir, fresh) {
       throw new CliError(`Could not download ${file}: ${err.message}`);
     });
     if (!res.ok) throw new CliError(`Could not download ${file}: HTTP ${res.status}`);
-    const target = import_node_path7.default.join(dir, ...file.split("/"));
-    import_node_fs8.default.mkdirSync(import_node_path7.default.dirname(target), { recursive: true });
+    const target = import_node_path8.default.join(dir, ...file.split("/"));
+    import_node_fs9.default.mkdirSync(import_node_path8.default.dirname(target), { recursive: true });
     const data = Buffer.from(await res.arrayBuffer());
-    import_node_fs8.default.writeFileSync(target, file.endsWith(".html") ? stripRuntime(data.toString("utf8")) : data);
+    import_node_fs9.default.writeFileSync(target, file.endsWith(".html") ? stripRuntime(data.toString("utf8")) : data);
   }
 }
 function parseTarget(target, defaultOrigin) {
@@ -18231,7 +18342,7 @@ async function getArtifact({
   const files = (json.files ?? []).filter(
     (file) => json.type !== "document" || file !== "doc.xml"
   );
-  const dir = out ? import_node_path7.default.resolve(out) : import_node_path7.default.join(cacheRoot, id);
+  const dir = out ? import_node_path8.default.resolve(out) : import_node_path8.default.join(cacheRoot, id);
   if (json.type === "document") {
     result.content = serializeDocument(json.payload.state);
     result.comments = json.payload.comments?.threads ?? [];
@@ -18241,8 +18352,8 @@ async function getArtifact({
   result.dir = dir;
   result.files = files;
   if (json.type === "artboard" && !files.includes("canvas.json")) {
-    import_node_fs8.default.writeFileSync(
-      import_node_path7.default.join(dir, "canvas.json"),
+    import_node_fs9.default.writeFileSync(
+      import_node_path8.default.join(dir, "canvas.json"),
       `${JSON.stringify(json.payload.canvas, null, 2)}
 `
     );
@@ -18300,9 +18411,9 @@ var getCommand = {
           /\/+$/,
           ""
         ),
-        credentialsFile: credentialsFile(process.env, process.platform, import_node_os3.default.homedir()),
-        cacheRoot: import_node_path7.default.join(
-          process.env.XDG_CACHE_HOME || import_node_path7.default.join(import_node_os3.default.homedir(), ".cache"),
+        credentialsFile: credentialsFile(process.env, process.platform, import_node_os4.default.homedir()),
+        cacheRoot: import_node_path8.default.join(
+          process.env.XDG_CACHE_HOME || import_node_path8.default.join(import_node_os4.default.homedir(), ".cache"),
           "ryugi",
           "get"
         ),
@@ -18321,557 +18432,6 @@ var getCommand = {
   }
 };
 
-// src/cli/monitor-ui.ts
-var import_node_child_process2 = require("node:child_process");
-var import_node_fs11 = __toESM(require("node:fs"), 1);
-var import_node_os6 = __toESM(require("node:os"), 1);
-var import_node_readline = __toESM(require("node:readline"), 1);
-
-// src/server/lifecycle.ts
-var DEFAULT_IDLE_TIMEOUT_MS = 4 * 60 * 60 * 1e3;
-var DEFAULT_LIFECYCLE_CHECK_MS = 60 * 1e3;
-function browserLauncher(platform, url) {
-  if (platform === "darwin") return { bin: "open", args: [url] };
-  if (platform === "win32") return { bin: "cmd", args: ["/c", "start", '""', url] };
-  if (platform === "linux" || platform === "freebsd" || platform === "openbsd")
-    return { bin: "xdg-open", args: [url] };
-  return null;
-}
-
-// src/cli/monitor-view.ts
-var import_node_os4 = __toESM(require("node:os"), 1);
-var REFRESH_SECONDS = 2;
-var BOLD = "\x1B[1m";
-var DIM = "\x1B[2m";
-var INVERSE = "\x1B[7m";
-var RESET = "\x1B[0m";
-var HELP = "\u2191\u2193 select  o open  c copy URL  l logs  x stop  X stop all safe  q quit";
-var COLUMNS = [
-  ["PORT", 6],
-  ["PID", 8],
-  ["UP", 7],
-  ["TABS", 5],
-  ["IDLE", 7],
-  ["VERSION", 13]
-];
-var FIXED = 2 + COLUMNS.reduce((sum, [, width]) => sum + width + 2, 0);
-var TAGS_WIDTH = 26;
-function duration(ms) {
-  const minutes = Math.max(0, Math.floor(ms / 6e4));
-  if (minutes < 60) return `${minutes}m`;
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24) return `${hours}h${minutes % 60 ? `${minutes % 60}m` : ""}`;
-  return `${Math.floor(hours / 24)}d${hours % 24 ? `${hours % 24}h` : ""}`;
-}
-var shortPath = (project, home = import_node_os4.default.homedir()) => project === home || project.startsWith(`${home}/`) ? `~${project.slice(home.length)}` : project;
-function tags(row) {
-  return [
-    row.safeToStop && "safe to stop",
-    row.oldRelease && "old release",
-    row.status === "no-status" && "no status"
-  ].filter(Boolean);
-}
-var initialView = () => ({
-  mode: "list",
-  selected: 0,
-  confirm: null,
-  target: null,
-  message: null
-});
-var fit = (text2, width) => text2.length > width ? text2.slice(0, width) : text2;
-var pad2 = (text2, width) => fit(text2, width).padEnd(width);
-var cutLeft = (text2, width) => text2.length > width ? `\u2026${text2.slice(text2.length - width + 1)}` : text2;
-function header(left, right, width) {
-  const gap = width - left.length - right.length;
-  return `${BOLD}${fit(gap >= 2 ? `${left}${" ".repeat(gap)}${right}` : left, width)}${RESET}`;
-}
-function cells(row, now) {
-  return [
-    row.port === null ? "-" : String(row.port),
-    String(row.pid),
-    duration(now - row.startedAt),
-    row.clients === null ? "-" : String(row.clients),
-    row.lastActivity === null ? "-" : duration(now - row.lastActivity),
-    row.version ?? "-"
-  ];
-}
-function footer(rows, state, home) {
-  if (state.confirm === "stop" && state.target)
-    return `Stop ${shortPath(state.target, home)}? y to confirm`;
-  if (state.confirm === "stop-safe") {
-    const count = rows.filter((row) => row.safeToStop).length;
-    return `Stop ${count} server${count === 1 ? "" : "s"} that ${count === 1 ? "is" : "are"} safe to stop? y to confirm`;
-  }
-  return state.message ?? HELP;
-}
-function renderList(rows, state, screen) {
-  const { width, height, now, home } = screen;
-  const count = `${rows.length} server${rows.length === 1 ? "" : "s"} \xB7 refreshes every ${REFRESH_SECONDS}s`;
-  const lines = [header("ryugi-artifacts monitor", count, width)];
-  if (!rows.length) {
-    lines.push("", fit("No artifacts servers are running.", width), "");
-  } else {
-    const projectWidth = Math.max(12, width - FIXED - TAGS_WIDTH);
-    const columns = [
-      "  ",
-      pad2("PROJECT", projectWidth),
-      ...COLUMNS.map(([name, w]) => `  ${pad2(name, w)}`)
-    ].join("");
-    lines.push(`${DIM}${fit(columns.trimEnd(), width)}${RESET}`);
-    const visible = Math.max(1, height - 4);
-    const first = Math.min(
-      Math.max(0, state.selected - visible + 1),
-      Math.max(0, rows.length - visible)
-    );
-    rows.slice(first, first + visible).forEach((row, offset) => {
-      const selected = first + offset === state.selected;
-      const text2 = [
-        selected ? "\u203A " : "  ",
-        pad2(cutLeft(shortPath(row.project, home), projectWidth), projectWidth),
-        ...cells(row, now).map((cell, i) => `  ${pad2(cell, COLUMNS[i][1])}`),
-        tags(row).length ? `  ${tags(row).join(", ")}` : ""
-      ].join("");
-      const line = fit(text2.trimEnd(), width);
-      lines.push(selected ? `${INVERSE}${line}${RESET}` : line);
-    });
-    lines.push("");
-  }
-  lines.push(`${DIM}${fit(footer(rows, state, home), width)}${RESET}`);
-  return lines;
-}
-function renderLog(row, text2, screen) {
-  const { width, height, home } = screen;
-  const lines = [header(`Log \xB7 ${shortPath(row.project, home)}`, row.log, width)];
-  const body = text2 === null ? [
-    "No log file: this server runs in the foreground, so its output is in the terminal that started it."
-  ] : text2.replace(/\n+$/, "").split("\n").slice(-Math.max(1, height - 2));
-  lines.push(...body.map((line) => fit(line, width)));
-  lines.push(`${DIM}${fit("Esc back  Ctrl+C quit", width)}${RESET}`);
-  return lines;
-}
-function handleKey(state, key2, rows) {
-  if (key2.ctrl && key2.name === "c") return { state, action: { type: "quit" } };
-  const next = { ...state, confirm: null, target: null, message: null };
-  if (state.mode === "log")
-    return { state: key2.name === "escape" || key2.name === "q" ? { ...next, mode: "list" } : state };
-  if (state.confirm) {
-    if (key2.name !== "y") return { state: next };
-    const targets = state.confirm === "stop" ? rows.filter((row) => row.project === state.target) : rows.filter((row) => row.safeToStop);
-    if (targets.length) return { state: next, action: { type: "stop", rows: targets } };
-    return {
-      state: {
-        ...next,
-        message: state.target ? `${shortPath(state.target)} is no longer running.` : "Nothing is safe to stop any more."
-      }
-    };
-  }
-  const selected = rows[state.selected];
-  if (key2.sequence === "X" || key2.name === "x" && key2.shift) {
-    if (rows.some((row) => row.safeToStop)) return { state: { ...next, confirm: "stop-safe" } };
-    return {
-      state: {
-        ...next,
-        message: "Nothing is safe to stop: every server has an open tab or was used in the last 30 minutes."
-      }
-    };
-  }
-  switch (key2.name) {
-    case "q": {
-      return { state, action: { type: "quit" } };
-    }
-    case "up":
-    case "k": {
-      return { state: { ...next, selected: Math.max(0, state.selected - 1) } };
-    }
-    case "down":
-    case "j": {
-      return {
-        state: { ...next, selected: Math.min(Math.max(0, rows.length - 1), state.selected + 1) }
-      };
-    }
-    case "o":
-    case "c": {
-      if (!selected) return { state: next };
-      if (!selected.url) return { state: { ...next, message: "This server has no URL yet." } };
-      return { state: next, action: { type: key2.name === "o" ? "open" : "copy", row: selected } };
-    }
-    case "l": {
-      return { state: selected ? { ...next, mode: "log" } : next };
-    }
-    case "x": {
-      return { state: selected ? { ...next, confirm: "stop", target: selected.project } : next };
-    }
-    default: {
-      return { state: next };
-    }
-  }
-}
-
-// src/cli/servers.ts
-var import_node_path9 = __toESM(require("node:path"), 1);
-
-// src/server/registry.ts
-var import_node_crypto = __toESM(require("node:crypto"), 1);
-var import_node_fs9 = __toESM(require("node:fs"), 1);
-var import_node_os5 = __toESM(require("node:os"), 1);
-var import_node_path8 = __toESM(require("node:path"), 1);
-function registryDir(env = process.env, platform = process.platform, uid = process.getuid?.() ?? -1, tmpdir = import_node_os5.default.tmpdir()) {
-  if (env.RYUGI_RUNTIME_DIR) return import_node_path8.default.join(env.RYUGI_RUNTIME_DIR, "servers");
-  if (platform === "win32") return import_node_path8.default.join(tmpdir, "ryugi", "servers");
-  return `/tmp/ryugi-${uid}/servers`;
-}
-var fileFor = (dir, project) => import_node_path8.default.join(dir, `${import_node_crypto.default.createHash("sha256").update(project).digest("hex").slice(0, 16)}.json`);
-function verifyDir(dir) {
-  if (process.platform === "win32") return;
-  for (const target of [import_node_path8.default.dirname(dir), dir]) {
-    const stat = import_node_fs9.default.lstatSync(target);
-    if (!stat.isDirectory() || stat.uid !== process.getuid() || stat.mode & 18)
-      throw new Error(`Unsafe registry directory: ${target}`);
-  }
-}
-function readEntry(file) {
-  try {
-    const value = JSON.parse(import_node_fs9.default.readFileSync(file, "utf8"));
-    if (typeof value.project !== "string" || typeof value.root !== "string" || typeof value.serverId !== "string")
-      return null;
-    if (!Number.isInteger(value.pid) || !Number.isFinite(value.startedAt)) return null;
-    if (value.root !== import_node_path8.default.join(value.project, ".ryugi", "artifacts")) return null;
-    return value;
-  } catch {
-    return null;
-  }
-}
-function readEntries(dir) {
-  let names;
-  try {
-    verifyDir(dir);
-    names = import_node_fs9.default.readdirSync(dir);
-  } catch {
-    return [];
-  }
-  return names.filter((name) => name.endsWith(".json")).flatMap((name) => readEntry(import_node_path8.default.join(dir, name)) ?? []);
-}
-function removeEntry(dir, entry) {
-  const file = fileFor(dir, entry.project);
-  if (readEntry(file)?.serverId === entry.serverId) import_node_fs9.default.rmSync(file, { force: true });
-}
-
-// src/cli/servers.ts
-var SAFE_IDLE_MS = 30 * 6e4;
-var STATUS_TIMEOUT_MS = 1e3;
-var safeToStop = (status, now) => !!status && status.clients === 0 && now - status.lastActivity >= SAFE_IDLE_MS;
-async function fetchStatus(url) {
-  const base = new URL(url);
-  if (base.hostname === "localhost") base.hostname = "127.0.0.1";
-  try {
-    const res = await fetch(
-      `${base.origin}/api/status?key=${encodeURIComponent(base.searchParams.get("key") ?? "")}`,
-      { signal: AbortSignal.timeout(STATUS_TIMEOUT_MS) }
-    );
-    if (!res.ok) return null;
-    const json = await res.json();
-    if (typeof json.pid !== "number" || typeof json.clients !== "number" || typeof json.lastActivity !== "number")
-      return null;
-    return { pid: json.pid, clients: json.clients, lastActivity: json.lastActivity };
-  } catch {
-    return null;
-  }
-}
-function serverUrl(root) {
-  try {
-    const { url } = JSON.parse(readText(import_node_path9.default.join(root, ".state", "server-info")) ?? "");
-    return typeof url === "string" ? url : null;
-  } catch {
-    return null;
-  }
-}
-async function listServers(now = Date.now(), platform = process.platform) {
-  const dir = registryDir();
-  const current = process.env.RYUGI_ARTIFACTS_VERSION;
-  const live = readEntries(dir).filter((entry) => {
-    if (hasServerId(entry.pid, entry.serverId)) return true;
-    try {
-      removeEntry(dir, entry);
-    } catch {
-    }
-    return false;
-  });
-  const rows = await Promise.all(
-    live.map(async (entry) => {
-      const url = serverUrl(entry.root);
-      const status = url ? await fetchStatus(url) : null;
-      if (status && status.pid !== entry.pid) return null;
-      if (!status && platform === "win32") return null;
-      const version = readText(import_node_path9.default.join(entry.root, ".state", "server-version")) || null;
-      return {
-        project: entry.project,
-        root: entry.root,
-        pid: entry.pid,
-        url,
-        port: url ? Number(new URL(url).port) : null,
-        startedAt: entry.startedAt,
-        version,
-        oldRelease: !!current && !!version && version !== current,
-        clients: status?.clients ?? null,
-        lastActivity: status?.lastActivity ?? null,
-        safeToStop: safeToStop(status, now),
-        status: status ? "ok" : "no-status",
-        log: import_node_path9.default.join(entry.root, ".state", "server.log")
-      };
-    })
-  );
-  return rows.filter((row) => row !== null).sort((a, b) => a.project.localeCompare(b.project));
-}
-
-// src/cli/stop.ts
-var import_node_fs10 = __toESM(require("node:fs"), 1);
-async function stop(projectDir, emit) {
-  const paths = projectPaths(projectDir);
-  const markStopped = (reason) => {
-    import_node_fs10.default.rmSync(paths.info, { force: true });
-    import_node_fs10.default.mkdirSync(paths.state, { recursive: true });
-    import_node_fs10.default.writeFileSync(
-      paths.stopped,
-      `${JSON.stringify({ reason, timestamp: Math.floor(Date.now() / 1e3) })}
-`
-    );
-  };
-  const pid = Number(readText(paths.pid));
-  if (readText(paths.pid) === null) {
-    emit({ status: "not_running" });
-    return 0;
-  }
-  const id = readText(paths.serverId) ?? "";
-  if (!Number.isInteger(pid) || pid <= 0 || !/^[\w-]{32,64}$/.test(id) || !hasServerId(pid, id)) {
-    import_node_fs10.default.rmSync(paths.pid, { force: true });
-    import_node_fs10.default.rmSync(paths.serverId, { force: true });
-    markStopped("stale_pid");
-    emit({ status: "stale_pid" });
-    return 0;
-  }
-  try {
-    process.kill(pid, "SIGTERM");
-  } catch {
-  }
-  if (!await waitForExit(pid, 2e3)) {
-    try {
-      process.kill(pid, "SIGKILL");
-    } catch {
-    }
-    await waitForExit(pid, 1e3);
-  }
-  if (alive(pid)) {
-    emit({ status: "failed", error: "process still running" });
-    return 1;
-  }
-  for (const file of [paths.pid, paths.serverId, paths.log, paths.owners])
-    import_node_fs10.default.rmSync(file, { force: true });
-  markStopped("stop");
-  emit({ status: "stopped" });
-  return 0;
-}
-var stopCommand = {
-  name: "stop",
-  summary: "Stop the project's artifacts server; the artifacts are kept",
-  usage: ["[project-directory] [options]"],
-  options: {},
-  positionals: 1,
-  run: ({ values, positionals }, emit) => stop(values["project-dir"] ?? positionals[0] ?? process.cwd(), emit)
-};
-
-// src/cli/monitor-ui.ts
-var LOG_TAIL_BYTES = 64 * 1024;
-var LOG_REFRESH_MS = 500;
-function readTail(file) {
-  let fd;
-  try {
-    fd = import_node_fs11.default.openSync(file, "r");
-  } catch {
-    return null;
-  }
-  try {
-    const size = import_node_fs11.default.fstatSync(fd).size;
-    const length = Math.min(size, LOG_TAIL_BYTES);
-    const buffer = Buffer.alloc(length);
-    import_node_fs11.default.readSync(fd, buffer, 0, length, size - length);
-    return buffer.toString("utf8");
-  } finally {
-    import_node_fs11.default.closeSync(fd);
-  }
-}
-function clipboardCommands() {
-  if (process.platform === "darwin") return [["pbcopy", []]];
-  if (process.platform === "win32") return [["clip", []]];
-  return [
-    ["wl-copy", []],
-    ["xclip", ["-selection", "clipboard"]],
-    ["xsel", ["--clipboard", "--input"]]
-  ];
-}
-function copy(text2, commands = clipboardCommands()) {
-  const [first, ...rest] = commands;
-  if (!first) return Promise.resolve(false);
-  return new Promise((resolve) => {
-    const child = (0, import_node_child_process2.spawn)(first[0], first[1], { stdio: ["pipe", "ignore", "ignore"] });
-    child.on("error", () => resolve(copy(text2, rest)));
-    child.on("close", (code) => code === 0 ? resolve(true) : resolve(copy(text2, rest)));
-    child.stdin.end(text2);
-  });
-}
-async function runMonitorUi() {
-  const { stdin, stdout } = process;
-  let rows = await listServers();
-  let state = initialView();
-  let busy = false;
-  let closed = false;
-  const restore = () => {
-    if (closed) return;
-    closed = true;
-    try {
-      stdin.setRawMode(false);
-    } catch {
-    }
-    stdout.write("\x1B[?25h\x1B[?1049l");
-  };
-  process.on("exit", restore);
-  const draw = () => {
-    if (closed) return;
-    const screen = {
-      width: stdout.columns || 80,
-      height: stdout.rows || 24,
-      now: Date.now(),
-      home: import_node_os6.default.homedir()
-    };
-    const row = rows[state.selected];
-    const lines = state.mode === "log" && row ? renderLog(row, readTail(row.log), screen) : renderList(rows, state, screen);
-    stdout.write(`\x1B[H${lines.join("\x1B[K\n")}\x1B[K\x1B[J`);
-  };
-  const refresh = async () => {
-    if (busy || closed) return;
-    busy = true;
-    const selected = rows[state.selected]?.project;
-    try {
-      rows = await listServers();
-    } finally {
-      busy = false;
-    }
-    const index = rows.findIndex((row) => row.project === selected);
-    state = {
-      ...state,
-      selected: index >= 0 ? index : Math.min(state.selected, Math.max(0, rows.length - 1))
-    };
-    if (state.mode === "log" && !rows[state.selected]) state = { ...state, mode: "list" };
-    draw();
-  };
-  const say = (message) => {
-    state = { ...state, message };
-    draw();
-  };
-  const run = async (action) => {
-    if (action.type === "open") {
-      const launcher = browserLauncher(process.platform, action.row.url);
-      if (launcher) (0, import_node_child_process2.execFile)(launcher.bin, launcher.args, () => {
-      });
-      say(launcher ? `Opened ${action.row.url}` : `Open ${action.row.url}`);
-      return;
-    }
-    if (action.type === "copy") {
-      say(
-        await copy(action.row.url) ? `Copied ${action.row.url}` : `No clipboard tool found; the URL is ${action.row.url}`
-      );
-      return;
-    }
-    if (action.type === "stop") {
-      say(
-        `Stopping ${action.rows.length === 1 ? shortPath(action.rows[0].project) : `${action.rows.length} servers`}\u2026`
-      );
-      const failed = [];
-      for (const row of action.rows) {
-        let status = "failed";
-        try {
-          await stop(row.project, (value) => {
-            status = String(value.status ?? "failed");
-          });
-        } catch {
-        }
-        if (status === "failed") failed.push(shortPath(row.project));
-      }
-      await refresh();
-      say(
-        failed.length ? `Could not stop ${failed.join(", ")}` : `Stopped ${action.rows.length === 1 ? shortPath(action.rows[0].project) : `${action.rows.length} servers`}`
-      );
-    }
-  };
-  return new Promise((resolve) => {
-    const timers = [
-      setInterval(() => void refresh(), REFRESH_SECONDS * 1e3),
-      setInterval(() => {
-        if (state.mode === "log") draw();
-      }, LOG_REFRESH_MS)
-    ];
-    const quit = (code) => {
-      timers.forEach(clearInterval);
-      stdin.off("keypress", onKey);
-      stdout.off("resize", draw);
-      stdin.pause();
-      restore();
-      resolve(code);
-    };
-    const onKey = (_, key2) => {
-      const result = handleKey(state, key2 ?? {}, rows);
-      state = result.state;
-      if (result.action?.type === "quit") return quit(0);
-      draw();
-      if (result.action) void run(result.action);
-    };
-    for (const [signal, code] of [
-      ["SIGINT", 130],
-      ["SIGTERM", 143],
-      ["SIGHUP", 129]
-    ])
-      process.once(signal, () => quit(code));
-    stdout.write("\x1B[?1049h\x1B[?25l");
-    import_node_readline.default.emitKeypressEvents(stdin);
-    stdin.setRawMode(true);
-    stdin.resume();
-    stdin.on("keypress", onKey);
-    stdout.on("resize", draw);
-    draw();
-  });
-}
-
-// src/cli/monitor.ts
-function monitorText(value, now = Date.now()) {
-  if (value.type !== "servers") return null;
-  const rows = value.servers;
-  if (!rows.length) return "No artifacts servers are running.";
-  return rows.map(
-    (row) => [
-      shortPath(row.project),
-      row.url ?? "starting",
-      `pid ${row.pid}`,
-      row.clients === null ? null : `tabs ${row.clients}`,
-      row.lastActivity === null ? null : `idle ${duration(now - row.lastActivity)}`,
-      ...tags(row).map((tag) => `[${tag}]`)
-    ].filter(Boolean).join("  ")
-  ).join("\n");
-}
-async function monitor(options, emit) {
-  if (options.json || !process.stdout.isTTY || !process.stdin.isTTY) {
-    emit({ type: "servers", servers: await listServers() });
-    return 0;
-  }
-  return runMonitorUi();
-}
-var monitorCommand = {
-  name: "monitor",
-  summary: "List every running artifacts server on this machine and manage them",
-  details: "In a terminal it opens a live view (open, copy URL, logs, stop); otherwise, or with --json, prints the list once.",
-  options: {},
-  run: ({ values }, emit) => monitor({ json: !!values.json }, emit),
-  text: (value) => monitorText(value)
-};
-
 // src/cli/publish.ts
 async function publish(options, emit) {
   if (options.action === "publish" || options.action === "unpublish") {
@@ -18985,15 +18545,15 @@ ${value.url}`;
 };
 
 // src/cli/start.ts
-var import_node_child_process4 = require("node:child_process");
+var import_node_child_process3 = require("node:child_process");
 var import_node_crypto2 = __toESM(require("node:crypto"), 1);
-var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_fs13 = __toESM(require("node:fs"), 1);
 var import_node_path12 = __toESM(require("node:path"), 1);
-var import_node_readline2 = __toESM(require("node:readline"), 1);
+var import_node_readline = __toESM(require("node:readline"), 1);
 
 // src/server/artifact-address.ts
-var import_node_fs12 = __toESM(require("node:fs"), 1);
-var import_node_path10 = __toESM(require("node:path"), 1);
+var import_node_fs10 = __toESM(require("node:fs"), 1);
+var import_node_path9 = __toESM(require("node:path"), 1);
 
 // src/shared/ids.ts
 var SLUG_SOURCE = "[a-z0-9][a-z0-9-]*";
@@ -19031,15 +18591,15 @@ function artifactKeyOf(relative, isId = isArtifactId) {
 
 // src/server/artifact-address.ts
 function artifactId(dir) {
-  const file = import_node_path10.default.join(dir, ".artifact-id");
+  const file = import_node_path9.default.join(dir, ".artifact-id");
   let id;
   try {
-    id = import_node_fs12.default.readFileSync(file, "utf8").trim();
+    id = import_node_fs10.default.readFileSync(file, "utf8").trim();
   } catch (err) {
     if (err.code !== "ENOENT") throw err;
     id = mintArtifactId();
     try {
-      import_node_fs12.default.writeFileSync(file, `${id}
+      import_node_fs10.default.writeFileSync(file, `${id}
 `, { flag: "wx" });
     } catch (writeError) {
       if (writeError.code !== "EEXIST") throw writeError;
@@ -19051,15 +18611,26 @@ function artifactId(dir) {
 }
 function artifactPath(root, type, slug) {
   if (!isArtifactType(type) || !isArtifactId(slug)) throw new Error("Invalid artifact locator");
-  const dir = import_node_path10.default.join(root, type, slug);
-  import_node_fs12.default.mkdirSync(dir, { recursive: true });
+  const dir = import_node_path9.default.join(root, type, slug);
+  import_node_fs10.default.mkdirSync(dir, { recursive: true });
   return `/${type}/${artifactId(dir)}`;
 }
 
 // src/server/browser-focus.ts
-var import_node_child_process3 = require("node:child_process");
+var import_node_child_process2 = require("node:child_process");
 var import_node_util2 = require("node:util");
-var execute = (0, import_node_util2.promisify)(import_node_child_process3.execFile);
+
+// src/server/lifecycle.ts
+function browserLauncher(platform, url) {
+  if (platform === "darwin") return { bin: "open", args: [url] };
+  if (platform === "win32") return { bin: "cmd", args: ["/c", "start", '""', url] };
+  if (platform === "linux" || platform === "freebsd" || platform === "openbsd")
+    return { bin: "xdg-open", args: [url] };
+  return null;
+}
+
+// src/server/browser-focus.ts
+var execute = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
 var MAC_FOCUS_SCRIPT = String.raw`
 function run(urls) {
   function key(url) {
@@ -19109,18 +18680,64 @@ async function openBrowser(url, aliases2 = []) {
   if (launcher) await execute(launcher.bin, launcher.args);
 }
 
+// src/server/registry.ts
+var import_node_crypto = __toESM(require("node:crypto"), 1);
+var import_node_fs11 = __toESM(require("node:fs"), 1);
+var import_node_os5 = __toESM(require("node:os"), 1);
+var import_node_path10 = __toESM(require("node:path"), 1);
+function registryDir(env = process.env, platform = process.platform, uid = process.getuid?.() ?? -1, tmpdir = import_node_os5.default.tmpdir()) {
+  if (env.RYUGI_RUNTIME_DIR) return import_node_path10.default.join(env.RYUGI_RUNTIME_DIR, "servers");
+  if (platform === "win32") return import_node_path10.default.join(tmpdir, "ryugi", "servers");
+  return `/tmp/ryugi-${uid}/servers`;
+}
+var fileFor = (dir, project) => import_node_path10.default.join(dir, `${import_node_crypto.default.createHash("sha256").update(project).digest("hex").slice(0, 16)}.json`);
+function verifyDir(dir) {
+  if (process.platform === "win32") return;
+  for (const target of [import_node_path10.default.dirname(dir), dir]) {
+    const stat = import_node_fs11.default.lstatSync(target);
+    if (!stat.isDirectory() || stat.uid !== process.getuid() || stat.mode & 18)
+      throw new Error(`Unsafe registry directory: ${target}`);
+  }
+}
+function readEntry(file) {
+  try {
+    const value = JSON.parse(import_node_fs11.default.readFileSync(file, "utf8"));
+    if (typeof value.project !== "string" || typeof value.root !== "string" || typeof value.serverId !== "string")
+      return null;
+    if (!Number.isInteger(value.pid) || !Number.isFinite(value.startedAt)) return null;
+    if (value.root !== import_node_path10.default.join(value.project, ".ryugi", "artifacts")) return null;
+    return value;
+  } catch {
+    return null;
+  }
+}
+function readEntries(dir) {
+  let names;
+  try {
+    verifyDir(dir);
+    names = import_node_fs11.default.readdirSync(dir);
+  } catch {
+    return [];
+  }
+  return names.filter((name) => name.endsWith(".json")).flatMap((name) => readEntry(import_node_path10.default.join(dir, name)) ?? []);
+}
+function removeEntry(dir, entry) {
+  const file = fileFor(dir, entry.project);
+  if (readEntry(file)?.serverId === entry.serverId) import_node_fs11.default.rmSync(file, { force: true });
+}
+
 // src/cli/login-hint.ts
-var import_node_fs13 = __toESM(require("node:fs"), 1);
-var import_node_os7 = __toESM(require("node:os"), 1);
+var import_node_fs12 = __toESM(require("node:fs"), 1);
+var import_node_os6 = __toESM(require("node:os"), 1);
 var import_node_path11 = __toESM(require("node:path"), 1);
 function takeLoginHint(projectDir) {
-  const file = credentialsFile(process.env, process.platform, import_node_os7.default.homedir());
+  const file = credentialsFile(process.env, process.platform, import_node_os6.default.homedir());
   const origin = (process.env.RYUGI_CLOUD_ORIGIN || "https://ryugi.innei.dev").replace(/\/+$/, "");
   if (readCredentials(file, origin)) return;
   const marker = import_node_path11.default.join(import_node_path11.default.dirname(file), "login-hint-shown");
   try {
-    import_node_fs13.default.mkdirSync(import_node_path11.default.dirname(marker), { recursive: true, mode: 448 });
-    import_node_fs13.default.writeFileSync(marker, "1\n", { flag: "wx", mode: 384 });
+    import_node_fs12.default.mkdirSync(import_node_path11.default.dirname(marker), { recursive: true, mode: 448 });
+    import_node_fs12.default.writeFileSync(marker, "1\n", { flag: "wx", mode: 384 });
   } catch (error) {
     if (error.code === "EEXIST") return;
   }
@@ -19138,32 +18755,69 @@ function loginHintText(value) {
 In ${hint.projectDir}, run \`${hint.command}\` to sign in.`;
 }
 
+// src/cli/upgrade-rule.ts
+var isLocal = (version) => version.startsWith("local-");
+function compare(a, b) {
+  const pa = a.split(/[.-]/).slice(0, 3).map(Number);
+  const pb = b.split(/[.-]/).slice(0, 3).map(Number);
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa[i] || 0) - (pb[i] || 0);
+    if (diff) return Math.sign(diff);
+  }
+  return 0;
+}
+function replaceDecision(running, cli) {
+  if (!cli) return "keep";
+  if (!running) return "replace";
+  if (running === cli) return "keep";
+  if (isLocal(cli)) return "replace";
+  if (isLocal(running)) return "keep";
+  return compare(cli, running) > 0 ? "replace" : "keep-older-cli";
+}
+
 // src/cli/start.ts
-var windowsLike = () => process.platform === "win32";
-function withLink(info, artifact, reused) {
-  const out = { ...info };
-  if (reused) out.reused = true;
-  if (artifact && typeof out.url === "string") {
-    const url = new URL(out.url);
+var DEFAULT_CLOUD_ORIGIN = "https://ryugi.innei.dev";
+var RESERVE_TIMEOUT_MS = 5e3;
+var REGISTER_TIMEOUT_MS = 15e3;
+var STATUS_TIMEOUT_MS = 1e3;
+var START_TIMEOUT_MS = 1e4;
+var SETTLE_MS = 6e3;
+var cloudOriginOf = (env) => (env.RYUGI_CLOUD_ORIGIN || DEFAULT_CLOUD_ORIGIN).replace(/\/+$/, "");
+var loopbackUrl = (url) => {
+  const parsed = new URL(url);
+  if (parsed.hostname === "localhost") parsed.hostname = "127.0.0.1";
+  return parsed;
+};
+var apiUrl = (info, pathname) => {
+  const base = loopbackUrl(info.url);
+  const target = new URL(pathname, base.origin);
+  const key2 = base.searchParams.get("key");
+  if (key2) target.searchParams.set("key", key2);
+  return target.toString();
+};
+function withLink(info, paths, artifact) {
+  const out = {
+    type: "server-started",
+    url: info.url,
+    port: info.port,
+    root: paths.root
+  };
+  if (artifact) {
+    const url = new URL(info.url);
     const ref = artifactKeyOf(artifact);
     const key2 = url.searchParams.get("key");
-    out.link = `${url.origin}${artifactPath(String(out.root), ref.type, ref.id)}${key2 ? `?key=${key2}` : ""}`;
+    out.link = `${url.origin}${artifactPath(paths.root, ref.type, ref.id)}${key2 ? `?key=${key2}` : ""}`;
   }
   return out;
 }
-var RESERVE_TIMEOUT_MS = 5e3;
-async function withCloudLink(out, artifact) {
-  if (!artifact || typeof out.url !== "string") return out;
-  const server = new URL(out.url);
-  if (server.hostname === "localhost") server.hostname = "127.0.0.1";
+async function withCloudLink(out, info, paths, artifact) {
+  if (!artifact) return out;
   try {
-    const res = await fetch(
-      `${server.origin}/api/cloud/reserve/${artifact}?key=${encodeURIComponent(server.searchParams.get("key") ?? "")}`,
-      {
-        method: "POST",
-        signal: AbortSignal.timeout(RESERVE_TIMEOUT_MS)
-      }
-    );
+    const res = await fetch(apiUrl(info, `/api/cloud/reserve/${artifact}`), {
+      method: "POST",
+      headers: { "X-Ryugi-Project": encodeURIComponent(paths.project) },
+      signal: AbortSignal.timeout(RESERVE_TIMEOUT_MS)
+    });
     const { url, limit } = await res.json();
     if (typeof url === "string") return { ...out, cloudLink: url };
     if (typeof limit?.upgradeUrl === "string")
@@ -19176,13 +18830,13 @@ async function withCloudLink(out, artifact) {
 async function acquireLock(lock) {
   for (let attempt = 0; attempt < 150; attempt++) {
     try {
-      import_node_fs14.default.mkdirSync(lock);
+      import_node_fs13.default.mkdirSync(lock);
       return true;
     } catch {
     }
     try {
-      if (Date.now() - import_node_fs14.default.statSync(lock).mtimeMs > 6e4) {
-        import_node_fs14.default.rmdirSync(lock);
+      if (Date.now() - import_node_fs13.default.statSync(lock).mtimeMs > 6e4) {
+        import_node_fs13.default.rmdirSync(lock);
         continue;
       }
     } catch {
@@ -19191,142 +18845,195 @@ async function acquireLock(lock) {
   }
   return false;
 }
-function runningPid(paths) {
-  const pid = Number(readText(paths.pid));
-  const id = readText(paths.serverId);
+function runningPid(machine) {
+  const pid = Number(readText(machine.pid));
+  const id = readText(machine.serverId);
   if (!Number.isInteger(pid) || pid <= 0 || !id) return null;
   return hasServerId(pid, id) ? pid : null;
 }
-function ownerPid() {
-  if (windowsLike()) return null;
-  const given = Number(process.env.RYUGI_ARTIFACTS_OWNER);
-  if (Number.isInteger(given) && given > 1) return given;
-  return parentOf(process.ppid) ?? process.ppid;
-}
-function registerOwner(paths) {
-  const owners = /* @__PURE__ */ new Set();
-  for (const line of (readText(paths.owners) ?? "").split("\n")) {
-    const pid = Number(line.trim());
-    if (Number.isInteger(pid) && pid > 1 && alive(pid)) owners.add(pid);
-  }
-  const owner = ownerPid();
-  if (owner) owners.add(owner);
-  const tmp = `${paths.owners}.${process.pid}`;
-  import_node_fs14.default.writeFileSync(
-    tmp,
-    [...owners].sort((a, b) => a - b).map((pid) => `${pid}
-`).join("")
-  );
-  import_node_fs14.default.renameSync(tmp, paths.owners);
+function readInfo(machine) {
+  try {
+    const info = JSON.parse(readText(machine.info) ?? "");
+    return typeof info.url === "string" && Number.isInteger(info.port) ? info : null;
+  } catch {
+    return null;
+  }
 }
-function recordAgent(paths) {
-  const markers = Object.fromEntries(
-    AGENT_MARKERS.flatMap((key2) => process.env[key2] ? [[key2, process.env[key2]]] : [])
-  );
-  if (Object.keys(markers).length) import_node_fs14.default.writeFileSync(paths.agent, `${JSON.stringify(markers)}
-`);
+async function answers(info) {
+  try {
+    const res = await fetch(apiUrl(info, "/api/status"), {
+      signal: AbortSignal.timeout(STATUS_TIMEOUT_MS)
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
 }
-async function replace2(pid, paths) {
+async function stopPid(pid, what) {
   try {
     process.kill(pid, "SIGTERM");
   } catch {
   }
-  if (await waitForExit(pid, 5e3)) return;
+  if (await waitForExit(pid, 7e3)) return;
   try {
     process.kill(pid, "SIGKILL");
   } catch {
   }
   if (await waitForExit(pid, 2e3)) return;
   throw new CliError(
-    `The running server (pid ${pid}) is on another release and did not stop; stop it with \`${invocation()} stop --project-dir ${paths.project}\` and retry`
+    `The ${what} (pid ${pid}) did not stop; stop it with \`${invocation()} stop\` and retry`
+  );
+}
+async function stopOldProjectServers() {
+  const dir = registryDir();
+  for (const entry of readEntries(dir)) {
+    if (hasServerId(entry.pid, entry.serverId)) {
+      try {
+        process.kill(entry.pid, "SIGTERM");
+      } catch {
+      }
+      await waitForExit(entry.pid, 5e3);
+    }
+    try {
+      removeEntry(dir, entry);
+    } catch {
+    }
+  }
+}
+function recordAgent(paths) {
+  const markers = Object.fromEntries(
+    AGENT_MARKERS.flatMap((key2) => process.env[key2] ? [[key2, process.env[key2]]] : [])
   );
+  if (Object.keys(markers).length) import_node_fs13.default.writeFileSync(paths.agent, `${JSON.stringify(markers)}
+`);
 }
-function serverEnv(paths, options) {
+function serverEnv(options) {
   const env = {
     ...process.env,
-    ARTIFACTS_ROOT: paths.root,
     ARTIFACTS_HOST: options.host,
-    ARTIFACTS_URL_HOST: options.urlHost,
-    ARTIFACTS_OPEN: options.open ? "1" : "0"
+    ARTIFACTS_URL_HOST: options.urlHost
   };
-  if (options.artifact) env.ARTIFACTS_OPEN_ARTIFACT = options.artifact;
-  if (options.idleTimeoutMinutes)
-    env.ARTIFACTS_IDLE_TIMEOUT_MS = String(Number(options.idleTimeoutMinutes) * 6e4);
-  delete env.RYUGI_ARTIFACTS_OWNER;
-  delete env.RYUGI_ARTIFACTS_VERSION;
-  delete env.RYUGI_ARTIFACTS_COMMAND;
+  if (process.env.RYUGI_ARTIFACTS_COMMAND)
+    env.RYUGI_ARTIFACTS_LAUNCHER = process.env.RYUGI_ARTIFACTS_COMMAND;
+  for (const key2 of [
+    "RYUGI_ARTIFACTS_OWNER",
+    "RYUGI_ARTIFACTS_VERSION",
+    "RYUGI_ARTIFACTS_COMMAND",
+    "ARTIFACTS_OPEN_CMD",
+    "ARTIFACTS_ROOT"
+  ])
+    delete env[key2];
   return env;
 }
+var startedLine = (text2) => text2.split("\n").find((line) => line.includes('"server-started"'));
+var errorLine = (text2) => text2.split("\n").find((line) => line.includes('"server-error"'));
+async function register(info, paths, open) {
+  const res = await fetch(apiUrl(info, "/api/hub/projects"), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      dir: paths.project,
+      ...open ? { open } : {},
+      ...open && process.env.ARTIFACTS_OPEN_CMD ? { openCmd: process.env.ARTIFACTS_OPEN_CMD } : {}
+    }),
+    signal: AbortSignal.timeout(REGISTER_TIMEOUT_MS)
+  });
+  if (!res.ok) throw new CliError(`The artifacts server refused this project: ${await res.text()}`);
+}
 async function start(options, emit) {
   if (options.artifact !== void 0 && !ARTIFACT_PATTERN.test(options.artifact))
     throw new CliError(ARTIFACT_ERROR);
-  if (options.idleTimeoutMinutes !== void 0 && (!/^\d+$/.test(options.idleTimeoutMinutes) || Number(options.idleTimeoutMinutes) < 1))
-    throw new CliError("--idle-timeout-minutes must be a positive integer");
+  if (options.port !== void 0 && (!/^\d+$/.test(options.port) || Number(options.port) < 1 || Number(options.port) > 65535))
+    throw new CliError("--port must be a port number");
   options.urlHost ||= options.host === "127.0.0.1" || options.host === "localhost" ? "localhost" : options.host;
-  const foreground = options.foreground || !options.background && (!!process.env.CODEX_CI || windowsLike());
   process.umask(63);
   const paths = projectPaths(options.projectDir);
-  const emitStarted = (out) => {
+  const machine = machinePaths();
+  ensureHome(machine.home);
+  import_node_fs13.default.mkdirSync(paths.state, { recursive: true });
+  if (!import_node_fs13.default.existsSync(import_node_path12.default.join(paths.state, ".gitignore")))
+    import_node_fs13.default.writeFileSync(import_node_path12.default.join(paths.state, ".gitignore"), "*\n");
+  const cliVersion = process.env.RYUGI_ARTIFACTS_VERSION || (true ? "1.51.1" : "");
+  const known = readProjects(machine.projects).some((entry) => entry.dir === paths.project);
+  const finish = async (info, reused, hint) => {
+    recordAgent(paths);
+    const wantsOpen = options.open && (!reused || !known);
+    await register(info, paths, wantsOpen ? options.artifact ?? true : void 0);
+    const base = withLink(info, paths, options.artifact);
+    if (reused) base.reused = true;
+    if (hint) base.hint = hint;
+    const out = await withCloudLink(base, info, paths, options.artifact);
     const loginHint = takeLoginHint(paths.project);
     emit(loginHint ? { ...out, loginHint } : out);
+    if (reused && known && process.platform === "darwin" && options.open && options.openExisting && options.artifact && !process.env.ARTIFACTS_OPEN_CMD) {
+      const local = out.link;
+      await openBrowser(typeof out.cloudLink === "string" ? out.cloudLink : local, [local]).catch(
+        (error) => console.error(error.message)
+      );
+    }
   };
-  import_node_fs14.default.mkdirSync(paths.state, { recursive: true });
-  if (!import_node_fs14.default.existsSync(import_node_path12.default.join(paths.state, ".gitignore")))
-    import_node_fs14.default.writeFileSync(import_node_path12.default.join(paths.state, ".gitignore"), "*\n");
-  const server = import_node_path12.default.join(__dirname, "server.cjs");
-  const version = process.env.RYUGI_ARTIFACTS_VERSION ?? "";
-  if (!await acquireLock(paths.lock))
-    throw new CliError("Another start for this project is still starting; retry in a moment");
+  if (!await acquireLock(machine.lock))
+    throw new CliError("Another start is still starting the artifacts server; retry in a moment");
   let locked = true;
   const unlock = () => {
     if (!locked) return;
     locked = false;
     try {
-      import_node_fs14.default.rmdirSync(paths.lock);
+      import_node_fs13.default.rmdirSync(machine.lock);
     } catch {
     }
   };
   try {
-    const running = runningPid(paths);
-    const info = readText(paths.info);
+    const running = runningPid(machine);
+    let info = readInfo(machine);
+    if (running && !info) {
+      for (let waited = 0; waited < SETTLE_MS && alive(running) && !info; waited += 100) {
+        await sleep(100);
+        info = readInfo(machine);
+      }
+      if (!info && alive(running)) await stopPid(running, "stopping artifacts server");
+    }
     if (running && info) {
-      if (!version || readText(paths.version) === version) {
-        registerOwner(paths);
-        recordAgent(paths);
-        const out = await withCloudLink(
-          withLink(JSON.parse(info), options.artifact, true),
-          options.artifact
+      const runningVersion = readText(machine.version) ?? "";
+      const decision = replaceDecision(runningVersion, cliVersion);
+      const mismatch = (info.host ?? "127.0.0.1") !== options.host || (info.urlHost ?? "localhost") !== options.urlHost || (info.cloudOrigin ?? DEFAULT_CLOUD_ORIGIN) !== cloudOriginOf(process.env) || options.port !== void 0 && String(info.port) !== options.port;
+      if (decision !== "replace" && !mismatch && await answers(info)) {
+        unlock();
+        await finish(
+          info,
+          true,
+          decision === "keep-older-cli" ? `The running server is ${runningVersion}, newer than this CLI (${cliVersion}); kept it` : void 0
         );
-        emitStarted(out);
-        if (process.platform === "darwin" && options.open && options.openExisting && options.artifact && !process.env.ARTIFACTS_OPEN_CMD) {
-          const local = out.link;
-          await openBrowser(typeof out.cloudLink === "string" ? out.cloudLink : local, [
-            local
-          ]).catch((error) => {
-            console.error(error.message);
-          });
-        }
         return 0;
       }
-      await replace2(running, paths);
+      await stopPid(running, "running artifacts server");
     }
-    registerOwner(paths);
-    recordAgent(paths);
-    import_node_fs14.default.rmSync(paths.info, { force: true });
+    await stopOldProjectServers();
+    import_node_fs13.default.rmSync(machine.info, { force: true });
     const id = import_node_crypto2.default.randomBytes(24).toString("hex");
-    import_node_fs14.default.writeFileSync(paths.serverId, `${id}
+    import_node_fs13.default.writeFileSync(machine.serverId, `${id}
 `);
-    import_node_fs14.default.writeFileSync(paths.version, `${version}
+    import_node_fs13.default.writeFileSync(machine.version, `${cliVersion}
 `);
-    const env = serverEnv(paths, options);
-    const args = [server, `--artifacts-server-id=${id}`];
+    const server = import_node_path12.default.join(__dirname, "server.cjs");
+    const args = [
+      server,
+      `--artifacts-server-id=${id}`,
+      ...options.port ? [`--port=${options.port}`] : []
+    ];
+    const env = serverEnv(options);
+    const foreground = options.foreground || !options.background && !!process.env.CODEX_CI;
     if (foreground) {
-      const child2 = (0, import_node_child_process4.spawn)(process.execPath, args, { env, stdio: ["ignore", "pipe", "inherit"] });
-      import_node_fs14.default.writeFileSync(paths.pid, `${child2.pid}
+      const child2 = (0, import_node_child_process3.spawn)(process.execPath, args, { env, stdio: ["ignore", "pipe", "inherit"] });
+      import_node_fs13.default.writeFileSync(machine.pid, `${child2.pid}
 `);
       for (const signal of ["SIGINT", "SIGTERM"])
         process.on(signal, () => child2.kill("SIGTERM"));
-      import_node_readline2.default.createInterface({ input: child2.stdout }).on("line", (line) => {
+      const exited = new Promise(
+        (resolve) => child2.on("close", (code) => resolve(code ?? 1))
+      );
+      let announced = false;
+      import_node_readline.default.createInterface({ input: child2.stdout }).on("line", (line) => {
         let value;
         try {
           value = JSON.parse(line);
@@ -19335,64 +19042,59 @@ async function start(options, emit) {
 `);
           return;
         }
-        if (value.type !== "server-started") emit(value);
-        else
-          void withCloudLink(withLink(value, options.artifact, false), options.artifact).then(
-            emitStarted
-          );
+        if (value.type !== "server-started" || announced) {
+          emit(value);
+          return;
+        }
+        announced = true;
+        unlock();
+        void finish(value, false).catch(
+          (error) => emit({ type: "error", error: error.message })
+        );
       });
-      const exited = new Promise(
-        (resolve) => child2.on("close", (code) => resolve(code ?? 1))
-      );
-      for (let waited = 0; waited < 5e3 && !import_node_fs14.default.existsSync(paths.info); waited += 100)
-        await sleep(100);
-      unlock();
       return await exited;
     }
-    const log = import_node_fs14.default.openSync(paths.log, "w");
-    const child = (0, import_node_child_process4.spawn)(process.execPath, args, {
+    const log = import_node_fs13.default.openSync(machine.log, "w");
+    const child = (0, import_node_child_process3.spawn)(process.execPath, args, {
       env,
       detached: true,
+      windowsHide: true,
       stdio: ["ignore", log, log]
     });
-    import_node_fs14.default.closeSync(log);
+    import_node_fs13.default.closeSync(log);
     child.unref();
-    import_node_fs14.default.writeFileSync(paths.pid, `${child.pid}
+    import_node_fs13.default.writeFileSync(machine.pid, `${child.pid}
 `);
-    for (let waited = 0; waited < 5e3; waited += 100) {
-      const lines = (readText(paths.log) ?? "").split("\n");
-      const started = lines.find((line) => line.includes('"server-started"'));
+    for (let waited = 0; waited < START_TIMEOUT_MS; waited += 100) {
+      const text2 = readText(machine.log) ?? "";
+      const started = startedLine(text2);
       if (started) {
-        for (let check2 = 0; check2 < 20; check2++) {
+        for (let check2 = 0; check2 < 10; check2++) {
           if (!alive(child.pid))
             throw new CliError(
               `Server started but was killed. Retry in a persistent terminal with: ${invocation()} start --project-dir ${paths.project}${options.artifact ? ` --artifact ${options.artifact}` : ""} --host ${options.host} --url-host ${options.urlHost} --foreground`
             );
           await sleep(100);
         }
-        emitStarted(
-          await withCloudLink(
-            withLink(JSON.parse(started), options.artifact, false),
-            options.artifact
-          )
-        );
+        unlock();
+        await finish(JSON.parse(started), false);
         return 0;
       }
-      const failed = lines.find((line) => line.includes('"server-error"'));
+      const failed = errorLine(text2);
       if (failed) {
         emit(JSON.parse(failed));
         return 1;
       }
       await sleep(100);
     }
-    throw new CliError("Server failed to start within 5 seconds");
+    throw new CliError(`Server failed to start within ${START_TIMEOUT_MS / 1e3} seconds`);
   } finally {
     unlock();
   }
 }
 var startCommand = {
   name: "start",
-  summary: "Start the project's artifacts server, or reuse the running one",
+  summary: "Start this machine's artifacts server if needed and register the project with it",
   options: {
     "artifact": {
       type: "string",
@@ -19409,10 +19111,10 @@ var startCommand = {
       value: "<host>",
       help: "Host in printed URLs (default: localhost for a loopback --host)"
     },
-    "idle-timeout-minutes": {
+    "port": {
       type: "string",
       value: "<n>",
-      help: "Stop after this many idle minutes (default: 240)"
+      help: "Port to listen on (default: the first free of 27319-27321)"
     },
     "open": {
       type: "boolean",
@@ -19433,7 +19135,7 @@ var startCommand = {
       artifact: values.artifact,
       host: values.host ?? "127.0.0.1",
       urlHost: values["url-host"],
-      idleTimeoutMinutes: values["idle-timeout-minutes"],
+      port: values.port,
       open: values["no-open"] ? false : values.open ? true : process.env.ARTIFACTS_OPEN !== "0",
       openExisting: !!values.open,
       foreground: !!(values.foreground || values["no-daemon"]),
@@ -19444,15 +19146,76 @@ var startCommand = {
   text: (value) => value.type === "server-started" ? `${value.cloudLink ?? value.link ?? value.url}${value.reused ? " (already running)" : ""}` : null
 };
 
+// src/cli/stop.ts
+var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_path13 = __toESM(require("node:path"), 1);
+function clearCompatInfo(projectsFile) {
+  for (const entry of readProjects(projectsFile))
+    import_node_fs14.default.rmSync(import_node_path13.default.join(artifactsRootOf(entry.dir), ".state", "server-info"), { force: true });
+}
+async function stop(emit) {
+  const machine = machinePaths();
+  const markStopped = (reason) => {
+    import_node_fs14.default.rmSync(machine.info, { force: true });
+    clearCompatInfo(machine.projects);
+    import_node_fs14.default.mkdirSync(machine.home, { recursive: true, mode: 448 });
+    import_node_fs14.default.writeFileSync(
+      machine.stopped,
+      `${JSON.stringify({ reason, timestamp: Math.floor(Date.now() / 1e3) })}
+`
+    );
+  };
+  if (readText(machine.pid) === null) {
+    emit({ status: "not_running" });
+    return 0;
+  }
+  const pid = Number(readText(machine.pid));
+  const id = readText(machine.serverId) ?? "";
+  if (!Number.isInteger(pid) || pid <= 0 || !/^[\w-]{32,64}$/.test(id) || !hasServerId(pid, id)) {
+    import_node_fs14.default.rmSync(machine.pid, { force: true });
+    import_node_fs14.default.rmSync(machine.serverId, { force: true });
+    markStopped("stale_pid");
+    emit({ status: "stale_pid" });
+    return 0;
+  }
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+  }
+  if (!await waitForExit(pid, 7e3)) {
+    try {
+      process.kill(pid, "SIGKILL");
+    } catch {
+    }
+    await waitForExit(pid, 1e3);
+  }
+  if (alive(pid)) {
+    emit({ status: "failed", error: "process still running" });
+    return 1;
+  }
+  for (const file of [machine.pid, machine.serverId]) import_node_fs14.default.rmSync(file, { force: true });
+  markStopped("stop");
+  emit({ status: "stopped" });
+  return 0;
+}
+var stopCommand = {
+  name: "stop",
+  summary: "Stop this machine's artifacts server; the artifacts are kept",
+  usage: ["[options]"],
+  options: {},
+  positionals: 1,
+  run: (_args, emit) => stop(emit)
+};
+
 // src/cli/update.ts
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var import_node_fs16 = __toESM(require("node:fs"), 1);
 
 // src/cli/update-hint.ts
-var import_node_child_process5 = require("node:child_process");
+var import_node_child_process4 = require("node:child_process");
 var import_node_fs15 = __toESM(require("node:fs"), 1);
-var import_node_os8 = __toESM(require("node:os"), 1);
-var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_os7 = __toESM(require("node:os"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
 var CHECK_MS = 24 * 60 * 60 * 1e3;
 var RELEASE = /^\d+\.\d+\.\d+$/;
 function newer(a, b) {
@@ -19469,8 +19232,8 @@ function updateCheck({ current, cached, now, env, tty, json, argv = [] }) {
   const hint = !quiet && RELEASE.test(current) && RELEASE.test(latest) && newer(latest, current) ? `ryugi-artifacts ${latest} is available (you have ${current}). Run \`ryugi-artifacts update\` to install it.` : null;
   return { hint, refresh: !cached || now - cached.checkedAt >= CHECK_MS };
 }
-var latestFile = (env) => import_node_path13.default.join(
-  env.XDG_CACHE_HOME || import_node_path13.default.join(import_node_os8.default.homedir(), ".cache"),
+var latestFile = (env) => import_node_path14.default.join(
+  env.XDG_CACHE_HOME || import_node_path14.default.join(import_node_os7.default.homedir(), ".cache"),
   "ryugi",
   "artifacts",
   "latest.json"
@@ -19485,7 +19248,7 @@ function readLatest(file) {
 }
 function writeLatest(file, version, checkedAt) {
   try {
-    import_node_fs15.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
+    import_node_fs15.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}`;
     import_node_fs15.default.writeFileSync(tmp, JSON.stringify({ version, checkedAt }));
     import_node_fs15.default.renameSync(tmp, file);
@@ -19509,7 +19272,7 @@ fetch(new URL('ryugi-artifacts/latest', registry), { signal: AbortSignal.timeout
 `;
 function refreshLatest(file, registry2) {
   const base = registry2.endsWith("/") ? registry2 : `${registry2}/`;
-  const child = (0, import_node_child_process5.spawn)(process.execPath, ["-e", REFRESH, file, base], {
+  const child = (0, import_node_child_process4.spawn)(process.execPath, ["-e", REFRESH, file, base], {
     detached: true,
     stdio: "ignore"
   });
@@ -19619,7 +19382,7 @@ or run \`${PACKAGE} update --pm <${PMS.join("|")}>\`.`
     return 0;
   }
   const windows = process.platform === "win32";
-  const result = windows ? (0, import_node_child_process6.spawnSync)(commandLine2(command), { stdio: ["inherit", 2, 2], env: options.env, shell: true }) : (0, import_node_child_process6.spawnSync)(command.cmd, command.args, { stdio: ["inherit", 2, 2], env: options.env });
+  const result = windows ? (0, import_node_child_process5.spawnSync)(commandLine2(command), { stdio: ["inherit", 2, 2], env: options.env, shell: true }) : (0, import_node_child_process5.spawnSync)(command.cmd, command.args, { stdio: ["inherit", 2, 2], env: options.env });
   if (result.error)
     throw new CliError(`Could not run ${commandLine2(command)}: ${result.error.message}`);
   if (result.status !== 0)
@@ -19646,7 +19409,7 @@ var updateCommand = {
   },
   run: ({ values }, emit) => update2(
     {
-      current: "1.49.5",
+      current: "1.51.1",
       file: __filename,
       env: process.env,
       registry: process.env.npm_config_registry || "https://registry.npmjs.org/",
@@ -19672,7 +19435,6 @@ var COMMANDS = [
   publishCommand,
   commentCommand,
   getCommand,
-  monitorCommand,
   configCommand,
   updateCommand
 ];
@@ -19694,7 +19456,7 @@ function text(value) {
 function openBrowser2(url) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
   const args = process.platform === "win32" ? ["/c", "start", '""', url] : [url];
-  (0, import_node_child_process7.execFile)(command, args, () => {
+  (0, import_node_child_process6.execFile)(command, args, () => {
   });
 }
 async function browse(argv) {
@@ -19727,7 +19489,7 @@ async function main(argv) {
   const [name, ...rest] = argv;
   const command = COMMANDS.find((candidate) => candidate.name === name);
   const json = argv.includes("--json") || !command?.explicitJson && !process.stdout.isTTY;
-  notifyUpdate("1.49.5", json, argv);
+  notifyUpdate("1.51.1", json, argv);
   const emit = (value) => {
     const line = json ? JSON.stringify(value) : text(value);
     if (!json && typeof value.error === "string") console.error(line);
@@ -19746,7 +19508,7 @@ async function main(argv) {
       return await command.run(parse(rest, command.options, command.positionals), emit);
     }
     if (name === "--version" || name === "-v") {
-      console.info("1.49.5");
+      console.info("1.51.1");
       return 0;
     }
     if (name === "--help" || name === "-h") {