@operstack/audit 0.36.2 → 0.38.0

package/src/test-narrative.mjs

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-/** Черновик текста аудита: заполняет всё, ничего не выдумывает, читается человеком. */
-import { draftNarrative, stillEmpty } from './narrative.mjs';
-
-let bad = 0;
-const is = (n, a, b) => { const ok = JSON.stringify(a) === JSON.stringify(b); if (!ok) { bad++; console.error(`FAIL ${n}\n  ждали ${JSON.stringify(b)}\n  вышло ${JSON.stringify(a)}`); } else console.log(`ok   ${n}`); };
-const ok = (n, c) => is(n, Boolean(c), true);
-
-const audit = (over = {}) => ({
-  meta: { host: 'x.ru', site: 'https://x.ru', collectedAt: '2026-09-11T00:00:00.000Z', lang: 'en', language: '' },
-  client: { name: '{{CLIENT NAME}}', subject: '{{What the site sells and where}}', reportDate: '2026-09-11', preparedBy: 'OperStack' },
-  scores: { 'SEO, technical': 9, 'SEO, content and structure': 4, 'AEO, answers and snippets': 6, 'GEO, visibility in AI systems': 8, 'Off-page and trust': null, 'Conversion and UX': 5 },
-  summary: { lead: '{{a}}', verdict: '{{b}}', priorities: ['{{1}}', '{{2}}', '{{3}}'] },
-  overview: { rows: [['CMS / stack', 'Astro'], ['Pages in sitemap', '40'], ['Language', '{{language}}'], ['What is sold', '{{products}}']], note: '{{note}}' },
-  content: { strengths: ['{{s}}'], weaknesses: ['{{w}}'], gaps: ['{{g}}'] },
-  aeo: { works: ['{{x}}'], blocks: ['{{y}}'], recommendation: '{{r}}' },
-  geo: { rows: [['Entity clarity', '{{s}}', '{{d}}'], ['Third-party mentions', '{{s}}', '{{d}}'], ['Reviews and PR', '{{s}}', '{{d}}']], callout: '{{c}}' },
-  offpage: { listed: ['{{l}}'], note: '{{n}}' },
-  conversion: { rows: [['Contact form', '{{s}}'], ['Price visible', '{{s}}'], ['Messengers', '{{s}}']] },
-  roadmap: [
-    { badge: 'Week 1', title: 'Critical', items: ['Fix: Image alt text', '{{...}}'] },
-    { badge: 'Weeks 2 to 4', title: 'Foundation', items: ['{{...}}'] },
-    { badge: 'Months 2 to 3', title: 'Growth', items: ['{{...}}'] },
-  ],
-  closing: '{{close}}',
-  sample: [{ url: 'https://x.ru/', title: 'Дом', description: 'Мы продаём станки', words: 900, answerFirst: false }],
-  checks: [
-    { id: 'alt', group: 'onpage', label: 'Image alt text', status: 'bad', value: '3 of 10 images carry alt text (30%) across 5 sampled page(s)' },
-    { id: 'thin', group: 'content', label: 'Thin pages in sample', status: 'warn', value: '4 of 20 pages under 300 words' },
-    { id: 'answer-first', group: 'aeo', label: 'Answer-first opening paragraph', status: 'bad', value: '2 of 20 sampled page(s) open with a figure' },
-    { id: 'sources', group: 'aeo', label: 'Sources named in the text', status: 'ok', value: '18 of 20 name a source' },
-    { id: 'dates', group: 'content', label: 'Publication dates exposed', status: 'ok', value: '19 of 20 expose dates' },
-    { id: 'conv-cta', group: 'conversion', label: 'A call to action in the first screen', status: 'bad', value: '1 of 20 put it in the first 30%' },
-    { id: 'conv-messenger', group: 'conversion', label: 'Messenger link', status: 'ok', value: 'telegram found' },
-    { id: 'trust-entity', group: 'trust', label: 'Who the business is', status: 'ok', value: 'city and country in the structured data' },
-    { id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'ok', value: 'every AI search fetcher may read the site' },
-  ],
-  ...over,
-});
-
-const d = draftNarrative(audit(), { lang: 'ru' });
-is('не осталось ни одной дыры', stillEmpty(d), []);
-ok('имя клиента это адрес сайта, а не выдумка', d.client.name === 'x.ru');
-ok('предмет взят с главной и помечен как прочитанный', d.client.subject.includes('Мы продаём станки') && /это то, что о вас прочитает/i.test(d.client.subject));
-// Клиентский текст не обращается к аналитику: это товар, а не черновик на правку.
-ok('в клиентском тексте нет обращений к аналитику', !/подтвердите|please confirm/i.test(JSON.stringify(d)));
-
-// Русский аудит, русский отчёт: названия областей тоже русские. Раньше перевод срабатывал
-// только для аудита, собранного по-английски, и в русский текст уезжали английские названия.
-{
-  const ruAudit = audit();
-  ruAudit.meta.lang = 'ru';
-  const dru = draftNarrative(ruAudit, { lang: 'ru' });
-  ok('в русском отчёте по русскому аудиту нет английских названий областей',
-    !/SEO, technical|content and structure|answers and snippets|visibility in AI systems|Off-page and trust|Conversion and UX/.test(dru.summary.lead));
-}
-
-// Ничего не выдумываем: там, где не мерили, так и написано
-ok('упоминания на чужих сайтах помечены как неизмеренные', d.geo.rows[1][1] === 'не измеряли');
-ok('и объяснено почему', /за деньги/.test(d.geo.rows[1][2]));
-ok('в разделе ссылок сказано, что данные платные', /не покупаем данные/.test(d.offpage.note));
-ok('язык не выдуман, если его нет в коде', /не указан/.test(d.overview.rows[2][1]));
-// Число в начале резюме это выборка, а не размер сайта: «сайт из 19 страниц» о магазине на
-// сотни товаров неправда (brainmd.com, 12.10.2026).
-ok('резюме говорит, сколько прочитано, а не сколько страниц у сайта', /^Мы прочитали \d+ страниц/.test(d.summary.lead) && !/сайт из/.test(d.summary.lead));
-{
-  const en = draftNarrative(audit(), { lang: 'en' });
-  ok('и по-английски тоже', /^We read \d+ pages? of /.test(en.summary.lead) && !/is a site of/.test(en.summary.lead));
-  const withLang = audit(); withLang.meta.language = 'en';
-  is('язык из кода страницы попадает в обзор словом', draftNarrative(withLang, { lang: 'en' }).overview.rows[2][1], 'English');
-}
-
-// Числа сходятся между собой
-const openN = 4; const mech = 2; // alt, conv-cta механические; thin и answer-first это тексты
-ok('в выводе число открытых проверок верное', d.summary.verdict.startsWith(`${openN} `) && /не полностью/.test(d.summary.verdict));
-ok('и механических не больше, чем всех', d.summary.verdict.includes(`${mech} правятся`) || d.summary.verdict.includes(`${mech} правится`));
-
-// Приоритеты это действие, а не название проверки
-ok('приоритет говорит, что делать', /Проставить подписи/.test(d.summary.priorities[0]));
-ok('и показывает, как сейчас', /Сейчас:/.test(d.summary.priorities[0]));
-ok('работа с текстами названа работой, а не отговоркой', d.summary.priorities.some((p) => /Наполнить короткие страницы|прямой ответ/.test(p)));
-
-// Русский отчёт по английскому аудиту не должен содержать английских названий проверок
-const ruText = JSON.stringify([d.summary, d.content, d.aeo, d.roadmap, d.closing]);
-ok('в русском черновике нет английских названий проверок', !/Image alt text|Thin pages|call to action/.test(ruText));
-ok('области названы по-русски', /доступ и адреса|техническая часть|конверсия/i.test(d.summary.lead));
-
-// Дорожная карта: уже написанные строки переведены, пустые заполнены
-ok('готовая строка карты переведена', d.roadmap[0].items[0].includes('подписи'));
-ok('пустая строка карты заполнена делом', !d.roadmap[1].items[0].includes('{{'));
-
-// Английский отчёт остаётся английским
-const e = draftNarrative(audit(), { lang: 'en' });
-is('по-английски тоже без дыр', stillEmpty(e), []);
-ok('английский черновик без кириллицы', !/[А-Яа-яЁё]/.test(JSON.stringify([e.summary, e.aeo, e.closing])));
-ok('и приоритет тоже действие', /Write alt text/.test(e.summary.priorities[0]));
-
-// Здоровый сайт: вывод не пугает, а говорит правду
-const clean = draftNarrative(audit({ checks: [
-  { id: 'alt', group: 'onpage', label: 'Image alt text', status: 'ok', value: 'all images carry alt text' },
-  { id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'ok', value: 'allowed' },
-] }), { lang: 'ru' });
-ok('на чистом сайте вывод говорит, что чинить нечего', /критичных поломок нет/.test(clean.summary.verdict));
-ok('и заключение не выдумывает проблем', /нечего/.test(clean.closing));
-
-// Ничего уже написанного человеком не затирается
-const edited = audit();
-edited.summary.lead = 'Текст, который написал аналитик.';
-const keep = draftNarrative(edited, { lang: 'ru' });
-is('правку аналитика черновик не трогает', keep.summary.lead, 'Текст, который написал аналитик.');
-
-// Заблокированные фетчеры это прямой приговор, а не намёк
-const blocked = draftNarrative(audit({ checks: [{ id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'bad', value: '3 blocked' }] }), { lang: 'ru' });
-ok('если роботы ИИ закрыты, об этом сказано прямо', /невозможно физически/.test(blocked.geo.callout));
-
-if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
-console.log('\nвсе тесты черновика прошли');

