feat: release Find-Word v0.2.3

scripts/check-build.mjs

@@ -1,7 +1,8 @@
-import { readFileSync } from "node:fs";
+import { readFileSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { ENVIRONMENTS, PATTERNS, WORDS } from "../src/content.ts";
 
 // 빌드가 성공해도 public 파일이 빠지면 게임은 실행 중 실패한다. 따라서 배포
 // 폴더 자체의 파일 해시를 원본 manifest와 비교하는 계약을 빌드 마지막에 둔다.
@@ -36,11 +37,128 @@ export function verifyBuild(directory) {
   );
   if (JSON.stringify(manifest) !== JSON.stringify(builtManifest))
     throw new Error("빌드 음성 목록이 원본과 다릅니다.");
+  // manifest끼리 일치해도 함께 축약될 수 있으므로 앱 콘텐츠에서 독립 재구성한다.
+  const expectedVoice = [
+    "intro.wav",
+    ...PATTERNS.flatMap((pattern) =>
+      WORDS.map((word) => `${pattern.id}-${word.id}.wav`),
+    ),
+  ].sort();
+  if (
+    expectedVoice.length !== 101 ||
+    manifest.files.length !== 101 ||
+    JSON.stringify(manifest.files.map((entry) => entry.file).sort()) !==
+      JSON.stringify(expectedVoice)
+  )
+    throw new Error("음성은 정확한 예상 목록 101개가 필요합니다.");
+  if (
+    JSON.stringify(readdirSync(resolve(directory, "audio")).sort()) !==
+    JSON.stringify([...expectedVoice, "manifest.json"].sort())
+  )
+    throw new Error("빌드 음성 파일 누락 또는 추가 파일");
   for (const entry of manifest.files) {
     const bytes = readFileSync(resolve(directory, "audio", entry.file));
     if (createHash("sha256").update(bytes).digest("hex") !== entry.sha256)
       throw new Error(`빌드 자산 해시 불일치: ${entry.file}`);
   }
+  // 현장음은 별도 라이선스가 있는 독립 자산이다. 누락뿐 아니라 큰 원본이
+  // 잘못 섞여 배포되는 경우도 디렉터리 파일 집합을 엄격히 비교해 차단한다.
+  try {
+    const source = readFileSync("public/ambience/manifest.json", "utf8");
+    if (
+      readFileSync(resolve(directory, "ambience/manifest.json"), "utf8") !==
+      source
+    )
+      throw new Error("manifest 불일치");
+    const ambience = JSON.parse(source);
+    const plan = JSON.parse(
+      readFileSync(".agent/AMBIENCE-SOURCES-v0.2.3.json", "utf8"),
+    );
+    if (
+      JSON.stringify(
+        ambience.files.map((entry) => entry.environmentId).sort(),
+      ) !== JSON.stringify(ENVIRONMENTS.map((entry) => entry.id).sort())
+    )
+      throw new Error("현장음 예상 환경 목록 불일치");
+    if (
+      ambience.files.length !== 8 ||
+      new Set(ambience.files.map((e) => e.sha256)).size !== 8
+    )
+      throw new Error("고유 녹음 8개가 필요합니다.");
+    const expected = [
+      ...ambience.files.map((e) => e.file),
+      "manifest.json",
+      "AMBIENCE_NOTICES.md",
+    ].sort();
+    if (
+      JSON.stringify(readdirSync(resolve(directory, "ambience")).sort()) !==
+      JSON.stringify(expected)
+    )
+      throw new Error("누락 또는 원본 파일 혼입");
+    const notice = readFileSync("public/ambience/AMBIENCE_NOTICES.md", "utf8");
+    if (
+      readFileSync(
+        resolve(directory, "ambience/AMBIENCE_NOTICES.md"),
+        "utf8",
+      ) !== notice
+    )
+      throw new Error("고지 불일치");
+    for (const entry of ambience.files) {
+      const bytes = readFileSync(resolve(directory, "ambience", entry.file));
+      if (
+        bytes.length !== entry.bytes ||
+        createHash("sha256").update(bytes).digest("hex") !== entry.sha256
+      )
+        throw new Error(`자산 해시 불일치: ${entry.file}`);
+      const approved = plan.assets.find(
+        (asset) => asset.environmentId === entry.environmentId,
+      );
+      if (
+        !approved ||
+        Object.entries(approved).some(
+          ([key, value]) =>
+            JSON.stringify(entry[key]) !== JSON.stringify(value),
+        ) ||
+        entry.file !== `${entry.environmentId}.wav` ||
+        entry.sourceSha256 !== approved.expectedSourceSha256 ||
+        entry.outputLicense !== approved.license ||
+        !Number.isFinite(approved.selectedSegmentStartSeconds) ||
+        approved.selectedSegmentStartSeconds < 0 ||
+        !Number.isFinite(approved.directMediaDurationSeconds) ||
+        approved.selectedSegmentStartSeconds + 12 >
+          approved.directMediaDurationSeconds ||
+        entry.conversion?.startSeconds !==
+          approved.selectedSegmentStartSeconds ||
+        entry.conversion?.durationSeconds !== 12 ||
+        entry.duration !== 12 ||
+        typeof entry.conversion?.operations !== "string" ||
+        !entry.conversion.operations.trim()
+      )
+        throw new Error(`승인 출처/변경 메타데이터 불일치: ${entry.file}`);
+      // 다른 항목에 같은 라이선스 URL이 있어도 이 항목의 누락을 가리지 못한다.
+      const sections = notice
+        .split("## ")
+        .filter((section) =>
+          section.startsWith(`${entry.displayName} — ${entry.environmentId}\n`),
+        );
+      const lines = sections[0]?.split("\n") ?? [];
+      if (
+        sections.length !== 1 ||
+        ![
+          entry.attribution,
+          `Creator: ${entry.creator}`,
+          `Source: ${entry.pageUrl}`,
+          `Download: ${entry.directUrl}`,
+          `License: ${entry.license} — ${entry.licenseUrl}`,
+          `Output license: ${entry.outputLicense}`,
+          `Changes: ${entry.conversion.operations}; source seconds ${entry.conversion.startSeconds}–${entry.conversion.startSeconds + entry.conversion.durationSeconds}.`,
+        ].every((line) => lines.includes(line))
+      )
+        throw new Error(`출처 고지 누락: ${entry.file}`);
+    }
+  } catch (cause) {
+    throw new Error("현장음 자산/manifest/notice 누락 또는 불일치", { cause });
+  }
   return manifest.files.length;
 }
 if (
@@ -48,6 +166,6 @@ if (
   import.meta.url === pathToFileURL(resolve(process.argv[1])).href
 ) {
   console.log(
-    `빌드 음성 자산 ${verifyBuild("dist")}개 및 런타임 notice 전문 확인`,
+    `빌드 음성 자산 ${verifyBuild("dist")}개 + 현장음 8개 및 런타임/현장음 notice 확인`,
   );
 }