ryugi-artifacts 1.11.0 → 1.12.0

package/dist/server.cjs

@@ -1563,14 +1563,14 @@ var require_canvas = __commonJS({
 
 // src/server/main.ts
 var import_node_child_process2 = require("node:child_process");
-var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_fs22 = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
-var import_node_path18 = __toESM(require("node:path"), 1);
+var import_node_path19 = __toESM(require("node:path"), 1);
 
 // src/server/app.ts
-var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_fs20 = __toESM(require("node:fs"), 1);
 var import_node_http = __toESM(require("node:http"), 1);
-var import_node_path17 = __toESM(require("node:path"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
 
 // src/shared/types.ts
 var ARTIFACT_TYPES = ["artboard", "document", "html"];
@@ -15642,19 +15642,19 @@ var ElementDOMSlot = class _ElementDOMSlot extends DOMSlot {
   }
 };
 function indexPath(root, child) {
-  const path19 = [];
+  const path20 = [];
   let node = child;
   for (; node !== root && node !== null; node = node.parentNode) {
     let i6 = 0;
     for (let sibling = node.previousSibling; sibling !== null; sibling = sibling.previousSibling) {
       i6++;
     }
-    path19.push(i6);
+    path20.push(i6);
   }
   if (!(node === root)) {
     formatDevErrorMessage(`indexPath: root is not a parent of child`);
   }
-  return path19.reverse();
+  return path20.reverse();
 }
 // @__NO_SIDE_EFFECTS__
 function readLexicalVersion() {
@@ -30434,9 +30434,9 @@ function getActiveElementDeep(root) {
 function getComposedEventTarget(event) {
   const target = event.target;
   if (target !== null && isHTMLElement(target) && target.shadowRoot !== null && typeof event.composedPath === "function") {
-    const path19 = event.composedPath();
-    if (path19.length > 0) {
-      return path19[0];
+    const path20 = event.composedPath();
+    if (path20.length > 0) {
+      return path20[0];
     }
   }
   return target;
@@ -40532,10 +40532,10 @@ function _loadWasmModule(sync, filepath, src, imports2) {
   var buf = null;
   var isNode2 = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
   if (filepath && isNode2) {
-    var fs23 = null;
-    var path19 = null;
+    var fs25 = null;
+    var path20 = null;
     return new Promise((resolve, reject) => {
-      fs23.readFile(path19.resolve(__dirname, filepath), (error, buffer) => {
+      fs25.readFile(path20.resolve(__dirname, filepath), (error, buffer) => {
         if (error != null) {
           reject(error);
         } else {
@@ -41838,10 +41838,10 @@ var LoroDoc = class _LoroDoc {
    * @param {string} path
    * @returns {Value | Container | undefined}
    */
-  getByPath(path19) {
+  getByPath(path20) {
     try {
       const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-      const ptr0 = passStringToWasm0(path19, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+      const ptr0 = passStringToWasm0(path20, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
       const len0 = WASM_VECTOR_LEN;
       wasm.lorodoc_getByPath(retptr, this.__wbg_ptr, ptr0, len0);
       var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -84952,15 +84952,18 @@ function isCloudRecord(value) {
 function normalize(raw) {
   const config = defaults();
   if (typeof raw !== "object" || raw === null) return config;
+  const { autoPublish } = raw;
+  if (typeof autoPublish === "boolean") config.autoPublish = autoPublish;
   const artifacts = raw.artifacts;
   if (typeof artifacts !== "object" || artifacts === null) return config;
   for (const [key2, value] of Object.entries(artifacts)) {
     if (typeof value !== "object" || value === null) continue;
-    const { visibility, cloud } = value;
+    const { visibility, cloud, autoPublish: autoPublish2 } = value;
     if (visibility !== void 0 && !isVisibility(visibility)) continue;
     const entry = {};
     if (visibility) entry.visibility = visibility;
     if (isCloudRecord(cloud)) entry.cloud = { id: cloud.id, url: cloud.url, publishedAt: cloud.publishedAt, visibility: cloud.visibility };
+    if (autoPublish2 === false) entry.autoPublish = false;
     config.artifacts[key2] = entry;
   }
   return config;
@@ -85003,10 +85006,20 @@ function updateArtifactConfig(file, key2, patch) {
   if (patch.visibility) entry.visibility = patch.visibility;
   if (patch.cloud === null) delete entry.cloud;
   else if (patch.cloud) entry.cloud = patch.cloud;
+  if (patch.autoPublish === null) delete entry.autoPublish;
+  else if (patch.autoPublish === false) entry.autoPublish = false;
   config.artifacts[key2] = entry;
   writeJsonAtomic(file, config);
   return entry;
 }
+function setProjectAutoPublish(file, value) {
+  const { config, warning } = readConfig(file);
+  if (warning) throw new Error(warning);
+  if (value === null) delete config.autoPublish;
+  else config.autoPublish = value;
+  import_node_fs12.default.mkdirSync(import_node_path12.default.dirname(file), { recursive: true });
+  writeJsonAtomic(file, config);
+}
 
 // src/server/avatars.ts
 var import_node_crypto3 = require("node:crypto");
@@ -85133,7 +85146,7 @@ function callbackPage(result) {
   const body = result.ok ? `<p class="status">${CIRCLE_CHECK}\u5DF2\u8FDE\u63A5 Ryugi Cloud</p>
       <h1>\u5DF2\u767B\u5F55<em>${escapeHtml(result.login)}</em></h1>
       <p class="lead">\u8FD9\u53F0\u7535\u8111\u4E0A\u7684 Ryugi \u73B0\u5728\u53EF\u4EE5\u53D1\u5E03 artifact \u4E86\u3002</p>
-      <ul class="rows">${row("\u5728 Ryugi \u9875\u9762\u91CC\u53D1\u5E03\u7684\uFF1F", "\u56DE\u5230 Ryugi\uFF0C\u5206\u4EAB\u9762\u677F\u4F1A\u81EA\u52A8\u5237\u65B0\u3002")}${row("\u8BA9 agent \u53D1\u5E03\u7684\uFF1F", "\u8BA9\u5B83\u518D\u8FD0\u884C\u4E00\u6B21\u53D1\u5E03\u547D\u4EE4\u3002")}</ul>` : `<p class="status">${CIRCLE_ALERT}\u672A\u8FDE\u63A5</p>
+      <ul class="rows">${row("\u5728 Ryugi \u9875\u9762\u91CC\u53D1\u5E03\u7684\uFF1F", "\u56DE\u5230 Ryugi\uFF0C\u5206\u4EAB\u9762\u677F\u4F1A\u81EA\u52A8\u5237\u65B0\u3002")}${row("\u8BA9 agent \u53D1\u5E03\u7684\uFF1F", "\u8BA9\u5B83\u518D\u8FD0\u884C\u4E00\u6B21\u53D1\u5E03\u547D\u4EE4\u3002")}${result.autoPublish ? row("\u81EA\u52A8\u53D1\u5E03\u5DF2\u6253\u5F00", "agent \u6BCF\u8F6E\u7ED3\u675F\u540E\uFF0C\u6539\u8FC7\u7684 artifact \u4F1A\u4EE5\u79C1\u5BC6\u65B9\u5F0F\u540C\u6B65\u5230 Ryugi Cloud\u3002\u5173\u95ED\uFF1A\u8FD0\u884C <code>ryugi-artifacts config --auto-publish off</code>\u3002") : ""}</ul>` : `<p class="status">${CIRCLE_ALERT}\u672A\u8FDE\u63A5</p>
       <h1>\u767B\u5F55\u6CA1\u6709\u5B8C\u6210</h1>
       <p class="lead">${escapeHtml(result.detail)}</p>
       <ul class="rows">${row("\u91CD\u65B0\u767B\u5F55", "\u56DE\u5230 Ryugi\uFF0C\u5728\u5206\u4EAB\u9762\u677F\u91CC\u518D\u70B9\u4E00\u6B21\u300C\u767B\u5F55\u300D\u3002")}</ul>`;
@@ -85259,12 +85272,39 @@ function withCloudRuntime(type, files) {
   );
 }
 
+// src/server/settings.ts
+var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_path16 = __toESM(require("node:path"), 1);
+var settingsFileFor = (credentialsFile2) => import_node_path16.default.join(import_node_path16.default.dirname(credentialsFile2), "config.json");
+function readSettings(file) {
+  try {
+    const raw = JSON.parse(import_node_fs16.default.readFileSync(file, "utf8"));
+    return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
+  } catch {
+    return {};
+  }
+}
+function readGlobalAutoPublish(file) {
+  const value = readSettings(file).autoPublish;
+  return typeof value === "boolean" ? value : void 0;
+}
+function writeGlobalAutoPublish(file, value) {
+  import_node_fs16.default.mkdirSync(import_node_path16.default.dirname(file), { recursive: true, mode: 448 });
+  writeJsonAtomic(file, { ...readSettings(file), autoPublish: value });
+}
+function defaultGlobalAutoPublish(file) {
+  if (readGlobalAutoPublish(file) === void 0) writeGlobalAutoPublish(file, true);
+}
+function autoPublishEnabled({ globalFile, projectFile }) {
+  return readConfig(projectFile).config.autoPublish ?? readGlobalAutoPublish(globalFile) ?? false;
+}
+
 // src/server/cloud.ts
 var LOGIN_STATE_TTL_MS = 10 * 60 * 1e3;
 var UPLOAD_CONCURRENCY = 6;
 var MAX_JSON_BODY = 4096;
 var CLOUD_ID = /^[A-Za-z0-9_-]{1,64}$/;
-var ROUTE = /^\/api\/cloud\/(status|login|logout|artifacts|publish|visibility)(?:\/([^/]+)(?:\/([^/]+))?)?$/;
+var ROUTE = /^\/api\/cloud\/(status|login|logout|artifacts|publish|visibility|auto-publish)(?:\/([^/]+)(?:\/([^/]+))?)?$/;
 var SignedOut = class extends Error {
 };
 var CloudRefused = class extends Error {
@@ -85274,6 +85314,15 @@ var CloudRefused = class extends Error {
   }
   status;
 };
+var CloudCopyGone = class extends Error {
+};
+var CreateRefused = class extends CloudRefused {
+  constructor(detail) {
+    super(502, `cloud refused (403): ${detail}`);
+    this.detail = detail;
+  }
+  detail;
+};
 async function readJsonBody(req) {
   const chunks = [];
   let size = 0;
@@ -85298,7 +85347,13 @@ async function errorMessage(res) {
   }
 }
 function createCloudRoutes(options) {
-  const { origin, credentialsFile: credentialsFile2, configFile } = options;
+  const { origin, credentialsFile: credentialsFile2, configFile, project } = options;
+  const settingsFile = settingsFileFor(credentialsFile2);
+  const autoPublishState = () => ({
+    global: readGlobalAutoPublish(settingsFile) ?? null,
+    project: readConfig(configFile).config.autoPublish ?? null,
+    enabled: !!readCredentials(credentialsFile2, origin) && autoPublishEnabled({ globalFile: settingsFile, projectFile: configFile })
+  });
   const pendingStates = /* @__PURE__ */ new Map();
   const loginUrl = () => {
     const now = Date.now();
@@ -85309,7 +85364,7 @@ function createCloudRoutes(options) {
     const challenge = import_node_crypto4.default.createHash("sha256").update(verifier).digest("base64url");
     return `${origin}/auth/cli?port=${options.port()}&state=${state}&challenge=${challenge}`;
   };
-  const cloudFetch = async (method, path19, body) => {
+  const cloudFetch = async (method, path20, body) => {
     const credentials = readCredentials(credentialsFile2, origin);
     if (!credentials) throw new SignedOut();
     const headers = { Authorization: `Bearer ${credentials.token}` };
@@ -85323,7 +85378,7 @@ function createCloudRoutes(options) {
     }
     let res;
     try {
-      res = await fetch(`${origin}${path19}`, { method, headers, body: payload });
+      res = await fetch(`${origin}${path20}`, { method, headers, body: payload });
     } catch (err) {
       throw new CloudRefused(502, `could not reach ${origin}: ${err.message}`);
     }
@@ -85335,7 +85390,18 @@ function createCloudRoutes(options) {
     return res;
   };
   const artifactEntry = (key2) => readConfig(configFile).config.artifacts[key2] ?? {};
-  const publish = async (ref, requested) => {
+  const locks = /* @__PURE__ */ new Map();
+  const serialized = (key2, task) => {
+    const run2 = (locks.get(key2) ?? Promise.resolve()).then(task, task);
+    const tail = run2.catch(() => void 0);
+    locks.set(key2, tail);
+    void tail.then(() => {
+      if (locks.get(key2) === tail) locks.delete(key2);
+    });
+    return run2;
+  };
+  const keyOfCloudId = (cloudId) => Object.entries(readConfig(configFile).config.artifacts).find(([, entry]) => entry.cloud?.id === cloudId)?.[0] ?? `cloud:${cloudId}`;
+  const publish = async (ref, requested, { recreate = true } = {}) => {
     const inspected = await options.inspect(ref);
     if (!inspected) throw new CloudRefused(404, `${ref.type}/${ref.id} not found`);
     if (inspected.reasons.length > 0 || !inspected.payload) return { status: 409, body: { error: "fix these before publishing", reasons: inspected.reasons } };
@@ -85349,10 +85415,11 @@ function createCloudRoutes(options) {
     const entry = artifactEntry(key2);
     const hashed = files.map((file) => ({ ...file, hash: import_node_crypto4.default.createHash("sha256").update(file.data).digest("hex") }));
     const byHash = new Map(hashed.map((file) => [file.hash, file.data]));
-    const manifest = hashed.map(({ path: path19, hash }) => ({ path: path19, hash }));
-    const version = (visibility) => ({ title: inspected.title, payload: inspected.payload, files: manifest, ...visibility ? { visibility } : {} });
+    const manifest = hashed.map(({ path: path20, hash }) => ({ path: path20, hash }));
+    const version = (visibility) => ({ title: inspected.title, payload: inspected.payload, files: manifest, project, ...visibility ? { visibility } : {} });
     const create3 = async () => {
-      const res2 = await cloudFetch("POST", "/api/artifacts", { type: ref.type, visibility: requested ?? entry.visibility ?? "private" });
+      const res2 = await cloudFetch("POST", "/api/artifacts", { type: ref.type, visibility: requested ?? entry.visibility ?? "private", project });
+      if (res2.status === 403) throw new CreateRefused(await errorMessage(res2));
       const created = await (await expectOk(res2)).json();
       updateArtifactConfig(configFile, key2, {
         visibility: created.visibility,
@@ -85380,7 +85447,10 @@ function createCloudRoutes(options) {
       return cloudFetch("POST", `/api/artifacts/${id2}/versions`, version(visibility));
     };
     let res = entry.cloud ? await commit(entry.cloud.id, requested) : await commit(await create3(), void 0);
-    if (res.status === 404 && entry.cloud) res = await commit(await create3(), void 0);
+    if (res.status === 404 && entry.cloud) {
+      if (!recreate) throw new CloudCopyGone();
+      res = await commit(await create3(), void 0);
+    }
     const published = await (await expectOk(res)).json();
     updateArtifactConfig(configFile, key2, {
       visibility: published.visibility,
@@ -85414,7 +85484,29 @@ function createCloudRoutes(options) {
     const res = await cloudFetch("DELETE", `/api/artifacts/${cloudId}`);
     if (res.status !== 404) await expectOk(res);
     for (const [key2, entry] of Object.entries(readConfig(configFile).config.artifacts)) {
-      if (entry.cloud?.id === cloudId) updateArtifactConfig(configFile, key2, { cloud: null });
+      if (entry.cloud?.id === cloudId) updateArtifactConfig(configFile, key2, { cloud: null, autoPublish: false });
+    }
+  };
+  const autoPublish = (key2) => serialized(key2, () => autoPublishNow(key2));
+  const autoPublishNow = async (key2) => {
+    const ref = artifactKeyOf(key2);
+    if (!ref) return { kind: "gone" };
+    const entry = artifactEntry(key2);
+    if (entry.autoPublish === false) return { kind: "opted-out" };
+    try {
+      const result = await publish(ref, void 0, { recreate: false });
+      if (result.status !== 200) return { kind: "not-ready" };
+      return { kind: "published", created: result.body.id !== entry.cloud?.id };
+    } catch (err) {
+      if (err instanceof CloudCopyGone) {
+        updateArtifactConfig(configFile, key2, { cloud: null, autoPublish: false });
+        return { kind: "opted-out" };
+      }
+      if (err instanceof SignedOut) return { kind: "signed-out" };
+      if (err instanceof CreateRefused) return { kind: "cannot-create", message: err.detail };
+      if (err instanceof CloudRefused && err.status === 404) return { kind: "gone" };
+      if (err instanceof CloudRefused && err.status === 413) return { kind: "not-ready" };
+      return { kind: "failed", message: err.message };
     }
   };
   const route = async (req, res, match) => {
@@ -85424,7 +85516,7 @@ function createCloudRoutes(options) {
     if (action === "status" && method === "GET" && !first) {
       const credentials = readCredentials(credentialsFile2, origin);
       const { config, warning } = readConfig(configFile);
-      sendJson(res, 200, { signedIn: !!credentials, login: credentials?.login ?? null, origin, artifacts: config.artifacts, warning: warning ?? null });
+      sendJson(res, 200, { signedIn: !!credentials, login: credentials?.login ?? null, origin, artifacts: config.artifacts, autoPublish: autoPublishState(), warning: warning ?? null });
       return;
     }
     if (action === "login" && method === "POST" && !first) {
@@ -85448,20 +85540,30 @@ function createCloudRoutes(options) {
     }
     if (action === "artifacts" && method === "DELETE" && first && !second) {
       if (!CLOUD_ID.test(first)) throw new CloudRefused(400, "not a cloud artifact id");
-      await deleteCloud(first);
+      await serialized(keyOfCloudId(first), () => deleteCloud(first));
       sendJson(res, 200, { deleted: first });
       return;
     }
     if (action === "publish" && ref && method === "POST") {
       const body = await readJsonBody(req);
       if (body?.visibility !== void 0 && !isVisibility(body.visibility)) throw new CloudRefused(400, 'visibility must be "public" or "private"');
-      const result = await publish(ref, body?.visibility);
+      const key2 = `${ref.type}/${ref.id}`;
+      const requested = body?.visibility;
+      const result = await serialized(key2, async () => {
+        const published = await publish(ref, requested);
+        if (published.status === 200) updateArtifactConfig(configFile, key2, { autoPublish: null });
+        return published;
+      });
       sendJson(res, result.status, result.body);
       return;
     }
     if (action === "publish" && ref && method === "DELETE") {
-      const entry = artifactEntry(`${ref.type}/${ref.id}`);
-      if (entry.cloud) await deleteCloud(entry.cloud.id);
+      const key2 = `${ref.type}/${ref.id}`;
+      await serialized(key2, async () => {
+        const entry = artifactEntry(key2);
+        if (entry.cloud) await deleteCloud(entry.cloud.id);
+        updateArtifactConfig(configFile, key2, { autoPublish: false });
+      });
       sendJson(res, 200, { unpublished: `${ref.type}/${ref.id}` });
       return;
     }
@@ -85472,6 +85574,15 @@ function createCloudRoutes(options) {
       sendJson(res, 200, await setVisibility(ref, visibility));
       return;
     }
+    if (action === "auto-publish" && method === "POST" && !first) {
+      const body = await readJsonBody(req);
+      const value = body?.value;
+      if (body?.scope === "global" && typeof value === "boolean") writeGlobalAutoPublish(settingsFile, value);
+      else if (body?.scope === "project" && (typeof value === "boolean" || value === null)) setProjectAutoPublish(configFile, value);
+      else throw new CloudRefused(400, 'send {"scope":"global","value":true|false} or {"scope":"project","value":true|false|null}');
+      sendJson(res, 200, autoPublishState());
+      return;
+    }
     send(res, 404, "Not found");
   };
   return {
@@ -85506,9 +85617,13 @@ function createCloudRoutes(options) {
         return;
       }
       writeCredentials(credentialsFile2, { origin, token: issued.token, login: issued.login });
-      page(200, { ok: true, login: issued.login });
+      defaultGlobalAutoPublish(settingsFile);
+      page(200, { ok: true, login: issued.login, autoPublish: autoPublishState().enabled });
     },
     match: (pathname) => ROUTE.exec(pathname),
+    autoPublish,
+    autoPublishEnabled: () => autoPublishState().enabled,
+    token: () => readCredentials(credentialsFile2, origin)?.token ?? null,
     async handle(req, res, match) {
       try {
         await route(req, res, match);
@@ -85528,7 +85643,7 @@ function createCloudRoutes(options) {
 
 // src/server/comment-names.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_fs17 = __toESM(require("node:fs"), 1);
 
 // src/server/agent.ts
 var NAMES = {
@@ -85609,7 +85724,7 @@ function commentNames({ agentFile, projectDir, cloud }) {
     },
     agent: () => {
       try {
-        return detectAgent(JSON.parse(import_node_fs16.default.readFileSync(agentFile, "utf8")));
+        return detectAgent(JSON.parse(import_node_fs17.default.readFileSync(agentFile, "utf8")));
       } catch {
         return void 0;
       }
@@ -85636,26 +85751,117 @@ function viewerPage(template, page) {
 </head>`);
 }
 
+// src/server/auto-publish.ts
+var import_node_crypto5 = __toESM(require("node:crypto"), 1);
+var import_node_fs18 = __toESM(require("node:fs"), 1);
+var SIGNED_OUT_MESSAGE = "auto-publish paused: the Ryugi Cloud sign-in expired";
+function isNotice(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const { id: id2, kind, message } = value;
+  return typeof id2 === "string" && (kind === "signed-out" || kind === "cap") && typeof message === "string";
+}
+function readAutoPublishState(file) {
+  let raw = {};
+  try {
+    const parsed = JSON.parse(import_node_fs18.default.readFileSync(file, "utf8"));
+    if (typeof parsed === "object" && parsed !== null) raw = parsed;
+  } catch {
+  }
+  const dirty = Array.isArray(raw.dirty) ? raw.dirty.filter((key2) => typeof key2 === "string") : [];
+  const paused = raw.paused;
+  return {
+    dirty,
+    notice: isNotice(raw.notice) ? raw.notice : null,
+    paused: paused && (typeof paused.token === "string" || paused.token === null) ? { token: paused.token } : null
+  };
+}
+function createAutoPublisher(options) {
+  const saved = readAutoPublishState(options.stateFile);
+  const dirty = new Set(saved.dirty);
+  let notice = saved.notice;
+  let paused = saved.paused;
+  const remarked = /* @__PURE__ */ new Set();
+  const save = () => writeJsonAtomic(options.stateFile, { dirty: [...dirty], notice, paused });
+  const raise = (kind, message) => {
+    if (notice?.kind !== kind) notice = { id: import_node_crypto5.default.randomUUID(), kind, message };
+  };
+  const run2 = async () => {
+    if (!options.enabled() || dirty.size === 0) return;
+    const token = options.token();
+    if (paused && paused.token === token) return;
+    if (paused) {
+      paused = null;
+      if (notice?.kind === "signed-out") notice = null;
+    }
+    for (const key2 of [...dirty]) {
+      remarked.delete(key2);
+      const outcome = await options.publish(key2);
+      if (outcome.kind === "signed-out") {
+        paused = { token };
+        raise("signed-out", SIGNED_OUT_MESSAGE);
+        break;
+      }
+      if (outcome.kind === "published") {
+        if (!remarked.has(key2)) dirty.delete(key2);
+        if (outcome.created && notice?.kind === "cap") notice = null;
+      } else if (outcome.kind === "opted-out" || outcome.kind === "gone") {
+        dirty.delete(key2);
+      } else if (outcome.kind === "cannot-create") {
+        raise("cap", outcome.message);
+      }
+    }
+    save();
+  };
+  let running = null;
+  let queued = null;
+  const flush = () => {
+    if (!running) {
+      running = run2().catch((err) => console.error(JSON.stringify({ type: "auto-publish-error", error: err.message }))).finally(() => {
+        running = null;
+      });
+      return running;
+    }
+    queued ??= running.then(() => {
+      queued = null;
+      return flush();
+    });
+    return queued;
+  };
+  return {
+    changed(key2) {
+      if (!options.enabled()) return;
+      dirty.add(key2);
+      remarked.add(key2);
+      save();
+    },
+    removed(key2) {
+      if (!dirty.delete(key2)) return;
+      save();
+    },
+    flush
+  };
+}
+
 // src/server/watch.ts
-var import_node_fs17 = __toESM(require("node:fs"), 1);
-var import_node_path16 = __toESM(require("node:path"), 1);
-var toPosix = (file) => file.split(import_node_path16.default.sep).join("/");
+var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
+var toPosix = (file) => file.split(import_node_path17.default.sep).join("/");
 var ignored = (file) => file === ".state" || file.startsWith(".state/");
 function snapshot(root, dir = root, out = /* @__PURE__ */ new Map()) {
   let entries2;
   try {
-    entries2 = import_node_fs17.default.readdirSync(dir, { withFileTypes: true });
+    entries2 = import_node_fs19.default.readdirSync(dir, { withFileTypes: true });
   } catch {
     return out;
   }
   for (const entry of entries2) {
-    const full = import_node_path16.default.join(dir, entry.name);
-    const rel = toPosix(import_node_path16.default.relative(root, full));
+    const full = import_node_path17.default.join(dir, entry.name);
+    const rel = toPosix(import_node_path17.default.relative(root, full));
     if (ignored(rel)) continue;
     if (entry.isDirectory()) snapshot(root, full, out);
     else {
       try {
-        out.set(rel, import_node_fs17.default.statSync(full).mtimeMs);
+        out.set(rel, import_node_fs19.default.statSync(full).mtimeMs);
       } catch {
       }
     }
@@ -85688,7 +85894,7 @@ function watchTree(root, onChange, debounceMs = 120, backupPollMs = 1e3) {
     }, debounceMs);
   };
   try {
-    const watcher = import_node_fs17.default.watch(root, { recursive: true }, (_event, filename) => {
+    const watcher = import_node_fs19.default.watch(root, { recursive: true }, (_event, filename) => {
       if (filename) queue([toPosix(filename.toString())]);
     });
     watcher.on("error", () => {
@@ -85713,7 +85919,7 @@ function watchTree(root, onChange, debounceMs = 120, backupPollMs = 1e3) {
 }
 
 // src/server/ws.ts
-var import_node_crypto5 = __toESM(require("node:crypto"), 1);
+var import_node_crypto6 = __toESM(require("node:crypto"), 1);
 var WS_MAGIC = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
 var OPCODE_TEXT = 1;
 var OPCODE_CLOSE = 8;
@@ -85721,7 +85927,7 @@ var OPCODE_PING = 9;
 var OPCODE_PONG = 10;
 var MAX_CLIENT_FRAME = 8 * 1024 * 1024;
 function acceptKey(clientKey) {
-  return import_node_crypto5.default.createHash("sha1").update(clientKey + WS_MAGIC).digest("base64");
+  return import_node_crypto6.default.createHash("sha1").update(clientKey + WS_MAGIC).digest("base64");
 }
 function encodeFrame(opcode, payload) {
   const len = payload.length;
@@ -85840,17 +86046,17 @@ function titleOf(payload, ref) {
   return payload.canvas?.title || ref.id;
 }
 async function startArtifactsServer(options) {
-  const root = import_node_path17.default.resolve(options.root);
-  const viewerDir = import_node_path17.default.resolve(options.viewerDir);
-  const runtimeDir = options.runtimeDir ? import_node_path17.default.resolve(options.runtimeDir) : null;
-  const stateDir = import_node_path17.default.join(root, ".state");
-  import_node_fs18.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
-  import_node_fs18.default.writeFileSync(import_node_path17.default.join(stateDir, ".gitignore"), "*\n");
+  const root = import_node_path18.default.resolve(options.root);
+  const viewerDir = import_node_path18.default.resolve(options.viewerDir);
+  const runtimeDir = options.runtimeDir ? import_node_path18.default.resolve(options.runtimeDir) : null;
+  const stateDir = import_node_path18.default.join(root, ".state");
+  import_node_fs20.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
+  import_node_fs20.default.writeFileSync(import_node_path18.default.join(stateDir, ".gitignore"), "*\n");
   if (options.configFile) ensureConfig(options.configFile);
-  const portFile = import_node_path17.default.join(stateDir, ".last-port");
-  const tokenFile = import_node_path17.default.join(stateDir, ".last-token");
+  const portFile = import_node_path18.default.join(stateDir, ".last-port");
+  const tokenFile = import_node_path18.default.join(stateDir, ".last-token");
   const token = readPersisted(tokenFile) || randomToken();
-  import_node_fs18.default.writeFileSync(tokenFile, `${token}
+  import_node_fs20.default.writeFileSync(tokenFile, `${token}
 `, { mode: 384 });
   const contentToken = randomToken();
   const runtimeWarnings = /* @__PURE__ */ new Map();
@@ -85871,7 +86077,7 @@ async function startArtifactsServer(options) {
     for (const socket of clients) socket.write(frame);
   };
   const avatars = createAvatars(options.fetch);
-  const names = commentNames({ agentFile: import_node_path17.default.join(stateDir, "agent"), projectDir: import_node_path17.default.resolve(root, "../.."), cloud: options.cloud });
+  const names = commentNames({ agentFile: import_node_path18.default.join(stateDir, "agent"), projectDir: import_node_path18.default.resolve(root, "../.."), cloud: options.cloud });
   const documents = createDocumentRegistry({
     root,
     stateDir,
@@ -85909,7 +86115,8 @@ async function startArtifactsServer(options) {
     }
     return { dir, title, reasons, payload: published };
   };
-  const cloud = options.cloud && options.configFile ? createCloudRoutes({ ...options.cloud, configFile: options.configFile, port: () => port, inspect }) : null;
+  const cloud = options.cloud && options.configFile ? createCloudRoutes({ ...options.cloud, configFile: options.configFile, project: import_node_path18.default.basename(import_node_path18.default.resolve(root, "../..")), port: () => port, inspect }) : null;
+  const autoPublisher = cloud ? createAutoPublisher({ stateFile: import_node_path18.default.join(stateDir, "auto-publish.json"), enabled: cloud.autoPublishEnabled, token: cloud.token, publish: cloud.autoPublish }) : null;
   const sameOrigin = (req) => {
     const origin2 = req.headers.origin;
     const host = req.headers.host ?? "";
@@ -85987,7 +86194,7 @@ async function startArtifactsServer(options) {
   };
   const blockIdsOf = async (id2, dir) => {
     await (await documents.open(id2))?.flush();
-    const state = parseDocument2(import_node_fs18.default.readFileSync(import_node_path17.default.join(dir, "doc.xml"), "utf8"));
+    const state = parseDocument2(import_node_fs20.default.readFileSync(import_node_path18.default.join(dir, "doc.xml"), "utf8"));
     return new Set(state.root.children.flatMap((block) => block.$?.blockId ? [block.$.blockId] : []));
   };
   const serveAgentComments = async (req, res, id2) => {
@@ -86067,7 +86274,7 @@ async function startArtifactsServer(options) {
       sendFile(res, target, headers);
       return;
     }
-    import_node_fs18.default.readFile(target, "utf8", (err, source) => {
+    import_node_fs20.default.readFile(target, "utf8", (err, source) => {
       if (err) send(res, 404, "Not found");
       else {
         const uiRuntimeUrl = runtimeDir ? `${contentPrefix}runtime/ryugi-ui.js` : void 0;
@@ -86092,7 +86299,7 @@ async function startArtifactsServer(options) {
       title: titleOf(readArtifact(entry.dir, entry), entry),
       updatedAt: latestMtime(entry.dir)
     }));
-    sendJson(res, 200, { project: import_node_path17.default.basename(import_node_path17.default.dirname(import_node_path17.default.dirname(root))), artifacts: summaries, warnings });
+    sendJson(res, 200, { project: import_node_path18.default.basename(import_node_path18.default.dirname(import_node_path18.default.dirname(root))), artifacts: summaries, warnings });
   };
   function onClientText(socket, text2) {
     let message;
@@ -86152,7 +86359,7 @@ async function startArtifactsServer(options) {
       return;
     }
     if (pathname === "/robots.txt") {
-      sendFile(res, import_node_path17.default.join(viewerDir, "robots.txt"));
+      sendFile(res, import_node_path18.default.join(viewerDir, "robots.txt"));
       return;
     }
     if (pathname.startsWith("/c/")) {
@@ -86201,6 +86408,19 @@ async function startArtifactsServer(options) {
       }
       return;
     }
+    if (pathname === "/api/cloud/flush") {
+      if (req.method !== "POST" || key2 === null || !safeEqual(key2, token)) {
+        send(res, 403, "Forbidden: agent calls need ?key=");
+        return;
+      }
+      if (!autoPublisher) sendJson(res, 404, { error: "cloud publishing is not configured" });
+      else if (url2.searchParams.get("wait") === "1") void autoPublisher.flush().then(() => sendJson(res, 200, { flushed: true }));
+      else {
+        void autoPublisher.flush();
+        sendJson(res, 202, { queued: true });
+      }
+      return;
+    }
     const cloudMatch = cloud?.match(pathname);
     if (cloud && cloudMatch) {
       if (req.method !== "GET" && !(key2 !== null && safeEqual(key2, token)) && !sameOrigin(req)) {
@@ -86236,7 +86456,7 @@ async function startArtifactsServer(options) {
     if (SHELL_ROUTE.test(pathname) || PREVIEW_ROUTE.test(pathname) || pathname === "/index.html") {
       const ref = artifactKeyOf(pathname.replace(/^\/(?:preview\/)?/, "").replace(/\/$/, ""));
       const dir = ref && resolveArtifactDir(root, ref.type, ref.id);
-      const project = import_node_path17.default.basename(import_node_path17.default.dirname(import_node_path17.default.dirname(root)));
+      const project = import_node_path18.default.basename(import_node_path18.default.dirname(import_node_path18.default.dirname(root)));
       const title = ref ? dir ? titleOf(readArtifact(dir, ref), ref) : ref.id : `${project} \xB7 Artifacts`;
       const description = ref ? `\u5728 ${project} \u9879\u76EE\u4E2D\u67E5\u770B ${title}\uFF0C\u8FD9\u662F\u4E00\u4E2A ${ref.type === "artboard" ? "Artboard" : ref.type === "document" ? "Document" : "HTML"} Artifact\u3002` : `\u6D4F\u89C8 ${project} \u9879\u76EE\u7684\u5168\u90E8 Artboard\u3001Document \u548C HTML Artifact\uFF0C\u9884\u89C8\u771F\u5B9E\u5185\u5BB9\uFF0C\u6309\u7C7B\u578B\u3001\u540D\u79F0\u548C\u66F4\u65B0\u65F6\u95F4\u67E5\u627E\u4F5C\u54C1\u3002`;
       const canonical = `http://${urlHostForHttp(options.urlHost)}:${port}/${ref ? `${ref.type}/${ref.id}` : ""}`;
@@ -86245,7 +86465,7 @@ async function startArtifactsServer(options) {
         "Content-Security-Policy": PREVIEW_ROUTE.test(pathname) ? VIEWER_CSP.replace("frame-ancestors 'none'", "frame-ancestors 'self'") : VIEWER_CSP
       };
       if (key2 !== null) headers["Set-Cookie"] = `${cookieName}=${token}; HttpOnly; SameSite=Strict; Path=/`;
-      void import_node_fs18.default.promises.readFile(import_node_path17.default.join(viewerDir, "index.html"), "utf8").then((template) => send(res, 200, viewerPage(template, { title, description, url: canonical }), headers)).catch((err) => send(res, err.code === "ENOENT" ? 404 : 500, "Viewer unavailable"));
+      void import_node_fs20.default.promises.readFile(import_node_path18.default.join(viewerDir, "index.html"), "utf8").then((template) => send(res, 200, viewerPage(template, { title, description, url: canonical }), headers)).catch((err) => send(res, err.code === "ENOENT" ? 404 : 500, "Viewer unavailable"));
       return;
     }
     const target = resolveInside(viewerDir, pathname.slice(1));
@@ -86292,7 +86512,7 @@ async function startArtifactsServer(options) {
     port = await listen(server, options.host, 0);
   }
   cookieName = `ryugi_artifacts_${port}`;
-  import_node_fs18.default.writeFileSync(portFile, `${port}
+  import_node_fs20.default.writeFileSync(portFile, `${port}
 `, { mode: 384 });
   const origin = `http://${urlHostForHttp(options.urlHost)}:${port}`;
   const url = `${origin}/?key=${token}`;
@@ -86318,7 +86538,7 @@ async function startArtifactsServer(options) {
     initialChanges.push({ ref: entry, payload, files: [] });
     if (entry.type === "document") void documents.open(entry.id);
   }
-  writeJsonAtomic(import_node_path17.default.join(stateDir, "server-info"), { type: "server-started", url, port, root });
+  writeJsonAtomic(import_node_path18.default.join(stateDir, "server-info"), { type: "server-started", url, port, root });
   const watcher = watchTree(
     root,
     (files) => {
@@ -86336,6 +86556,7 @@ async function startArtifactsServer(options) {
         const dir = resolveArtifactDir(root, ref.type, ref.id);
         if (!dir) {
           signatures.delete(key2);
+          autoPublisher?.removed(key2);
           const frame2 = textFrame(JSON.stringify({ type: "change", artifact: key2, files: changed }));
           for (const socket of clients) socket.write(frame2);
           continue;
@@ -86343,6 +86564,7 @@ async function startArtifactsServer(options) {
         if (ref.type === "document" && (changed.includes("doc.xml") || changed.length === 0)) documents.fileChanged(ref.id);
         if (ref.type === "document" && changed.includes("comments.json")) documents.commentsChanged(ref.id);
         if (signatures.get(key2) === artifactSignature(dir)) continue;
+        autoPublisher?.changed(key2);
         runtimeWarnings.delete(key2);
         const payload = refreshState(ref, dir);
         const frame = textFrame(JSON.stringify({ type: "change", artifact: key2, files: changed }));
@@ -86376,7 +86598,7 @@ async function startArtifactsServer(options) {
 }
 
 // src/server/lifecycle.ts
-var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
 var DEFAULT_IDLE_TIMEOUT_MS = 4 * 60 * 60 * 1e3;
 var DEFAULT_LIFECYCLE_CHECK_MS = 60 * 1e3;
 var SERVER_ID_ARG = "--artifacts-server-id=";
@@ -86408,7 +86630,7 @@ function parseEnv(env, argv = []) {
 function readOwners(file) {
   let text2;
   try {
-    text2 = import_node_fs19.default.readFileSync(file, "utf8");
+    text2 = import_node_fs21.default.readFileSync(file, "utf8");
   } catch {
     return [];
   }
@@ -86473,15 +86695,15 @@ function openReady(payload) {
 // src/server/main.ts
 async function main() {
   const config = parseEnv(process.env, process.argv.slice(2));
-  const root = import_node_path18.default.resolve(config.root);
-  const stateDir = import_node_path18.default.join(root, ".state");
+  const root = import_node_path19.default.resolve(config.root);
+  const stateDir = import_node_path19.default.join(root, ".state");
   const server = await startArtifactsServer({
     root,
-    viewerDir: import_node_path18.default.join(__dirname, "viewer"),
-    runtimeDir: import_node_path18.default.join(__dirname, "runtime"),
+    viewerDir: import_node_path19.default.join(__dirname, "viewer"),
+    runtimeDir: import_node_path19.default.join(__dirname, "runtime"),
     host: config.host,
     urlHost: config.urlHost,
-    configFile: import_node_path18.default.join(import_node_path18.default.dirname(root), "config.json"),
+    configFile: import_node_path19.default.join(import_node_path19.default.dirname(root), "config.json"),
     cloud: { origin: config.cloudOrigin, credentialsFile: credentialsFile(process.env, process.platform, import_node_os.default.homedir()) }
   });
   let lastActivity = Date.now();
@@ -86510,12 +86732,12 @@ async function main() {
     if (stopping) return;
     stopping = true;
     console.log(JSON.stringify({ type: "server-stopped", reason }));
-    import_node_fs20.default.rmSync(import_node_path18.default.join(stateDir, "server-info"), { force: true });
-    writeJsonAtomic(import_node_path18.default.join(stateDir, "server-stopped"), { reason, timestamp: Date.now() });
+    import_node_fs22.default.rmSync(import_node_path19.default.join(stateDir, "server-info"), { force: true });
+    writeJsonAtomic(import_node_path19.default.join(stateDir, "server-stopped"), { reason, timestamp: Date.now() });
     await server.close();
     process.exit(0);
   };
-  const ownersFile = import_node_path18.default.join(stateDir, "owners");
+  const ownersFile = import_node_path19.default.join(stateDir, "owners");
   const timer = setInterval(() => {
     const owners = readOwners(ownersFile);
     const reason = shutdownReason({
@@ -86529,7 +86751,7 @@ async function main() {
   timer.unref();
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
   process.on("SIGINT", () => void shutdown("SIGINT"));
-  import_node_fs20.default.rmSync(import_node_path18.default.join(stateDir, "server-stopped"), { force: true });
+  import_node_fs22.default.rmSync(import_node_path19.default.join(stateDir, "server-stopped"), { force: true });
   console.log(JSON.stringify({ type: "server-started", url: server.url, port: server.port, root }));
 }
 main().catch((err) => {