@operstack/audit 0.33.4 → 0.34.0

package/src/render.mjs

@@ -3,10 +3,10 @@
  * through headless Chrome. Every narrative field is read from the JSON; a field that still
  * holds a {{placeholder}} is rendered highlighted so it cannot ship unnoticed.
  */
-import { writeFileSync, existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { writeFileSync, existsSync, mkdtempSync, rmSync, readFileSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import { tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { join, resolve as resolvePath } from 'node:path';
 import { computeScores, computeOverall } from './collect.mjs';
 import { localiseBasisNote, AREAS_RU } from './i18n.mjs';
 import { MESSAGES as VISIBILITY_MESSAGES } from './visibility.mjs';
@@ -35,7 +35,7 @@ const LABELS = {
     // Подпись обязана сказать три вещи: откуда число, что именно успели прочитать, и почему
     // повтор может дать на пункт-другой иначе. Без последнего человек читает разницу как ошибку.
     overallNote: (o) => {
-      const read = o.basis ? `It was read from ${o.basis.pages} page${o.basis.pages === 1 ? '' : 's'} of the site${o.basis.sitemapUnchecked ? ', and the sitemap did not answer in time, which is not counted against the score either way' : o.basis.sitemapRead ? ' and its sitemap' : ''}. ` : '';
+      const read = o.basis ? `It was read from ${o.basis.pages} page${o.basis.pages === 1 ? '' : 's'} of the site${o.basis.sitemapUnchecked ? ', and the sitemap did not answer in time, which is not counted against the score either way' : o.basis.sitemapRead ? ' and its sitemap' : ''} for this score; the rest of the report counts the whole sample. ` : '';
       const where = o.source === 'visibility:reused'
         ? `This is the same figure you already saw on the free check${o.measuredAt ? ` on ${String(o.measuredAt).slice(0, 10)}` : ''}. It is not measured again here, so the page, the email and this report always carry one number. `
         : 'Measured here by the same code and the same settings as the free check at oper-stack.com/ai-visibility. ';
@@ -60,10 +60,10 @@ const LABELS = {
     secTechnical: 'Technical SEO', technicalEyebrow: '04 · Technical', technicalTitle: 'Technical and on-page checklist', colCheck: 'Check', colStatus: 'Status', colFinding: 'Finding',
     secContent: 'Content and on-page', contentEyebrow: '05 · Content', contentTitle: 'Content and on-page SEO', strengths: 'Strengths', weaknesses: 'Weaknesses', gaps: 'Structural gaps: pages that do not exist yet',
     secAeo: 'AEO and GEO', aeoEyebrow: '06 · AEO / GEO', aeoTitle: 'Answer engines: AEO', aeoLead: 'Whether the site\'s answers can be lifted into "People also ask", AI overviews, ChatGPT and Perplexity.', aeoWorks: 'What already works', aeoBlocks: 'What blocks the wins', recommendation: 'Recommendation:', geoTitle: 'Generative engines: GEO', colSignal: 'Signal', colDetail: 'Detail',
-    secOffpage: 'Off-page, conversion, limitations', offpageEyebrow: '07 · Off-page', offpageTitle: 'Off-page and trust', conversionEyebrow: '08 · Conversion', conversionTitle: 'Conversion and UX', colElement: 'Element', limitationsEyebrow: '09 · Limitations', sourcesTitle: 'Where the data comes from', colSource: 'Source', colAccess: 'Access', colWhatRead: 'What was read',
-    sourcesFoot: 'Every score in this report is computed from sources marked free. Nothing that costs money is counted in a score, so you can re-run this audit yourself and get the same numbers.',
+    secOffpage: 'Off-page, conversion, limitations', offpageEyebrow: '07 · Off-page', offpageTitle: 'Off-page and trust', conversionEyebrow: '08 · Conversion', conversionTitle: 'Conversion and UX', colElement: 'Element', limitationsEyebrow: '10 · Limitations', sourcesTitle: 'Where the data comes from', colSource: 'Source', colAccess: 'Access', colWhatRead: 'What was read',
+    sourcesFoot: 'Every score in this report is computed from sources marked free. Nothing that costs money is counted in a score, so you can re-run this audit yourself and get the same or very close numbers.',
     limitations: 'Limitations',
-    secRoadmap: 'Roadmap', roadmapEyebrow: '10 · Roadmap', demandEyebrow: '11 · Demand', demandTitle: 'Demand map', secDemand: 'Demand', roadmapTitle: 'What to do, in order', keyMessage: 'Key message:',
+    secRoadmap: 'Roadmap', roadmapEyebrow: '09 · Roadmap', demandEyebrow: '11 · Demand', demandTitle: 'Demand map', secDemand: 'Demand', roadmapTitle: 'What to do, in order', keyMessage: 'Key message:',
     runningHead: 'SEO, AEO and GEO audit',
     statusOk: '✓ OK', statusWarn: '△ Partial', statusBad: '✗ Problem', statusNa: '· Note',
     areas: null,
@@ -83,7 +83,7 @@ const LABELS = {
     overallNote: (o) => {
       const p = o.basis ? o.basis.pages : 0;
       const pl = ruPages(p);
-      const read = o.basis ? `Прочитано ${p} ${pl} сайта${o.basis.sitemapUnchecked ? ', а карта сайта не ответила вовремя, и это не зачтено ни в плюс, ни в минус' : o.basis.sitemapRead ? ' и его карта' : ''}. ` : '';
+      const read = o.basis ? `Прочитано ${p} ${pl} сайта${o.basis.sitemapUnchecked ? ', а карта сайта не ответила вовремя, и это не зачтено ни в плюс, ни в минус' : o.basis.sitemapRead ? ' и его карта' : ''}: это для балла; остальные разделы отчёта считаются по всей выборке. ` : '';
       const where = o.source === 'visibility:reused'
         ? `Это ровно то число, которое вы уже видели в бесплатной проверке${o.measuredAt ? ` ${String(o.measuredAt).slice(0, 10)}` : ''}. Здесь оно не меряется заново, поэтому страница, письмо и этот отчёт всегда несут одно число. `
         : 'Измерено здесь тем же кодом и с теми же настройками, что у бесплатной проверки на oper-stack.ru/ai-visibility. ';
@@ -108,10 +108,10 @@ const LABELS = {
     secTechnical: 'Техническое SEO', technicalEyebrow: '04 · Техника', technicalTitle: 'Техническая проверка и страницы', colCheck: 'Проверка', colStatus: 'Статус', colFinding: 'Что нашли',
     secContent: 'Контент и страницы', contentEyebrow: '05 · Контент', contentTitle: 'Контент и внутренняя оптимизация', strengths: 'Сильные стороны', weaknesses: 'Слабые места', gaps: 'Структурные дыры: страниц, которых пока нет',
     secAeo: 'AEO и GEO', aeoEyebrow: '06 · AEO / GEO', aeoTitle: 'Ответные системы: AEO', aeoLead: 'Может ли ответ с вашего сайта попасть в блок «Люди также спрашивают», в ответы ИИ, в ChatGPT и Perplexity.', aeoWorks: 'Что уже работает', aeoBlocks: 'Что мешает', recommendation: 'Рекомендация:', geoTitle: 'Генеративные системы: GEO', colSignal: 'Сигнал', colDetail: 'Подробности',
-    secOffpage: 'Ссылки, конверсия, ограничения', offpageEyebrow: '07 · Ссылки', offpageTitle: 'Ссылки и доверие', conversionEyebrow: '08 · Конверсия', conversionTitle: 'Конверсия и удобство', colElement: 'Элемент', limitationsEyebrow: '09 · Ограничения', sourcesTitle: 'Откуда взяты данные', colSource: 'Источник', colAccess: 'Доступ', colWhatRead: 'Что прочитали',
-    sourcesFoot: 'Каждая оценка в этом отчёте посчитана из источников с пометкой «бесплатно». Ничего платного ни в одну оценку не входит, поэтому вы можете повторить этот аудит сами и получить те же цифры.',
+    secOffpage: 'Ссылки, конверсия, ограничения', offpageEyebrow: '07 · Ссылки', offpageTitle: 'Ссылки и доверие', conversionEyebrow: '08 · Конверсия', conversionTitle: 'Конверсия и удобство', colElement: 'Элемент', limitationsEyebrow: '10 · Ограничения', sourcesTitle: 'Откуда взяты данные', colSource: 'Источник', colAccess: 'Доступ', colWhatRead: 'Что прочитали',
+    sourcesFoot: 'Каждая оценка в этом отчёте посчитана из источников с пометкой «бесплатно». Ничего платного ни в одну оценку не входит, поэтому вы можете повторить этот аудит сами и получить те же или очень близкие цифры.',
     limitations: 'Ограничения',
-    secRoadmap: 'План работ', roadmapEyebrow: '10 · План', demandEyebrow: '11 · Спрос', demandTitle: 'Карта спроса', secDemand: 'Спрос', roadmapTitle: 'Что делать и в каком порядке', keyMessage: 'Главное сообщение:',
+    secRoadmap: 'План работ', roadmapEyebrow: '09 · План', demandEyebrow: '11 · Спрос', demandTitle: 'Карта спроса', secDemand: 'Спрос', roadmapTitle: 'Что делать и в каком порядке', keyMessage: 'Главное сообщение:',
     runningHead: 'Аудит SEO, AEO и GEO',
     statusOk: '✓ Норма', statusWarn: '△ Частично', statusBad: '✗ Проблема', statusNa: '· Заметка',
     areas: AREAS_RU,
@@ -665,7 +665,8 @@ export function toHtml(audit, brand = null) {
      * 54 пикселя, от верха листа до таблицы уходит 189, снизу отступ и подвал ещё 106.
      * Остаётся около 790 пикселей, это четырнадцать строк вместе с шапкой таблицы.
      */
-    const APPENDIX_ROWS = 14;
+    // Строки делятся поровну: 30 строк это три листа по 10, а не 14, 14 и лист с двумя строками (14.10.2026).
+    const APPENDIX_ROWS = Math.ceil(allSampleRows.length / Math.max(1, Math.ceil(allSampleRows.length / 14)));
     for (let i = 0; i < allSampleRows.length; i += APPENDIX_ROWS) {
       const chunk = allSampleRows.slice(i, i + APPENDIX_ROWS);
       const part = Math.floor(i / APPENDIX_ROWS) + 1;
@@ -678,7 +679,66 @@ export function toHtml(audit, brand = null) {
   if (a.demand && Array.isArray(a.demand.queries)) {
     pages.push(`<div class="page">${header(a, L.secDemand, L)}<div class="eyebrow">${L.demandEyebrow}</div><h2>${L.demandTitle}</h2>${renderDemandHtml(a.demand, { lang: a.meta?.lang === 'ru' ? 'ru' : 'en' })}${footer(a, n++, preparedBy)}</div>`);
   }
-  return `<!doctype html><html lang="${a.meta?.lang === 'ru' ? 'ru' : 'en'}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${esc(a.client.name)}: ${esc(L.docTitle)}</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&family=IBM+Plex+Mono&display=swap"><style>${css()}${accentCss}</style></head><body>${pages.join('\n')}</body></html>`;
+  return `<!doctype html><html lang="${a.meta?.lang === 'ru' ? 'ru' : 'en'}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${esc(a.client.name)}: ${esc(L.docTitle)}</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&family=IBM+Plex+Mono&display=swap"><style>${css()}${accentCss}</style></head><body>${pages.join('\n')}${FIT_SCRIPT}</body></html>`;
+}
+
+
+/*
+ * Подгонка листов перед печатью (14.10.2026). Chrome печатает каждый .page на A4, и всё, что не
+ * влезло, уходит на следующий лист: клиент получал отчёт с листом, где один подвал. Скрипт в самой
+ * странице до печати (1) переносит хвост длинной таблицы на новый лист, (2) малый перелив ужимает
+ * масштабом, не мельче 0.9, (3) перенумеровывает подвалы. Работает и у печати на сервере, потому что
+ * живёт в HTML, а не в печатающем коде. Проверка числа листов после печати: pdfPageCount.
+ */
+export const FIT_SCRIPT = `<script>(document.fonts?document.fonts.ready:Promise.resolve()).then(function(){var H=297*96/25.4;function rowsOf(t){return Array.prototype.filter.call(t.querySelectorAll('tr'),function(r){return !r.querySelector('th')})}
+for(var g=0;g<30;g++){var did=false,pages=document.querySelectorAll('.page');for(var i=0;i<pages.length;i++){var el=pages[i];if(el.scrollHeight<=H+1)continue;var tbs=el.querySelectorAll('table');if(!tbs.length)continue;var tb=tbs[tbs.length-1],rows=rowsOf(tb);if(el.scrollHeight/H<1.06||rows.length<4)continue;
+var clone=el.cloneNode(true),ctbs=clone.querySelectorAll('table'),ctb=ctbs[ctbs.length-1],crows=rowsOf(ctb),k=rows.length;while(el.scrollHeight>H+1&&k>1){rows[--k].style.display='none'}if(k===rows.length)continue;
+for(var j=k;j<rows.length;j++)rows[j].parentNode.removeChild(rows[j]);for(var j2=0;j2<k;j2++)crows[j2].parentNode.removeChild(crows[j2]);
+var keep=[];for(var n=ctb;n&&n!==clone;n=n.parentNode)keep.push(n);Array.prototype.slice.call(clone.children).forEach(function(c){if(keep.indexOf(c)>=0)return;if(/page-footer|masthead|eyebrow/.test(c.className||''))return;if(/^H[1-3]$/.test(c.tagName))return;if(c.compareDocumentPosition(ctb)&4)c.parentNode.removeChild(c)});
+var top=tb;while(top.parentNode&&top.parentNode!==el)top=top.parentNode;var nx=top.nextElementSibling;while(nx){var after=nx.nextElementSibling;if(!/page-footer/.test(nx.className||''))nx.parentNode.removeChild(nx);nx=after}el.parentNode.insertBefore(clone,el.nextSibling);did=true;break}if(!did)break}
+Array.prototype.forEach.call(document.querySelectorAll('.page'),function(el){var h=el.scrollHeight;if(h>H+1){var z=Math.max(0.9,Math.floor((H-2)/h*1000)/1000);el.style.zoom=z;el.style.height=(H/z)+'px';el.style.minHeight=(H/z)+'px';el.style.overflow='hidden';if(z===0.9&&h*z>H+1)document.documentElement.setAttribute('data-overflow','1')}});
+var no=0;Array.prototype.forEach.call(document.querySelectorAll('.page-footer span:last-child'),function(s){if(/^\\d+$/.test(s.textContent.trim()))s.textContent=String(++no)});
+document.documentElement.setAttribute('data-pages',String(document.querySelectorAll('.page').length))});</script>`;
+
+/** Сколько листов в PDF: по объектам /Type /Page, без сторонних библиотек. */
+export function pdfPageCount(buf) {
+  const s = Buffer.isBuffer(buf) ? buf.toString('latin1') : String(buf);
+  return (s.match(/\/Type\s*\/Page(?![s\w])/g) || []).length;
+}
+/** Сколько блоков .page в HTML до подгонки: подгонка может только добавить листы с хвостом таблицы. */
+export function htmlPageCount(html) {
+  return (String(html).match(/<div class="page[ "]/g) || []).length;
+}
+
+
+/*
+ * Печать в два шага (14.10.2026). Сначала Chrome открывает отчёт и отдаёт DOM после подгонки листов
+ * (FIT_SCRIPT), потом печатается уже подогнанный DOM. Так мы знаем, сколько листов должно выйти, и
+ * сверяем с тем, сколько вышло. Не сошлось или что-то не влезло даже после ужатия: PDF не отдаём,
+ * отчёт с пустым листом клиенту не уходит.
+ */
+export function printFitted(chrome, htmlFileIn, pdfPathIn) {
+  // Относительный путь давал Chrome адрес file://report.html и ошибку RR_INVALID_URL.
+  const htmlFile = resolvePath(htmlFileIn); const pdfPath = resolvePath(pdfPathIn);
+  const run = (args) => {
+    const profile = mkdtempSync(join(tmpdir(), 'operstack-audit-'));
+    const r = spawnSync(chrome, ['--headless=new', '--disable-gpu', '--no-first-run', '--no-default-browser-check', `--user-data-dir=${profile}`, '--virtual-time-budget=8000', ...args], { encoding: 'utf8', timeout: 90000, maxBuffer: 64 * 1024 * 1024 });
+    try { rmSync(profile, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 }); } catch { /* временная папка */ }
+    return r;
+  };
+  const dom = run(['--dump-dom', `file://${htmlFile}`]);
+  const fitted = String(dom.stdout || '');
+  const want = Number((fitted.match(/data-pages="(\d+)"/) || [])[1]);
+  if (!want) return { ok: false, error: `layout gate: Chrome did not lay the report out${dom.stderr ? `: ${dom.stderr.slice(-300)}` : ''}` };
+  if (/data-overflow="1"/.test(fitted)) return { ok: false, error: 'layout gate: a page does not fit A4 even at 90% scale; shorten it before sending' };
+  const fittedFile = htmlFile.replace(/\.html?$/, '') + '.fitted.html';
+  writeFileSync(fittedFile, `<!doctype html>${fitted.replace(/<script>\(document\.fonts[\s\S]*?<\/script>/, '')}`);
+  const r = run(['--no-pdf-header-footer', `--print-to-pdf=${pdfPath}`, `file://${fittedFile}`]);
+  rmSync(fittedFile, { force: true });
+  if (!existsSync(pdfPath)) return { ok: false, error: `Chrome did not write the PDF${r.stderr ? `: ${r.stderr.slice(-300)}` : ''}` };
+  const got = pdfPageCount(readFileSync(pdfPath));
+  if (got !== want) { rmSync(pdfPath, { force: true }); return { ok: false, error: `layout gate: ${got} sheets printed for ${want} report pages, so some sheet is a spill-over; the PDF was not kept` }; }
+  return { ok: true, pages: got };
 }
 
 function findChrome() {
@@ -695,10 +755,8 @@ export async function render(audit, { out, pdf = false, brand = null } = {}) {
     if (!chrome) { console.error('no Chrome found; set CHROME_PATH or open the HTML and print to PDF'); }
     else {
       pdfPath = out.replace(/\.html?$/, '') + '.pdf';
-      const profile = mkdtempSync(join(tmpdir(), 'operstack-audit-'));
-      const r = spawnSync(chrome, ['--headless=new', '--disable-gpu', '--no-first-run', '--no-default-browser-check', `--user-data-dir=${profile}`, '--virtual-time-budget=8000', '--no-pdf-header-footer', `--print-to-pdf=${pdfPath}`, `file://${out}`], { encoding: 'utf8', timeout: 90000 });
-      rmSync(profile, { recursive: true, force: true });
-      if (!existsSync(pdfPath)) { console.error(`Chrome did not write the PDF${r.stderr ? `: ${r.stderr.slice(-300)}` : ''}`); pdfPath = null; }
+      const r = printFitted(chrome, out, pdfPath);
+      if (!r.ok) { console.error(r.error); pdfPath = null; }
     }
   }
   return { html, pdf: pdfPath };

package/src/rendered.mjs

@@ -166,7 +166,10 @@ export function jsBlindnessCheck(pages, lang = 'en') {
       id: 'js-content', group: 'technical',
       label: lang === 'ru' ? 'Виден ли текст без выполнения скриптов' : 'Text visible without running JavaScript',
       status: 'na',
-      value: lang === 'ru' ? 'не измеряли: на этой машине нет браузера Chrome или Chromium' : 'not measured: no Chrome or Chromium on this machine',
+      // Браузер есть, но страница не догрузилась (14.10.2026: на medeq-mc.ru висел скрипт Яндекс.Карт): клиенту про «машину» не пишем.
+      value: findChrome()
+        ? (lang === 'ru' ? 'не измеряли: страница не догрузилась в браузере за отведённое время (часто это зависший внешний скрипт, например карты)' : 'not measured: the page did not finish loading in a browser in time (often a stuck third-party script such as a map)')
+        : (lang === 'ru' ? 'не измеряли в этой проверке' : 'not measured in this check'),
       comment: lang === 'ru' ? 'проверка сравнивает страницу, прочитанную без скриптов, с ней же в настоящем браузере' : 'the check compares the page read without scripts against the same page in a real browser',
     };
   }

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);