@riddledc/riddle-proof 0.7.89 → 0.7.91

package/dist/cli.cjs

@@ -6914,6 +6914,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
+  "link_status",
+  "artifact_link_status",
   "route_inventory",
   "no_horizontal_overflow",
   "no_mobile_horizontal_overflow",
@@ -7578,6 +7580,29 @@ function normalizeStringList(value, label) {
   if (!values.length) throw new Error(`${label} must contain non-empty strings.`);
   return values;
 }
+function normalizeHttpStatus(value, label) {
+  if (value === void 0) return void 0;
+  const status = numberValue(value);
+  if (status === void 0 || !Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`${label} must be an HTTP status code.`);
+  }
+  return status;
+}
+function normalizeHttpStatuses(value, label) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error(`${label} must be an array.`);
+  if (!value.length) throw new Error(`${label} must not be empty.`);
+  const statuses = value.map((item, index) => normalizeHttpStatus(item, `${label}[${index}]`));
+  return Array.from(new Set(statuses));
+}
+function normalizePositiveInteger(value, label, max) {
+  if (value === void 0) return void 0;
+  const number = numberValue(value);
+  if (number === void 0 || !Number.isInteger(number) || number < 1 || max !== void 0 && number > max) {
+    throw new Error(`${label} must be an integer from 1 to ${max ?? "unbounded"}.`);
+  }
+  return number;
+}
 function validateRegexPatterns(patterns, label) {
   for (const pattern of patterns || []) {
     try {
@@ -7621,7 +7646,8 @@ function normalizeCheck(input, index) {
   if (type === "url_search_param_equals" && expectedValue === void 0) {
     throw new Error(`checks[${index}] url_search_param_equals requires expected_value.`);
   }
-  if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
+  const minCount = numberValue(input.min_count) ?? numberValue(input.minCount);
+  if (type === "selector_count_at_least" && minCount === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
   const expectedCount = numberValue(input.expected_count) ?? numberValue(input.expectedCount) ?? numberValue(input.count);
@@ -7637,6 +7663,21 @@ function normalizeCheck(input, index) {
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
   }
+  const isLinkStatusCheck = type === "link_status" || type === "artifact_link_status";
+  const expectedStatus = isLinkStatusCheck ? normalizeHttpStatus(input.expected_status ?? input.expectedStatus ?? input.status, `checks[${index}] expected_status`) : void 0;
+  const allowedStatuses = isLinkStatusCheck ? normalizeHttpStatuses(
+    input.allowed_statuses ?? input.allowedStatuses ?? input.expected_statuses ?? input.expectedStatuses,
+    `checks[${index}] allowed_statuses`
+  ) : void 0;
+  const maxLinks = isLinkStatusCheck ? normalizePositiveInteger(input.max_links ?? input.maxLinks ?? input.limit, `checks[${index}] max_links`, 500) : void 0;
+  if (isLinkStatusCheck) {
+    if (minCount !== void 0 && (!Number.isInteger(minCount) || minCount < 0)) {
+      throw new Error(`checks[${index}] ${type} min_count must be a non-negative integer.`);
+    }
+    if (expectedCount !== void 0 && (!Number.isInteger(expectedCount) || expectedCount < 0)) {
+      throw new Error(`checks[${index}] ${type} expected_count must be a non-negative integer.`);
+    }
+  }
   return {
     type,
     label: stringValue2(input.label),
@@ -7662,8 +7703,15 @@ function normalizeCheck(input, index) {
     allowed_console_patterns: normalizeStringList(input.allowed_console_patterns ?? input.allowedConsolePatterns ?? input.allow_console_patterns ?? input.allowConsolePatterns, `checks[${index}] allowed_console_patterns`),
     allowed_page_error_texts: normalizeStringList(input.allowed_page_error_texts ?? input.allowedPageErrorTexts ?? input.allow_page_error_texts ?? input.allowPageErrorTexts, `checks[${index}] allowed_page_error_texts`),
     allowed_page_error_patterns: normalizeStringList(input.allowed_page_error_patterns ?? input.allowedPageErrorPatterns ?? input.allow_page_error_patterns ?? input.allowPageErrorPatterns, `checks[${index}] allowed_page_error_patterns`),
-    min_count: numberValue(input.min_count),
+    min_count: minCount,
     expected_count: expectedCount,
+    expected_status: expectedStatus,
+    allowed_statuses: allowedStatuses,
+    max_links: maxLinks,
+    same_origin_only: isLinkStatusCheck ? input.same_origin_only === true || input.sameOriginOnly === true : void 0,
+    dedupe: isLinkStatusCheck ? input.dedupe === false ? false : true : void 0,
+    require_nonzero_bytes: isLinkStatusCheck ? input.require_nonzero_bytes === true || input.requireNonzeroBytes === true : void 0,
+    allow_get_fallback: isLinkStatusCheck ? input.allow_get_fallback === false || input.allowGetFallback === false ? false : true : void 0,
     max_overflow_px: numberValue(input.max_overflow_px),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
@@ -7756,6 +7804,97 @@ function checkLabel(check) {
 function selectorKey(check) {
   return check.selector || "";
 }
+function linkStatusSelector(check) {
+  return check.selector || check.link_selector || "a[href]";
+}
+function linkStatusAllowedStatuses(check) {
+  if (check.allowed_statuses?.length) return check.allowed_statuses;
+  if (check.expected_status !== void 0) return [check.expected_status];
+  return void 0;
+}
+function linkStatusIsAllowed(status, check) {
+  if (status === void 0) return false;
+  const allowed = linkStatusAllowedStatuses(check);
+  return allowed?.length ? allowed.includes(status) : status >= 200 && status < 400;
+}
+function linkStatusResultOk(result, check) {
+  const status = numberValue(result.status);
+  if (!linkStatusIsAllowed(status, check)) return false;
+  if (stringValue2(result.error)) return false;
+  if (result.ok === false) return false;
+  if (check.require_nonzero_bytes) {
+    const bytes = numberValue(result.bytes);
+    const contentLength = numberValue(result.content_length);
+    return bytes !== void 0 && bytes > 0 || contentLength !== void 0 && contentLength > 0;
+  }
+  return true;
+}
+function linkStatusEvidenceForCheck(viewport, check) {
+  const evidence = viewport.link_statuses?.[linkStatusSelector(check)];
+  return isRecord(evidence) ? evidence : void 0;
+}
+function summarizeLinkStatusEvidence(viewport, check) {
+  const linkEvidence = linkStatusEvidenceForCheck(viewport, check);
+  if (!linkEvidence) {
+    return {
+      viewport: viewport.name,
+      selector: linkStatusSelector(check),
+      total_count: 0,
+      ok_count: 0,
+      failed_count: 1,
+      failures: [{ code: "link_status_evidence_missing" }]
+    };
+  }
+  const results = Array.isArray(linkEvidence.results) ? linkEvidence.results.filter(isRecord) : [];
+  const totalCount = numberValue(linkEvidence.total_count) ?? results.length;
+  const okCount = results.filter((result) => linkStatusResultOk(result, check)).length;
+  const failures = results.filter((result) => !linkStatusResultOk(result, check)).map((result) => ({
+    code: "link_status_failed",
+    url: stringValue2(result.url) ?? null,
+    status: numberValue(result.status) ?? null,
+    method: stringValue2(result.method) ?? null,
+    error: stringValue2(result.error) ?? null,
+    bytes: numberValue(result.bytes) ?? numberValue(result.content_length) ?? null
+  }));
+  if (stringValue2(linkEvidence.error)) {
+    failures.push({ code: "link_status_capture_failed", error: stringValue2(linkEvidence.error) ?? "" });
+  }
+  const recordedFailedCount = numberValue(linkEvidence.failed_count) ?? 0;
+  if (!failures.length && recordedFailedCount > 0) {
+    const recordedFailures = Array.isArray(linkEvidence.failures) ? linkEvidence.failures.slice(0, 20) : [];
+    failures.push({
+      code: "link_status_recorded_failures",
+      failed_count: recordedFailedCount,
+      failures: toJsonValue(recordedFailures)
+    });
+  }
+  if (linkEvidence.truncated === true) {
+    failures.push({
+      code: "link_status_probe_truncated",
+      discovered_count: numberValue(linkEvidence.discovered_count) ?? totalCount,
+      max_links: numberValue(linkEvidence.max_links) ?? check.max_links ?? 100
+    });
+  }
+  if (check.expected_count !== void 0 && totalCount !== check.expected_count) {
+    failures.push({ code: "link_status_count_mismatch", expected: check.expected_count, actual: totalCount });
+  }
+  if (check.min_count !== void 0 && totalCount < check.min_count) {
+    failures.push({ code: "link_status_count_below_minimum", min_count: check.min_count, actual: totalCount });
+  }
+  const statusCounts = isRecord(linkEvidence.status_counts) ? linkEvidence.status_counts : {};
+  return {
+    viewport: viewport.name,
+    selector: linkStatusSelector(check),
+    total_count: totalCount,
+    discovered_count: numberValue(linkEvidence.discovered_count) ?? totalCount,
+    ok_count: numberValue(linkEvidence.ok_count) ?? okCount,
+    failed_count: failures.length,
+    truncated: linkEvidence.truncated === true,
+    max_links: numberValue(linkEvidence.max_links) ?? check.max_links ?? 100,
+    status_counts: statusCounts,
+    failures: failures.slice(0, 20)
+  };
+}
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
@@ -8235,6 +8374,26 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "link_status" || check.type === "artifact_link_status") {
+    const selector = linkStatusSelector(check);
+    const summaries = viewports.map((viewport) => summarizeLinkStatusEvidence(viewport, check));
+    const failed = summaries.filter((summary) => (numberValue(summary.failed_count) ?? 0) > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector,
+        expected_count: check.expected_count ?? null,
+        min_count: check.min_count ?? null,
+        allowed_statuses: linkStatusAllowedStatuses(check) || ["2xx", "3xx"],
+        require_nonzero_bytes: check.require_nonzero_bytes === true,
+        viewports: summaries.map((summary) => toJsonValue(summary)),
+        failures: failed.flatMap((summary) => Array.isArray(summary.failures) ? summary.failures.map((failure) => toJsonValue({ viewport: stringValue2(summary.viewport) ?? null, failure })) : [])
+      },
+      message: failed.length ? `Link status failed in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "route_inventory") {
     const inventories = viewports.map((viewport) => ({ viewport: viewport.name, inventory: viewport.route_inventory })).filter((item) => isRecord(item.inventory));
     if (!inventories.length) {
@@ -8801,6 +8960,98 @@ function textOrderMatch(texts, expectedTexts) {
   }
   return { matched: true, positions };
 }
+function linkStatusSelector(check) {
+  return check.selector || check.link_selector || "a[href]";
+}
+function linkStatusAllowedStatuses(check) {
+  if (Array.isArray(check.allowed_statuses) && check.allowed_statuses.length) return check.allowed_statuses;
+  if (typeof check.expected_status === "number" && Number.isFinite(check.expected_status)) return [check.expected_status];
+  return undefined;
+}
+function linkStatusIsAllowed(status, check) {
+  if (typeof status !== "number" || !Number.isFinite(status)) return false;
+  const allowed = linkStatusAllowedStatuses(check);
+  return Array.isArray(allowed) && allowed.length ? allowed.includes(status) : status >= 200 && status < 400;
+}
+function linkStatusResultOk(result, check) {
+  if (!result || typeof result !== "object" || Array.isArray(result)) return false;
+  if (!linkStatusIsAllowed(result.status, check)) return false;
+  if (typeof result.error === "string" && result.error.trim()) return false;
+  if (result.ok === false) return false;
+  if (check.require_nonzero_bytes === true) {
+    const bytes = typeof result.bytes === "number" && Number.isFinite(result.bytes) ? result.bytes : undefined;
+    const contentLength = typeof result.content_length === "number" && Number.isFinite(result.content_length) ? result.content_length : undefined;
+    return (bytes !== undefined && bytes > 0) || (contentLength !== undefined && contentLength > 0);
+  }
+  return true;
+}
+function summarizeLinkStatusEvidence(viewport, check) {
+  const selector = linkStatusSelector(check);
+  const linkEvidence = viewport && viewport.link_statuses && viewport.link_statuses[selector];
+  if (!linkEvidence || typeof linkEvidence !== "object" || Array.isArray(linkEvidence)) {
+    return {
+      viewport: viewport && viewport.name,
+      selector,
+      total_count: 0,
+      ok_count: 0,
+      failed_count: 1,
+      failures: [{ code: "link_status_evidence_missing" }],
+    };
+  }
+  const results = Array.isArray(linkEvidence.results) ? linkEvidence.results.filter((result) => result && typeof result === "object" && !Array.isArray(result)) : [];
+  const totalCount = typeof linkEvidence.total_count === "number" && Number.isFinite(linkEvidence.total_count) ? linkEvidence.total_count : results.length;
+  const okCount = results.filter((result) => linkStatusResultOk(result, check)).length;
+  const failures = results
+    .filter((result) => !linkStatusResultOk(result, check))
+    .map((result) => ({
+      code: "link_status_failed",
+      url: typeof result.url === "string" ? result.url : null,
+      status: typeof result.status === "number" && Number.isFinite(result.status) ? result.status : null,
+      method: typeof result.method === "string" ? result.method : null,
+      error: typeof result.error === "string" ? result.error : null,
+      bytes: typeof result.bytes === "number" && Number.isFinite(result.bytes)
+        ? result.bytes
+        : typeof result.content_length === "number" && Number.isFinite(result.content_length)
+          ? result.content_length
+          : null,
+    }));
+  if (typeof linkEvidence.error === "string" && linkEvidence.error.trim()) {
+    failures.push({ code: "link_status_capture_failed", error: linkEvidence.error });
+  }
+  const recordedFailedCount = typeof linkEvidence.failed_count === "number" && Number.isFinite(linkEvidence.failed_count) ? linkEvidence.failed_count : 0;
+  if (!failures.length && recordedFailedCount > 0) {
+    failures.push({
+      code: "link_status_recorded_failures",
+      failed_count: recordedFailedCount,
+      failures: Array.isArray(linkEvidence.failures) ? linkEvidence.failures.slice(0, 20) : [],
+    });
+  }
+  if (linkEvidence.truncated === true) {
+    failures.push({
+      code: "link_status_probe_truncated",
+      discovered_count: typeof linkEvidence.discovered_count === "number" ? linkEvidence.discovered_count : totalCount,
+      max_links: typeof linkEvidence.max_links === "number" ? linkEvidence.max_links : check.max_links || 100,
+    });
+  }
+  if (typeof check.expected_count === "number" && Number.isFinite(check.expected_count) && totalCount !== check.expected_count) {
+    failures.push({ code: "link_status_count_mismatch", expected: check.expected_count, actual: totalCount });
+  }
+  if (typeof check.min_count === "number" && Number.isFinite(check.min_count) && totalCount < check.min_count) {
+    failures.push({ code: "link_status_count_below_minimum", min_count: check.min_count, actual: totalCount });
+  }
+  return {
+    viewport: viewport && viewport.name,
+    selector,
+    total_count: totalCount,
+    discovered_count: typeof linkEvidence.discovered_count === "number" ? linkEvidence.discovered_count : totalCount,
+    ok_count: typeof linkEvidence.ok_count === "number" ? linkEvidence.ok_count : okCount,
+    failed_count: failures.length,
+    truncated: linkEvidence.truncated === true,
+    max_links: typeof linkEvidence.max_links === "number" ? linkEvidence.max_links : check.max_links || 100,
+    status_counts: linkEvidence.status_counts && typeof linkEvidence.status_counts === "object" && !Array.isArray(linkEvidence.status_counts) ? linkEvidence.status_counts : {},
+    failures: failures.slice(0, 20),
+  };
+}
 function frameEvidenceForSelector(viewport, selector) {
   const container = viewport.frames && viewport.frames[selector || ""];
   if (!container || typeof container !== "object" || Array.isArray(container)) return [];
@@ -9454,6 +9705,29 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "link_status" || check.type === "artifact_link_status") {
+      const selector = linkStatusSelector(check);
+      const summaries = checkViewports.map((viewport) => summarizeLinkStatusEvidence(viewport, check));
+      const failed = summaries.filter((summary) => summary.failed_count > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_count: check.expected_count ?? null,
+          min_count: check.min_count ?? null,
+          allowed_statuses: linkStatusAllowedStatuses(check) || ["2xx", "3xx"],
+          require_nonzero_bytes: check.require_nonzero_bytes === true,
+          viewports: summaries,
+          failures: failed.flatMap((summary) => Array.isArray(summary.failures)
+            ? summary.failures.map((failure) => ({ viewport: summary.viewport || null, failure }))
+            : []),
+        },
+        message: failed.length ? "Link status failed in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "route_inventory") {
       const inventories = checkViewports
         .map((viewport) => ({ viewport: viewport.name, inventory: viewport.route_inventory }))
@@ -9694,6 +9968,10 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function profileCheckAppliesToViewport(check, viewport) {
+  if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
+  return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
+}
 function setupActionType(action) {
   return String(action && action.type ? action.type : "").replace(/-/g, "_");
 }
@@ -9711,6 +9989,30 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+async function waitForAnyVisibleSelector(context, selector, timeout) {
+  const deadline = Date.now() + setupNumber(timeout, 15000);
+  let lastReason = "selector_not_found";
+  while (Date.now() <= deadline) {
+    try {
+      const locator = context.locator(selector);
+      const count = await locator.count();
+      if (!count) {
+        lastReason = "selector_not_found";
+      } else {
+        lastReason = "no_visible_match";
+        for (let index = 0; index < count; index += 1) {
+          if (await locator.nth(index).isVisible().catch(() => false)) {
+            return { ok: true, count, index };
+          }
+        }
+      }
+    } catch (error) {
+      lastReason = String(error && error.message ? error.message : error).slice(0, 500);
+    }
+    await page.waitForTimeout(200);
+  }
+  throw new Error("No visible match for selector " + selector + ": " + lastReason);
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -10044,7 +10346,7 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "wait_for_selector") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
+      await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
     if (type === "drag") {
@@ -10512,6 +10814,196 @@ async function selectorTextSequence(selector) {
     };
   }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+function linkProbeMaxLinks(check) {
+  const value = Number(check.max_links || check.maxLinks || check.limit || 100);
+  return Number.isInteger(value) && value > 0 ? Math.min(value, 500) : 100;
+}
+function linkProbeDedupe(check) {
+  return check.dedupe !== false;
+}
+function linkProbeSameOriginOnly(check) {
+  return check.same_origin_only === true;
+}
+async function collectLinkCandidates(selector) {
+  return page.locator(selector).evaluateAll((elements) => {
+    const compact = (value, limit) => String(value || "").replace(/\s+/g, " ").trim().slice(0, limit || 160);
+    return elements.map((element, index) => {
+      const tag = element && element.tagName ? element.tagName.toLowerCase() : "element";
+      const href = element && typeof element.href === "string" ? element.href : "";
+      const src = element && typeof element.src === "string" ? element.src : "";
+      const currentSrc = element && typeof element.currentSrc === "string" ? element.currentSrc : "";
+      const attrHref = element && typeof element.getAttribute === "function" ? element.getAttribute("href") || "" : "";
+      const attrSrc = element && typeof element.getAttribute === "function" ? element.getAttribute("src") || "" : "";
+      const attrPoster = element && typeof element.getAttribute === "function" ? element.getAttribute("poster") || "" : "";
+      const raw = href || currentSrc || src || attrHref || attrSrc || attrPoster;
+      if (!raw) return null;
+      let url = "";
+      try {
+        url = new URL(raw, location.href).href;
+      } catch {}
+      if (!url) return null;
+      return {
+        index,
+        tag,
+        url,
+        raw,
+        text: compact(element.innerText || element.textContent || "", 160),
+        alt: compact(element.getAttribute && element.getAttribute("alt"), 80),
+      };
+    }).filter(Boolean);
+  }).catch((error) => ({ error: String(error && error.message ? error.message : error).slice(0, 500) }));
+}
+function linkProbeAllowed(status, check) {
+  if (typeof status !== "number" || !Number.isFinite(status)) return false;
+  const allowed = Array.isArray(check.allowed_statuses) && check.allowed_statuses.length
+    ? check.allowed_statuses
+    : typeof check.expected_status === "number" && Number.isFinite(check.expected_status)
+      ? [check.expected_status]
+      : null;
+  return allowed ? allowed.includes(status) : status >= 200 && status < 400;
+}
+function linkProbeResponseFields(response, method) {
+  const contentLengthHeader = response.headers && typeof response.headers.get === "function" ? response.headers.get("content-length") : null;
+  const contentLength = contentLengthHeader && /^\d+$/.test(contentLengthHeader) ? Number(contentLengthHeader) : null;
+  return {
+    method,
+    status: response.status,
+    redirected: Boolean(response.redirected),
+    final_url: response.url || null,
+    content_type: response.headers && typeof response.headers.get === "function" ? response.headers.get("content-type") : null,
+    content_length: contentLength,
+  };
+}
+async function probeLinkStatus(candidate, check) {
+  const requireNonzeroBytes = check.require_nonzero_bytes === true;
+  const allowGetFallback = check.allow_get_fallback !== false;
+  const result = {
+    url: candidate.url,
+    tag: candidate.tag,
+    text: candidate.text || null,
+    status: null,
+    method: null,
+    ok: false,
+    content_type: null,
+    content_length: null,
+    bytes: null,
+    redirected: false,
+    final_url: null,
+    error: null,
+  };
+  const applyResponse = async (response, method, readBytes) => {
+    Object.assign(result, linkProbeResponseFields(response, method));
+    if (readBytes || requireNonzeroBytes) {
+      try {
+        const buffer = await response.arrayBuffer();
+        result.bytes = buffer.byteLength;
+      } catch (error) {
+        result.error = String(error && error.message ? error.message : error).slice(0, 500);
+      }
+    }
+    result.ok = linkProbeAllowed(result.status, check)
+      && (!requireNonzeroBytes || (typeof result.bytes === "number" ? result.bytes > 0 : typeof result.content_length === "number" && result.content_length > 0))
+      && !result.error;
+  };
+  try {
+    const response = await fetch(candidate.url, { method: "HEAD", redirect: "follow", cache: "no-store" });
+    await applyResponse(response, "HEAD", false);
+    if (result.ok || !allowGetFallback) return result;
+  } catch (error) {
+    result.error = String(error && error.message ? error.message : error).slice(0, 500);
+    if (!allowGetFallback) return result;
+  }
+  try {
+    result.error = null;
+    const response = await fetch(candidate.url, {
+      method: "GET",
+      redirect: "follow",
+      cache: "no-store",
+      headers: { Range: "bytes=0-0" },
+    });
+    await applyResponse(response, "GET", requireNonzeroBytes);
+    return result;
+  } catch (error) {
+    result.error = String(error && error.message ? error.message : error).slice(0, 500);
+    result.ok = false;
+    return result;
+  }
+}
+async function collectLinkStatus(check) {
+  const selector = linkStatusSelector(check);
+  const candidateResult = await collectLinkCandidates(selector);
+  if (candidateResult && candidateResult.error) {
+    return {
+      version: "riddle-proof.link-status.v1",
+      selector,
+      total_count: 0,
+      discovered_count: 0,
+      ok_count: 0,
+      failed_count: 1,
+      failures: [{ code: "link_status_capture_failed", error: candidateResult.error }],
+      results: [],
+      status_counts: {},
+      error: candidateResult.error,
+    };
+  }
+  const baseUrl = page.url() || targetUrl;
+  let candidates = Array.isArray(candidateResult) ? candidateResult : [];
+  if (linkProbeSameOriginOnly(check)) {
+    const origin = new URL(baseUrl).origin;
+    candidates = candidates.filter((candidate) => {
+      try { return new URL(candidate.url).origin === origin; } catch { return false; }
+    });
+  }
+  const discoveredCount = candidates.length;
+  if (linkProbeDedupe(check)) {
+    const seen = new Set();
+    candidates = candidates.filter((candidate) => {
+      if (seen.has(candidate.url)) return false;
+      seen.add(candidate.url);
+      return true;
+    });
+  }
+  const maxLinks = linkProbeMaxLinks(check);
+  const selected = candidates.slice(0, maxLinks);
+  const results = [];
+  for (const candidate of selected) {
+    results.push(await probeLinkStatus(candidate, check));
+  }
+  const failures = results.filter((result) => !result.ok).map((result) => ({
+    code: "link_status_failed",
+    url: result.url,
+    status: result.status,
+    method: result.method,
+    error: result.error,
+    bytes: result.bytes == null ? result.content_length : result.bytes,
+  }));
+  const statusCounts = {};
+  for (const result of results) {
+    const key = result.status == null ? "error" : String(result.status);
+    statusCounts[key] = (statusCounts[key] || 0) + 1;
+  }
+  return {
+    version: "riddle-proof.link-status.v1",
+    selector,
+    max_links: maxLinks,
+    same_origin_only: linkProbeSameOriginOnly(check),
+    dedupe: linkProbeDedupe(check),
+    require_nonzero_bytes: check.require_nonzero_bytes === true,
+    allowed_statuses: Array.isArray(check.allowed_statuses) && check.allowed_statuses.length
+      ? check.allowed_statuses
+      : typeof check.expected_status === "number"
+        ? [check.expected_status]
+        : ["2xx", "3xx"],
+    discovered_count: discoveredCount,
+    total_count: selected.length,
+    truncated: candidates.length > selected.length,
+    ok_count: results.filter((result) => result.ok).length,
+    failed_count: failures.length,
+    status_counts: statusCounts,
+    failures: failures.slice(0, 20),
+    results,
+  };
+}
 async function frameEvidence(selector) {
   const result = { selector, count: 0, frame_count: 0, frames: [], errors: [] };
   let handles = [];
@@ -10870,7 +11362,7 @@ async function collectRouteInventory(check, viewport) {
       try {
         await page.goto(targetUrl, { waitUntil: "domcontentloaded", timeout: 90000 });
         if (profile.target.wait_for_selector) {
-          await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 }).catch(() => {});
+          await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
         const index = await findInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
@@ -10929,7 +11421,7 @@ async function captureViewport(viewport) {
   }
   if (!navigationError && profile.target.wait_for_selector) {
     try {
-      await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 });
+      await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000);
     } catch (error) {
       waitError = String(error && error.message ? error.message : error).slice(0, 1000);
     }
@@ -11031,7 +11523,9 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const link_statuses = {};
   for (const check of profile.checks || []) {
+    if (!profileCheckAppliesToViewport(check, viewport)) continue;
     if (
       (
         check.type === "selector_visible"
@@ -11055,6 +11549,10 @@ async function captureViewport(viewport) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }
+    if (check.type === "link_status" || check.type === "artifact_link_status") {
+      const selector = linkStatusSelector(check);
+      link_statuses[selector] = link_statuses[selector] || await collectLinkStatus(check);
+    }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
@@ -11063,7 +11561,7 @@ async function captureViewport(viewport) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
   let routeInventory;
-  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
+  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory" && profileCheckAppliesToViewport(check, viewport));
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
   if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
@@ -11118,6 +11616,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    link_statuses,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
@@ -11166,6 +11665,18 @@ function buildProfileEvidence(currentViewports) {
             ),
           })),
         })),
+      link_status: currentViewports
+        .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
+        .map((viewport) => ({
+          viewport: viewport.name,
+          selectors: Object.entries(viewport.link_statuses || {}).map(([selector, statusSet]) => ({
+            selector,
+            total_count: statusSet && statusSet.total_count,
+            ok_count: statusSet && statusSet.ok_count,
+            failed_count: statusSet && statusSet.failed_count,
+            truncated: statusSet && statusSet.truncated === true,
+          })),
+        })),
       route_inventory: currentViewports
         .filter((viewport) => viewport.route_inventory)
         .map((viewport) => ({
@@ -11602,6 +12113,10 @@ function profileResultMarkdown(result) {
   if (routeInventorySummaryLines.length) {
     lines.push("", "## Route Inventory", "", ...routeInventorySummaryLines);
   }
+  const linkStatusSummaryLines = profileLinkStatusSummaryMarkdown(result);
+  if (linkStatusSummaryLines.length) {
+    lines.push("", "## Link Status", "", ...linkStatusSummaryLines);
+  }
   const environmentBlockerLines = profileEnvironmentBlockerMarkdown(result);
   if (environmentBlockerLines.length) {
     lines.push("", "## Environment Blocker", "", ...environmentBlockerLines);
@@ -11671,6 +12186,13 @@ function profileCheckMarkdownTarget(check) {
     if (selector && maxOverflow !== void 0) return `${markdownInlineCode(selector)} <= ${maxOverflow}px`;
     return selector ? markdownInlineCode(selector) : maxOverflow !== void 0 ? `<= ${maxOverflow}px` : void 0;
   }
+  if (check.type === "link_status" || check.type === "artifact_link_status") {
+    const expectedCount = cliFiniteNumber(evidence.expected_count);
+    const minCount = cliFiniteNumber(evidence.min_count);
+    if (selector && expectedCount !== void 0) return `${markdownInlineCode(selector)} links = ${expectedCount}`;
+    if (selector && minCount !== void 0) return `${markdownInlineCode(selector)} links >= ${minCount}`;
+    return selector ? markdownInlineCode(selector) : void 0;
+  }
   if (check.type === "no_horizontal_overflow" || check.type === "no_mobile_horizontal_overflow") {
     const maxOverflow = cliFiniteNumber(evidence.max_overflow_px);
     return maxOverflow !== void 0 ? `<= ${maxOverflow}px` : void 0;
@@ -11864,6 +12386,26 @@ function profileRouteInventorySummaryMarkdown(result) {
   }
   return lines;
 }
+function profileLinkStatusSummaryMarkdown(result) {
+  const linkStatusChecks = result.checks.filter((check) => check.type === "link_status" || check.type === "artifact_link_status");
+  const lines = [];
+  for (const check of linkStatusChecks) {
+    const evidence = cliRecord(check.evidence);
+    if (!evidence) continue;
+    const label = check.label || check.type;
+    const selector = cliString(evidence.selector);
+    const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
+    const totals = viewports.map((viewport) => cliFiniteNumber(viewport.total_count)).filter((count) => count !== void 0);
+    const okTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.ok_count) || 0), 0);
+    const failedTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.failed_count) || 0), 0);
+    const truncatedTotal = viewports.filter((viewport) => viewport.truncated === true).length;
+    const countText = totals.length ? totals.join("/") : "unknown";
+    lines.push(
+      `- ${label}${selector ? ` ${markdownInlineCode(selector)}` : ""}: links ${countText}, ok ${okTotal}, failures ${failedTotal}${truncatedTotal ? `, truncated viewports ${truncatedTotal}` : ""}`
+    );
+  }
+  return lines;
+}
 function writeProfileOutput(outputDir, result) {
   if (!outputDir) return;
   (0, import_node_fs6.mkdirSync)(outputDir, { recursive: true });