@zalkera/client 0.21.1 → 0.21.3

package/bin/check-aeo-surfaces.mjs

@@ -113,7 +113,9 @@ const printOnly = argv.includes("--print-guarantees");
  */
 const siteWideOnly = argv.includes("--site-wide-only");
 if (!printOnly && !siteUrl) {
-    die("사용: zalkera-aeo-check <사이트URL> --category <코드> [--category …] [--code …] [--version …] [--out …]\n      무주장 사이트: zalkera-aeo-check <사이트URL> --site-wide-only\n      (잣대 해석만 확인: zalkera-aeo-check --print-guarantees)");
+    die(
+        "사용: zalkera-aeo-check <사이트URL> --category <코드> [--category …] [--code …] [--version …] [--out …]\n      무주장 사이트: zalkera-aeo-check <사이트URL> --site-wide-only\n      (잣대 해석만 확인: zalkera-aeo-check --print-guarantees)",
+    );
 }
 if (!printOnly && siteWideOnly && categories.length > 0) {
     // 둘 다 주면 어느 쪽을 원한 것인지 알 수 없다. 조용히 한쪽을 이기게 하면 "쟀다고 생각한 것"과
@@ -234,7 +236,9 @@ if (printOnly) {
     console.log(`· 경로 ${specPath}`);
     console.log(`· 보장표 rev ${spec.contractRev} · 카테고리 ${[...byCategory.keys()].join(", ")}`);
     if (carriedDrift) console.warn(`⚠️  ${carriedDrift}`);
-    console.log(`· 사이트 축(무주장) 검사 항목 ${(spec.siteWide?.requirements ?? []).map((r) => r.id).join(", ")} — \`--site-wide-only\``);
+    console.log(
+        `· 사이트 축(무주장) 검사 항목 ${(spec.siteWide?.requirements ?? []).map((r) => r.id).join(", ")} — \`--site-wide-only\``,
+    );
     console.log("· 잣대 해석 성공 — 이제 사이트 URL 과 --category(또는 --site-wide-only)를 주면 실제로 잽니다.");
     process.exit(0);
 }
@@ -243,7 +247,9 @@ for (const c of categories) {
     if (!byCategory.has(c)) {
         // 표에 없는 이름은 **순수 라벨**이다(예: "미니멀"). 보장 주장이 없으므로 잴 것도 없고,
         // 억지로 통과시킨 스냅샷을 만들면 promote 게이트가 의미를 잃는다.
-        die(`'${c}' 는 보장표에 없는 이름이라 검사 대상이 아니다(순수 라벨). 등재된 카테고리: ${[...byCategory.keys()].join(", ")}`);
+        die(
+            `'${c}' 는 보장표에 없는 이름이라 검사 대상이 아니다(순수 라벨). 등재된 카테고리: ${[...byCategory.keys()].join(", ")}`,
+        );
     }
 }
 
@@ -400,7 +406,9 @@ async function fetchText(path) {
     }
 }
 
-console.log(`· 대상 ${siteUrl} · ${siteWideOnly ? "무주장(사이트 축만)" : `카테고리 ${categories.join(", ")}`} · 보장표 rev ${spec.contractRev}`);
+console.log(
+    `· 대상 ${siteUrl} · ${siteWideOnly ? "무주장(사이트 축만)" : `카테고리 ${categories.join(", ")}`} · 보장표 rev ${spec.contractRev}`,
+);
 console.log(`· 잣대 출처 ${resolved.source} — ${specPath}`);
 if (carriedDrift) console.warn(`⚠️  ${carriedDrift}`);
 
@@ -435,7 +443,9 @@ const crawled = await crawlPages({
 });
 
 if (crawled.pages.size === 0) {
-    die(`크롤한 페이지가 0건이다 — 사이트가 응답하지 않는다.\n${crawled.fetchFailures.map((f) => `   · ${f}`).join("\n")}`);
+    die(
+        `크롤한 페이지가 0건이다 — 사이트가 응답하지 않는다.\n${crawled.fetchFailures.map((f) => `   · ${f}`).join("\n")}`,
+    );
 }
 
 /** 라우트 → {status, html, ld}. 못 받은 라우트는 여기 없다(= 부재). */
