fix(release): never roll the latest updater feed back to an older tag

scripts/ci/lib/latest-feed-guard.mjs

@@ -0,0 +1,126 @@
+// scripts/ci/lib/latest-feed-guard.mjs
+// latest feed(electron-updater alias) 보호 정책.
+//
+// 버전별 경로(<version>/)는 불변이라 어떤 순서로 게시돼도 안전하지만, latest/ 경로는
+// 모든 태그가 공유한다. 오래된 태그의 job이 늦게 끝나거나(재실행·GitLab mirror 재시도)
+// 하면 latest.yml과 update-policy.json이 이전 버전으로 되돌아간다. 이 모듈은
+//   1) 순수 정책 (버전 파싱·비교·게시 여부 결정)
+//   2) 이미 게시된 latest.yml을 읽는 IO 어댑터 (fetch 주입)
+// 를 분리해 publisher가 alias를 덮어쓰기 전에 판단할 수 있게 한다.
+
+const SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/;
+
+/**
+ * @param {string} value
+ * @returns {{ major: number, minor: number, patch: number, prerelease: string | null } | null}
+ */
+export function parseSemver(value) {
+  const match = SEMVER_PATTERN.exec(String(value ?? "").trim().replace(/^v/, ""));
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ?? null,
+  };
+}
+
+/**
+ * SemVer 비교. a<b → 음수, a=b → 0, a>b → 양수.
+ * 같은 core면 정식 버전이 prerelease보다 크다. 파싱할 수 없으면 예외.
+ * @param {string} a
+ * @param {string} b
+ */
+export function compareSemver(a, b) {
+  const left = parseSemver(a);
+  const right = parseSemver(b);
+  if (!left || !right) throw new Error(`Cannot compare non-semver versions: ${a} vs ${b}`);
+  for (const key of /** @type {const} */ (["major", "minor", "patch"])) {
+    if (left[key] !== right[key]) return left[key] - right[key];
+  }
+  if (left.prerelease === right.prerelease) return 0;
+  if (left.prerelease === null) return 1;
+  if (right.prerelease === null) return -1;
+  return left.prerelease < right.prerelease ? -1 : 1;
+}
+
+/**
+ * electron-builder update metadata(latest.yml)의 최상위 `version:` 값을 읽는다.
+ * @param {string} yamlText
+ * @returns {string | null}
+ */
+export function parseUpdateMetadataVersion(yamlText) {
+  const match = /^version:\s*["']?([^"'\s#]+)["']?\s*(?:#.*)?$/m.exec(String(yamlText ?? ""));
+  if (!match) return null;
+  return parseSemver(match[1]) ? match[1].replace(/^v/, "") : null;
+}
+
+/**
+ * latest alias(latest.yml + update-policy.json)를 갱신할지 결정하는 순수 정책.
+ *
+ * - 게시된 feed가 없음(publishedVersion === undefined) → 갱신 (첫 게시)
+ * - 게시된 latest.yml을 파싱할 수 없음(null) → 갱신 (깨진 feed는 복구 대상)
+ * - 게시된 버전 > 이번 버전 → 건너뜀 (이전 태그의 재실행/지연 완료가 되돌리는 것 방지)
+ * - 게시된 버전 = 이번 버전 → 갱신 (같은 태그 재실행: 부분 실패한 alias/policy 복구, 바이트 동일)
+ * - 게시된 버전 < 이번 버전 → 갱신
+ *
+ * @param {{ publishingVersion: string, publishedVersion: string | null | undefined }} input
+ * @returns {{ update: boolean, reason: "no-feed" | "unreadable-feed" | "newer-published" | "same-version" | "older-published" }}
+ */
+export function decideLatestFeedUpdate({ publishingVersion, publishedVersion }) {
+  if (!parseSemver(publishingVersion)) {
+    throw new Error(`Publishing version is not semver: ${publishingVersion}`);
+  }
+  if (publishedVersion === undefined) return { update: true, reason: "no-feed" };
+  if (publishedVersion === null || !parseSemver(publishedVersion)) {
+    return { update: true, reason: "unreadable-feed" };
+  }
+  const order = compareSemver(publishedVersion, publishingVersion);
+  if (order > 0) return { update: false, reason: "newer-published" };
+  if (order === 0) return { update: true, reason: "same-version" };
+  return { update: true, reason: "older-published" };
+}
+
+/**
+ * latest alias 갱신 유스케이스. IO는 포트로 주입받는다.
+ * 판단 결과가 "건너뜀"이면 어떤 파일도 업로드하지 않는다.
+ *
+ * @template T
+ * @param {{
+ *   publishingVersion: string,
+ *   files: readonly T[],
+ *   readPublishedVersion: () => Promise<string | null | undefined>,
+ *   upload: (file: T) => Promise<void>,
+ * }} input  files는 게시 순서대로 (설치 자산 → metadata → policy)
+ * @returns {Promise<{ update: boolean, reason: string, publishedVersion: string | null | undefined }>}
+ */
+export async function publishLatestAlias({ publishingVersion, files, readPublishedVersion, upload }) {
+  const publishedVersion = await readPublishedVersion();
+  const decision = decideLatestFeedUpdate({ publishingVersion, publishedVersion });
+  if (decision.update) {
+    for (const file of files) await upload(file);
+  }
+  return { ...decision, publishedVersion };
+}
+
+/**
+ * 이미 게시된 latest.yml의 버전을 읽는 IO 어댑터.
+ * - 404 → undefined (feed 없음)
+ * - 200 → 파싱된 버전 또는 null (파싱 불가)
+ * - 그 외 HTTP/네트워크 오류 → 예외 (fail-closed: 판단할 수 없으면 alias를 건드리지 않는다)
+ *
+ * @param {{ url: string, fetchImpl: (url: string, init?: RequestInit) => Promise<Response> }} deps
+ * @returns {Promise<string | null | undefined>}
+ */
+export async function readPublishedFeedVersion({ url, fetchImpl }) {
+  const separator = url.includes("?") ? "&" : "?";
+  const response = await fetchImpl(`${url}${separator}ts=${Date.now()}`, { cache: "no-store" });
+  if (response.status === 404) return undefined;
+  if (!response.ok) {
+    throw new Error(
+      `Cannot read the published latest feed (${url}): HTTP ${response.status}. ` +
+        "Refusing to overwrite the latest alias without knowing its version.",
+    );
+  }
+  return parseUpdateMetadataVersion(await response.text());
+}