package/src/test-overall.mjs

@@ -1,236 +0,0 @@
-#!/usr/bin/env node
-/** Один балл на странице, в письме и в отчёте.
- *
- *  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, overallSummary } 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' });
-
-// ---- балл по проверкам отчёта: отдельное измерение, оно обязано пересчитываться из 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([]).score, null);
-{
-  const o = computeOverall([c('technical', 'ok'), c('geo', 'ok')]);
-  is('неизмеренное выпадает из знаменателя, а не становится нулём', o.score, 100);
-  is('в знаменателе только измеренные веса', o.weighed, 40);
-}
-
-// ---- параметры измерения зафиксированы: их расхождение и есть расхождение чисел
-is('бюджет времени один на всех', VISIBILITY_DEFAULTS.budgetMs, 8500);
-// Девять плюс главная это десять. Число стоит на витрине словами «другие проверяют одну
-// страницу, мы проверяем десять», поэтому оно обязано совпадать с тем, что движок правда читает.
-is('глубина выборки одна на всех', VISIBILITY_DEFAULTS.samplePages, 9);
-ok('параметры нельзя поменять на ходу', Object.isFrozen(VISIBILITY_DEFAULTS));
-
-// ---- балл видимости сходится сам с собой
-{
-  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 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 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);
-    // Искать надо напечатанный элемент, а не название стиля: `.overall-num` есть в CSS всегда.
-    ok(`${lang}: без балла заголовок не печатается вовсе`, !/class="ring ring-/.test(html));
-    ok(`${lang}: шесть областей отчёта на месте`, /second-measure/.test(html));
-  }
-}
-
-// Тот же отчёт, но с настоящим баллом: печать заголовка и обе подписи.
-{
-  const audit = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  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(/class="ring-num"[^>]*>(\d+)</) || [])[1]), 61);
-    ok(`${lang}: оценка словом на своём языке`, grade.test((html.match(/overall-grade">([^<]*)</) || [])[1] || ''));
-    ok(`${lang}: сказано, что это то же измерение, что на странице`, /ai[-\u2011]visibility/.test((html.match(/overall-note">([^<]*)</) || [])[1] || ''));
-    ok(`${lang}: пять областей напечатаны рядом с баллом`, /class="areas-bars"/.test(html) && (html.match(/class="ar ar-/g) || []).length === 5);
-    ok(`${lang}: балл стоит и пилюлей с буквой`, /class="pill pill-(good|fair|poor)"/.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: whitewill.ru дал 47 и 44 в двух прогонах подряд, habr.com в одном
- * прогоне вернул отказ. Тот же код, разная удача сети: бюджет 8,5 секунды, и карта сайта то
- * успевает прочитаться, то нет. Покупателю всё равно, что оба числа честные, он видит два разных.
- * Поэтому в воронке измерение происходит один раз.
- */
-{
-  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 fromPage = { ok: true, score: 63, grade: 'B', checkedAt: '2026-09-14T20:00:00.000Z', ms: 4200, areas: [
-    { id: 'access', label: 'Access for AI crawlers', score: 25, 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: 11, max: 25 },
-    { id: 'trust', label: 'Freshness and sources', score: 5, max: 15 }] };
-
-  const audit = await collect(base, { pages: 2, log: () => {}, visibility: fromPage });
-  server.close();
-
-  is('готовый балл берётся как есть', audit.overall.score, 63);
-  is('и оценка буквой тоже', audit.overall.grade, 'B');
-  is('видно, что балл переиспользован, а не измерен заново', audit.overall.source, 'visibility:reused');
-  is('сохранено, когда его измерили', audit.overall.measuredAt, '2026-09-14T20:00:00.000Z');
-  is('пять областей приехали целиком', audit.overall.areas.length, 5);
-  is('и складываются в заголовок', audit.overall.areas.reduce((a, x) => a + x.score, 0), 63);
-  is('отчёт сходится сам с собой', verifyScores(audit), []);
-  // Локальный адрес движок бы мерить отказался, а балл всё равно есть: значит второго измерения не было.
-  ok('второго измерения не случилось', audit.overall.score === 63 && !audit.overall.error);
-
-  audit.meta.lang = 'ru';
-  is('и отчёт печатает именно его', Number((toHtml(audit, null).match(/class="ring-num"[^>]*>(\d+)</) || [])[1]), 63);
-}
-
-/*
- * Подпись под баллом обязана объяснить человеку три вещи, иначе он прочитает разницу в пару
- * пунктов как ошибку: откуда взялось число, что успели прочитать, и почему повтор может дать
- * иначе. Это критерий приёмки, а не украшение: человек, прочитавший сначала страницу, а потом
- * отчёт, не должен удивиться.
- */
-{
-  const audit = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  const areas = [{ id: 'access', label: 'Access', score: 20, max: 25 }, { id: 'index', label: 'Index', score: 10, max: 15 },
-    { id: 'entity', label: 'Entity', score: 12, max: 20 }, { id: 'content', label: 'Content', score: 14, max: 25 }, { id: 'trust', label: 'Trust', score: 5, max: 15 }];
-  const note = (a) => ((toHtml(a, null).match(/overall-note">([^<]*)</) || [])[1] || '');
-
-  for (const lang of ['en', 'ru']) {
-    audit.meta.lang = lang;
-
-    audit.overall = { score: 61, grade: 'B', areas, source: 'visibility:reused', measuredAt: '2026-09-14T20:00:00.000Z', basis: { pages: 4, sitemapRead: true, sitemapUnchecked: false } };
-    const reused = note(audit);
-    ok(`${lang}: сказано, что число уже видели на проверке`, lang === 'en' ? /already saw on the free check/.test(reused) : /уже видели в бесплатной проверке/.test(reused));
-    ok(`${lang}: сказано, что здесь не меряли заново`, lang === 'en' ? /not measured again here/.test(reused) : /не меряется заново/.test(reused));
-    ok(`${lang}: названа дата измерения`, /2026-09-14/.test(reused));
-    ok(`${lang}: сказано, сколько страниц прочитано`, /4/.test(reused));
-    ok(`${lang}: предупреждает про разброс в пункт-другой`, lang === 'en' ? /a point or two/.test(reused) : /на пункт-другой/.test(reused));
-
-    audit.overall = { score: 61, grade: 'B', areas, source: 'visibility', basis: { pages: 1, sitemapRead: false, sitemapUnchecked: true } };
-    const fresh = note(audit);
-    ok(`${lang}: при собственном измерении сказано именно это`, lang === 'en' ? /Measured here by the same code/.test(fresh) : /Измерено здесь тем же кодом/.test(fresh));
-    ok(`${lang}: непрочитанная карта сайта названа, а не спрятана`, lang === 'en' ? /sitemap did not answer in time/.test(fresh) : /карта сайта не ответила вовремя/.test(fresh));
-    ok(`${lang}: и сказано, что она не зачтена в минус`, lang === 'en' ? /not counted against the score/.test(fresh) : /не зачтено ни в плюс, ни в минус/.test(fresh));
-    ok(`${lang}: в подписи нет чужого языка`, lang === 'en' ? !/[А-Яа-яЁё]/.test(fresh) : !/Measured|sitemap did/.test(fresh));
-  }
-
-  // Русское склонение в подписи: человек это читает.
-  audit.meta.lang = 'ru';
-  for (const [n, word] of [[1, 'страница'], [2, 'страницы'], [5, 'страниц'], [11, 'страниц'], [21, 'страница']]) {
-    audit.overall = { score: 61, grade: 'B', areas, source: 'visibility', basis: { pages: n, sitemapRead: true, sitemapUnchecked: false } };
-    ok(`ru: ${n} ${word}`, new RegExp(`Прочитано ${n} ${word} сайта`).test(note(audit)));
-  }
-}
-
-// ---- один блок «балл и области» на отчёт и на письмо
-//
-// Письмо собирало свою формулировку и свою цифру, отчёт свою. Разошлись. Теперь обе стороны
-// зовут overallSummary, и разойтись нечему: текст ровно один и живёт в пакете.
-{
-  const areas = [{ id: 'access', label: 'Can AI crawlers read it', score: 20, max: 25 },
-    { id: 'index', label: 'Is there a map for agents (llms.txt)', score: 5, max: 15 },
-    { id: 'entity', label: 'Is the entity clear (schema)', score: 12, max: 20 },
-    { id: 'content', label: 'Is there something to quote', score: 18, max: 25 },
-    { id: 'trust', label: 'Can it be dated and trusted', score: 8, max: 15 }];
-  const overall = { score: 63, grade: 'B', areas, source: 'visibility:reused', measuredAt: '2026-09-14T20:00:00.000Z', basis: { pages: 4, sitemapRead: true, sitemapUnchecked: false } };
-
-  const ru = overallSummary(overall, { lang: 'ru' });
-  const en = overallSummary(overall, { lang: 'en' });
-  is('заголовок письма это заголовок отчёта', ru.score, 63);
-  is('сумма пяти областей даёт заголовок', ru.areas.reduce((a, x) => a + x.score, 0), ru.score);
-  ok('оценка словом переведена', ru.grade === 'Рабочее состояние' && en.grade === 'Workable');
-  const fixture = JSON.parse(readFileSync(new URL('../examples/sample-audit.json', import.meta.url), 'utf8'));
-  fixture.meta.lang = 'ru'; fixture.overall = overall;
-  ok('подпись та же, что печатает отчёт', ru.note === (toHtml(fixture, null).match(/overall-note">([^<]*)</) || [])[1]);
-
-  // Замер мог пройти на английской странице, а отчёт уходит русскому покупателю: язык отчёта главнее.
-  ok('названия областей на языке отчёта, а не замера', ru.areas[0].label === 'Могут ли роботы ИИ прочитать сайт');
-  ok('и в английском они английские', en.areas[0].label === 'Can AI crawlers read it');
-  ok('в русском блоке нет английских названий', !ru.areas.some((x) => /[A-Za-z]{4}/.test(x.label.replace('llms.txt', ''))));
-
-  // Шесть областей отчёта это второе измерение, и подпись обязана это говорить в обоих языках.
-  ok('подзаголовок второго измерения есть', /Второе, отдельное измерение/.test(ru.secondMeasure) && /second, separate measurement/.test(en.secondMeasure));
-  ok('и сказано, что складывать их с заголовком не надо', /в сумме его не дают/.test(ru.secondMeasureFoot) && /will not add up to it/.test(en.secondMeasureFoot));
-  ok('в подписи второго измерения нет разметки', !/</.test(ru.secondMeasureFoot) && !/</.test(en.secondMeasureFoot));
-
-  // Балла может не быть: движок не мерит закрытые адреса. Тогда письмо не называет цифру вовсе.
-  is('без балла блока нет', overallSummary({ score: null, grade: 'not measured', areas: [] }, { lang: 'ru' }), null);
-  is('и на пустом объекте тоже', overallSummary(null, { lang: 'en' }), null);
-}
-
-// ---- движок в пакете это та же программа, что стоит на сайтах
-{
-  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); }
-console.log('\nвсе тесты общего балла прошли');

package/src/test-planted.mjs

@@ -1,114 +0,0 @@
-/**
- * 20 подсаженных ошибок (задание 14.10.2026, «второй шаг проверки фактов»): в отчёты пяти эталонов
- * вписываются по четыре ложных числа, как это сделал Hermes, и прогоняется проверка с подменёнными
- * моделями, без сети и денег. Каждая ошибка должна быть исправлена на верное значение или отчёт удержан.
- * На отчётах без подсадки ни одна верная фраза не должна стать неверной.
- */
-import { readFileSync } from 'node:fs';
-import { replayer } from './etalon.mjs';
-import { collect } from './collect.mjs';
-import { secondLook } from './verify.mjs';
-import { draftNarrative } from './narrative.mjs';
-import { statementsOf, applyFix, reviewAndFix } from './review.mjs';
-import { numbersOf } from './facts.mjs';
-
-const dir = new URL('../test/etalon/', import.meta.url);
-// [id, число было, число стало]: те же места, что у Hermes.
-const PLANTS = {
-  medeq: [['chk:api-catalog:comment', '9727', '29188'], ['sum:lead', '20', '67'], ['sum:verdict', null, '79'], ['sum:prio:0', '120', '367']],
-  neronov: [['chk:api-catalog:comment', '9727', '29188'], ['sub:subject', '23 000', '76 000'], ['sum:lead', '20', '67'], ['sum:verdict', null, '28']],
-  brainmd: [['chk:api-catalog:comment', '9727', '29188'], ['sum:lead', '20', '67'], ['sum:verdict', null, '49'], ['sum:prio:1', null, '148']],
-  drivee: [['chk:api-catalog:comment', '9727', '29188'], ['sum:lead', '20', '67'], ['sum:verdict', null, '52'], ['sum:prio:0', null, '145']],
-  babynanny: [['chk:api-catalog:comment', '9727', '29188'], ['sub:subject', '13 000', '46 000'], ['sum:lead', null, '61'], ['sum:verdict', null, '40']],
-};
-
-const json = (o) => ({ text: JSON.stringify(o), usage: { input: 1000, output: 100 } });
-/** Первый шаг: всё «ok», кроме заданных id (их помечает ложными). */
-const firstStep = (flag = new Set()) => async (messages) => {
-  const st = JSON.parse(messages[2].content).statements;
-  return json({ items: st.map((s) => (flag.has(s.id) ? { id: s.id, verdict: 'false', why: 'подсадка', fix: s.text } : { id: s.id, verdict: 'ok', premiseTrue: true, fitsNiche: true, passesNow: false, possible: true })) });
-};
-const silent = async () => json({ items: [] });
-/** Второй шаг, который «подтверждает» порчу верного числа: правка должна быть отклонена. */
-const spoiler = async (messages) => {
-  const fl = JSON.parse(messages[2].content).flagged;
-  return json({ items: fl.map((x) => ({ id: x.id, keep: true, evidence: 'на глаз', fix: String(x.text).replace(/\d+/, (n) => String(Number(n) + 1)) })) });
-};
-
-async function build(name) {
-  const truth = JSON.parse(readFileSync(new URL(`${name}-truth.json`, dir), 'utf8'));
-  const real = globalThis.fetch;
-  globalThis.fetch = replayer(new URL(`${name}.json.gz`, dir));
-  const raw = await collect(truth.site, { pages: 20, tier: '9', lang: truth.lang, rendered: false, log: () => {}, pageDelayMs: 0 });
-  const second = await secondLook(raw, { maxPages: 120, probes: false, log: () => {} });
-  globalThis.fetch = real;
-  return { audit: draftNarrative(raw, { lang: truth.lang }), digest: second.digest || { robots: '', pages: [] }, lang: truth.lang };
-}
-
-const textMap = (audit, lang) => Object.fromEntries(statementsOf(audit, { lang }).map((s) => [s.id, s.text]));
-/** Подсадить: заменить число «было» (или первое число строки) на «стало». */
-function plant(audit, lang, [id, from, to]) {
-  const t = textMap(audit, lang)[id];
-  if (!t) throw new Error(`нет строки ${id}`);
-  const target = from || numbersOf(t)[0];
-  if (!target) throw new Error(`в строке ${id} нет числа: «${t}»`);
-  const re = new RegExp(`(?<!\\d)(?<!\\d[\\u00A0\\u202F ])${target.replace(/ /g, '[\\u00A0\\u202F ]')}(?![\\d])`);
-  if (!re.test(t)) throw new Error(`в строке ${id} нет числа ${target}: «${t}»`);
-  applyFix(audit, id, t.replace(re, to));
-  return { id, from: target, to, before: t };
-}
-
-let fail = 0; const table = [];
-for (const name of Object.keys(PLANTS)) {
-  const row = { site: name, fixed: 0, held: 0, missed: 0, spoiled: 0 };
-
-  // 1. Подсадка, первый шаг ничего не замечает, второй молчит: ловить обязан код.
-  {
-    const { audit, digest, lang } = await build(name);
-    const planted = PLANTS[name].map((p) => plant(audit, lang, p));
-    const rev = await reviewAndFix(audit, digest, firstStep(), { lang, askConfirm: silent });
-    const after = textMap(audit, lang);
-    for (const p of planted) {
-      const now = after[p.id] || '';
-      const fixed = !numbersOf(now).includes(p.to.replace(/ /g, '')) && now === p.before;
-      if (fixed) row.fixed++; else if (!rev.ok) row.held++; else { row.missed++; fail++; console.log(`FAIL ${name} ${p.id}: «${p.to}» прошло молча: «${now}»`); }
-    }
-  }
-  // 2. Подсадка, первый шаг помечает ещё и верную строку, второй молчит: отчёт удержан с причиной.
-  {
-    const { audit, digest, lang } = await build(name);
-    PLANTS[name].forEach((p) => plant(audit, lang, p));
-    const other = statementsOf(audit, { lang }).find((s) => s.kind === 'claim' && !PLANTS[name].some((p) => p[0] === s.id));
-    const rev = await reviewAndFix(audit, digest, firstStep(new Set([other.id])), { lang, askConfirm: silent });
-    if (rev.ok || !/не ответил по 1 строке/.test(rev.held || '')) { fail++; console.log(`FAIL ${name}: молчание второго шага не удержало отчёт (${rev.held || 'ok'}), строка ${other.id}, круги ${JSON.stringify(rev.rounds.map((r) => ({ f: r.flagged, c: r.byCode, m: r.missing })))}`); }
-  }
-  // 2б. Ответ в «грязной» форме (```json, keep строкой, id с пробелом) это ответ, а не молчание.
-  {
-    const { audit, digest, lang } = await build(name);
-    const other = statementsOf(audit, { lang }).find((s) => s.kind === 'claim');
-    const messy = async (messages) => { const fl = JSON.parse(messages[2].content).flagged; return { text: '```json\n' + JSON.stringify({ items: fl.map((x) => ({ id: ` ${x.id} `, keep: 'false' })) }) + '\n```', usage: { input: 1, output: 1 } }; };
-    const rev = await reviewAndFix(audit, digest, firstStep(new Set([other.id])), { lang, askConfirm: messy });
-    if (!rev.ok || rev.held) { fail++; console.log(`FAIL ${name}: «грязный» ответ второго шага принят за молчание (${rev.held})`); }
-  }
-  // 2в. Русская правка строки с латиницей («www») не затирается переводом: иначе круги не сходятся (cimes.ru, 14.10.2026).
-  if (name === 'medeq') {
-    const { audit, lang } = await build(name);
-    applyFix(audit, 'chk:www:value', 'Склейка адреса с www: адрес с www перенаправляется на основной');
-    const t = textMap(audit, lang)['chk:www:value'];
-    if (t !== 'Склейка адреса с www: адрес с www перенаправляется на основной') { fail++; console.log(`FAIL правка www затёрта переводом: «${t}»`); }
-  }
-  // 3. Без подсадки: ни одна верная фраза не меняется, даже если второй шаг «подтверждает» порчу чисел.
-  for (const [label, first, confirm] of [['всё верно', firstStep(), silent], ['порча чисел', firstStep(new Set(['sum:lead', 'sum:verdict', 'sum:prio:0'])), spoiler]]) {
-    const { audit, digest, lang } = await build(name);
-    const mine = textMap(audit, lang);
-    await reviewAndFix(audit, digest, first, { lang, askConfirm: confirm });
-    const after = textMap(audit, lang);
-    for (const [id, t] of Object.entries(mine)) if (after[id] !== undefined && after[id] !== t) { row.spoiled++; fail++; console.log(`FAIL ${name} (${label}) ${id}: верное «${t}» стало «${after[id]}»`); }
-  }
-  table.push(row);
-}
-for (const r of table) console.log(`${r.site.padEnd(10)} исправлено ${r.fixed}, удержано ${r.held}, пропущено ${r.missed}, испорчено верных ${r.spoiled}`);
-const total = table.reduce((a, r) => ({ fixed: a.fixed + r.fixed, held: a.held + r.held, missed: a.missed + r.missed }), { fixed: 0, held: 0, missed: 0 });
-console.log(`подсадка: ${total.fixed + total.held} из 20 исправлены или удержаны, пропущено молча ${total.missed}`);
-if (fail) process.exit(1);
-console.log('PASS planted errors');

package/src/test-presentation.mjs

@@ -1,67 +0,0 @@
-/**
- * Проверка оформления (presentation.mjs): каждое из восьми правил отдельным тестом на настоящем отчёте
- * эталона, куда вписан один огрех. Плюс все эталоны без огрехов должны проходить чисто.
- */
-import { readdirSync, readFileSync } from 'node:fs';
-import { replayer } from './etalon.mjs';
-import { collect } from './collect.mjs';
-import { secondLook } from './verify.mjs';
-import { draftNarrative } from './narrative.mjs';
-import { presentationCheck } from './presentation.mjs';
-
-const dir = new URL('../test/etalon/', import.meta.url);
-let bad = 0;
-const is = (n, c) => { if (!c) { bad++; console.error(`FAIL ${n}`); } else console.log(`ok   ${n}`); };
-
-async function build(name) {
-  const truth = JSON.parse(readFileSync(new URL(`${name}-truth.json`, dir), 'utf8'));
-  const real = globalThis.fetch;
-  globalThis.fetch = replayer(new URL(`${name}.json.gz`, dir));
-  const raw = await collect(truth.site, { pages: 20, tier: '9', lang: truth.lang, rendered: false, log: () => {}, pageDelayMs: 0 });
-  await secondLook(raw, { maxPages: 120, probes: false, log: () => {} });
-  globalThis.fetch = real;
-  return { a: draftNarrative(raw, { lang: truth.lang }), lang: truth.lang };
-}
-
-// Все эталоны чистые.
-const names = readdirSync(dir).filter((x) => x.endsWith('-truth.json')).map((x) => x.replace('-truth.json', '')).sort();
-for (const name of names) {
-  const { a, lang } = await build(name);
-  const r = presentationCheck(a, { lang });
-  is(`${name}: оформление чистое (${r.problems.map((p) => `[${p.rule}] ${p.id} ${p.why}`).join('; ') || 'ни одной находки'})`, r.ok);
-}
-
-// По одному огреху на правило, на отчёте cimes.ru.
-const fires = async (rule, label, spoil) => {
-  const { a, lang } = await build('cimes');
-  spoil(a);
-  const r = presentationCheck(a, { lang });
-  is(`правило ${rule}: ${label}`, r.problems.some((p) => p.rule === rule));
-};
-await fires(1, 'пустой раздел «Неделя 1»', (a) => { a.roadmap[0].items = []; });
-await fires(2, '«Сейчас: 1: t.me»', (a) => { a.summary.priorities[0] = 'Заявить профили. Сейчас: 1: t.me'; });
-await fires(2, 'undefined в тексте', (a) => { a.summary.lead += ' балл undefined'; });
-await fires(3, 'фраза оборвана на «на»', (a) => { a.summary.verdict = 'Та же дата видна на самой странице на'; });
-await fires(3, 'фраза оборвана на «на 1»', (a) => { const c = a.checks.find((x) => x.id === 'dates'); c.value = '1 из 20 страниц выборки указывают дату в разметке; та же дата видна на самой странице на 1'; });
-await fires(4, '«Норма» при 1 из 20', (a) => { const c = a.checks.find((x) => x.id === 'dates'); c.status = 'ok'; c.value = '1 из 20 страниц выборки указывают дату в разметке'; });
-await fires(5, '«Тонкие страницы» в сильных сторонах', (a) => { a.content.strengths = ['Тонкие страницы: медиана 1618 слов на страницу', ...(a.content.strengths || [])]; });
-await fires(6, '«не измеряли» при найденном движке', (a) => { a.checks.push({ id: 'cms', group: 'overview', label: 'Движок сайта', status: 'na', value: '1C-Bitrix (определён по коду страницы)' }); a.overview.rows[0][1] = 'не измеряли'; });
-await fires(7, 'в отчёте 5 страниц, в задаче 2', (a) => { const c = a.checks.find((x) => x.id === 'sections'); c.status = 'warn'; c.value = 'меньше трёх подзаголовков H2 на 5 из 20 страниц выборки'; a.taskOverrides = { sections: { task: 'Разбей на разделы страницы /a/, /b/.' } }; });
-await fires(8, 'длинное тире в нашей фразе', (a) => { a.summary.verdict = 'Сайт в порядке — почти'; });
-
-// Команда для разработчика с /dev/null не огрех.
-{
-  const { a, lang } = await build('cimes');
-  a.taskOverrides = { ...(a.taskOverrides || {}), sections: { verify: 'Три замера (curl -o /dev/null -w "%{time_starttransfer}" адрес главной) показывают не больше 0,8 секунды.' } };
-  is('команда curl с /dev/null не огрех', !presentationCheck(a, { lang }).problems.some((p) => p.rule === 2));
-}
-
-// Тире в цитате с сайта клиента не огрех.
-{
-  const { a, lang } = await build('cimes');
-  a.client.subject = 'По описанию на главной: Студия — сайты под ключ.';
-  is('тире в цитате с сайта клиента не огрех', !presentationCheck(a, { lang }).problems.some((p) => p.rule === 8));
-}
-
-if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
-console.log('\nпроверка оформления: все правила работают, эталоны чистые');