@operstack/audit 0.33.3 → 0.34.0

package/src/review.mjs

@@ -0,0 +1,271 @@
+/**
+ * Проверка отчёта ИИ до выдачи и автоисправление (14.10.2026).
+ *
+ * Простым языком. Отчёт разбирается на отдельные утверждения: каждая строка проверки, каждая фраза
+ * вывода, каждая задача. Утверждения делятся на части (техника, тексты, задачи, выводы и обложка),
+ * и каждую часть одновременно проверяет отдельный вызов модели, не тот, что писал текст. Он видит
+ * само утверждение, замер, на котором оно стоит, и сохранённые копии страниц сайта, и отвечает по
+ * каждому: подтверждено, ложно, вводит в заблуждение или проверить нельзя, с правкой. Ложное и
+ * вводящее в заблуждение переписывается по правке, затем перепроверяются только изменённые фразы.
+ * До трёх кругов. Не сошлось: отчёт не уходит.
+ *
+ * Модель сюда не зашита: вызывающий передаёт ask(messages) → { text, usage }. Так один и тот же
+ * код проверяет и на сервере (OpenAI), и в тестах (заглушка).
+ */
+import { localiseChecks } from './i18n.mjs';
+import { agentPrompts } from './prompts.mjs';
+import { rescore } from './verify.mjs';
+import { vocabFor } from './niche.mjs';
+
+const PART_OF = (id) => {
+  if (/^task:/.test(id)) return 'tasks';
+  if (/^(sum|sub|ov|road):/.test(id)) return 'summary';
+  if (/^chk:(https|favicon|redirect-chain|www|ttfb|robots|sitemap|canonical|viewport|og-|twitter|resources|hreflang|utility|sitemap-health|js-content|title|description|h1|title-all|description-all|alt|h1-sample|dup-titles|xmlrpc)/.test(id)) return 'tech';
+  return 'content';
+};
+
+/** Все утверждения отчёта и задач, по одному на строку, с тем, на чём они стоят. */
+export function statementsOf(audit, { lang = audit.meta?.lang || 'en' } = {}) {
+  const ru = lang === 'ru';
+  const out = [];
+  const kindOf = (id) => (/^chk:.*:value$/.test(id) ? 'measure' : /^chk:.*:comment$/.test(id) ? 'explain' : /^task:.*:task$/.test(id) ? 'task' : /^task:.*:verify$/.test(id) ? 'verify' : /^road:/.test(id) ? 'plan' : 'claim');
+  const add = (id, text, basis = '') => { if (text && String(text).trim() && !String(text).includes('{{')) out.push({ id, kind: kindOf(id), part: PART_OF(id), text: String(text), basis }); };
+  const shown = ru ? localiseChecks(audit.checks || [], 'ru') : (audit.checks || []);
+  for (const c of shown) {
+    if (c.status === 'na' && !c.value) continue;
+    add(`chk:${c.id}:value`, `${c.label}: ${c.value}`, `статус ${c.status}`);
+    if (c.comment) add(`chk:${c.id}:comment`, `${c.label}, пояснение: ${c.comment}`);
+  }
+  add('sub:subject', audit.client?.subject);
+  add('sum:lead', audit.summary?.lead);
+  add('sum:verdict', audit.summary?.verdict);
+  (audit.summary?.priorities || []).forEach((x, i) => add(`sum:prio:${i}`, x));
+  (audit.overview?.rows || []).forEach((r, i) => add(`ov:row:${i}`, `${r[0]}: ${r[1]}`));
+  if (audit.overview?.note) add('ov:note', audit.overview.note);
+  for (const [k, arr] of [['str', audit.content?.strengths], ['weak', audit.content?.weaknesses], ['gap', audit.content?.gaps]]) (arr || []).forEach((x, i) => add(`cont:${k}:${i}`, x));
+  (audit.aeo?.works || []).forEach((x, i) => add(`aeo:works:${i}`, x));
+  (audit.aeo?.blocks || []).forEach((x, i) => add(`aeo:blocks:${i}`, x));
+  add('aeo:rec', audit.aeo?.recommendation);
+  if (audit.geo?.note) add('geo:note', audit.geo.note);
+  (audit.offpage?.listed || []).forEach((x, i) => add(`off:listed:${i}`, x));
+  (audit.conversion?.rows || []).forEach((r, i) => add(`conv:row:${i}`, `${r[0]}: ${r[1]}`));
+  (audit.roadmap || []).forEach((st, j) => (st.items || []).forEach((x, i) => add(`road:${j}:${i}`, x)));
+  for (const t of agentPrompts(audit, { lang })) {
+    const part = (name) => (t.text.match(new RegExp(`\\*\\*${name}:\\*\\*\\s*([^\\n]+)`)) || [])[1];
+    add(`task:${t.id}:task`, part(ru ? 'Задача' : 'Task'), `задача к строке ${t.id}`);
+    add(`task:${t.id}:verify`, part(ru ? 'Как проверить' : 'How to check'), `как проверить задачу ${t.id}`);
+  }
+  return out;
+}
+
+/** Применить правку проверяющего к одному утверждению. Возвращает true, если было что менять. */
+export function applyFix(audit, id, text) {
+  const m = id.split(':');
+  const set = (obj, key, v) => { if (obj && key in obj) { obj[key] = v; return true; } return false; };
+  const strip = (x, label) => String(x).replace(new RegExp(`^${label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?:, пояснение)?:\\s*`), '');
+  if (m[0] === 'chk') {
+    const c = (audit.checks || []).find((x) => x.id === m[1]); if (!c) return false;
+    const label = c.label;
+    if (m[2] === 'value') c.value = strip(text, label);
+    else c.comment = strip(text, label);
+    return true;
+  }
+  if (m[0] === 'task') { audit.taskOverrides = audit.taskOverrides || {}; (audit.taskOverrides[m[1]] = audit.taskOverrides[m[1]] || {})[m[2]] = text; return true; }
+  if (id === 'sub:subject') return set(audit.client, 'subject', text);
+  if (id === 'sum:lead') return set(audit.summary, 'lead', text);
+  if (id === 'sum:verdict') return set(audit.summary, 'verdict', text);
+  if (m[0] === 'sum' && m[1] === 'prio') { audit.summary.priorities[Number(m[2])] = text; return true; }
+  if (m[0] === 'ov' && m[1] === 'row') { const r = audit.overview.rows[Number(m[2])]; r[1] = String(text).replace(new RegExp(`^${r[0]}:\\s*`), ''); return true; }
+  if (id === 'ov:note') return set(audit.overview, 'note', text);
+  if (m[0] === 'cont') { const k = { str: 'strengths', weak: 'weaknesses', gap: 'gaps' }[m[1]]; audit.content[k][Number(m[2])] = text; return true; }
+  if (m[0] === 'aeo' && m[1] !== 'rec') { audit.aeo[m[1]][Number(m[2])] = text; return true; }
+  if (id === 'aeo:rec') return set(audit.aeo, 'recommendation', text);
+  if (id === 'geo:note') return set(audit.geo, 'note', text);
+  if (m[0] === 'off') { audit.offpage.listed[Number(m[2])] = text; return true; }
+  if (m[0] === 'conv') { const r = audit.conversion.rows[Number(m[2])]; r[1] = String(text).replace(new RegExp(`^${r[0]}:\\s*`), ''); return true; }
+  if (m[0] === 'road') { audit.roadmap[Number(m[1])].items[Number(m[2])] = text; return true; }
+  return false;
+}
+
+/** Утверждение «нельзя проверить» удаляется, если это не строка замера: в отчёт идёт только то, что доказано. */
+export function dropStatement(audit, id) {
+  const m = id.split(':');
+  if (m[0] === 'cont') { const k = { str: 'strengths', weak: 'weaknesses', gap: 'gaps' }[m[1]]; audit.content[k].splice(Number(m[2]), 1); return true; }
+  if (m[0] === 'aeo' && m[1] !== 'rec') { audit.aeo[m[1]].splice(Number(m[2]), 1); return true; }
+  if (m[0] === 'off') { audit.offpage.listed.splice(Number(m[2]), 1); return true; }
+  return false;
+}
+
+const SYSTEM = (ru, niche) => (ru
+  ? `Ты проверяющий отчёта о сайте перед отправкой платному клиенту. Одна неправда бьёт по репутации, но и ложная тревога дорого стоит: каждую твою правку текст отчёта примет. Ниша сайта: ${niche}.
+Тебе дают: утверждения (id, kind, текст, на чём стоит), toolFacts (замеры инструмента: размер выборки, число адресов в карте, результаты запросов к файлам и роботам) и выжимку сайта (robots.txt и по каждой странице заголовок, описание, H1, H2, типы разметки, sameAs, картинки и пустые alt, формы, соцсети, мессенджеры, слова, начало текста).
+Правила по виду (kind):
+- measure (строка замера «Метка: значение»): сверь каждое число и каждое «есть/нет» с таблицей страниц в выжимке (она покрывает весь сайт, pagesTotal страниц) и с toolFacts. Особенно проверяй «нет», «ни одного», «0 из», «на всех»: найди в таблице хоть одну страницу, которая это опровергает (например, ссылки на соцсети в social, текст политики в privacyText, правила в termsText, раскрывающиеся блоки в accordions, видимые даты в visibleDates, цены в prices, число H1). Нашёл: false. Не нашёл противоречия: ok. unverifiable для measure не ставь.
+- explain (пояснение к строке): ok, если по делу; misleading, если преувеличивает, вводит в заблуждение или не подходит нише.
+- claim (вывод, обложка, обзор, сильные и слабые стороны, рекомендация): сверь с выжимкой и toolFacts; false или misleading с правкой; unverifiable, если ничем не подтверждается.
+- task (задача исполнителю): вместо verdict заполни поля premiseTrue (true, если проблема, которую решает задача, на сайте действительно есть, и задача не просит чинить то, чего нет), fitsNiche (true, если совет подходит нише и не велит выдумывать факты). Если хоть одно false, дай fix.
+- verify («Как проверить» у задачи): вместо verdict заполни поля passesNow (true, если эта проверка УЖЕ проходит на сайте прямо сейчас, до всякой работы) и possible (true, если её можно выполнить). Это не вопрос «верно ли», задача ещё не сделана, и это нормально. Если passesNow true или possible false, дай fix.
+- plan (пункт плана): ok, если пункт соответствует строке отчёта.
+Для false и misleading дай fix: полный новый текст по-русски, без длинного и среднего тире, только с фактами из выжимки и toolFacts, в той же форме («Метка: значение» для measure).
+Ответ строго JSON: {"items":[{"id":"...","verdict":"ok|false|misleading|unverifiable","premiseTrue":true,"fitsNiche":true,"passesNow":false,"possible":true,"why":"коротко","fix":"..."}]} (лишние для вида поля не заполняй)`
+  : `You review a website report before a paying client receives it. One false statement damages the business, but a false alarm costs too: the report takes every fix you give. Site niche: ${niche}.
+You get: statements (id, kind, text, basis), toolFacts (tool measurements: sample size, sitemap URL count, file and robot probe results) and a site digest (robots.txt and, per page, title, description, H1, H2, schema types, sameAs, images and empty alts, forms, social, messengers, words, opening text).
+Rules by kind:
+- measure ("Label: value" check row): check every number and every present/absent claim against the per-page table in the digest (it covers the whole site, pagesTotal pages) and toolFacts. Look hardest at "none", "no", "0 of", "on every": find any page in the table that contradicts it (social links in social, policy text in privacyText, terms in termsText, accordions, visibleDates, prices, H1 counts). Found one: false. Found no contradiction: ok. Never unverifiable.
+- explain (a row's note): ok if relevant; misleading if it overstates, misleads or does not fit the niche.
+- claim (summary, cover, overview, strengths, weaknesses, recommendation): check against digest and toolFacts; false or misleading with a fix; unverifiable if nothing supports it.
+- task (a task for the developer): instead of verdict fill premiseTrue (true if the problem it solves really exists on the site and it does not ask to fix what is not there) and fitsNiche (true if it fits the niche and asks to invent nothing). If either is false, give fix.
+- verify (a task's "How to check"): instead of verdict fill passesNow (true if this check ALREADY passes on the site right now, before any work) and possible (true if it can be met). The task is not done yet and that is fine. If passesNow is true or possible is false, give fix.
+- plan (a roadmap item): ok if it matches a report row.
+For false and misleading give fix: full replacement text in English, no em or en dashes, facts from digest and toolFacts only, same shape ("Label: value" for measure).
+Answer strictly as JSON: {"items":[{"id":"...","verdict":"ok|false|misleading|unverifiable","premiseTrue":true,"fitsNiche":true,"passesNow":false,"possible":true,"why":"short","fix":"..."}]} (leave out fields that do not apply)`);
+
+/** Замеры инструмента, на которые опираются строки: проверяющий иначе считает их «непроверяемыми». */
+export function toolFacts(audit) {
+  // Только то, что инструмент измерил запросом к сайту (файлы, роботы, скорость), а не его же выводы:
+  // выводы из строк проверки здесь делали проверку круговой (14.10.2026: 0 из 13 известных ошибок).
+  const by = (id) => (audit.checks || []).find((c) => c.id === id);
+  const probe = (id) => (by(id) ? by(id).value : undefined);
+  const sm = (audit.sample || []).filter((p) => p && p.title !== undefined);
+  return {
+    sampled: sm.length,
+    sampleUrls: sm.map((p) => p.url),
+    sitemapUrlCount: (String(probe('sitemap') || '').match(/(\d+)/) || [])[1],
+    filesAndProbes: { 'https': probe('https'), www: probe('www'), 'redirect-chain': probe('redirect-chain'), ttfb: probe('ttfb'), 'llms.txt': probe('llms'), 'agent.json': probe('agent-card'), 'api-catalog': probe('api-catalog'), markdown: probe('agent-markdown'), 'robots-to-ai-robots': probe('train-bots'), 'js-hidden-text': probe('js-content'), cms: probe('cms') },
+    images: { total: sm.reduce((a, p) => a + (p.images || 0), 0), withoutAltText: sm.reduce((a, p) => a + (p.imagesNoAlt || 0), 0), withoutAltAttribute: sm.reduce((a, p) => a + (p.imagesAltMissing || 0), 0) },
+    perSampledPage: sm.map((p) => ({ url: p.url, words: p.words, h1Count: p.h1Count, h2Count: p.h2Count, images: p.images, imagesNoAlt: p.imagesNoAlt, ctaFirstScreen: p.ctaFirstScreen })),
+    classification: 'Деление открытых проверок на «правятся технически» и «требуют фактов владельца» и оценки областей считает инструмент по своему списку; это не утверждения о сайте.',
+  };
+}
+
+export function digestFor(digest, statements, full = 4000) {
+  const text = statements.map((s) => s.text).join(' ');
+  const mentioned = new Set();
+  for (const p of digest.pages || []) { let path = ''; try { path = new URL(p.url).pathname; } catch { /* */ } if (path && path !== '/' && text.includes(path)) mentioned.add(p.url); }
+  if (digest.pages && digest.pages[0]) mentioned.add(digest.pages[0].url);
+  // Таблица фактов по каждой странице сайта без текста; текст только у страниц, о которых говорят утверждения.
+  // Компактная строка на страницу: пустые поля и повторяющиеся по всему сайту значения (одни и те же соцсети,
+  // одинаковые типы разметки) не повторяем в каждой строке, иначе на сайте в 150 страниц цена проверки удваивается.
+  const pages = digest.pages || [];
+  const common = (key) => { const vals = pages.map((p) => JSON.stringify(p[key] || [])); const top = vals.sort((a, b) => vals.filter((x) => x === b).length - vals.filter((x) => x === a).length)[0]; return top && vals.filter((x) => x === top).length > pages.length / 2 ? top : null; };
+  const siteWide = { schema: common('schema'), social: common('social'), sameAs: common('sameAs') };
+  const slim = (p) => {
+    const o = {};
+    for (const [k, v] of Object.entries(p)) {
+      if (k === 'text') continue;
+      if (Array.isArray(v) && !v.length) continue;
+      if (v === '' || v === 0 || v === false) continue;
+      if (siteWide[k] && JSON.stringify(v) === siteWide[k]) continue;
+      o[k] = Array.isArray(v) ? v.slice(0, k === 'h2' ? 8 : 5) : v;
+    }
+    if (mentioned.has(p.url)) o.text = String(p.text || '').slice(0, full);
+    return o;
+  };
+  return { robots: String(digest.robots || '').slice(0, 1500), pagesTotal: pages.length, sameOnMostPages: Object.fromEntries(Object.entries(siteWide).filter(([, v]) => v).map(([k, v]) => [k, JSON.parse(v)])), pages: pages.map(slim) };
+}
+
+/**
+ * Один круг: все части параллельно. Возвращает вердикты по id и учёт токенов.
+ * @param {(messages: object[]) => Promise<{text: string, usage?: object}>} ask
+ */
+export async function reviewRound(audit, digest, statements, ask, { lang = audit.meta?.lang || 'en' } = {}) {
+  const ru = lang === 'ru';
+  const niche = vocabFor(audit, lang).niche;
+  const parts = [...new Set(statements.map((s) => s.part))];
+  const usage = { input: 0, output: 0, calls: 0 };
+  // Пачки по 20 утверждений одной части: на 170 строках сразу модель пропускала очевидное (14.10.2026).
+  const batches = parts.flatMap((part) => { const all = statements.filter((s) => s.part === part); const out = []; for (let i = 0; i < all.length; i += 20) out.push({ part, st: all.slice(i, i + 20) }); return out; });
+  // Одна и та же выжимка в начале каждого вызова: OpenAI берёт повторяющееся начало из кэша за десятую часть цены.
+  const shared = JSON.stringify({ site: audit.meta?.site, toolFacts: toolFacts(audit), digest: digestFor(digest, statements) });
+  const runBatch = async ({ part, st }) => {
+    const messages = [
+      { role: 'system', content: SYSTEM(ru, niche) },
+      { role: 'user', content: shared },
+      { role: 'user', content: JSON.stringify({ statements: st.map(({ id, kind, text, basis }) => ({ id, kind, text, basis })) }) },
+    ];
+    let r; let lastErr;
+    for (let attempt = 0; attempt < 2; attempt++) {
+      try { r = await ask(messages); break; } catch (e) { lastErr = e; }
+    }
+    if (!r) throw new Error(`проверка части «${part}» не ответила: ${lastErr?.message || 'нет ответа'}`);
+    usage.calls += 1; usage.input += r.usage?.input || 0; usage.cached = (usage.cached || 0) + (r.usage?.cached || 0); usage.output += r.usage?.output || 0;
+    let parsed; try { parsed = JSON.parse(String(r.text).replace(/^```json\s*|```$/g, '')); } catch { throw new Error(`проверка части «${part}» вернула не JSON`); }
+    return (parsed.items || []).filter((x) => st.some((s) => s.id === x.id));
+  };
+  // Первый вызов один: он кладёт общую выжимку в кэш OpenAI, остальные идут параллельно уже по кэшу.
+  const first = batches.length ? [await runBatch(batches[0])] : [];
+  const rest = await Promise.all(batches.slice(1).map(runBatch));
+  const items = [...first, ...rest].flat();
+  // Утверждение, по которому проверяющий промолчал, считаем непроверенным, а не подтверждённым.
+  const seen = new Set(items.map((x) => x.id));
+  for (const s of statements) if (!seen.has(s.id)) items.push({ id: s.id, verdict: 'unverifiable', why: 'проверяющий не ответил по этой строке' });
+  const kind = Object.fromEntries(statements.map((s) => [s.id, s.kind]));
+  // Вердикт по задачам и проверкам выставляет код по ответам «да/нет»: на вопрос «верно ли» модели
+  // отвечали «ложно, ещё не сделано» (14.10.2026), а на прямые вопросы отвечают точно.
+  for (const x of items) {
+    if (kind[x.id] === 'verify') x.verdict = x.passesNow === true || x.possible === false ? 'misleading' : 'ok';
+    if (kind[x.id] === 'task') x.verdict = x.premiseTrue === false || x.fitsNiche === false ? 'misleading' : 'ok';
+  }
+  // Для замеров, задач и плана «не проверить» значит «не опровергнуто»: это не вывод, а замер или указание.
+  for (const x of items) if (x.verdict === 'unverifiable' && kind[x.id] !== 'claim' && kind[x.id] !== 'explain') x.verdict = 'ok';
+  return { items, usage };
+}
+
+
+const CONFIRM = (ru) => (ru
+  ? `Ты второй проверяющий. Первый пометил утверждения отчёта о сайте как ложные или вводящие в заблуждение. Он часто ошибается: помечает верное. Твоя задача отсеять ложные тревоги.
+По каждому помеченному утверждению найди в выжимке сайта или toolFacts КОНКРЕТНОЕ доказательство: адрес страницы и поле (или файл) со значением, которое прямо опровергает утверждение, либо (для задачи) показывает, что проблемы нет, совет чужой ниши или проверка уже проходит. Нашёл: keep true, evidence с адресом и значением, fix с полным новым текстом по-русски без длинного и среднего тире. Не нашёл прямого доказательства: keep false. Мнения, стиль и «можно сказать лучше» это не доказательство.
+Ответ строго JSON: {"items":[{"id":"...","keep":true,"evidence":"адрес: поле = значение","fix":"..."}]}`
+  : `You are the second reviewer. The first one flagged report statements as false or misleading. It often errs and flags correct text. Your job is to drop the false alarms.
+For each flagged statement find SPECIFIC evidence in the site digest or toolFacts: a page URL and a field (or file) whose value directly contradicts the statement, or (for a task) shows the problem is absent, the advice belongs to another niche, or the check already passes. Found it: keep true, evidence with URL and value, fix with the full replacement in English, no em or en dashes. No direct evidence: keep false. Opinions, style and "could be phrased better" are not evidence.
+Answer strictly as JSON: {"items":[{"id":"...","keep":true,"evidence":"url: field = value","fix":"..."}]}`);
+
+/** Второй шаг: подтвердить пометки первого более сильной моделью, только с прямым доказательством. */
+export async function confirmFlags(audit, digest, statements, flagged, ask, { lang = audit.meta?.lang || 'en' } = {}) {
+  const ru = lang === 'ru';
+  if (!flagged.length) return { items: [], usage: { input: 0, output: 0, calls: 0 } };
+  const shared = JSON.stringify({ site: audit.meta?.site, toolFacts: toolFacts(audit), digest: digestFor(digest, statements) });
+  const byId = Object.fromEntries(statements.map((s) => [s.id, s]));
+  const usage = { input: 0, output: 0, cached: 0, calls: 0 };
+  const groups = []; for (let i = 0; i < flagged.length; i += 40) groups.push(flagged.slice(i, i + 40));
+  const res = await Promise.all(groups.map(async (g) => {
+    const r = await ask([{ role: 'system', content: CONFIRM(ru) }, { role: 'user', content: shared }, { role: 'user', content: JSON.stringify({ flagged: g.map((x) => ({ id: x.id, kind: byId[x.id]?.kind, text: byId[x.id]?.text, firstReviewer: { verdict: x.verdict, why: x.why, fix: x.fix } })) }) }]);
+    usage.calls += 1; usage.input += r.usage?.input || 0; usage.cached += r.usage?.cached || 0; usage.output += r.usage?.output || 0;
+    let parsed; try { parsed = JSON.parse(String(r.text).replace(/^```json\s*|```$/g, '')); } catch { throw new Error('второй проверяющий вернул не JSON'); }
+    return parsed.items || [];
+  }));
+  return { items: res.flat(), usage };
+}
+
+/**
+ * Полная проверка с автоисправлением, до maxRounds кругов.
+ * @returns {{ ok: boolean, rounds: object[], usage: object, left: object[] }}
+ */
+export async function reviewAndFix(audit, digest, ask, { lang = audit.meta?.lang || 'en', maxRounds = 3, log = () => {}, askConfirm = ask } = {}) {
+  const rounds = []; const usage = { input: 0, cached: 0, output: 0, calls: 0, confirm: { input: 0, cached: 0, output: 0, calls: 0 } };
+  const add = (u, t) => { for (const k of ['input', 'cached', 'output', 'calls']) t[k] += u[k] || 0; };
+  let todo = statementsOf(audit, { lang });
+  let left = [];
+  for (let round = 1; round <= maxRounds && todo.length; round++) {
+    const all = statementsOf(audit, { lang });
+    const { items, usage: u } = await reviewRound(audit, digest, todo, ask, { lang });
+    add(u, usage);
+    const flagged = items.filter((x) => x.verdict === 'false' || x.verdict === 'misleading');
+    // Второй шаг: каждая пометка нужна с прямым доказательством, иначе это ложная тревога.
+    const { items: conf, usage: cu } = await confirmFlags(audit, digest, all, flagged, askConfirm, { lang });
+    add(cu, usage.confirm);
+    const kept = conf.filter((x) => x.keep);
+    const lost = items.filter((x) => x.verdict === 'unverifiable');
+    rounds.push({ round, checked: todo.length, flagged: flagged.length, kept: kept.length, unverifiable: lost.length, items: kept.map((x) => ({ ...x, text: all.find((s) => s.id === x.id)?.text })) });
+    log(`проверка, круг ${round}: проверено ${todo.length}, помечено ${flagged.length}, подтверждено ${kept.length}, не проверить ${lost.length}`);
+    const changed = [];
+    for (const x of kept) if (x.fix && applyFix(audit, x.id, x.fix)) changed.push(x.id);
+    for (const x of lost.slice().sort((a, b) => b.id.localeCompare(a.id))) if (dropStatement(audit, x.id)) changed.push(x.id);
+    rescore(audit);
+    if (!kept.length) { left = []; break; }
+    left = kept.filter((x) => !x.fix);
+    todo = statementsOf(audit, { lang }).filter((st) => changed.includes(st.id));
+    if (round === maxRounds) left = kept;
+  }
+  return { ok: left.length === 0, rounds, usage, left };
+}

