@operstack/audit 0.14.0 → 0.15.1

package/README.md

@@ -166,3 +166,20 @@ report lands in `reports/`, and a site that fails does not stop the rest.
 The key goes in `--licence`, in `OPERSTACK_LICENCE`, or in a `.operstack-licence` file beside the
 work. This package is MIT and its source is public, so the key states the terms of commercial use
 and records who bought them; it is not a technical lock. Plan: https://oper-stack.com/products/agency/
+
+## Who to write to first
+
+`prospect` answers the question a batch of reports does not: of twenty sites, which one has the
+worst problem and what do you say in the first line of the email.
+
+```
+operstack-audit prospect clients.txt --out prospects
+```
+
+Out comes `prospects.csv` and `prospects.md`: one row per site, weakest first, with the two or
+three open findings and one sentence written for a business owner rather than for an engineer.
+Every sentence is a translation of a check that measured something; where there is no translation,
+the raw finding is printed instead of an invention.
+
+It runs the same checks as the report but skips the writing and the layout, so twenty sites take
+minutes. Free, no licence needed.

package/bin/audit.mjs

@@ -31,7 +31,7 @@ import { draftNarrative, stillEmpty } from '../src/narrative.mjs';
 import { renderAgentPrompts, agentPrompts } from '../src/prompts.mjs';
 import { render, checkNarrative } from '../src/render.mjs';
 import { resolveBranding } from '../src/agency.mjs';
