@operstack/audit 0.16.2 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "SEO, AEO and GEO audit generator: collect public signals from a site into audit.json, let an analyst or an agent fill the narrative, render the OperStack report as HTML and PDF.",
   "type": "module",
   "license": "MIT",
@@ -29,7 +29,8 @@
   ],
   "scripts": {
     "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.mjs && node src/test-prompts.mjs && node src/test-sitemap.mjs && node src/test-overall.mjs && node src/test-rendered.mjs && node src/test-agent-surface.mjs && node src/test-agency.mjs && node src/test-i18n.mjs examples/sample-audit.json && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html",
-    "sample": "node bin/audit.mjs render examples/sample-audit.json --pdf"
+    "sample": "node bin/audit.mjs render examples/sample-audit.json --pdf",
+    "verify:live": "node src/verify-live.mjs"
   },
   "keywords": [
     "seo",

package/src/collect.mjs

@@ -9,6 +9,7 @@ import { fileURLToPath } from 'node:url';
 import { renderedDom, compareReadings, jsBlindnessCheck } from './rendered.mjs';
 import { parse } from 'node-html-parser';
 import { localiseChecks } from './i18n.mjs';
+import { checkVisibility, VISIBILITY_DEFAULTS } from './visibility.mjs';
 
 /** Версия читается из своего package.json. Зашитая строка врала в каждом отчёте с первого релиза:
  *  в подвале стояло 0.1.0, когда пакет был уже 0.12.0, и покупатель не мог понять, чем его мерили. */
@@ -468,11 +469,27 @@ export async function collect(startUrl, { pages = 20, log = () => {}, backlinks
     checks.push(jsBlindnessCheck(measured, lang));
   }
 
-  // Балл считается ПОСЛЕ всех этапов, включая браузерный: раньше он снимался до него, и на прогоне
-  // с `rendered: true` сохранённое поле расходилось с тем, что печатает отчёт. Письмо говорило 61,
-  // PDF печатал 59. Одна функция, один набор проверок, один момент: вот этот.
   const { scores, scoreBasis } = computeScores(checks);
-  const overall = computeOverall(checks);
+
+  /*
+   * Общий балл отчёта это тот же балл видимости, который считает бесплатная проверка на странице,
+   * и считает его тот же код с теми же параметрами.
+   *
+   * 14.09.2026 человек видел 46 на странице, 61 в письме и шесть областей из шестидесяти в PDF.
+   * Три числа про один сайт в одном дне. Пока их считали разные движки с разными рамками, сойтись
+   * они не могли, и единственный вывод, который делает читатель, это что цифры выдуманы.
+   *
+   * Параметры намеренно взяты из VISIBILITY_DEFAULTS, а не расширены под платный аудит: стоит дать
+   * тут больше страниц или времени, и число снова разойдётся со страницей. Глубина аудита живёт в
+   * его собственных шести областях и в списке задач, а не в этом числе.
+   */
+  log('visibility score');
+  const visibility = await checkVisibility(startUrl, { ...VISIBILITY_DEFAULTS, lang });
+  const overall = visibility.ok
+    ? { score: visibility.score, grade: visibility.grade, areas: visibility.areas, source: 'visibility', ms: visibility.ms }
+    : { score: null, grade: 'not measured', areas: [], source: 'visibility', error: visibility.error };
+  // Шесть областей отчёта остаются, но это другое измерение, а не разбивка общего балла.
+  const reportScore = computeOverall(checks);
 
   const localised = localiseChecks(checks, lang);
   const critical = checks.filter((c) => c.status === 'bad').map((c) => ({ title: c.label, text: `${c.value}${c.comment ? `. ${c.comment}` : ''}`, level: 'bad' }));
@@ -481,6 +498,7 @@ export async function collect(startUrl, { pages = 20, log = () => {}, backlinks
     meta: { site: home.final, host, reachable: homeAnswered, collectedAt: new Date().toISOString(), tool: `@operstack/audit ${VERSION}`, auditType: lang === 'ru' ? 'Аудит по публичным сигналам' : 'External audit (no Search Console or analytics access)', lang, language: hp ? (hp.og?.locale || '') : '' },
     client: { name: '{{CLIENT NAME}}', subject: '{{What the site sells and where}}', reportDate: new Date().toISOString().slice(0, 10), preparedBy: preparedBy || process.env.OPERSTACK_PREPARED_BY || 'OperStack' },
     overall,
+    reportScore,
     scores,
     scoreBasis,
     summary: { lead: '{{Three sentences: what the site is, what works, what holds it back.}}', verdict: '{{Key takeaway in three sentences, ending with how fast the critical issues can be fixed.}}', priorities: ['{{Priority one}}', '{{Priority two}}', '{{Priority three}}'] },
@@ -613,17 +631,24 @@ export function verifyScores(audit) {
   const { scores } = computeScores(audit.checks || []);
   const show = (v) => (v === null || v === undefined ? 'not measured' : `${v}/10`);
   const problems = [];
-  // Общий балл проверяется первым: именно он стоит в заголовке отчёта, в письме и на странице,
-  // и именно он обесценивает всё остальное, если разойдётся со своими же проверками.
-  //
-  // Сверяем только когда поле есть. Отчёт, собранный версией до 0.16.0, его не содержит, и это не
-  // ложь, а старый формат: в вёрстке заголовок всё равно считается из проверок этого же файла,
-  // поэтому отсутствие поля не может напечатать неверное число.
-  if (audit.overall && audit.overall.score !== undefined) {
-    const overall = computeOverall(audit.checks || []);
-    const stored = audit.overall.score;
-    const show = (v) => (v === null || v === undefined ? 'not measured' : `${v}/100`);
-    if (stored !== overall.score) problems.push(`overall: the report says ${show(stored)}, the checks give ${show(overall.score)}`);
+  const show100 = (v) => (v === null || v === undefined ? 'not measured' : `${v}/100`);
+
+  /*
+   * Общий балл это балл видимости, и пересчитать его из проверок отчёта нельзя: его считает движок
+   * по своему обходу сайта. Зато можно проверить, что он сходится сам с собой: пять областей обязаны
+   * давать в сумме ровно заголовок. Ровно это и защищает от числа, взятого с потолка.
+   */
+  if (audit.overall && audit.overall.score !== undefined && audit.overall.score !== null && Array.isArray(audit.overall.areas) && audit.overall.areas.length) {
+    const sum = audit.overall.areas.reduce((acc, x) => acc + (Number(x.score) || 0), 0);
+    if (sum !== audit.overall.score) problems.push(`overall: the report says ${show100(audit.overall.score)}, its own five areas add up to ${sum}`);
+    const max = audit.overall.areas.reduce((acc, x) => acc + (Number(x.max) || 0), 0);
+    if (max !== 100) problems.push(`overall: the five areas are out of ${max}, not 100`);
+  }
+
+  // Балл по проверкам самого отчёта это отдельное измерение, и он пересчитывается из checks.
+  if (audit.reportScore && audit.reportScore.score !== undefined) {
+    const expected = computeOverall(audit.checks || []);
+    if (audit.reportScore.score !== expected.score) problems.push(`reportScore: the report says ${show100(audit.reportScore.score)}, the checks give ${show100(expected.score)}`);
   }
   for (const [label, expected] of Object.entries(scores)) {
     const stored = (audit.scores || {})[label];

package/src/index.mjs

@@ -1,4 +1,6 @@
 export { collect, computeScores, computeOverall, verifyScores, SCORE_AREAS } from './collect.mjs';
+// Единственная копия движка видимости. Сайты и актор зовут его отсюда, своих копий больше нет.
+export { checkVisibility, normaliseInput, parseRobots, agentVerdict, MESSAGES as VISIBILITY_MESSAGES, VISIBILITY_DEFAULTS } from './visibility.mjs';
 export { render, checkNarrative } from './render.mjs';
 export { localiseChecks, localiseBasisNote, untranslated, AREAS_RU } from './i18n.mjs';
 export { buildFixPlan, renderFixPlan, renderFixChecklist, buildFixReport, renderFixReport, FIX_ACTIONS } from './fix.mjs';

package/src/render.mjs

@@ -23,15 +23,14 @@ const LABELS = {
     reproducible: 'Every status in this report was read from the public site and can be reproduced from it as it stood on the report date.',
     collectedBy: (tool, date) => `Public signals were collected by ${tool} on ${date}. Every status in this report can be reproduced from the site as it stood on that day.`,
     secSummary: 'Executive summary', summaryEyebrow: '01 · Summary', keyTakeaway: 'Key takeaway:', threePriorities: 'Three priorities',
-    scorecardFoot: 'Each score counts the checks in this report: a check that passes scores one, a check that needs attention a half, a failing check nothing. An area marked <strong>not measured</strong> is an area this audit does not test, and is never scored on an impression. Every figure here can be recomputed from section 04 onwards.',
+    scorecardFoot: 'These six scores are not a breakdown of the number above and will not add up to it: they count the checks in this report, which go wider than AI visibility. Each score counts the checks in this report: a check that passes scores one, a check that needs attention a half, a failing check nothing. An area marked <strong>not measured</strong> is an area this audit does not test, and is never scored on an impression. Every figure here can be recomputed from section 04 onwards.',
     notMeasured: 'not measured',
-    overallLabel: 'Overall score',
-    grades: { strong: 'Strong', workable: 'Workable', weak: 'Weak', critical: 'Critical' },
-    // Веса это решение, а не измерение, поэтому они напечатаны здесь: балл должен пересчитываться руками.
-    overallNote: (o) => `Weighted from the areas below: ${o.parts.map((x) => `${x.label} ${x.weight}`).join(', ')}. `
-      + (o.weighed === 100
-        ? 'Every area was measurable on this site.'
-        : `Only ${o.weighed} of 100 points were measurable here, so the areas this audit could not read are left out of the total rather than scored zero.`),
+    overallLabel: 'AI visibility score',
+    grades: { A: 'Strong', B: 'Workable', C: 'Weak', D: 'Poor', E: 'Critical' },
+    // Заголовок это то же измерение, что на странице проверки. Подпись обязана это говорить,
+    // иначе читатель снова начнёт сводить его с шестью областями ниже.
+    overallNote: 'The same measurement the free check at oper-stack.com/ai-visibility gives for this site: the same code, the same settings. The five areas below add up to it exactly, so you can recompute it by hand.',
+    secondMeasure: 'A second, separate measurement: how this report scores its own checks',
     secOverview: 'Site overview', overviewEyebrow: '02 · Overview', whatSiteIs: 'What the site is', parameter: 'Parameter', value: 'Value', pagesSampled: 'Pages sampled', colUrl: 'URL', colTitle: 'Title', colWords: 'Words',
     secCritical: 'Critical issues', criticalEyebrow: '03 · P0', criticalTitle: 'Critical issues, fix first', whatItCosts: 'What it costs', theFix: 'Fix', noBody: 'This issue has no description in the audit file.', noCritical: 'No critical defects were found in the public signals.',
     secTechnical: 'Technical SEO', technicalEyebrow: '04 · Technical', technicalTitle: 'Technical and on-page checklist', colCheck: 'Check', colStatus: 'Status', colFinding: 'Finding',
@@ -53,14 +52,12 @@ const LABELS = {
     reproducible: 'Каждый статус в этом отчёте прочитан с публичного сайта, и его можно перепроверить по сайту на дату отчёта.',
     collectedBy: (tool, date) => `Публичные сигналы собраны инструментом ${tool} ${date}. Любой статус в этом отчёте можно перепроверить по сайту в том виде, в каком он был в этот день.`,
     secSummary: 'Главное', summaryEyebrow: '01 · Итог', keyTakeaway: 'Главный вывод:', threePriorities: 'Три приоритета',
-    scorecardFoot: 'Каждая оценка считает проверки из этого же отчёта: пройденная проверка это балл, спорная половина балла, проваленная ноль. Область с пометкой <strong>не измерялось</strong> это область, которую аудит не проверяет, и она никогда не оценивается на глаз. Любую цифру отсюда можно пересчитать по разделам начиная с четвёртого.',
+    scorecardFoot: 'Эти шесть оценок не разбивка балла выше и в сумме его не дают: они считают проверки самого отчёта, а он шире, чем видимость в ИИ. Каждая оценка считает проверки из этого же отчёта: пройденная проверка это балл, спорная половина балла, проваленная ноль. Область с пометкой <strong>не измерялось</strong> это область, которую аудит не проверяет, и она никогда не оценивается на глаз. Любую цифру отсюда можно пересчитать по разделам начиная с четвёртого.',
     notMeasured: 'не измерялось',
-    overallLabel: 'Общий балл',
-    grades: { strong: 'Сильно', workable: 'Рабочее состояние', weak: 'Слабо', critical: 'Критично' },
-    overallNote: (o) => `Взвешен по областям ниже: ${o.parts.map((x) => `${AREAS_RU[x.label] || x.label} ${x.weight}`).join(', ')}. `
-      + (o.weighed === 100
-        ? 'Все области на этом сайте удалось измерить.'
-        : `Измеримыми здесь оказались ${o.weighed} ${ruPoints(o.weighed)} из 100, поэтому области, которые аудит прочитать не смог, не попали в знаменатель, а не получили ноль.`),
+    overallLabel: 'Балл видимости в ИИ',
+    grades: { A: 'Сильно', B: 'Рабочее состояние', C: 'Слабо', D: 'Плохо', E: 'Критично' },
+    overallNote: 'То же измерение, что даёт бесплатная проверка на oper-stack.com/ai-visibility для этого сайта: тот же код, те же настройки. Пять областей ниже дают в сумме ровно этот балл, его можно сложить руками.',
+    secondMeasure: 'Второе, отдельное измерение: как этот отчёт оценивает собственные проверки',
     secOverview: 'О сайте', overviewEyebrow: '02 · Обзор', whatSiteIs: 'Что это за сайт', parameter: 'Параметр', value: 'Значение', pagesSampled: 'Проверенные страницы', colUrl: 'Адрес', colTitle: 'Заголовок', colWords: 'Слов',
     secCritical: 'Критичное', criticalEyebrow: '03 · Срочно', criticalTitle: 'Что чинить первым', whatItCosts: 'Чем это грозит', theFix: 'Как чинится', noBody: 'У этой проблемы нет описания в файле аудита.', noCritical: 'Критичных дефектов в публичных сигналах не найдено.',
     secTechnical: 'Техническое SEO', technicalEyebrow: '04 · Техника', technicalTitle: 'Техническая проверка и страницы', colCheck: 'Проверка', colStatus: 'Статус', colFinding: 'Что нашли',
@@ -126,6 +123,11 @@ function css() {
   .page-header { display: flex; justify-content: space-between; align-items: center; padding-bottom: 3mm; margin-bottom: 6mm; border-bottom: 1px solid var(--rule); font-size: 8pt; color: var(--muted); }
   .page-header strong { color: var(--accent); }
   .page-footer { position: absolute; bottom: 9mm; left: var(--pad); right: var(--pad); display: flex; justify-content: space-between; font-size: 8pt; color: var(--muted); border-top: 1px solid var(--rule); padding-top: 2.5mm; }
+  table.areas { border-collapse: collapse; width: 100%; margin: -2mm 0 5mm; font-size: 8.5pt; }
+  table.areas th { background: #eef4f4; color: var(--muted); font-weight: 500; text-transform: uppercase; letter-spacing: .05em; font-size: 7.5pt; padding: 2mm 2.5mm; text-align: center; border: 1px solid var(--rule); }
+  table.areas td { text-align: center; padding: 2.5mm; border: 1px solid var(--rule); font-family: "Fraunces", Georgia, serif; font-size: 13pt; font-weight: 600; color: var(--ink); font-variant-numeric: tabular-nums; }
+  table.areas td span { font-family: inherit; font-size: 9pt; color: var(--muted); font-weight: 400; }
+  h3.second-measure { font-size: 11pt; margin: 7mm 0 3mm; }
   .overall { display: flex; align-items: center; gap: 6mm; border: 1px solid var(--rule); border-radius: 5px; padding: 5mm 6mm; background: #f4f8f8; margin: 5mm 0 4mm; }
   .overall-num { font-family: "Fraunces", Georgia, serif; font-size: 44pt; font-weight: 600; line-height: 1; color: var(--accent); font-variant-numeric: tabular-nums; }
   .overall-num span { font-size: 18pt; color: var(--muted); }
@@ -180,15 +182,24 @@ export function toHtml(audit, brand = null) {
   const groups = [['technical', 'Technical'], ['onpage', 'On-page'], ['content', 'Content'], ['aeo', 'Answer engines'], ['geo', 'Generative engines'], ['offpage', 'Off-page and trust'], ['conversion', 'Conversion'], ['overview', 'Overview']];
   const checksBy = (g) => (a.checks || []).filter((c) => c.group === g);
   const { scores: measured, scoreBasis } = computeScores(a.checks || []);
-  // Один балл на весь отчёт стоит заголовком, шесть областей под ним расшифровкой. До 14.09.2026
-  // в письме и в PDF стояли числа из двух разных движков, и читатель делал единственный возможный
-  // вывод: цифры выдуманы. Веса печатаются рядом, чтобы балл можно было пересчитать руками.
-  const overall = computeOverall(a.checks || []);
-  const overallBlock = overall.score === null ? '' : `<div class="overall">
+  /*
+   * Заголовок отчёта это тот же балл видимости, который человек увидел на странице бесплатной
+   * проверки, и он приходит готовым из `audit.overall`: пересчитывать его здесь нельзя, иначе
+   * снова получатся два числа про один сайт. Под ним его же пять областей, которые дают в сумме
+   * ровно заголовок, чтобы читатель мог сложить их и сойтись.
+   *
+   * Шесть областей отчёта печатаются ниже отдельным блоком и с другой подписью: это второе,
+   * независимое измерение по проверкам самого отчёта, а не разбивка заголовка. Сводить их с
+   * заголовком не нужно и не получится, и об этом сказано словами.
+   */
+  const overall = a.overall && a.overall.score !== undefined ? a.overall : null;
+  const overallAreas = overall && Array.isArray(overall.areas) ? overall.areas : [];
+  const overallBlock = !overall || overall.score === null ? '' : `<div class="overall">
     <div class="overall-num ${scoreClass(Math.round(overall.score / 10))}">${overall.score}<span>/100</span></div>
     <div class="overall-side"><div class="overall-label">${esc(L.overallLabel)}</div>
-      <div class="overall-grade">${esc(L.grades[overall.grade] || overall.grade)}</div>
-      <div class="overall-note">${esc(L.overallNote(overall))}</div></div></div>`;
+      <div class="overall-grade">${esc((L.grades && L.grades[overall.grade]) || overall.grade)}</div>
+      <div class="overall-note">${esc(L.overallNote)}</div></div></div>`
+    + (overallAreas.length ? `<table class="areas"><tr>${overallAreas.map((x) => `<th>${esc(x.label)}</th>`).join('')}</tr><tr>${overallAreas.map((x) => `<td>${x.score}<span>/${x.max}</span></td>`).join('')}</tr></table>` : '');
   const scoreCards = Object.entries(measured).map(([label, n]) => {
     const basis = scoreBasis[label] || {};
     const shown = (L.areas && L.areas[label]) || label;
@@ -209,7 +220,7 @@ export function toHtml(audit, brand = null) {
     <dl class="cover-meta"><div><dt>${L.auditSubject}</dt><dd>${t(a.client.name)}</dd></div><div><dt>${L.reportDate}</dt><dd>${esc(a.client.reportDate)}</dd></div><div><dt>${L.auditType}</dt><dd>${esc(a.meta.auditType)}</dd></div><div><dt>${L.preparedBy}</dt><dd>${esc(preparedBy)}</dd></div></dl></div>
     ${toolLine}</div></div>`);
   n++;
-  pages.push(`<div class="page">${header(a, L.secSummary, L)}<div class="eyebrow">${L.summaryEyebrow}</div><h2>${L.secSummary}</h2><p class="lead">${t(a.summary.lead)}</p>${overallBlock}<div class="scorecard">${scoreCards}</div><p class="scorecard-foot">${L.scorecardFoot}</p><div class="verdict"><p><strong>${L.keyTakeaway}</strong> ${t(a.summary.verdict)}</p></div><h3>${L.threePriorities}</h3>${olist(a.summary.priorities)}${footer(a, n++, preparedBy)}</div>`);
+  pages.push(`<div class="page">${header(a, L.secSummary, L)}<div class="eyebrow">${L.summaryEyebrow}</div><h2>${L.secSummary}</h2><p class="lead">${t(a.summary.lead)}</p>${overallBlock}<h3 class="second-measure">${L.secondMeasure}</h3><div class="scorecard">${scoreCards}</div><p class="scorecard-foot">${L.scorecardFoot}</p><div class="verdict"><p><strong>${L.keyTakeaway}</strong> ${t(a.summary.verdict)}</p></div><h3>${L.threePriorities}</h3>${olist(a.summary.priorities)}${footer(a, n++, preparedBy)}</div>`);
   pages.push(`<div class="page">${header(a, L.secOverview, L)}<div class="eyebrow">${L.overviewEyebrow}</div><h2>${L.whatSiteIs}</h2><table><tr><th>${L.parameter}</th><th>${L.value}</th></tr>${(a.overview.rows || []).map(([k, v]) => `<tr><td>${t(k)}</td><td>${t(v)}</td></tr>`).join('')}</table><p>${t(a.overview.note)}</p><h3>${L.pagesSampled}</h3><table><tr><th>${L.colUrl}</th><th>${L.colTitle}</th><th>${L.colWords}</th><th>H1</th><th>Alt</th></tr>${(a.sample || []).filter((p) => p.title !== undefined).slice(0, 14).map((p) => `<tr><td><code>${esc(new URL(p.url).pathname)}</code></td><td>${esc(p.title)}</td><td>${p.words}</td><td>${p.h1Count}</td><td>${p.images ? `${p.images - p.imagesNoAlt}/${p.images}` : '·'}</td></tr>`).join('')}</table>${footer(a, n++, preparedBy)}</div>`);
   const cardBody = (c) => [
     c.text ? `<p>${t(c.text)}</p>` : '',

package/src/test-overall.mjs

@@ -1,110 +1,117 @@
 #!/usr/bin/env node
-/** Один балл из ста: и в объекте аудита, и в отчёте, и на обоих языках.
+/** Один балл на странице, в письме и в отчёте.
  *
- *  14.09.2026 человек получил письмо с «45 из 100» и приложенный PDF, где шесть областей давали
- *  44 из 60, то есть 73 процента. Два разных движка в одном документе читаются как выдуманные
- *  цифры. Эти тесты держат единственный источник балла и запрет считать неизмеренное нулём. */
+ *  14.09.2026 человек увидел 46 на странице проверки, 61 в письме и шесть областей из шестидесяти
+ *  в приложенном PDF. Три числа про один сайт за один день. Считали их разные движки с разными
+ *  рамками, и единственный вывод, который делает читатель, это что цифры выдуманы.
+ *
+ *  Теперь движок один и живёт в этом пакете, а параметры зафиксированы в VISIBILITY_DEFAULTS.
+ *  Эти тесты держат три вещи: балл сходится сам с собой, сборщик берёт его у того же движка, и
+ *  отчёт печатает именно его, на обоих языках. */
 import { readFileSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { collect, computeOverall, computeScores, verifyScores, SCORE_AREAS } from './collect.mjs';
+import { checkVisibility, VISIBILITY_DEFAULTS } from './visibility.mjs';
 import { toHtml } from './render.mjs';
 
 let bad = 0;
 const ok = (n, c) => { if (c) console.log(`ok   ${n}`); else { bad++; console.error(`FAIL ${n}`); } };
 const is = (n, a, b) => ok(`${n} (ждали ${JSON.stringify(b)}, вышло ${JSON.stringify(a)})`, JSON.stringify(a) === JSON.stringify(b));
-
 const c = (group, status, i = 0) => ({ id: `${group}-${status}-${i}`, group, status, label: group, value: 'x' });
 
-// Веса это решение, а не измерение, но сумма обязана быть сотней, иначе балл не из ста.
-is('веса дают ровно сто', SCORE_AREAS.reduce((s, a) => s + a.weight, 0), 100);
-
-// Всё пройдено это сто, всё провалено это ноль.
+// ---- балл по проверкам отчёта: отдельное измерение, оно обязано пересчитываться из checks
+is('веса шести областей дают сто', SCORE_AREAS.reduce((s, a) => s + a.weight, 0), 100);
 const every = (status) => SCORE_AREAS.flatMap((a) => a.groups.map((g) => c(g, status)));
-is('все проверки пройдены: сто', computeOverall(every('ok')).score, 100);
-is('все проверки провалены: ноль', computeOverall(every('bad')).score, 0);
-is('все спорные: половина', computeOverall(every('warn')).score, 50);
-
-// Неизмеренная область выкидывается из знаменателя, а не получает ноль. Ноль за то, чего не
-// мерили, это неверное измерение, ровно как «0 знаков» вместо «описания у страницы нет».
+is('все пройдены: сто', computeOverall(every('ok')).score, 100);
+is('все провалены: ноль', computeOverall(every('bad')).score, 0);
+is('пустой набор не даёт нуля', computeOverall([]).score, null);
 {
-  const partial = [c('technical', 'ok'), c('geo', 'ok')];
-  const o = computeOverall(partial);
-  is('измеренное на отлично даёт сто даже при неполном покрытии', o.score, 100);
-  is('в знаменатель попали только измеренные веса', o.weighed, 40);
-  ok('и отчёт об этом говорит', /40 of 100 points were measurable/.test(o.note));
-  ok('неизмеренные области в разбивку не попали', o.parts.length === 2);
+  const o = computeOverall([c('technical', 'ok'), c('geo', 'ok')]);
+  is('неизмеренное выпадает из знаменателя, а не становится нулём', o.score, 100);
+  is('в знаменателе только измеренные веса', o.weighed, 40);
 }
 
-// Пустой аудит не выдаёт ноль: нечего мерить это не то же самое, что всё плохо.
-{
-  const o = computeOverall([]);
-  is('пустой набор проверок не даёт нуля', o.score, null);
-  is('и называется неизмеренным', o.grade, 'not measured');
-}
+// ---- параметры измерения зафиксированы: их расхождение и есть расхождение чисел
+is('бюджет времени один на всех', VISIBILITY_DEFAULTS.budgetMs, 8500);
+is('глубина выборки одна на всех', VISIBILITY_DEFAULTS.samplePages, 3);
+ok('параметры нельзя поменять на ходу', Object.isFrozen(VISIBILITY_DEFAULTS));
 
-// Проверки со статусом na не считаются ни в плюс, ни в минус.
+// ---- балл видимости сходится сам с собой
 {
-  const withNa = [c('technical', 'ok'), { ...c('technical', 'na'), status: 'na' }];
-  is('na не портит и не улучшает балл', computeOverall(withNa).score, 100);
+  const audit = { checks: [], overall: { score: 61, areas: [{ score: 20, max: 25 }, { score: 10, max: 15 }, { score: 12, max: 20 }, { score: 14, max: 25 }, { score: 5, max: 15 }] } };
+  is('честный заголовок проверку проходит', verifyScores(audit), []);
+  ok('подделанный заголовок ловится', verifyScores({ ...audit, overall: { ...audit.overall, score: 70 } }).some((p) => p.startsWith('overall')));
+  ok('шкала не из ста ловится', verifyScores({ checks: [], overall: { score: 20, areas: [{ score: 20, max: 30 }] } }).some((p) => /out of 30/.test(p)));
 }
-
-// Балл в отчёте обязан сходиться с проверками этого же отчёта.
 {
-  const audit = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  const o = computeOverall(audit.checks || []);
-  audit.overall = o;
-  const problems = verifyScores(audit);
-  ok('честный отчёт проходит проверку', !problems.some((p) => p.startsWith('overall')));
-  audit.overall = { ...o, score: (o.score + 7) % 101 };
-  ok('подделанный балл ловится', verifyScores(audit).some((p) => p.startsWith('overall')));
+  const checks = [c('technical', 'ok'), c('geo', 'bad')];
+  const audit = { checks, scores: computeScores(checks).scores, reportScore: computeOverall(checks) };
+  is('балл по проверкам отчёта сходится с checks', verifyScores(audit), []);
+  ok('подделанный балл по проверкам ловится', verifyScores({ ...audit, reportScore: { score: 99 } }).some((p) => p.startsWith('reportScore')));
 }
 
-// Оба языка. Сегодня дважды чинили русскую ветку и оставляли английскую сломанной.
+/*
+ * Движок намеренно отказывается мерить приватные адреса: публичная проверка не должна ходить
+ * по чужой локальной сети. Значит локальным сайтом «одно число» не докажешь, и это правильно.
+ * Здесь проверяется, что в таком случае сборщик не выдумывает балл, а честно отдаёт «не измерено»,
+ * и что отчёт от этого не ломается. Совпадение чисел на живом сайте проверяется отдельно,
+ * командой `npm run verify:live`, потому что для этого нужна сеть.
+ */
 {
-  const audit = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  const expected = computeOverall(audit.checks || []).score;
-  for (const [lang, grade, note] of [['en', /Strong|Workable|Weak|Critical/, /Weighted from the areas below/], ['ru', /Сильно|Рабочее состояние|Слабо|Критично/, /Взвешен по областям ниже/]]) {
+  const server = createServer((req, res) => {
+    res.setHeader('content-type', 'text/html');
+    res.end('<!doctype html><html><head><title>Local</title></head><body><h1>Local</h1><p>Text.</p></body></html>');
+  });
+  await new Promise((r) => server.listen(0, '127.0.0.1', r));
+  const base = `http://127.0.0.1:${server.address().port}/`;
+  const direct = await checkVisibility(base, { ...VISIBILITY_DEFAULTS, lang: 'en' });
+  const audit = await collect(base, { pages: 2, log: () => {} });
+  server.close();
+
+  ok('приватный адрес движок мерить отказывается', !direct.ok);
+  is('и сборщик не выдумывает за него балл', audit.overall.score, null);
+  is('а называет это неизмеренным', audit.overall.grade, 'not measured');
+  is('и говорит, откуда балл должен был прийти', audit.overall.source, 'visibility');
+  ok('причина отказа сохранена, а не потеряна', typeof audit.overall.error === 'string' && audit.overall.error.length > 0);
+  ok('балл по проверкам отчёта при этом посчитан', typeof audit.reportScore.score === 'number');
+  is('и отчёт по-прежнему сходится сам с собой', verifyScores(audit), []);
+
+  for (const lang of ['en', 'ru']) {
     audit.meta.lang = lang;
     const html = toHtml(audit, null);
-    const num = (html.match(/overall-num[^>]*>(\d+)<span>/) || [])[1];
-    is(`${lang}: в отчёте стоит тот же балл, что считают проверки`, Number(num), expected);
-    ok(`${lang}: оценка словом на своём языке`, grade.test((html.match(/overall-grade">([^<]*)</) || [])[1] || ''));
-    ok(`${lang}: веса напечатаны, балл можно пересчитать руками`, note.test(html));
-    ok(`${lang}: в подписи нет чужого языка`, lang === 'en'
-      ? !/[А-Яа-яЁё]/.test((html.match(/overall-note">([^<]*)</) || [])[1] || '')
-      : !/Weighted|measurable/.test((html.match(/overall-note">([^<]*)</) || [])[1] || ''));
+    // Искать надо напечатанный элемент, а не название стиля: `.overall-num` есть в CSS всегда.
+    ok(`${lang}: без балла заголовок не печатается вовсе`, !/<div class="overall-num/.test(html));
+    ok(`${lang}: шесть областей отчёта на месте`, /second-measure/.test(html));
   }
-  // Русское склонение: 75 баллов, а не 75 балла.
-  audit.meta.lang = 'ru';
-  ok('русское склонение «баллов» верное', !/\d+ балла из 100/.test(toHtml(audit, null)));
 }
 
-// Шесть областей никуда не делись: общий балл их дополняет, а не заменяет.
+// Тот же отчёт, но с настоящим баллом: печать заголовка и обе подписи.
 {
   const audit = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  const { scores } = computeScores(audit.checks || []);
-  const html = toHtml(audit, null);
-  ok('разбивка по областям осталась под общим баллом', Object.keys(scores).every((k) => html.includes('/10') || scores[k] === null));
+  audit.overall = { score: 61, grade: 'B', source: 'visibility', areas: [
+    { id: 'access', label: 'Access for AI crawlers', score: 20, max: 25 },
+    { id: 'index', label: 'Agent index', score: 10, max: 15 },
+    { id: 'entity', label: 'Entity and structure', score: 12, max: 20 },
+    { id: 'content', label: 'Answer-first content', score: 14, max: 25 },
+    { id: 'trust', label: 'Freshness and sources', score: 5, max: 15 }] };
+  is('заголовок сходится со своими областями', verifyScores(audit).filter((p) => p.startsWith('overall')), []);
+  for (const [lang, grade] of [['en', /Strong|Workable|Weak|Poor|Critical/], ['ru', /Сильно|Рабочее состояние|Слабо|Плохо|Критично/]]) {
+    audit.meta.lang = lang;
+    const html = toHtml(audit, null);
+    is(`${lang}: в отчёте стоит сохранённый балл`, Number((html.match(/overall-num[^>]*>(\d+)<span>/) || [])[1]), 61);
+    ok(`${lang}: оценка словом на своём языке`, grade.test((html.match(/overall-grade">([^<]*)</) || [])[1] || ''));
+    ok(`${lang}: сказано, что это то же измерение, что на странице`, /ai-visibility/.test((html.match(/overall-note">([^<]*)</) || [])[1] || ''));
+    ok(`${lang}: пять областей напечатаны рядом с баллом`, /table class="areas"/.test(html));
+    const foot = (html.match(/scorecard-foot">([^<]*)</) || [])[1] || '';
+    ok(`${lang}: сказано, что шесть областей не складываются в заголовок`, lang === 'en' ? /not a breakdown/.test(foot) : /\u043d\u0435 \u0440\u0430\u0437\u0431\u0438\u0432\u043a\u0430/.test(foot));
+  }
 }
 
-// Сохранённые оценки обязаны сходиться с итоговым набором проверок того же объекта.
-//
-// 14.09.2026 письмо сказало 61, а PDF напечатал 59: поле снималось до браузерного этапа, а он
-// дописывает проверки. Отчёт считал заново и получал другое число. Тест поднимает маленький сайт
-// и сверяет то, что collect положил в объект, с тем, что даёт функция по его же checks.
+// ---- движок в пакете это та же программа, что стоит на сайтах
 {
-  const server = createServer((req, res) => {
-    if (req.url === '/robots.txt') return res.end('User-agent: *\nAllow: /\nSitemap: http://127.0.0.1:' + server.address().port + '/sitemap.xml');
-    if (req.url === '/sitemap.xml') { res.setHeader('content-type', 'application/xml'); return res.end(`<?xml version="1.0"?><urlset><url><loc>http://127.0.0.1:${server.address().port}/</loc></url></urlset>`); }
-    res.setHeader('content-type', 'text/html');
-    res.end('<!doctype html><html><head><title>A small test page for the audit collector</title><meta name="description" content="A page that exists only so the collector has something real to read during the test run of the suite."></head><body><h1>Test page</h1><p>Ten pounds a month, measured on our own invoices in 2026.</p><h2>One</h2><p>Text.</p><h2>Two</h2><p>Text.</p><h2>Three</h2><p>Text.</p><a href="mailto:a@b.c">write</a></body></html>');
-  });
-  await new Promise((r) => server.listen(0, '127.0.0.1', r));
-  const audit = await collect(`http://127.0.0.1:${server.address().port}/`, { pages: 2, log: () => {} });
-  server.close();
-  is('сохранённый общий балл равен пересчитанному по тем же проверкам', audit.overall.score, computeOverall(audit.checks).score);
-  is('сохранённые оценки областей тоже сходятся', audit.scores, computeScores(audit.checks).scores);
-  is('и собственная проверка отчёта молчит', verifyScores(audit).filter((p) => p.startsWith('overall')), []);
+  const here = readFileSync(new URL('./visibility.mjs', import.meta.url), 'utf8');
+  ok('движок несёт свои параметры', /VISIBILITY_DEFAULTS/.test(here));
+  ok('и не тянет за собой зависимостей', !/^import /m.test(here.replace(/VISIBILITY_DEFAULTS/g, '')));
 }
 
 if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }

package/src/verify-live.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/** Живая сверка: балл движка и балл, который кладёт в отчёт сборщик, на одном и том же сайте.
+ *  Нужна сеть, поэтому отдельно от npm test. Запуск: node src/verify-live.mjs <адрес> [ещё...] */
+import { collect } from './collect.mjs';
+import { checkVisibility, VISIBILITY_DEFAULTS } from './visibility.mjs';
+
+const sites = process.argv.slice(2);
+if (!sites.length) { console.error('укажите хотя бы один адрес'); process.exit(2); }
+let bad = 0;
+for (const site of sites) {
+  for (const lang of ['en', 'ru']) {
+    const direct = await checkVisibility(site, { ...VISIBILITY_DEFAULTS, lang });
+    const audit = await collect(site, { pages: 5, lang, log: () => {} });
+    const a = direct.ok ? direct.score : null;
+    const b = audit.overall.score;
+    const same = a === b;
+    if (!same) bad++;
+    const sum = (audit.overall.areas || []).reduce((s, x) => s + x.score, 0);
+    console.log(`${same ? 'ok  ' : 'FAIL'} ${site} [${lang}] движок ${a} | отчёт ${b} | сумма областей ${audit.overall.areas?.length ? sum : '-'} | ${audit.overall.grade}`);
+  }
+}
+if (bad) { console.error(`\n${bad} расхождений`); process.exit(1); }
+console.log('\nбалл совпадает везде');

package/src/visibility.mjs

@@ -0,0 +1,491 @@
+/**
+ * AI visibility check: can ChatGPT, Perplexity, Copilot, Claude and Gemini read, understand
+ * and cite this site? Public signals only, one homepage fetch plus robots, llms.txt, the
+ * sitemap head and up to three sampled pages, all in parallel, under a hard time budget so it
+ * runs inside a serverless function. Plain ESM so the same module runs in Node for tests.
+ *
+ * The measurement is language-neutral; only the words a person reads come from the MESSAGES
+ * table below, picked by the `lang` option ('en' by default, 'ru' on oper-stack.ru). Finding ids
+ * and area ids never change with the language, so task lists and reports can key on them.
+ *
+ * This file is also vendored by the Apify actor (OperStack/apify-ai-visibility/src). The two
+ * copies must stay byte for byte identical, and `npm test` in the actor fails if they drift.
+ * That is why `samplePages` lives here although both sites leave it at three: a copy that has
+ * to differ is a copy nobody keeps in sync, and this one had drifted by 304 lines.
+ */
+
+const UA = 'Mozilla/5.0 (compatible; OperStackVisibility/0.1; +https://oper-stack.com/ai-visibility/)';
+const MAX_BODY = 600_000;
+
+const AI_AGENTS = [
+  { agent: 'oai-searchbot', label: 'ChatGPT search (OAI-SearchBot)', labelRu: 'Поиск ChatGPT (OAI-SearchBot)', kind: 'search' },
+  { agent: 'chatgpt-user', label: 'ChatGPT browsing (ChatGPT-User)', labelRu: 'Просмотр страниц ChatGPT (ChatGPT-User)', kind: 'search' },
+  { agent: 'gptbot', label: 'OpenAI training (GPTBot)', labelRu: 'Обучение OpenAI (GPTBot)', kind: 'train' },
+  { agent: 'perplexitybot', label: 'Perplexity (PerplexityBot)', labelRu: 'Perplexity (PerplexityBot)', kind: 'search' },
+  { agent: 'perplexity-user', label: 'Perplexity browsing (Perplexity-User)', labelRu: 'Просмотр страниц Perplexity (Perplexity-User)', kind: 'search' },
+  { agent: 'claudebot', label: 'Claude (ClaudeBot)', labelRu: 'Claude (ClaudeBot)', kind: 'train' },
+  { agent: 'claude-searchbot', label: 'Claude search (Claude-SearchBot)', labelRu: 'Поиск Claude (Claude-SearchBot)', kind: 'search' },
+  { agent: 'claude-user', label: 'Claude browsing (Claude-User)', labelRu: 'Просмотр страниц Claude (Claude-User)', kind: 'search' },
+  { agent: 'anthropic-ai', label: 'Anthropic (anthropic-ai)', labelRu: 'Anthropic (anthropic-ai)', kind: 'train' },
+  { agent: 'google-extended', label: 'Gemini grounding (Google-Extended)', labelRu: 'Gemini (Google-Extended)', kind: 'train' },
+  { agent: 'bingbot', label: 'Copilot and Bing (Bingbot)', labelRu: 'Copilot и Bing (Bingbot)', kind: 'search' },
+  { agent: 'applebot-extended', label: 'Apple Intelligence (Applebot-Extended)', labelRu: 'Apple Intelligence (Applebot-Extended)', kind: 'train' },
+  { agent: 'ccbot', label: 'Common Crawl (CCBot)', labelRu: 'Common Crawl (CCBot)', kind: 'train' },
+  { agent: 'duckassistbot', label: 'DuckDuckGo AI (DuckAssistBot)', labelRu: 'DuckDuckGo AI (DuckAssistBot)', kind: 'search' },
+];
+
+/**
+ * Russian plural form: pl(1, ...) is "страница", pl(2, ...) "страницы", pl(5, ...) "страниц".
+ * Two shapes are needed and they differ: a bare count takes the counted form, while "из N"
+ * always takes the genitive, which is plural for every N but one. Getting this wrong reads as
+ * broken Russian on the one screen we send catalogue traffic to.
+ */
+const pl = (n, one, few, many) => { const a = Math.abs(n) % 100; const b = a % 10; return a > 10 && a < 20 ? many : b > 1 && b < 5 ? few : b === 1 ? one : many; };
+const ofPages = (n) => (n === 1 ? 'проверенной страницы' : 'проверенных страниц');
+
+/** Exported so the offline test can assert the Russian forms without hitting the network. */
+export const MESSAGES = {
+  en: {
+    badInput: 'Enter a public site address, for example example.com',
+    tooSlow: 'The site took too long to answer',
+    badAnswer: (status, url) => `The site answered ${status || 'nothing'} for ${url}`,
+    botWall: (status) => `The site refuses unknown clients (HTTP ${status}). AI fetchers that do not run a browser get the same answer, so nothing here can be read or quoted.`,
+    botChallenge: (status) => `The site sits behind a browser challenge (Cloudflare, HTTP ${status}). AI fetchers do not run one, so ChatGPT, Perplexity and the rest are turned away exactly as this check was, and nothing on the site can be quoted.`,
+    area: { access: 'Can AI crawlers read it', index: 'Is there a map for agents (llms.txt)', entity: 'Is the entity clear (schema)', content: 'Is there something to quote', trust: 'Can it be dated and trusted' },
+    robotsAllBlocked: 'robots.txt disallows the whole site for every crawler. Nothing can read it.',
+    fetchersBlocked: (list) => `Blocked answer-engine fetchers: ${list}. These are the bots that cite pages live.`,
+    trainingBlocked: (list) => `Blocked training crawlers: ${list}. Models will not learn the brand from the site.`,
+    noaiMeta: 'A page carries a noai robots meta tag.',
+    allAllowed: (n, signal) => `All ${n} AI crawlers and fetchers are allowed${signal ? ` (Content-Signal: ${signal})` : ''}.`,
+    llmsMissing: 'No llms.txt. Answer engines get no map of what the site is and which pages matter.',
+    llmsNotText: '/llms.txt answers with an HTML page instead of a text index.',
+    llmsForeign: (hosts) => `llms.txt links mostly to other hosts (${hosts}). An AI system may misidentify the business.`,
+    llmsOk: (n) => `llms.txt present with ${n} link(s) to the site's own pages.`,
+    orgOk: 'Organization or business schema names the entity behind the site.',
+    orgMissing: 'No Organization or business schema: AI systems have no entity to attach the site to.',
+    faqOk: 'FAQPage schema found, the easiest format for an engine to quote.',
+    faqMissing: 'No FAQPage schema on the sampled pages.',
+    articleOk: 'Article schema on the sampled pages: an engine can name and date what it is quoting.',
+    pageTypeOk: (type) => `${type} schema on the sampled pages: an engine can name what it is quoting.`,
+    pageTypeMissing: 'The sampled pages carry no page-level type (Article, Service, Product, Course and the like), so an engine cannot say what kind of thing it is quoting.',
+    canonicalMissing: 'The homepage has no canonical tag.',
+    ogMissing: 'No Open Graph tags on the homepage: shared links and previews render without a title or image.',
+    thinPages: (thin, total) => `${thin} of ${total} sampled page(s) hold under 300 words. Engines rarely cite thin pages.`,
+    avgWords: (avg) => `Sampled pages carry ${avg} words on average.`,
+    answerFirstMissing: (n, total) => `${n} of ${total} sampled page(s) open with an answer-first paragraph (20 to 90 words with a figure right after the H1). That paragraph is what gets quoted.`,
+    answerFirstOk: 'Every sampled page opens with an answer-first paragraph carrying a figure.',
+    fewH2: (n) => `${n} sampled page(s) have fewer than three H2 sections.`,
+    noTables: 'No tables on the sampled pages. Tables are the second most quoted format after the first paragraph.',
+    homeOnly: 'Only the homepage could be read, so this area is measured on one page rather than several. A sitemap that answers would give a fuller picture.',
+    datesMissing: (n) => `${n} sampled page(s) expose no publication or modified date. Engines prefer sources they can date.`,
+    datesOk: 'Sampled pages expose publication dates.',
+    noFigures: 'The sampled pages state no figures, so there is nothing that needs a source named.',
+    sourcesMissing: (n, total) => `${n} of ${total} sampled page(s) state figures without naming where they came from ("according to", "data from").`,
+    sourcesOk: 'Every sampled page that states figures names where they came from.',
+    sitemapNoLastmod: 'The sitemap carries no lastmod dates.',
+    sitemapTimedOut: 'The sitemap did not answer in time, so it was not checked. The score does not count this either way.',
+    sitemapMissing: 'No XML sitemap found at the usual paths or in robots.txt.',
+  },
+  ru: {
+    badInput: 'Введите адрес публичного сайта, например example.ru',
+    tooSlow: 'Сайт слишком долго не отвечал',
+    badAnswer: (status, url) => `Сайт ответил ${status ? `кодом ${status}` : 'ничем'} на ${url}`,
+    botWall: (status) => `Сайт отказывает незнакомым клиентам (код ${status}). Роботы ИИ, которые не запускают браузер, получают тот же ответ, поэтому прочитать и процитировать здесь нечего.`,
+    botChallenge: (status) => `Сайт закрыт проверкой браузера (Cloudflare, код ${status}). Роботы ИИ её не проходят, поэтому ChatGPT, Perplexity и остальных разворачивают ровно так же, как развернули эту проверку, и процитировать с сайта нельзя ничего.`,
+    area: { access: 'Могут ли роботы ИИ прочитать сайт', index: 'Есть ли карта для агентов (llms.txt)', entity: 'Понятно ли, кто вы (разметка)', content: 'Есть ли что процитировать', trust: 'Можно ли датировать и доверять' },
+    robotsAllBlocked: 'robots.txt закрывает весь сайт для всех роботов. Его никто не может прочитать.',
+    fetchersBlocked: (list) => `Закрыты поисковые роботы ответных систем: ${list}. Именно они достают страницу, чтобы процитировать её в ответе.`,
+    trainingBlocked: (list) => `Закрыты обучающие роботы: ${list}. Модели не узнают о бренде с сайта.`,
+    noaiMeta: 'На одной из страниц стоит мета-тег robots со значением noai.',
+    allAllowed: (n, signal) => `Все ${n} роботов ИИ допущены на сайт${signal ? ` (Content-Signal: ${signal})` : ''}.`,
+    llmsMissing: 'Нет llms.txt. Ответные системы не получают карты: что это за сайт и какие страницы главные.',
+    llmsNotText: '/llms.txt отдаёт HTML-страницу вместо текстового указателя.',
+    llmsForeign: (hosts) => `Ссылки в llms.txt ведут в основном на чужие домены (${hosts}). Система ИИ может перепутать, чей это бизнес.`,
+    llmsOk: (n) => `llms.txt есть, в нём ${n} ${pl(n, 'ссылка', 'ссылки', 'ссылок')} на страницы самого сайта.`,
+    orgOk: 'Разметка Organization или бизнеса называет, кто стоит за сайтом.',
+    orgMissing: 'Нет разметки Organization или бизнеса: системам ИИ не к кому привязать сайт.',
+    faqOk: 'Найдена разметка FAQPage, самый удобный для цитирования формат.',
+    faqMissing: 'На проверенных страницах нет разметки FAQPage.',
+    articleOk: 'На проверенных страницах есть разметка Article: система может назвать и датировать то, что цитирует.',
+    pageTypeOk: (type) => `На проверенных страницах есть разметка ${type}: система может назвать, что именно цитирует.`,
+    pageTypeMissing: 'На проверенных страницах нет типа страницы (Article, Service, Product, Course и подобных), поэтому система не может сказать, что за вещь она цитирует.',
+    canonicalMissing: 'На главной нет канонического адреса (тега canonical).',
+    ogMissing: 'На главной нет тегов Open Graph: ссылка в мессенджерах и соцсетях показывается без заголовка и картинки.',
+    thinPages: (thin, total) => (total === 1
+      ? 'Единственная проверенная страница короче 300 слов. Короткие страницы цитируют редко.'
+      : `Из ${total} ${ofPages(total)} ${thin} короче 300 слов. Короткие страницы цитируют редко.`),
+    avgWords: (avg) => `На проверенных страницах в среднем ${avg} ${pl(avg, 'слово', 'слова', 'слов')}.`,
+    answerFirstMissing: (n, total) => (total === 1
+      ? 'Единственная проверенная страница не начинается с абзаца-ответа (20-90 слов с цифрой сразу после H1). Именно этот абзац попадает в цитату.'
+      : `Из ${total} ${ofPages(total)} с абзаца-ответа (20-90 слов с цифрой сразу после H1) ${n === 0 ? 'не начинается ни одна' : n === 1 ? 'начинается одна' : `начинаются ${n}`}. Именно этот абзац попадает в цитату.`),
+    answerFirstOk: 'Каждая проверенная страница начинается с абзаца-ответа с цифрой.',
+    fewH2: (n, total) => (total === 1
+      ? 'У единственной проверенной страницы меньше трёх подзаголовков H2.'
+      : `У ${n} из ${total} ${ofPages(total)} меньше трёх подзаголовков H2.`),
+    noTables: 'На проверенных страницах нет таблиц. Таблица второй по цитируемости формат после первого абзаца.',
+    homeOnly: 'Прочитать удалось только главную, поэтому эта область измерена по одной странице, а не по нескольким. Отвечающая карта сайта дала бы полную картину.',
+    datesMissing: (n, total) => (total === 1
+      ? 'Единственная проверенная страница не показывает дату публикации или изменения. Системы предпочитают источники, которые можно датировать.'
+      : `${n} из ${total} ${ofPages(total)} не ${n === 1 ? 'показывает' : 'показывают'} дату публикации или изменения. Системы предпочитают источники, которые можно датировать.`),
+    datesOk: 'Проверенные страницы показывают даты публикации.',
+    noFigures: 'На проверенных страницах нет цифр, поэтому и источники называть нечему.',
+    sourcesMissing: (n, total) => (total === 1
+      ? 'Единственная проверенная страница с цифрами не называет, откуда они («по данным», «источник»).'
+      : `${n} из ${total} ${ofPages(total)} ${n === 1 ? 'приводит' : 'приводят'} цифры, не называя, откуда они («по данным», «источник»).`),
+    sourcesOk: 'Каждая проверенная страница с цифрами называет их источник.',
+    sitemapNoLastmod: 'В карте сайта нет дат изменения (lastmod).',
+    sitemapTimedOut: 'Карта сайта не ответила вовремя, поэтому её не проверяли. На оценку это не влияет ни в какую сторону.',
+    sitemapMissing: 'XML-карта сайта не найдена ни по обычным адресам, ни в robots.txt.',
+  },
+};
+
+function isPrivateHost(host) {
+  const h = host.toLowerCase();
+  if (h === 'localhost' || h.endsWith('.localhost') || h.endsWith('.local') || h.endsWith('.internal')) return true;
+  const m = h.match(/^(\d+)\.(\d+)\.(\d+)\.(\d+)$/);
+  if (m) {
+    const [a, b] = [Number(m[1]), Number(m[2])];
+    return a === 10 || a === 127 || a === 0 || (a === 169 && b === 254) || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168) || a >= 224;
+  }
+  return h.includes(':') || h.startsWith('[');
+}
+
+export function normaliseInput(input) {
+  let s = String(input || '').trim();
+  if (!s) return null;
+  if (!/^https?:\/\//i.test(s)) s = `https://${s}`;
+  let u;
+  try { u = new URL(s); } catch { return null; }
+  if (!/^https?:$/.test(u.protocol) || !u.hostname.includes('.') || isPrivateHost(u.hostname)) return null;
+  u.hash = ''; u.search = '';
+  return u.href;
+}
+
+async function get(url, { timeout = 6000, method = 'GET' } = {}) {
+  const c = new AbortController(); const t = setTimeout(() => c.abort(), timeout);
+  const started = Date.now();
+  try {
+    const res = await fetch(url, { method, redirect: 'follow', signal: c.signal, headers: { 'user-agent': UA, accept: 'text/html,application/xml,text/plain,*/*' } });
+    let text = '';
+    if (method === 'GET') { const buf = await res.arrayBuffer(); text = new TextDecoder('utf-8', { fatal: false }).decode(buf.slice(0, MAX_BODY)); }
+    return { ok: res.ok, status: res.status, url: res.url, type: res.headers.get('content-type') || '', server: res.headers.get('server') || '', mitigated: res.headers.get('cf-mitigated') || '', text, ms: Date.now() - started };
+  } catch (e) { return { ok: false, status: 0, url, type: '', text: '', ms: Date.now() - started, error: e.name === 'AbortError' ? 'timeout' : 'unreachable' }; }
+  finally { clearTimeout(t); }
+}
+
+const strip = (s) => s.replace(/<script[\s\S]*?<\/script>/gi, ' ').replace(/<style[\s\S]*?<\/style>/gi, ' ').replace(/<[^>]+>/g, ' ').replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/\s+/g, ' ').trim();
+const attr = (html, re) => { const m = html.match(re); return m ? m[1].trim() : ''; };
+
+export function parseRobots(text) {
+  const blocks = []; let cur = null;
+  for (const raw of (text || '').split(/\r?\n/)) {
+    const line = raw.replace(/#.*$/, '').trim(); if (!line) continue;
+    const m = line.match(/^([a-z-]+)\s*:\s*(.*)$/i); if (!m) continue;
+    const key = m[1].toLowerCase(); const val = m[2].trim();
+    if (key === 'user-agent') { if (!cur || cur.rules.length) { cur = { agents: [], rules: [] }; blocks.push(cur); } cur.agents.push(val.toLowerCase()); }
+    else if (cur && (key === 'allow' || key === 'disallow')) cur.rules.push({ key, val });
+  }
+  const signal = (text.match(/^content-signal:\s*(.+)$/im) || [])[1] || '';
+  return { blocks, signal };
+}
+
+/** Effective verdict for one agent: the most specific block wins, then the star block, then allowed. */
+export function agentVerdict(robots, agent) {
+  const own = robots.blocks.find((b) => b.agents.includes(agent));
+  const star = robots.blocks.find((b) => b.agents.includes('*'));
+  const block = own || star;
+  if (!block) return 'allowed';
+  const fullBlock = block.rules.some((r) => r.key === 'disallow' && r.val === '/') && !block.rules.some((r) => r.key === 'allow' && r.val === '/');
+  return fullBlock ? 'blocked' : 'allowed';
+}
+
+/*
+ * Что считается утверждением, требующим источника, и что считается названным источником.
+ *
+ * Здесь дважды ошибались, и оба раза в сторону несправедливого штрафа. Сначала регулярки знали
+ * только английский, и русская страница теряла пять баллов за то, что написана по-русски.
+ * Потом выяснилось хуже: собственная цена («от 800 ₽»), длительность своей же встречи
+ * («30 до 45 минут») и подписанный словом «иллюстративный» пример весов считались утверждениями
+ * о мире, а настоящая ссылка на исследование Harvard Business Review источником не считалась,
+ * потому что рядом не стояло оборота «по данным». Стоматолог, который пишет «приём 45 минут,
+ * от 3 000 ₽», получал ровно тот же штраф.
+ *
+ * Поэтому теперь: цена и длительность это факты о себе, они источника не требуют; источником
+ * считается не только оборот, но и внешняя ссылка рядом с цифрой; а число, честно подписанное
+ * как пример, утверждением не является. \b в JavaScript работает только по латинице, поэтому
+ * кириллица огорожена просмотрами вперёд и назад.
+ */
+const SOURCE_RE = /(?<!\p{L})(according to|source:|sources:|data from|reported by|published by|registry|statistics office|central bank|по данным|источник:|источники:|согласно|по информации|по сведениям|росстат|центробанк|банк россии|росреестр|минфин|минэкономразвития)(?!\p{L})/giu;
+/** Число, которое что-то утверждает о мире: доля, объём, расстояние, площадь. */
+const CLAIM_FIGURE_RE = /\d[\d,.\s]*\s*(%|percent|процент\w*|km\b|км(?!\p{L})|m²|м²|sqm|кв\.?\s?м|тыс(?!\p{L})|млн(?!\p{L})|млрд(?!\p{L})|thousand|million|billion)/giu;
+/*
+ * Число в первом абзаце. «Шестнадцать гейтов» это такая же цифра, как «16»: дом стиля многих
+ * сайтов (и нашего) требует писать числа словами, и проверка, которая видит только 16, штрафует
+ * за грамотность. 13 из 16 наших витрин продуктов попались ровно на этом.
+ * «Один» и «one» не в счёт: в обоих языках это слишком часто не число, а оборот речи.
+ */
+const SPELLED_NUMBER_RE = new RegExp(
+  '(?<![A-Za-z])(two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety|hundred|thousand|million|billion)(?![A-Za-z])'
+  + '|(?<!\\p{L})(два|две|двух|двум|двумя|три|трёх|трех|трём|трем|тремя|четыре|четырёх|четырех|пять|пяти|шесть|шести|семь|семи|восемь|восьми|девять|девяти|десять|десяти'
+  + '|одиннадцат\\p{L}*|двенадцат\\p{L}*|тринадцат\\p{L}*|четырнадцат\\p{L}*|пятнадцат\\p{L}*|шестнадцат\\p{L}*|семнадцат\\p{L}*|восемнадцат\\p{L}*|девятнадцат\\p{L}*'
+  + '|двадцат\\p{L}*|тридцат\\p{L}*|сорок|сорока|пятьдесят|пятидесяти|шестьдесят|шестидесяти|семьдесят|восемьдесят|девяносто|сто|ста|двест\\p{L}*|трист\\p{L}*|четырест\\p{L}*|пятьсот'
+  + '|тысяч\\p{L}*|миллион\\p{L}*|миллиард\\p{L}*)(?!\\p{L})',
+  'iu',
+);
+/** Абзац-ответ несёт число: цифрой или словом. */
+const hasFigure = (text) => /\d/.test(text) || SPELLED_NUMBER_RE.test(text);
+
+/** Число, честно подписанное как пример, не является утверждением. */
+const ILLUSTRATIVE_RE = /(иллюстратив\w*|для примера|условн\w+|примерн\w+|illustrative|for example|hypothetical)/giu;
+/** Ссылка наружу рядом с цифрой это и есть названный источник. */
+const OUTBOUND_LINK_RE = /<a[^>]+href=["']https?:\/\//i;
+
+function analysePage(html, url) {
+  const head = html.slice(0, 200_000);
+  const title = strip(attr(head, /<title[^>]*>([\s\S]*?)<\/title>/i));
+  const description = attr(head, /<meta[^>]+name=["']description["'][^>]+content=["']([^"']*)["']/i) || attr(head, /<meta[^>]+content=["']([^"']*)["'][^>]+name=["']description["']/i);
+  const robotsMeta = attr(head, /<meta[^>]+name=["']robots["'][^>]+content=["']([^"']*)["']/i).toLowerCase();
+  const canonical = attr(head, /<link[^>]+rel=["']canonical["'][^>]+href=["']([^"']*)["']/i) || attr(head, /<link[^>]+href=["']([^"']*)["'][^>]+rel=["']canonical["']/i);
+  const ogTitle = /property=["']og:title["']/i.test(head);
+  const ld = [...html.matchAll(/<script[^>]+application\/ld\+json[^>]*>([\s\S]*?)<\/script>/gi)].map((m) => m[1]);
+  const types = new Set();
+  for (const block of ld) for (const m of block.matchAll(/"@type"\s*:\s*"([A-Za-z]+)"/g)) types.add(m[1]);
+  const datePublished = attr(head, /<meta[^>]+property=["']article:published_time["'][^>]+content=["']([^"']*)["']/i) || (ld.join('\n').match(/"datePublished"\s*:\s*"([^"]+)"/) || [])[1] || '';
+  const dateModified = attr(head, /<meta[^>]+property=["']article:modified_time["'][^>]+content=["']([^"']*)["']/i) || (ld.join('\n').match(/"dateModified"\s*:\s*"([^"]+)"/) || [])[1] || '';
+  // Site chrome is dropped so it cannot be counted as content, with one exception that matters:
+  // an article's title block is usually <header><h1>…</h1><p>the answer…</p></header>. Stripping
+  // every <header> deleted exactly the paragraph this check looks for, so a page that did open
+  // with an answer scored as if it had none. Keep any header that carries the H1.
+  const stripChrome = (h) => h
+    .replace(/<(nav|footer|aside)[\s\S]*?<\/\1>/gi, ' ')
+    .replace(/<header[\s\S]*?<\/header>/gi, (block) => (/<h1[\s>]/i.test(block) ? block : ' '));
+  const bodyHtml = stripChrome((html.match(/<body[\s\S]*<\/body>/i) || [html])[0]);
+  const text = strip(bodyHtml);
+  const words = (text.match(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu) || []).length;
+  const h1 = strip((bodyHtml.match(/<h1[^>]*>([\s\S]*?)<\/h1>/i) || ['', ''])[1]);
+  const h2Count = (bodyHtml.match(/<h2[\s>]/gi) || []).length;
+  const tables = (bodyHtml.match(/<table[\s>]/gi) || []).length;
+  const afterH1 = bodyHtml.split(/<\/h1>/i)[1] || '';
+  const firstPara = strip((afterH1.match(/<p[^>]*>([\s\S]*?)<\/p>/i) || ['', ''])[1]);
+  const firstParaWords = (firstPara.match(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu) || []).length;
+  const answerFirst = firstParaWords >= 20 && firstParaWords <= 90 && hasFigure(firstPara);
+  /*
+   * Цифру и её источник ищем в одном блоке, а не по всей странице: иначе одно «по данным» внизу
+   * прикрывает десять неподписанных чисел сверху. Таблица берётся целиком, потому что подпись
+   * («Иллюстративный вес») стоит в шапке, а число в ячейке.
+   */
+  const tableBlocks = [...bodyHtml.matchAll(/<table[\s\S]*?<\/table>/gi)].map((m) => m[0]);
+  const outsideTables = bodyHtml.replace(/<table[\s\S]*?<\/table>/gi, ' ');
+  const textBlocks = [...outsideTables.matchAll(/<(p|li|h2|h3|figcaption|blockquote)[^>]*>([\s\S]*?)<\/\1>/gi)].map((m) => m[0]);
+  let claimFigures = 0;
+  let unsourcedFigures = 0;
+  for (const block of [...tableBlocks, ...textBlocks]) {
+    const blockText = strip(block);
+    const found = (blockText.match(CLAIM_FIGURE_RE) || []).length;
+    if (!found) continue;
+    claimFigures += found;
+    const named = Boolean(blockText.match(SOURCE_RE)) || Boolean(blockText.match(ILLUSTRATIVE_RE)) || OUTBOUND_LINK_RE.test(block);
+    if (!named) unsourcedFigures += found;
+  }
+  return { url, title, description, robotsMeta, canonical, ogTitle, schemaTypes: [...types], datePublished, dateModified, words, h1, h2Count, tables, firstPara: firstPara.slice(0, 220), answerFirst, claimFigures, unsourcedFigures, noai: /noai|noimageai/.test(robotsMeta) };
+}
+
+async function readSitemap(origin, robotsText, timeoutFn = () => 3000) {
+  const fromRobots = [...(robotsText || '').matchAll(/^sitemap:\s*(\S+)/gim)].map((m) => m[1]);
+  const candidates = fromRobots.length
+    ? [...fromRobots.slice(0, 2), `${origin}/sitemap_index.xml`, `${origin}/sitemap-index.xml`, `${origin}/sitemap.xml`]
+    : [`${origin}/sitemap_index.xml`, `${origin}/sitemap-index.xml`, `${origin}/sitemap.xml`];
+  /*
+   * "We ran out of time" and "there is no sitemap" are different answers and used to score the
+   * same. A slow response once cost a real site three points and made the same site score 78, 81
+   * and 84 on different days, which is the one thing a number we sell must never do.
+   */
+  let timedOut = false;
+  for (const u of [...new Set(candidates)]) {
+    if (timeoutFn() < 500) { timedOut = true; break; }
+    const r = await get(u, { timeout: timeoutFn() });
+    if (r.error === 'timeout') { timedOut = true; continue; }
+    if (!r.ok || !/<(urlset|sitemapindex)/.test(r.text)) continue;
+    let locs = [...r.text.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/g)].map((m) => m[1]);
+    let lastmod = /<lastmod>/.test(r.text);
+    if (/<sitemapindex/.test(r.text) && locs.length && timeoutFn() > 500) {
+      const child = await get(locs[0], { timeout: timeoutFn() });
+      if (child.ok) { locs = [...child.text.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/g)].map((m) => m[1]); lastmod = lastmod || /<lastmod>/.test(child.text); }
+    }
+    return { found: true, url: u, count: locs.length, lastmod, pages: locs.filter((l) => !/\.(xml|pdf|jpe?g|png)$/i.test(l)) };
+  }
+  return { found: false, url: '', count: 0, lastmod: false, pages: [], timedOut };
+}
+
+
+/**
+ * Единственные параметры, с которыми этот балл считается где бы то ни было: на странице проверки,
+ * в аудите и в акторе. Если где-то дать больше страниц или времени, число про один и тот же сайт
+ * разойдётся, и мы вернёмся к тому, ради чего всё это затевалось.
+ */
+export const VISIBILITY_DEFAULTS = Object.freeze({ budgetMs: 8500, samplePages: 3 });
+
+export async function checkVisibility(input, { budgetMs = 8500, lang = 'en', samplePages = 3 } = {}) {
+  const T = MESSAGES[lang] || MESSAGES.en;
+  const agentLabel = (a) => (lang === 'ru' ? a.labelRu : a.label);
+  const started = Date.now();
+  const deadline = started + budgetMs;
+  const left = () => deadline - Date.now();
+  const url = normaliseInput(input);
+  if (!url) return { ok: false, error: T.badInput };
+  const origin = new URL(url).origin; const host = new URL(url).host;
+  const [home, robotsRes, llmsRes] = await Promise.all([get(url, { timeout: Math.min(6000, left() - 300) }), get(`${origin}/robots.txt`, { timeout: Math.min(4000, left() - 300) }), get(`${origin}/llms.txt`, { timeout: Math.min(4000, left() - 300) })]);
+  if (!home.ok || !/html/i.test(home.type)) {
+    // Код 401/403/405/429 это бот-стена, а не сломанный сайт, и это находка сама по себе: та же
+    // стена, что развернула эту проверку, разворачивает и роботов ответных систем.
+    const blocked = [401, 403, 405, 429].includes(home.status);
+    // Проверка браузера и простой отказ лечатся по-разному, и первое дороже: робот ИИ никогда
+    // её не проходит, поэтому сайт за ней невидим для всех ассистентов, что бы ни было на
+    // страницах. Пришло из актора Apify, где это работало, а на сайтах человек видел «403».
+    const challenged = blocked && (/challenge|managed/i.test(home.mitigated) || (/cloudflare/i.test(home.server) && home.status === 403));
+    const error = home.error === 'timeout' ? T.tooSlow
+      : challenged ? T.botChallenge(home.status)
+        : blocked ? T.botWall(home.status)
+          : T.badAnswer(home.status, url);
+    return { ok: false, blocked, challenged, status: home.status, error };
+  }
+  const homePage = analysePage(home.text, home.url);
+  const robots = parseRobots(robotsRes.ok ? robotsRes.text : '');
+  const sitemap = left() > 1500 ? await readSitemap(origin, robotsRes.ok ? robotsRes.text : '', () => Math.min(3000, left() - 300)) : { found: false, url: '', count: 0, lastmod: false, pages: [], skipped: true };
+  let sampled = [];
+  if (left() > 2000 && sitemap.pages.length) {
+    const norm = (u) => u.replace(/\/$/, '').toLowerCase();
+    const picks = sitemap.pages.filter((p) => norm(p) !== norm(home.url) && p.startsWith(origin)).sort((a, b) => b.length - a.length).slice(0, Math.max(12, samplePages * 4)).filter((_, i) => i % 4 === 0).slice(0, samplePages);
+    const rs = await Promise.all(picks.map((p) => get(p, { timeout: Math.min(4000, left() - 300) })));
+    sampled = rs.filter((r) => r.ok && /html/i.test(r.type)).map((r) => analysePage(r.text, r.url));
+  }
+  const pages = [homePage, ...sampled];
+
+  // llms.txt
+  const llmsIsText = llmsRes.ok && !/<html/i.test(llmsRes.text.slice(0, 400));
+  const llmsLinks = llmsIsText ? [...llmsRes.text.matchAll(/https?:\/\/[^\s)\]>]+/g)].map((m) => m[0]) : [];
+  const llmsForeign = llmsLinks.filter((l) => { try { return !new URL(l).host.endsWith(host.replace(/^www\./, '')); } catch { return false; } });
+
+  // Area 1: access for AI crawlers (25)
+  const verdicts = AI_AGENTS.map((a) => ({ ...a, verdict: agentVerdict(robots, a.agent) }));
+  const blockedSearch = verdicts.filter((v) => v.kind === 'search' && v.verdict === 'blocked');
+  const blockedTrain = verdicts.filter((v) => v.kind === 'train' && v.verdict === 'blocked');
+  const starBlocked = agentVerdict(robots, '__none__') === 'blocked';
+  const noai = pages.some((p) => p.noai);
+  let access = 25;
+  if (starBlocked) access = 0; else { access -= Math.min(15, blockedSearch.length * 4); access -= Math.min(8, blockedTrain.length * 2); if (noai) access -= 5; }
+  access = Math.max(0, access);
+  const accessFindings = [];
+  if (starBlocked) accessFindings.push({ id: 'robots-all-blocked', level: 'fail', text: T.robotsAllBlocked });
+  if (blockedSearch.length) accessFindings.push({ id: 'robots-fetchers-blocked', level: 'fail', text: T.fetchersBlocked(blockedSearch.map(agentLabel).join(', ')) });
+  if (blockedTrain.length) accessFindings.push({ id: 'robots-training-blocked', level: 'warn', text: T.trainingBlocked(blockedTrain.map(agentLabel).join(', ')) });
+  if (noai) accessFindings.push({ id: 'noai-meta', level: 'warn', text: T.noaiMeta });
+  if (!accessFindings.length) accessFindings.push({ level: 'pass', text: T.allAllowed(AI_AGENTS.length, robots.signal) });
+
+  // Area 2: agent index (15)
+  let index = 0; const indexFindings = [];
+  if (!llmsRes.ok) indexFindings.push({ id: 'llms-missing', level: 'fail', text: T.llmsMissing });
+  else if (!llmsIsText) { index = 3; indexFindings.push({ id: 'llms-not-text', level: 'fail', text: T.llmsNotText }); }
+  else if (llmsLinks.length && llmsForeign.length > llmsLinks.length / 2) { index = 5; indexFindings.push({ id: 'llms-foreign', level: 'fail', text: T.llmsForeign([...new Set(llmsForeign.map((l) => new URL(l).host))].slice(0, 3).join(', ')) }); }
+  else { index = llmsLinks.length >= 5 ? 15 : 10; indexFindings.push({ level: 'pass', text: T.llmsOk(llmsLinks.length) }); }
+
+  // Area 3: entity and structure (20)
+  const allTypes = new Set(pages.flatMap((p) => p.schemaTypes));
+  const hasOrg = [...allTypes].some((t) => /Organization|Corporation|NGO|EducationalOrganization|GovernmentOrganization|MedicalOrganization|NewsMediaOrganization|Person|LocalBusiness|RealEstateAgent|Dentist|Physician|Hospital|Pharmacy|VeterinaryCare|LegalService|Attorney|Notary|AccountingService|InsuranceAgency|FinancialService|BankOrCreditUnion|AutomotiveBusiness|AutoRepair|AutoDealer|HomeAndConstructionBusiness|Plumber|Electrician|RoofingContractor|HVACBusiness|HousePainter|Locksmith|MovingCompany|GeneralContractor|Restaurant|FoodEstablishment|CafeOrCoffeeShop|Bakery|BarOrPub|LodgingBusiness|Hotel|TravelAgency|HealthAndBeautyBusiness|BeautySalon|HairSalon|DaySpa|NailSalon|TattooParlor|SportsActivityLocation|HealthClub|Gym|ProfessionalService|Store|ClothingStore|GroceryStore|HardwareStore|FurnitureStore|JewelryStore|PetStore|ChildCare|EmploymentAgency|SelfStorage|Library|Museum|EntertainmentBusiness|MedicalClinic|DentalClinic|Optician|PhysicalTherapy|NutritionService|EmergencyService|ITService|WebDesignService|MarketingAgency|AdvertisingAgency/.test(t));
+  const hasFaq = allTypes.has('FAQPage');
+  const hasArticle = [...allTypes].some((t) => /Article|BlogPosting|NewsArticle/.test(t));
+  /*
+   * A page does not have to be an article to be quotable. Asking every site for Article schema
+   * marks a correctly typed service, shop, course or job page as missing something, which is the
+   * same mistake the check once made by refusing "Dentist" as a business type. What an answer
+   * engine needs is a page-level type it can name, so any of these earns the same points.
+   */
+  const PAGE_TYPES = /^(Service|Product|Course|Event|HowTo|Recipe|SoftwareApplication|WebApplication|MobileApplication|JobPosting|Book|Review|QAPage|MedicalWebPage|CollectionPage|ItemPage|AboutPage|ProfilePage)$/;
+  const pageType = [...allTypes].find((t) => PAGE_TYPES.test(t)) || null;
+  let entity = 0; const entityFindings = [];
+  if (hasOrg) { entity += 8; entityFindings.push({ level: 'pass', text: T.orgOk }); } else entityFindings.push({ id: 'schema-org-missing', level: 'fail', text: T.orgMissing });
+  if (hasFaq) { entity += 5; entityFindings.push({ level: 'pass', text: T.faqOk }); } else entityFindings.push({ id: 'schema-faq-missing', level: 'warn', text: T.faqMissing });
+  if (hasArticle) {
+    entity += 3;
+    entityFindings.push({ level: 'pass', text: T.articleOk });
+  } else if (pageType) {
+    entity += 3;
+    entityFindings.push({ level: 'pass', text: T.pageTypeOk(pageType) });
+  } else if (sampled.length) {
+    entityFindings.push({ id: 'schema-article-missing', level: 'warn', text: T.pageTypeMissing });
+  }
+  if (homePage.canonical) entity += 2; else entityFindings.push({ id: 'canonical-missing', level: 'warn', text: T.canonicalMissing });
+  if (homePage.ogTitle) entity += 2; else entityFindings.push({ id: 'og-missing', level: 'warn', text: T.ogMissing });
+
+  // Area 4: answer-first content (25)
+  const contentPages = sampled.length ? sampled : [homePage];
+  /* Say so. A score built from one page is not the same measurement as one built from four. */
+  const homeOnly = !sampled.length;
+  const thin = contentPages.filter((p) => p.words < 300).length;
+  const answerFirst = contentPages.filter((p) => p.answerFirst).length;
+  const structured = contentPages.filter((p) => p.h2Count >= 3).length;
+  const withTables = contentPages.filter((p) => p.tables > 0).length;
+  let content = 0; const contentFindings = [];
+  content += Math.round(10 * (1 - thin / contentPages.length));
+  if (thin) contentFindings.push({ id: 'thin-pages', level: thin === contentPages.length ? 'fail' : 'warn', text: T.thinPages(thin, contentPages.length) }); else contentFindings.push({ level: 'pass', text: T.avgWords(Math.round(contentPages.reduce((a, p) => a + p.words, 0) / contentPages.length)) });
+  content += Math.round(8 * (answerFirst / contentPages.length));
+  if (answerFirst < contentPages.length) contentFindings.push({ id: 'answer-first-missing', level: answerFirst ? 'warn' : 'fail', text: T.answerFirstMissing(answerFirst, contentPages.length) }); else contentFindings.push({ level: 'pass', text: T.answerFirstOk });
+  content += Math.round(4 * (structured / contentPages.length)) + Math.round(3 * (withTables / contentPages.length));
+  if (structured < contentPages.length) contentFindings.push({ id: 'few-h2', level: 'warn', text: T.fewH2(contentPages.length - structured, contentPages.length) });
+  if (!withTables) contentFindings.push({ id: 'no-tables', level: 'warn', text: T.noTables });
+  if (homeOnly) contentFindings.push({ level: 'warn', text: T.homeOnly });
+
+  // Area 5: freshness and sources (15)
+  const dated = contentPages.filter((p) => p.datePublished || p.dateModified).length;
+  /*
+   * Only a page that states figures can fail to attribute them. Docking a page for naming no
+   * source for numbers it does not contain is not a measurement, it is a complaint, and the
+   * finding said something untrue about the page. A price and the length of your own meeting
+   * are facts about you, not claims about the world, and they never counted here.
+   */
+  const withFigures = contentPages.filter((p) => p.claimFigures > 0);
+  const sourced = withFigures.filter((p) => p.unsourcedFigures === 0).length;
+  let trust = 0; const trustFindings = [];
+  trust += Math.round(7 * (dated / contentPages.length));
+  if (dated < contentPages.length) trustFindings.push({ id: 'dates-missing', level: dated ? 'warn' : 'fail', text: T.datesMissing(contentPages.length - dated, contentPages.length) }); else trustFindings.push({ level: 'pass', text: T.datesOk });
+  if (!withFigures.length) {
+    trust += 5;
+    trustFindings.push({ level: 'pass', text: T.noFigures });
+  } else {
+    trust += Math.round(5 * (sourced / withFigures.length));
+    if (sourced < withFigures.length) {
+      trustFindings.push({ id: 'sources-missing', level: 'warn', text: T.sourcesMissing(withFigures.length - sourced, withFigures.length) });
+    } else {
+      trustFindings.push({ level: 'pass', text: T.sourcesOk });
+    }
+  }
+  if (sitemap.found) {
+    trust += sitemap.lastmod ? 3 : 1;
+    if (!sitemap.lastmod) trustFindings.push({ id: 'sitemap-no-lastmod', level: 'warn', text: T.sitemapNoLastmod });
+  } else if (sitemap.timedOut || sitemap.skipped) {
+    // Not measured, so not scored down. Printing a low number for something we never read is the
+    // error this check exists to avoid in other people's tools.
+    trust += 3;
+    trustFindings.push({ level: 'warn', text: T.sitemapTimedOut });
+  } else {
+    trustFindings.push({ level: 'fail', text: T.sitemapMissing });
+  }
+
+  const areas = [
+    { id: 'access', label: T.area.access, score: access, max: 25, findings: accessFindings },
+    { id: 'index', label: T.area.index, score: index, max: 15, findings: indexFindings },
+    { id: 'entity', label: T.area.entity, score: entity, max: 20, findings: entityFindings },
+    { id: 'content', label: T.area.content, score: content, max: 25, findings: contentFindings },
+    { id: 'trust', label: T.area.trust, score: trust, max: 15, findings: trustFindings },
+  ];
+  const total = areas.reduce((a, x) => a + x.score, 0);
+  const grade = total >= 80 ? 'A' : total >= 65 ? 'B' : total >= 45 ? 'C' : total >= 25 ? 'D' : 'E';
+  const fixes = areas.flatMap((a) => a.findings.filter((f) => f.level === 'fail').map((f) => ({ id: f.id, area: a.label, text: f.text }))).concat(areas.flatMap((a) => a.findings.filter((f) => f.level === 'warn').map((f) => ({ id: f.id, area: a.label, text: f.text })))).slice(0, 3);
+  return {
+    ok: true, url: home.url, host, checkedAt: new Date().toISOString(), ms: Date.now() - started,
+    score: total, grade, areas, fixes,
+    sample: pages.map((p) => ({ url: p.url, title: p.title, words: p.words, answerFirst: p.answerFirst, dated: Boolean(p.datePublished || p.dateModified), schema: p.schemaTypes.slice(0, 4) })),
+    sitemap: { found: sitemap.found, count: sitemap.count, lastmod: sitemap.lastmod, unchecked: Boolean(!sitemap.found && (sitemap.timedOut || sitemap.skipped)) },
+    crawlers: verdicts.map((v) => ({ label: agentLabel(v), kind: v.kind, verdict: v.verdict })),
+  };
+}