package/src/tasks-pdf.mjs

@@ -0,0 +1,67 @@
+/**
+ * Задачи для исполнителя отдельным PDF вместо файла .md (14.10.2026).
+ *
+ * Простым языком. Владелец сайта не знает, чем открыть .md, и не перешлёт его исполнителю. PDF в
+ * оформлении отчёта открывается везде: у каждой задачи «Сейчас», «Что сделать» и «Как проверить»,
+ * и файл целиком пересылается тому, кто ведёт сайт.
+ */
+import { writeFileSync, existsSync, mkdtempSync, rmSync, readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { join, resolve as resolvePath } from 'node:path';
+import { agentPrompts } from './prompts.mjs';
+import { pdfPageCount } from './render.mjs';
+
+const esc = (t) => String(t ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+const md = (t) => esc(t).replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+
+export function renderTasksHtml(audit, { lang = audit.meta?.lang || 'en' } = {}) {
+  const ru = lang === 'ru';
+  const host = audit.meta?.host || '';
+  const L = ru
+    ? { eb: 'OperStack · задачи для исполнителя', h1: `${host}: что поправить на сайте`, now: 'Сейчас', task: 'Что сделать', verify: 'Как проверить',
+        intro: ['Ниже список задач, по одной на каждую найденную проблему. Каждая написана обычными словами, и её можно отдать тому, кто ведёт ваш сайт, или помощнику вроде ChatGPT.', 'Отдавайте по одной задаче, вместе со строками «Сейчас» и «Как проверить»: так исполнитель поймёт, откуда начинать и когда работа сделана.', 'Этот файл можно целиком переслать тому, кто ведёт ваш сайт.'],
+        rule: 'Правило для исполнителя: не выдумывай факты о бизнесе. Всё, чего нет на сайте и чего тебе не сказали, спрашивай у владельца.', foot: 'задачи' }
+    : { eb: 'OperStack · tasks for your developer', h1: `${host}: what to fix on the site`, now: 'Now', task: 'What to do', verify: 'How to check',
+        intro: ['Below is one task for every problem found, each in plain words, ready to hand to whoever runs your site or to an assistant like ChatGPT.', 'Hand over one task at a time, with its "Now" and "How to check" lines: that is how the developer knows where to start and when it is done.', 'You can forward this whole file to whoever runs your site.'],
+        rule: 'Rule for the developer: invent no facts about the business. Anything not on the site and not told to you, ask the owner.', foot: 'tasks' };
+  const items = agentPrompts(audit, { lang }).map((t, n) => {
+    const get = (k) => (t.text.match(new RegExp(`\\*\\*${k}:\\*\\*\\s*([^\\n]+)`)) || [])[1] || '';
+    const title = (t.text.match(/^### (.+)$/m) || [])[1] || t.id;
+    return `<section class="t"><h3><span>${n + 1}</span>${esc(title)}</h3><p class="now"><em>${L.now}</em>${md(get(ru ? 'Сейчас' : 'Now'))}</p><p><em>${L.task}</em>${md(get(ru ? 'Задача' : 'Task'))}</p><p class="chk"><em>${L.verify}</em>${md(get(ru ? 'Как проверить' : 'How to check'))}</p></section>`;
+  });
+  return `<!doctype html><html lang="${ru ? 'ru' : 'en'}"><head><meta charset="utf-8"><title>${esc(L.h1)}</title>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,600&family=IBM+Plex+Sans:wght@400;500;600&display=swap">
+<style>@page{size:A4;margin:16mm 16mm 18mm}body{font:10pt/1.5 "IBM Plex Sans",sans-serif;color:#16202B;margin:0}
+.eb{font-size:7.5pt;letter-spacing:.14em;text-transform:uppercase;color:#177C70;font-weight:600;margin:0 0 6px}
+h1{font-family:Fraunces,serif;font-size:22pt;line-height:1.15;margin:0 0 10px}
+.intro{background:#E7F3EF;border-radius:10px;padding:10px 14px;margin:10px 0 16px}.intro p{margin:0 0 6px}
+.t{border-top:1px solid #DCE3E6;padding:10px 0 8px;break-inside:avoid}
+h3{font-family:Fraunces,serif;font-size:12.5pt;margin:0 0 6px;display:flex;gap:8px;align-items:baseline}h3 span{font-family:"IBM Plex Sans";font-size:9pt;color:#fff;background:#177C70;border-radius:10px;padding:1px 7px}
+p{margin:0 0 5px}em{font-style:normal;font-weight:600;font-size:8pt;text-transform:uppercase;letter-spacing:.06em;color:#5A6470;display:block}
+.now{color:#3F4854}.chk{color:#0F5C53}.rule{margin-top:14px;font-size:9pt;color:#5A6470}</style></head><body>
+<p class="eb">${esc(L.eb)}</p><h1>${esc(L.h1)}</h1><div class="intro">${L.intro.map((x) => `<p>${esc(x)}</p>`).join('')}</div>
+${items.join('\n')}
+<p class="rule">${esc(L.rule)}</p></body></html>`;
+}
+
+function findChrome() {
+  return [process.env.CHROME_PATH, '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser'].filter(Boolean).find((p) => existsSync(p));
+}
+
+/** Печать задач в PDF. Возвращает { pdf, pages } или бросает ошибку: без PDF задачи клиенту не уходят. */
+export function renderTasksPdf(audit, { out, lang } = {}) {
+  const html = renderTasksHtml(audit, { lang });
+  const htmlPath = resolvePath(out.replace(/\.pdf$/, '') + '.html');
+  const pdfPath = resolvePath(out);
+  writeFileSync(htmlPath, html);
+  const chrome = findChrome();
+  if (!chrome) throw new Error('нет Chrome: задачи в PDF не напечатаны');
+  const profile = mkdtempSync(join(tmpdir(), 'operstack-tasks-'));
+  const r = spawnSync(chrome, ['--headless=new', '--disable-gpu', '--no-first-run', `--user-data-dir=${profile}`, '--virtual-time-budget=8000', '--no-pdf-header-footer', `--print-to-pdf=${pdfPath}`, `file://${htmlPath}`], { encoding: 'utf8', timeout: 90000 });
+  try { rmSync(profile, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 }); } catch { /* временная папка */ }
+  if (!existsSync(pdfPath)) throw new Error(`Chrome не напечатал задачи${r.stderr ? `: ${r.stderr.slice(-200)}` : ''}`);
+  const pages = pdfPageCount(readFileSync(pdfPath));
+  if (!pages) throw new Error('в PDF задач нет ни одного листа');
+  return { pdf: pdfPath, html: htmlPath, pages };
+}

package/src/test-agent-surface.mjs

@@ -23,7 +23,7 @@ ok('и объяснено почему', /есть API/.test(FIX_ACTIONS['api-ca
 // Задания для агента полные и не врут про обязательность
 const card = agentPrompt({ id: 'agent-card', label: 'Карточка агента', status: 'warn', value: 'нет' }, { lang: 'ru' });
 ok('в задании про карточку есть проверка', /Как проверить/.test(card));
-ok('и запрет выдумывать возможности', /только правду|выдуманная возможность/.test(card));
+ok('и не велит делать карточку без агента', /только правду|выдуманная возможность|ради галочки нельзя/.test(card));
 const md = agentPrompt({ id: 'agent-markdown', label: 'Markdown-версия', status: 'warn', value: 'нет' }, { lang: 'ru' });
 ok('в задании про markdown сказано, что класть, а что нет', /меню и подвал/.test(md));
 

package/src/test-etalon.mjs

@@ -0,0 +1,42 @@
+/**
+ * Эталон: движок прогоняется по записанным ответам пяти сайтов и сверяется с ответами, проверенными
+ * вручную (test/etalon/*-truth.json). Одно расхождение, и версия не выкладывается.
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { replayer } from './etalon.mjs';
+import { collect } from './collect.mjs';
+import { secondLook } from './verify.mjs';
+import { localiseChecks } from './i18n.mjs';
+
+const dir = new URL('../test/etalon/', import.meta.url);
+let fail = 0; let pass = 0;
+const real = globalThis.fetch;
+for (const f of readdirSync(dir).filter((x) => x.endsWith('-truth.json')).sort()) {
+  const truth = JSON.parse(readFileSync(new URL(f, dir), 'utf8'));
+  const name = f.replace(/-truth\.json$/, '');
+  const rec = new URL(`${name}.json.gz`, dir);
+  if (!existsSync(rec)) { console.log(`FAIL ${name}: нет записи ответов сайта`); fail++; continue; }
+  globalThis.fetch = replayer(rec);
+  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;
+  const by = Object.fromEntries(raw.checks.map((c) => [c.id, c]));
+  // Число по выборке без слова «выборки» читается как число по всему сайту и преуменьшает проблему (14.10.2026).
+  const sampleN = (raw.sample || []).filter((p) => p && p.title !== undefined).length;
+  const shown = truth.lang === 'ru' ? localiseChecks(raw.checks, 'ru') : raw.checks;
+  for (const c of shown) {
+    const v = String(c.value || '');
+    const re = truth.lang === 'ru' ? /из (\d+) (?:страниц\S*|проверенн\S*)(?!\s+(?:выборки|карты|сайта|прочитанн))/gu : /of (\d+) (?!sampled|pages read|pages in the sitemap)(?:pages?)\b/g;
+    for (const m of v.matchAll(re)) if (Number(m[1]) === sampleN) { fail++; console.log(`FAIL ${name} ${c.id}: число по выборке без слова «выборки»: «${v}»`); }
+  }
+  if (truth.niche && raw.niche?.niche !== truth.niche) { console.log(`FAIL ${name}: ниша ${raw.niche?.niche}, правильно ${truth.niche}`); fail++; } else pass++;
+  for (const [id, exp] of Object.entries(truth.checks || {})) {
+    const c = by[id];
+    const okStatus = !exp.status || (c && c.status === exp.status);
+    const okValue = !exp.valueRegex || (c && new RegExp(String(exp.valueRegex).replace(/\\w/g, '[\\p{L}\\p{N}_]'), 'iu').test(String(c.value)));
+    if (okStatus && okValue) pass++;
+    else { fail++; console.log(`FAIL ${name} ${id}: движок ${c ? `${c.status} «${c.value}»` : 'нет строки'}, ждали ${exp.status || ''} ${exp.valueRegex ? `/${exp.valueRegex}/` : ''}`); }
+  }
+}
+console.log(fail ? `эталон: ${fail} расхождений, ${pass} совпадений` : `эталон: всё сходится (${pass} проверок)`);
+if (fail) process.exit(1);

package/src/test-narrative.mjs

@@ -60,10 +60,19 @@ ok('упоминания на чужих сайтах помечены как н
 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], 'en');
+}
 
 // Числа сходятся между собой
 const openN = 4; const mech = 2; // alt, conv-cta механические; thin и answer-first это тексты
-ok('в выводе число открытых проверок верное', d.summary.verdict.includes(`${openN} вещи`) || d.summary.verdict.includes(`${openN} вещей`));
+ok('в выводе число открытых проверок верное', d.summary.verdict.startsWith(`${openN} `) && /не полностью/.test(d.summary.verdict));
 ok('и механических не больше, чем всех', d.summary.verdict.includes(`${mech} правятся`) || d.summary.verdict.includes(`${mech} правится`));
 
 // Приоритеты это действие, а не название проверки
@@ -74,7 +83,7 @@ ok('работа с текстами названа работой, а не от
 // Русский отчёт по английскому аудиту не должен содержать английских названий проверок
 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('области названы по-русски', /техническая часть|Конверсия/.test(d.summary.lead));
+ok('области названы по-русски', /доступ и адреса|техническая часть|конверсия/i.test(d.summary.lead));
 
 // Дорожная карта: уже написанные строки переведены, пустые заполнены
 ok('готовая строка карты переведена', d.roadmap[0].items[0].includes('подписи'));

package/src/test-prompts.mjs

@@ -39,9 +39,9 @@ ok('английский файл без кириллицы', !/[А-Яа-яЁё]
 
 // Задания не обещают того, чего мы не знаем
 const contact = agentPrompt(c('conv-messenger', 'bad', 'Мессенджер', 'нет'), { lang: 'ru' });
-ok('не выбирает мессенджер за клиента', /не знаешь, какой мессенджер|спроси владельца/.test(contact));
+ok('не выбирает мессенджер за клиента', /не знаешь, какой мессенджер|спроси владельца/i.test(contact));
 const src = agentPrompt(c('sources', 'bad', 'Источники', '2 из 20'), { lang: 'ru' });
-ok('запрещает ставить ссылку наугад', /не ставь ссылку наугад|неверный источник хуже/.test(src));
+ok('запрещает ставить ссылку наугад', /не ставь ссылку наугад|неверный источник хуже/i.test(src));
 const af = agentPrompt(c('answer-first', 'bad', 'Ответ в начале', '2 из 20'), { lang: 'ru' });
 ok('запрещает придумывать цифру', /не придумывай её|спроси владельца/.test(af));
 

package/src/test-rendered.mjs

@@ -3,12 +3,21 @@
 import { chmodSync, mkdtempSync, writeFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { compareReadings, jsBlindnessCheck, isBrowserErrorPage, renderedDom } from './rendered.mjs';
+import { compareReadings, jsBlindnessCheck, isBrowserErrorPage, renderedDom, removeProfile } from './rendered.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);
 
+// Профиль Chrome: ENOTEMPTY на macOS ронял весь сбор (brainmd.com, 12.10.2026).
+{
+  let opts = null;
+  is('удаление профиля с повторами', removeProfile('/tmp/x', (d, o) => { opts = o; }), true);
+  ok('повторы включены', opts && opts.maxRetries >= 3 && opts.recursive);
+  const fail = () => { const e = new Error('ENOTEMPTY: directory not empty'); e.code = 'ENOTEMPTY'; throw e; };
+  is('ENOTEMPTY не роняет сбор', removeProfile('/tmp/x', fail), false);
+}
+
 const text = (n) => '<p>' + 'слово '.repeat(n) + '</p>';
 const body = (inner) => `<html><body>${inner}</body></html>`;
 
@@ -55,7 +64,7 @@ ok('а пишем, что часть текста не доходит', /не д
 
 const none = jsBlindnessCheck([], 'ru');
 is('без браузера статус «не измеряли»', none.status, 'na');
-ok('и сказано почему', /нет браузера/.test(none.value));
+ok('и сказано почему, без слов про «машину»', /не измеряли/.test(none.value) && !/машин/.test(none.value));
 
 const en = jsBlindnessCheck([{ url: 'https://x.com/', raw: 10, rendered: 400, hiddenShare: 98, verdict: 'bad' }], 'en');
 ok('английская версия без кириллицы', !/[А-Яа-яЁё]/.test(JSON.stringify(en)));