-import { readList, runBatch, summarise } from '../src/batch.mjs';
+import { rank, readList, runBatch, runProspect, split, summarise, toCsv, toMarkdown } from '../src/batch.mjs';
 import { writeFileSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 
@@ -61,6 +61,8 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
     '  operstack-audit foundation-scope <audit.json> [--lang ru|en] [--new-pages 3] [--gsc] [--price] [--out base]',
     '      the text work the Foundation package would do, page by page; --price also states the money',
     '',
+    '  operstack-audit prospect <sites.txt> [--out prospects] [--pages 8] [--lang en|ru]',
+    '      who to write to first: one table, weakest site at the top, with a line to open the email',
     '  operstack-audit batch <sites.txt> [--out reports] [--pages 12] [--lang en|ru] [--pdf] [brand flags]',
     '      one report per line of the list; a line is "url" or "url, Client Name"',
     '',
@@ -95,6 +97,23 @@ if (cmd === 'collect') {
   writeFileSync(out, JSON.stringify(audit, null, 2));
   console.log(`wrote ${out}: ${audit.checks.length} checks, ${audit.sample.length} pages sampled, scores ${Object.entries(audit.scores).map(([k, v]) => `${k} ${v === null ? 'not measured' : v}`).join(', ')}`);
   console.log(`next: fill the narrative fields (operstack-audit check ${out} lists them), then render.`);
+} else if (cmd === 'prospect') {
+  const items = readList(target);
+  if (!items.length) { console.error('the list is empty'); process.exit(2); }
+  const lang = opt('--lang', 'en');
+  console.error(`${items.length} site(s) to check`);
+  const { rows, failed } = await runProspect(items, { pages: Number(opt('--pages', 8)), lang, log: (m) => console.error(`  ${m}`) });
+  if (!rows.length) { console.error('nothing could be checked'); process.exit(1); }
+  const base = resolve(opt('--out', 'prospects'));
+  writeFileSync(`${base}.csv`, toCsv(rows));
+  writeFileSync(`${base}.md`, toMarkdown(rows));
+  for (const f of failed) console.error(`  skipped ${f.url}: ${f.reason}`);
+  // Считаем по тем же правилам, по которым печатается таблица: иначе терминал скажет одно,
+  // а файл покажет другое, и первым, кто это заметит, будет покупатель.
+  const { live, dead } = split(rows);
+  const shown = rank(live).length;
+  console.log(`wrote ${base}.csv and ${base}.md: ${shown} site(s) to write to, weakest first`
+    + (dead.length ? `, ${dead.length} did not answer` : ''));
 } else if (cmd === 'batch') {
   const brand = brandFrom(opt, has);
   const items = readList(target);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "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",

package/src/batch.mjs

@@ -11,6 +11,7 @@ import { resolve, join } from 'node:path';
 import { collect } from './collect.mjs';
 import { render } from './render.mjs';
 import { draftNarrative as draft } from './narrative.mjs';
+import { prospectRow, rank, split, toCsv, toMarkdown } from './prospect.mjs';
 
 /** Строки списка: адрес и, через запятую, имя клиента для обложки. Пустые строки и # игнорируются. */
 export function parseList(text) {
@@ -80,3 +81,36 @@ export function summarise(results) {
 export function readList(path) {
   return parseList(readFileSync(resolve(path), 'utf8'));
 }
+
+/**
+ * Разведка: те же проверки, но без отчётов. Нужен ответ «кому писать первым», а не двадцать PDF,
+ * поэтому здесь не собирается ни черновик, ни вёрстка: только замер и таблица.
+ */
+export async function runProspect(items, { pages = 8, lang = 'en', log = () => {} } = {}) {
+  const rows = [];
+  const failed = [];
+  for (const [i, item] of items.entries()) {
+    const label = `${i + 1}/${items.length} ${item.url}`;
+    if (item.invalid) { failed.push({ ...item, reason: 'not a valid address' }); log(`${label}: пропущен`); continue; }
+    try {
+      log(`${label}: проверяю`);
+      let audit = await collect(item.url, { pages, lang, rendered: false });
+      // Сеть подводит чаще, чем сайты падают. Один повтор через пару секунд убирает почти все
+      // ложные «не отвечает»: без него один и тот же клиент в понедельник в списке, а во вторник
+      // в мёртвых, и человек перестаёт верить таблице.
+      if (audit.meta?.reachable === false) {
+        log(`${label}: не ответил, пробую ещё раз`);
+        await new Promise((r) => setTimeout(r, 2500));
+        const again = await collect(item.url, { pages, lang, rendered: false });
+        if (again.meta?.reachable !== false) audit = again;
+      }
+      rows.push(prospectRow(audit, { name: item.name, lang }));
+    } catch (err) {
+      failed.push({ ...item, reason: err.message });
+      log(`${label}: не вышло, ${err.message}`);
+    }
+  }
+  return { rows, failed };
+}
+
+export { rank, split, toCsv, toMarkdown };

package/src/prospect.mjs

@@ -0,0 +1,306 @@
+/**
+ * Кому писать первым и что сказать.
+ *
+ * Пакетный прогон отдаёт двадцать отчётов по десять страниц каждый, и дальше человек три часа
+ * читает их подряд, чтобы понять, у кого дыра, а у кого мелочь. Здесь эти три часа сводятся к
+ * одной таблице: сайты по возрастанию оценки, две-три худшие находки и одна фраза, которую можно
+ * поставить в письмо.
+ *
+ * Фраза не сочиняется. Она берётся из проверки, которая уже что-то измерила, и переводится на
+ * язык владельца бизнеса. Там, где перевода нет, печатается сама находка: пусть сухо, но правда.
+ */
+
+/**
+ * Что сказать владельцу про каждую находку. Здесь только те проверки, по которым владельцу
+ * действительно есть что услышать: остальные важны исполнителю, а не в первом письме.
+ *
+ * Правило для каждой строки: это последствие для его бизнеса, а не название проверки.
+ */
+export const OWNER_LINES = {
+  'robots': {
+    en: 'Your site tells robots to skip part of it and never shows them the sitemap.',
+    ru: 'Служебный файл сайта запрещает роботам часть страниц и не показывает им карту сайта.',
+  },
+  'sitemap': {
+    en: 'There is no working sitemap, so a search engine simply never finds some of your pages.',
+    ru: 'У сайта нет рабочей карты, поэтому часть страниц поисковик просто не находит.',
+  },
+  'sitemap-health': {
+    en: 'Your sitemap points at pages that have moved or no longer exist.',
+    ru: 'Карта сайта ведёт на страницы, которых уже нет или которые переехали.',
+  },
+  'ai-search-access': {
+    en: 'ChatGPT and Perplexity cannot read your site: one line in a config file shuts them out.',
+    ru: 'ChatGPT и Perplexity не могут прочитать ваш сайт: доступ закрыт в одной строке служебного файла.',
+  },
+  'llms': {
+    en: 'An assistant asked about you has no way to know which of your pages to read, so it reads whichever it hits first.',
+    ru: 'Ассистенту, которого спросили про вас, нечем понять, какие ваши страницы читать, и он берёт первую попавшуюся.',
+  },
+  'llms-health': {
+    en: 'You do have the file assistants look for, but its links lead nowhere.',
+    ru: 'Файл для ассистентов у вас есть, но ссылки в нём ведут в никуда.',
+  },
+  'agent-card': {
+    en: 'There is nothing on the site telling an AI agent who you are and how to reach you.',
+    ru: 'На сайте нет карточки, по которой программа-агент понимает, кто вы и как с вами связаться.',
+  },
+  'agent-markdown': {
+    en: 'Assistants have to parse your layout to read you, because no clean text copy of the pages exists.',
+    ru: 'Ассистенту приходится разбирать вёрстку, потому что чистой текстовой копии страниц нет.',
+  },
+  'org-schema': {
+    en: 'Your markup does not say who you are: no address, no profiles to check you against.',
+    ru: 'В разметке не указано, кто вы: ни адреса, ни профилей, по которым вас можно сверить.',
+  },
+  'schema': {
+    en: 'Nothing in your markup tells a search engine what this organisation is or what it does.',
+    ru: 'Поисковик не понимает по разметке, что это за организация и чем она занимается.',
+  },
+  'faq-schema': {
+    en: 'Your questions and answers are not marked up, so they never appear as an answer in search.',
+    ru: 'Вопросы и ответы не размечены, поэтому в выдачу как ответ они не попадают.',
+  },
+  'title': {
+    en: 'The title of your home page does not say what you do, and that is the first thing both a person and a machine read.',
+    ru: 'Заголовок главной страницы не говорит, чем вы занимаетесь, а это первое, что видят и человек, и машина.',
+  },
+  'description': {
+    en: 'The description shown in search results is not written, so the engine assembles one from scraps of your text.',
+    ru: 'Описание страницы в выдаче не написано, поэтому поисковик собирает его сам из обрывков текста.',
+  },
+  'h1': {
+    en: 'The home page has several top-level headings at once, so it is unclear which one is the subject.',
+    ru: 'На главной несколько главных заголовков сразу, и непонятно, какой из них про что.',
+  },
+  'dup-titles': {
+    en: 'Several of your pages carry the same title, so a search engine cannot tell them apart.',
+    ru: 'У нескольких страниц одинаковые заголовки, и поисковик не отличает их друг от друга.',
+  },
+  'alt': {
+    en: 'Your images carry no captions, so neither image search nor a blind visitor can make sense of them.',
+    ru: 'У картинок нет подписей, поэтому ни поиск по картинкам, ни незрячий посетитель их не понимают.',
+  },
+  'viewport': {
+    en: 'On a phone your page cannot be pinched to zoom: the code forbids it.',
+    ru: 'С телефона страницу нельзя увеличить пальцами, масштабирование запрещено в коде.',
+  },
+  'answer-first': {
+    en: 'Not one page opens with a short direct answer, and that opening is exactly what gets quoted.',
+    ru: 'Ни на одной странице нет короткого прямого ответа в первом абзаце, а цитируют именно его.',
+  },
+  'tables': {
+    en: 'Your pages have no tables, and a table is the easiest thing for an assistant to lift and quote.',
+    ru: 'На страницах нет таблиц, а таблицу ассистенту проще всего взять и процитировать.',
+  },
+  'sections': {
+    en: 'Your pages run as long unbroken text, so an assistant cannot pick out the part that answers the question.',
+    ru: 'Страницы идут сплошным текстом, и ассистент не может выделить кусок, который отвечает на вопрос.',
+  },
+  'sources': {
+    en: 'Your pages carry figures but never say where they came from, so nobody can cite them.',
+    ru: 'Цифры на страницах есть, но не сказано, откуда они взяты, и сослаться на них нельзя.',
+  },
+  'dates': {
+    en: 'Your pages do not show when they were updated, so they read as stale even when they are not.',
+    ru: 'На страницах не видно, когда их обновляли, и выглядят они устаревшими, даже если это не так.',
+  },
+  'thin': {
+    en: 'Several pages are too short to answer anything, and a short page is not quoted.',
+    ru: 'Несколько страниц слишком короткие, чтобы на чём-то отвечать, а короткую страницу не цитируют.',
+  },
+  'trust-entity': {
+    en: 'Your structured data has no postal address, so there is nothing to verify the business against.',
+    ru: 'В данных о компании нет почтового адреса, и сверить бизнес не с чем.',
+  },
+  'trust-profiles': {
+    en: 'There is nothing to check you against from the outside: no profile on any other platform was found.',
+    ru: 'Вас не на что сверить со стороны: ни одного профиля на других площадках не нашлось.',
+  },
+  'trust-contact': {
+    en: 'The site does not give a plain way to reach a human, which both buyers and search engines look for.',
+    ru: 'На сайте нет понятного способа связаться с человеком, а его ищут и покупатели, и поисковик.',
+  },
+  'trust-about': {
+    en: 'There is no page saying who is behind the business, and that is one of the first things checked.',
+    ru: 'Нет страницы о том, кто стоит за бизнесом, а это проверяют одним из первых.',
+  },
+  'trust-policies': {
+    en: 'The site has no terms or privacy page, which costs trust with both buyers and platforms.',
+    ru: 'На сайте нет условий и политики конфиденциальности, и это стоит доверия и покупателей, и площадок.',
+  },
+  'conv-cta': {
+    en: 'Most pages hide the call to action far down, so a visitor who is ready to act has to hunt for it.',
+    ru: 'На большинстве страниц призыв к действию спрятан далеко вниз, и готовый покупатель его ищет.',
+  },
+  'conv-form-depth': {
+    en: 'Your enquiry form sits past the middle of the page, and most phone visitors never scroll that far.',
+    ru: 'Форма заявки стоит за серединой страницы, а большинство посетителей с телефона так далеко не листают.',
+  },
+  'conv-form-fields': {
+    en: 'The enquiry form asks for too much at once, and every extra field costs replies.',
+    ru: 'Форма заявки спрашивает слишком много сразу, и каждое лишнее поле стоит ответов.',
+  },
+  'conv-contact-path': {
+    en: 'Getting from a page to a way of contacting you takes more steps than it should.',
+    ru: 'Путь от страницы до способа связаться длиннее, чем нужно.',
+  },
+  'utility': {
+    en: 'Some pages exist that nobody should land on from search, and they dilute the rest.',
+    ru: 'Есть страницы, на которые из поиска попадать не должны, и они размывают остальные.',
+  },
+};
+
+/**
+ * Чем открывать письмо. Порядок здесь не по тяжести проверки, а по силе для владельца: закрытый
+ * доступ роботов ИИ он поймёт мгновенно, а «есть лишние страницы» не значит для него ничего, хотя
+ * формально обе находки одного веса. Первая же строка решает, дочитают письмо или нет.
+ */
+const LEAD_ORDER = [
+  'ai-search-access', 'llms', 'llms-health', 'answer-first', 'sources', 'schema', 'org-schema',
+  'agent-card', 'conv-form-depth', 'conv-cta', 'title', 'description', 'tables', 'sections',
+  'trust-profiles', 'trust-entity', 'trust-contact', 'faq-schema', 'sitemap', 'sitemap-health',
+  'robots', 'thin', 'dup-titles', 'alt', 'viewport', 'trust-about', 'trust-policies',
+  'conv-form-fields', 'conv-contact-path', 'agent-markdown', 'h1', 'dates', 'utility',
+];
+
+/** Фраза владельцу на нужном языке. Нет перевода, значит нет фразы, и печатается сама находка. */
+const line = (id, lang = 'en') => (OWNER_LINES[id] || {})[lang === 'ru' ? 'ru' : 'en'] || '';
+
+/** Вес области при подсчёте одной общей оценки. Считаем только то, что правда измерено. */
+const WEIGHT = {
+  'SEO, technical': 1,
+  'SEO, content and structure': 1.2,
+  'AEO, answers and snippets': 1.3,
+  'GEO, visibility in AI systems': 1.3,
+  'Off-page and trust': 0.8,
+  'Conversion and UX': 0.8,
+};
+
+/**
+ * Одна оценка на сайт из шести областей. Неизмеренная область не занижает и не завышает:
+ * она просто не участвует, потому что оценивать неизмеренное значит выдумывать.
+ */
+export function overallScore(scores = {}) {
+  let sum = 0;
+  let weight = 0;
+  for (const [area, value] of Object.entries(scores)) {
+    if (typeof value !== 'number') continue;
+    const w = WEIGHT[area] ?? 1;
+    sum += value * w;
+    weight += w;
+  }
+  if (!weight) return null;
+  return Math.round((sum / weight) * 10);
+}
+
+// Сборщик размечает проверки как ok, warn, bad и na. Слова fail в нём нет, и код,
+// который его искал, пропускал мимо себя всё самое тяжёлое.
+const SEVERITY = { bad: 0, warn: 1 };
+const OPEN = (s) => s === 'bad' || s === 'warn';
+
+/** Худшие находки по одному сайту: сначала провалы, потом предупреждения, и только те, что слышит владелец. */
+export function worstFindings(audit, limit = 3, lang = 'en') {
+  const open = (audit.checks || [])
+    .filter((c) => OPEN(c.status))
+    .sort((a, b) => {
+      const s = (SEVERITY[a.status] ?? 2) - (SEVERITY[b.status] ?? 2);
+      if (s) return s;
+      // При равной тяжести вперёд идёт то, для чего есть фраза владельцу: она и попадёт в письмо.
+      return (line(b.id, lang) ? 1 : 0) - (line(a.id, lang) ? 1 : 0);
+    });
+  return open.slice(0, limit).map((c) => ({
+    id: c.id,
+    status: c.status,
+    label: c.label,
+    value: c.value,
+    say: line(c.id, lang) || `${c.label}: ${c.value}`,
+    translated: Boolean(line(c.id, lang)),
+  }));
+}
+
+/** Одна строка таблицы: сайт, оценка, находки и фраза для письма. */
+export function prospectRow(audit, { name = '', lang = 'en' } = {}) {
+  const reachable = audit.meta?.reachable !== false;
+  const findings = worstFindings(audit, 3, lang);
+  // Фразу для письма ищем по всем открытым находкам, а не только по трём верхним: иначе в письмо
+  // попадёт сырая техническая строка вроде «API catalogue (RFC 9727): not present», которую
+  // владелец бизнеса не поймёт, хотя ниже лежала находка с человеческим объяснением.
+  const all = worstFindings(audit, 99, lang).filter((f) => f.translated);
+  const lead = [...all].sort((a, b) => {
+    const ia = LEAD_ORDER.indexOf(a.id);
+    const ib = LEAD_ORDER.indexOf(b.id);
+    return (ia === -1 ? 999 : ia) - (ib === -1 ? 999 : ib);
+  })[0] || findings[0] || null;
+  return {
+    reachable,
+    host: audit.meta?.host || '',
+    name: name || audit.client?.name || audit.meta?.host || '',
+    score: overallScore(audit.scores),
+    failing: (audit.checks || []).filter((c) => c.status === 'bad').length,
+    warning: (audit.checks || []).filter((c) => c.status === 'warn').length,
+    findings,
+    say: lead ? lead.say : (lang === 'ru'
+      ? 'Ничего заметного не нашлось: этот сайт в порядке, писать не о чем.'
+      : 'Nothing worth writing about: this site is in order.'),
+  };
+}
+
+/** Сортировка: сначала те, у кого хуже. Сайт без оценки уходит в конец, а не наверх.
+ *  Повторы по адресу схлопываются: список клиентов человек собирает руками, и один и тот же
+ *  сайт в нём попадается. */
+export function rank(rows) {
+  const seen = new Map();
+  for (const r of rows) if (!seen.has(r.host)) seen.set(r.host, r);
+  return [...seen.values()].sort((a, b) => {
+    if (a.score === null) return 1;
+    if (b.score === null) return -1;
+    if (a.score !== b.score) return a.score - b.score;
+    return b.failing - a.failing;
+  });
+}
+
+const csvCell = (v) => {
+  const s = String(v ?? '');
+  return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+};
+
+/** Живые и мёртвые: писать можно только живым, остальные идут отдельным списком. */
+export function split(rows) {
+  return { live: rows.filter((r) => r.reachable !== false), dead: rows.filter((r) => r.reachable === false) };
+}
+
+export function toCsv(rows) {
+  const head = ['site', 'name', 'score', 'problems', 'warnings', 'what to say'];
+  return [head, ...rank(split(rows).live).map((r) => [r.host, r.name, r.score ?? '', r.failing, r.warning, r.say])]
+    .map((line) => line.map(csvCell).join(','))
+    .join('\n');
+}
+
+export function toMarkdown(rows, { title = 'Prospects, worst first' } = {}) {
+  const { live, dead } = split(rows);
+  const ranked = rank(live);
+  const out = [`# ${title}`, '',
+    dead.length
+      ? `${ranked.length} site(s) to write to, weakest at the top. ${dead.length} did not answer and are listed at the end.`
+      : `${ranked.length} site(s), the weakest at the top.`,
+    '',
+    '| # | Site | Score | Problems | What to say in the first line |', '|---:|---|---:|---:|---|'];
+  ranked.forEach((r, i) => {
+    out.push(`| ${i + 1} | ${r.host} | ${r.score ?? 'n/a'} | ${r.failing} | ${r.say.replace(/\|/g, '/')} |`);
+  });
+  if (dead.length) {
+    out.push('', '## Did not answer', '',
+      'These sites did not respond, so there is nothing measured and nobody to write to. Check the address before you use it.', '');
+    for (const r of rank(dead)) out.push(`- ${r.host}`);
+  }
+  out.push('', '## What each one has open', '');
+  for (const r of ranked) {
+    out.push(`### ${r.name} (${r.host})`);
+    if (!r.findings.length) out.push('Nothing open that an owner would act on.');
+    for (const f of r.findings) out.push(`- **${f.label}** (${f.status}): ${f.value}`);
+    out.push('');
+  }
+  out.push('Every line above is a measured check, not an opinion. Open the site and confirm before you send anything.');
+  return out.join('\n');
+}

package/src/test-agency-ids.mjs

@@ -0,0 +1,48 @@
+/** Идентификаторы проверок, снятые с настоящего прогона: тест сверяет с ними фразы владельцу,
+ *  чтобы переименованная проверка не оставила строку, которая никогда не сработает. */
+export const CHECK_IDS = [
+  "agent-card",
+  "agent-markdown",
+  "ai-search-access",
+  "alt",
+  "answer-first",
+  "api-catalog",
+  "canonical",
+  "conv-contact-path",
+  "conv-cta",
+  "conv-form-depth",
+  "conv-form-fields",
+  "conv-messenger",
+  "dates",
+  "description",
+  "dup-titles",
+  "faq-schema",
+  "h1",
+  "h1-sample",
+  "hreflang",
+  "https",
+  "llms",
+  "llms-health",
+  "og",
+  "org-schema",
+  "resources",
+  "robots",
+  "robots-ai",
+  "schema",
+  "sections",
+  "sitemap",
+  "sitemap-health",
+  "sources",
+  "tables",
+  "thin",
+  "title",
+  "trust-about",
+  "trust-contact",
+  "trust-entity",
+  "trust-policies",
+  "trust-profiles",
+  "ttfb",
+  "utility",
+  "viewport",
+  "www"
+];

package/src/test-agency.mjs

@@ -82,5 +82,68 @@ const { findKey } = await import('./agency.mjs');
 ok('ключ читается из файла .operstack-licence', findKey().startsWith('OSK1.'));
 process.chdir(cwd);
 
+
+// ── Разведка кандидатов ───────────────────────────────────────────────────────
+// Правило: в письмо никогда не попадает строка, которую владелец бизнеса не поймёт, и
+// ни одна фраза не ссылается на проверку, которой в сборщике нет.
+const { OWNER_LINES, overallScore, prospectRow, rank, toCsv, toMarkdown } = await import('./prospect.mjs');
+const { CHECK_IDS } = await import('./test-agency-ids.mjs');
+
+const unknown = Object.keys(OWNER_LINES).filter((id) => !CHECK_IDS.includes(id));
+ok('каждая фраза ссылается на существующую проверку', unknown.length === 0);
+ok('у каждой фразы есть оба языка', Object.values(OWNER_LINES).every((v) => v.en && v.ru));
+
+ok('неизмеренная область не тянет оценку вниз', overallScore({ a: 10, b: null }) === 100);
+ok('пустые оценки дают не ноль, а «не измеряли»', overallScore({}) === null);
+
+const mk = (id, status, scores) => ({
+  meta: { host: `${id}.example` }, client: { name: id }, scores,
+  checks: [{ id, group: 'x', label: 'L', status, value: 'v' }],
+});
+const weak = prospectRow(mk('ai-search-access', 'bad', { a: 2 }));
+ok('перекрытый доступ роботов ИИ попадает в письмо', /ChatGPT/.test(weak.say));
+ok('провал посчитан', weak.failing === 1 && weak.warning === 0);
+
+const dull = prospectRow(mk('utility', 'warn', { a: 9 }));
+const sharp = prospectRow({
+  meta: { host: 'x.example' }, client: { name: 'x' }, scores: { a: 5 },
+  checks: [
+    { id: 'utility', group: 'x', label: 'L', status: 'warn', value: 'v' },
+    { id: 'ai-search-access', group: 'x', label: 'L', status: 'warn', value: 'v' },
+  ],
+});
+ok('при равной тяжести в письмо идёт сильная находка, а не первая', /ChatGPT/.test(sharp.say));
+ok('слабая находка всё равно объяснена по-человечески', !/^utility/.test(dull.say));
+
+const ranked = rank([prospectRow(mk('alt', 'warn', { a: 9 })), weak, { ...dull, score: null }]);
+ok('сначала идёт тот, у кого хуже', ranked[0].score < ranked[1].score);
+ok('сайт без оценки уходит в конец, а не наверх', ranked[ranked.length - 1].score === null);
+
+const csv = toCsv([weak]);
+ok('в CSV есть заголовок и строка', csv.split('\n').length === 2 && csv.startsWith('site,name,score'));
+ok('запятая внутри фразы не ломает CSV', toCsv([{ ...weak, say: 'a, b' }]).includes('"a, b"'));
+ok('в таблице сказано, что строки измерены, а не придуманы', /measured check, not an opinion/.test(toMarkdown([weak])));
+
+const russian = prospectRow(mk('ai-search-access', 'bad', { a: 2 }), { lang: 'ru' });
+ok('русская фраза приходит по-русски', /Perplexity не могут/.test(russian.say));
+
+
+// Три дыры, найденные прогоном по списку, который специально собран из ломающего.
+const dead = prospectRow({ meta: { host: 'gone.example', reachable: false }, scores: {}, checks: [] });
+ok('мёртвый сайт помечен, а не выдан как кандидат', dead.reachable === false);
+const { split } = await import('./prospect.mjs');
+const parts = split([dead, prospectRow(mk('alt', 'warn', { a: 9 }))]);
+ok('мёртвые не попадают в таблицу кандидатов', parts.live.length === 1 && parts.dead.length === 1);
+ok('и названы отдельным списком', /Did not answer/.test(toMarkdown([dead, prospectRow(mk('alt', 'warn', { a: 9 }))])));
+ok('мёртвого нет в CSV', !toCsv([dead]).includes('gone.example'));
+
+const bad = prospectRow(mk('ai-search-access', 'bad', { a: 2 }));
+ok('статус bad считается провалом, а не пропускается', bad.failing === 1);
+ok('и тяжёлая находка доходит до письма', /ChatGPT/.test(bad.say));
+
+const twice = rank([prospectRow(mk('alt', 'warn', { a: 9 })), prospectRow(mk('alt', 'warn', { a: 9 }))]);
+ok('один сайт в списке дважды даёт одну строку', twice.length === 1);
+
 console.log(failed ? `\n${failed} проверок не прошли` : '\nагентский план: лицензия, оформление и список проверены');
 process.exit(failed ? 1 : 0);
+