@@ -474,7 +484,11 @@ function judgeSurface(surface, bucket) {
 
     // 라우트가 없다 = 표면이 없다. 스킵이 아니라 미충족이다.
     if (target.kind === "MISSING") {
-        return {...base, status: "MISSING_ROUTE", detail: `라우트 부재 — ${target.path} 가 응답하지 않거나 실물이 0건이다`};
+        return {
+            ...base,
+            status: "MISSING_ROUTE",
+            detail: `라우트 부재 — ${target.path} 가 응답하지 않거나 실물이 0건이다`,
+        };
     }
 
     const types = surface.jsonLd ?? [];
@@ -489,9 +503,7 @@ function judgeSurface(surface, bucket) {
         }
         for (const child of surface.requiredChildren ?? []) {
             const carriers =
-                target.kind === "ANY"
-                    ? [...seen.values()].flatMap((p) => p.ld.nodes)
-                    : target.page.ld.nodes;
+                target.kind === "ANY" ? [...seen.values()].flatMap((p) => p.ld.nodes) : target.page.ld.nodes;
             const ok = carriers.some((n) => found.some((t) => typesOf(n).includes(t)) && nodeContainsType(n, child));
             if (!ok) {
                 return {...base, at, status: "MISSING_CHILD", detail: `${at} 의 ${found[0]} 안에 ${child} 가 없다`};
@@ -503,7 +515,12 @@ function judgeSurface(surface, bucket) {
     if (surface.jsonLdProperty) {
         const pool = target.kind === "ANY" ? [...seen.values()].flatMap((p) => p.ld.nodes) : target.page.ld.nodes;
         if (!pool.some((n) => n[surface.jsonLdProperty] != null)) {
-            return {...base, at, status: "MISSING_PROPERTY", detail: `${at} 의 JSON-LD 에 ${surface.jsonLdProperty} 속성이 없다`};
+            return {
+                ...base,
+                at,
+                status: "MISSING_PROPERTY",
+                detail: `${at} 의 JSON-LD 에 ${surface.jsonLdProperty} 속성이 없다`,
+            };
         }
     }
 
@@ -515,7 +532,12 @@ function judgeSurface(surface, bucket) {
 
     // ③ 깨진 JSON-LD 는 없는 것보다 나쁘다.
     if (target.kind === "PAGE" && target.page.ld.malformed.length > 0) {
-        return {...base, at, status: "MALFORMED_JSONLD", detail: `${at} 의 JSON-LD 파싱 실패 ${target.page.ld.malformed.length}건`};
+        return {
+            ...base,
+            at,
+            status: "MALFORMED_JSONLD",
+            detail: `${at} 의 JSON-LD 파싱 실패 ${target.page.ld.malformed.length}건`,
+        };
     }
 
     return {...base, at, status: "PASS"};
@@ -531,7 +553,11 @@ function judgeSurface(surface, bucket) {
 function judgeSiteWide(req, requiredRoutePaths) {
     const base = {id: req.id, bucket: "siteWide", check: req.check};
     if (req.check === "SITEMAP_COVERS" && requiredRoutePaths === null) {
-        return {...base, status: "SKIPPED", detail: "보장 카테고리를 주장하지 않아 sitemap 이 덮어야 할 라우트가 정해지지 않는다"};
+        return {
+            ...base,
+            status: "SKIPPED",
+            detail: "보장 카테고리를 주장하지 않아 sitemap 이 덮어야 할 라우트가 정해지지 않는다",
+        };
     }
     switch (req.check) {
         case "ROBOTS_PRESENT":
@@ -581,7 +607,12 @@ function judgeNegative() {
         }
         out.push(
             hits.length
-                ? {id: `no-${rule.type}`, bucket: "negative", status: "FORBIDDEN_PRESENT", detail: `${rule.type} 가 나왔다 — ${[...new Set(hits)].join(", ")}`}
+                ? {
+                      id: `no-${rule.type}`,
+                      bucket: "negative",
+                      status: "FORBIDDEN_PRESENT",
+                      detail: `${rule.type} 가 나왔다 — ${[...new Set(hits)].join(", ")}`,
+                  }
                 : {id: `no-${rule.type}`, bucket: "negative", status: "PASS"},
         );
     }
@@ -590,7 +621,18 @@ function judgeNegative() {
 
 // ── 실행 ─────────────────────────────────────────────────────────────────────
 
-const FAIL_STATUSES = new Set(["MISSING_ROUTE", "MISSING_JSONLD", "MISSING_CHILD", "MISSING_PROPERTY", "NOT_SSR", "MALFORMED_JSONLD", "MISSING", "RELATIVE_URL", "FORBIDDEN_PRESENT", "ERROR"]);
+const FAIL_STATUSES = new Set([
+    "MISSING_ROUTE",
+    "MISSING_JSONLD",
+    "MISSING_CHILD",
+    "MISSING_PROPERTY",
+    "NOT_SSR",
+    "MALFORMED_JSONLD",
+    "MISSING",
+    "RELATIVE_URL",
+    "FORBIDDEN_PRESENT",
+    "ERROR",
+]);
 
 const results = [];
 
@@ -620,12 +662,24 @@ for (const code of categories) {
     for (const s of cat.conditional ?? []) {
         const r = judgeSurface(s, "conditional");
         // 조건부는 못 찾으면 SKIPPED — "섹션을 안 썼다"와 구별할 수 없다(§EVENT/faq-page why).
-        surfaces.push(r.status === "PASS" ? r : {...r, status: "SKIPPED", detail: `${r.detail ?? ""} (섹션 미사용일 수 있어 실패로 세지 않는다)`.trim()});
+        surfaces.push(
+            r.status === "PASS"
+                ? r
+                : {
+                      ...r,
+                      status: "SKIPPED",
+                      detail: `${r.detail ?? ""} (섹션 미사용일 수 있어 실패로 세지 않는다)`.trim(),
+                  },
+        );
     }
     for (const s of cat.planned ?? []) {
         const r = judgeSurface(s, "planned");
         // planned 는 게이트가 아니라 T6 작업 지시서다.
-        surfaces.push(r.status === "PASS" ? {...r, status: "PLANNED_PRESENT"} : {...r, status: "PLANNED_MISSING", tranche: s.tranche ?? null});
+        surfaces.push(
+            r.status === "PASS"
+                ? {...r, status: "PLANNED_PRESENT"}
+                : {...r, status: "PLANNED_MISSING", tranche: s.tranche ?? null},
+        );
     }
 
     // 이 카테고리가 보장하는 라우트의 실제 경로 — sitemap 커버리지 판정 입력.
@@ -634,7 +688,8 @@ for (const code of categories) {
         const t = resolveRoute(s.route ?? "any");
         if (t.kind === "PAGE") requiredRoutePaths.push(t.path);
     }
-    for (const req of spec.siteWide?.requirements ?? []) surfaces.push(judgeSiteWide(req, [...new Set(requiredRoutePaths)]));
+    for (const req of spec.siteWide?.requirements ?? [])
+        surfaces.push(judgeSiteWide(req, [...new Set(requiredRoutePaths)]));
     surfaces.push(...judgeNegative());
 
     const gating = surfaces.filter((s) => s.bucket !== "planned" && s.bucket !== "conditional");
@@ -675,7 +730,9 @@ const snapshot = {
 const MARK = {PASS: "✅", PLANNED_PRESENT: "✅", SKIPPED: "⏭️ ", PLANNED_MISSING: "📋"};
 console.log("");
 for (const r of results) {
-    console.log(`■ ${r.category ? `${r.category}(${r.label})` : r.label} — ${r.verdict}${r.shipState === "BLOCKED" ? " · 진열 차단(DON'T-SHIP)" : ""}`);
+    console.log(
+        `■ ${r.category ? `${r.category}(${r.label})` : r.label} — ${r.verdict}${r.shipState === "BLOCKED" ? " · 진열 차단(DON'T-SHIP)" : ""}`,
+    );
     for (const s of r.surfaces) {
         const mark = MARK[s.status] ?? "❌";
         const tail = s.detail ? ` — ${s.detail}` : "";