@operstack/audit 0.4.0 → 0.6.0

package/README.md

@@ -46,6 +46,29 @@ An agent can fill these fields from the JSON: the Claude Code plugin `operstack-
 
 Ten A4 pages: cover, executive summary with a scorecard, site overview with the sampled pages, critical issues, technical and on-page checklist, content and structure, AEO and GEO, off-page and conversion and limitations, roadmap in three phases, closing message. HTML always; PDF with `--pdf` when Chrome or Chromium is installed (`CHROME_PATH` overrides the lookup).
 
+## The Fix package: turning findings into agreed work
+
+An audit says what is wrong. `fix-plan` says what we will do about it, before anyone pays.
+
+```
+npx @operstack/audit fix-plan audit.json --lang en --platform files --price 249
+npx @operstack/audit fix-report audit-fix-plan.json after.json
+```
+
+Every open check is sorted into one of three buckets by whose knowledge it needs, not by how hard it is:
+
+| Bucket | Meaning |
+|---|---|
+| We close it | Standard work: markup, redirects, robots, sitemap, titles, contact paths. |
+| We need your facts | Text work: an answer-first paragraph, the source behind a figure, thin pages. Foundation does this, priced separately. |
+| Not promised | Out of our hands (TLS, hosting response time) or behind paid data (link profile). Never charged for. |
+
+`fix-plan` writes three files: the plan as JSON, a letter the client agrees to before paying, and a checklist for whoever does the work. The price is divided by the number of checks in the list, so one unclosed check has a known refund. `--platform cms` moves the checks that need source access out of the list instead of promising them on a hosted site builder. When fewer than five checks are left to close, the letter says plainly that the package is poor value here and points at the alternative.
+
+`fix-report` re-runs the comparison after the work: what closed, what did not, and the exact sum to refund. A check that vanished from the later run counts as not closed.
+
+Both read the language from the audit: a Russian letter translates the check names itself, and an English letter over a Russian audit is refused rather than sent half-translated.
+
 ## Example
 
 `examples/sample-audit.json` is a complete, fictional audit of "Example Villas". `npm run sample` renders it to HTML and PDF next to the JSON.

package/bin/audit.mjs

@@ -2,11 +2,16 @@
 /**
  * OperStack audit generator.
  *
- *   operstack-audit collect https://example.com [--pages 20] [--out audit.json] [--backlinks links.json]
+ *   operstack-audit collect https://example.com [--pages 20] [--out audit.json] [--backlinks links.json] [--lang ru]
  *       fetches the public signals (robots, sitemaps, llms.txt, sampled pages) and writes
  *       audit.json with every technical row filled and the narrative fields left for the analyst
  *   operstack-audit render audit.json [--out report.html] [--pdf]
  *       renders the report from the JSON; --pdf also prints a PDF with headless Chrome
+ *   operstack-audit fix-plan audit.json [--platform files|cms] [--lang ru|en] [--price 249]
+ *       the list of checks the Fix package closes on this site, a letter for the client and a checklist
+ *       in the buyer's language; the price defaults to 249 USD in English and 21000 RUB in Russian
+ *   operstack-audit fix-report audit-fix-plan.json after.json
+ *       what was closed, what was not, and how much to refund
  *   operstack-audit check audit.json
  *       lists narrative fields still holding placeholders and any score the checks do not support
  *
@@ -14,6 +19,7 @@
  * and an area with no checks is printed as "not measured" rather than scored low.
  */
 import { collect, verifyScores } from '../src/collect.mjs';
+import { buildFixPlan, renderFixPlan, renderFixChecklist, buildFixReport, renderFixReport } from '../src/fix.mjs';
 import { render, checkNarrative } from '../src/render.mjs';
 import { writeFileSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
@@ -23,14 +29,14 @@ const opt = (k, d) => { const i = rest.indexOf(k); return i === -1 ? d : rest[i
 const has = (k) => rest.includes(k);
 
 if (!cmd || cmd === '--help' || cmd === '-h') {
-  console.log('Usage:\n  operstack-audit collect <url> [--pages 20] [--out audit.json] [--backlinks links.json]\n  operstack-audit render <audit.json> [--out report.html] [--pdf]\n  operstack-audit check <audit.json>');
+  console.log('Usage:\n  operstack-audit collect <url> [--pages 20] [--out audit.json] [--backlinks links.json] [--lang ru]\n  operstack-audit render <audit.json> [--out report.html] [--pdf]\n  operstack-audit check <audit.json>');
   process.exit(cmd ? 0 : 2);
 }
 if (cmd === 'collect') {
   if (!/^https?:\/\//.test(target || '')) { console.error('collect needs an absolute URL'); process.exit(2); }
   const backlinksFile = opt('--backlinks', '');
   const backlinks = backlinksFile ? JSON.parse(readFileSync(resolve(backlinksFile), 'utf8')) : null;
-  const audit = await collect(target, { pages: Number(opt('--pages', 20)), backlinks, log: (m) => console.error(`  ${m}`) });
+  const audit = await collect(target, { pages: Number(opt('--pages', 20)), backlinks, lang: opt('--lang', 'en'), log: (m) => console.error(`  ${m}`) });
   const out = resolve(opt('--out', 'audit.json'));
   writeFileSync(out, JSON.stringify(audit, null, 2));
   console.log(`wrote ${out}: ${audit.checks.length} checks, ${audit.sample.length} pages sampled, scores ${Object.entries(audit.scores).map(([k, v]) => `${k} ${v === null ? 'not measured' : v}`).join(', ')}`);
@@ -52,4 +58,31 @@ if (cmd === 'collect') {
   if (drift.length) { console.log(`${drift.length} score(s) that no check supports:`); for (const d of drift) console.log(`  ${d}`); }
   if (!missing.length && !drift.length) console.log('every narrative field is written and every score matches its checks');
   else process.exit(1);
+} else if (cmd === 'fix-plan') {
+  const audit = JSON.parse(readFileSync(resolve(target), 'utf8'));
+  // Язык покупки решает и валюту, и письмо: за доллары платят по английскому списку, за рубли по русскому.
+  const lang = opt('--lang', 'ru') === 'en' ? 'en' : 'ru';
+  const plan = buildFixPlan(audit, {
+    platform: opt('--platform', 'files'),
+    lang,
+    price: Number(opt('--price', lang === 'en' ? 249 : 21000)),
+    currency: opt('--currency', lang === 'en' ? 'USD' : 'RUB'),
+  });
+  if (plan.langMismatch) { console.error(`this audit was collected in Russian: an English letter would carry Russian check names. Re-run: operstack-audit collect <site> --lang en`); process.exit(1); }
+  if (plan.unknown.length) console.error(`note: ${plan.unknown.length} check(s) have no fix action yet: ${plan.unknown.join(', ')}`);
+  const base = opt('--out', target.replace(/\.json$/, ''));
+  writeFileSync(resolve(`${base}-fix-plan.json`), JSON.stringify(plan, null, 2));
+  writeFileSync(resolve(`${base}-fix-letter.md`), renderFixPlan(plan));
+  writeFileSync(resolve(`${base}-fix-checklist.md`), renderFixChecklist(plan));
+  console.log(`${plan.included.length} check(s) we close, ${plan.needsClient.length} need the client's facts, ${plan.notPossible.length} not promised`);
+  console.log(`share per check ${plan.share} ${plan.currency}`);
+  console.log(`wrote ${base}-fix-plan.json, ${base}-fix-letter.md, ${base}-fix-checklist.md`);
+} else if (cmd === 'fix-report') {
+  const plan = JSON.parse(readFileSync(resolve(target), 'utf8'));
+  const after = JSON.parse(readFileSync(resolve(rest[0]), 'utf8'));
+  const report = buildFixReport(plan, after);
+  const out = resolve(opt('--out', target.replace(/-fix-plan\.json$/, '') + '-fix-report.md'));
+  writeFileSync(out, renderFixReport(report));
+  console.log(`closed ${report.closed.length} of ${report.total}, still open ${report.stillOpen.length}, refund ${report.refund} ${report.currency}`);
+  console.log(`wrote ${out}`);
 } else { console.error(`unknown command ${cmd}`); process.exit(2); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "SEO, AEO and GEO audit generator: collect public signals from a site into audit.json, let an analyst or an agent fill the narrative, render the OperStack report as HTML and PDF.",
   "type": "module",
   "license": "MIT",
@@ -9,7 +9,9 @@
     "operstack-audit": "bin/audit.mjs"
   },
   "exports": {
-    ".": "./src/index.mjs"
+    ".": "./src/index.mjs",
+    "./i18n": "./src/i18n.mjs",
+    "./fix": "./src/fix.mjs"
   },
   "files": [
     "bin",
@@ -20,7 +22,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node src/test-scores.mjs && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html",
+    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html",
     "sample": "node bin/audit.mjs render examples/sample-audit.json --pdf"
   },
   "keywords": [

package/src/collect.mjs

@@ -4,6 +4,7 @@
  * No Search Console, no analytics. The narrative fields are left for the analyst.
  */
 import { parse } from 'node-html-parser';
+import { localiseChecks } from './i18n.mjs';
 
 const UA = 'Mozilla/5.0 (compatible; OperStackAudit/0.1; +https://oper-stack.com)';
 
@@ -145,7 +146,7 @@ async function readSitemap(url, seen = new Set(), depth = 0) {
   return out;
 }
 
-export async function collect(startUrl, { pages = 20, log = () => {}, backlinks = null } = {}) {
+export async function collect(startUrl, { pages = 20, log = () => {}, backlinks = null, lang = 'en' } = {}) {
   const opts = { backlinks };
   const origin = new URL(startUrl).origin;
   const host = new URL(startUrl).host;
@@ -317,17 +318,19 @@ export async function collect(startUrl, { pages = 20, log = () => {}, backlinks
   checks.push(row('conv-messenger', 'conversion', 'A messenger link', msg.length ? 'ok' : 'warn', msg.length ? `on ${msg.length} of ${pagesForTrust.length} sampled page(s)` : 'none on the sampled pages', msg.length ? '' : 'for an international audience reading on a phone, one messenger link is usually worth more than a form'));
 
   const { scores, scoreBasis } = computeScores(checks);
+  // Оценки считаются до перевода: язык на цифры не влияет.
+  const localised = localiseChecks(checks, lang);
   const critical = checks.filter((c) => c.status === 'bad').map((c) => ({ title: c.label, text: `${c.value}${c.comment ? `. ${c.comment}` : ''}`, level: 'bad' }));
 
   return {
-    meta: { site: home.final, host, collectedAt: new Date().toISOString(), tool: '@operstack/audit 0.1.0', auditType: 'External audit (no Search Console or analytics access)', language: hp ? (hp.og?.locale || '') : '' },
+    meta: { site: home.final, host, collectedAt: new Date().toISOString(), tool: '@operstack/audit 0.1.0', auditType: lang === 'ru' ? 'Аудит по публичным сигналам' : 'External audit (no Search Console or analytics access)', lang, language: hp ? (hp.og?.locale || '') : '' },
     client: { name: '{{CLIENT NAME}}', subject: '{{What the site sells and where}}', reportDate: new Date().toISOString().slice(0, 10), preparedBy: 'OperStack' },
     scores,
     scoreBasis,
     summary: { lead: '{{Three sentences: what the site is, what works, what holds it back.}}', verdict: '{{Key takeaway in three sentences, ending with how fast the critical issues can be fixed.}}', priorities: ['{{Priority one}}', '{{Priority two}}', '{{Priority three}}'] },
     overview: { rows: [['CMS / stack', hp?.generator || '{{stack}}'], ['Pages in sitemap', String(sitemapPages.length)], ['Language', '{{language}}'], ['What is sold', '{{products}}']], note: '{{One paragraph on how the offer is structured on the site and whether it is clear.}}' },
-    critical,
-    checks,
+    critical: lang === 'ru' ? localised.filter((c) => c.status === 'bad').map((c) => ({ title: c.label, text: `${c.value}${c.comment ? `. ${c.comment}` : ''}`, level: 'bad' })) : critical,
+    checks: localised,
     content: { strengths: ['{{strength}}'], weaknesses: ['{{weakness}}'], gaps: ['{{missing landing page or cluster}}'] },
     aeo: { works: ['{{what already works}}'], blocks: ['{{what blocks answer-engine wins}}'], recommendation: '{{One recommendation with a page name.}}' },
     geo: { rows: [['Entity clarity', '{{status}}', '{{detail}}'], ['Third-party mentions', '{{status}}', '{{detail}}'], ['Reviews and PR', '{{status}}', '{{detail}}']], callout: '{{Brand disambiguation note or the single biggest GEO risk.}}' },

package/src/fix.mjs

@@ -0,0 +1,280 @@
+/**
+ * Пакет Fix: составление списка работ по чужому сайту и отчёт о закрытии.
+ *
+ * Страница пакета обещает две вещи: список проверок согласуется письменно до оплаты, и всё, что мы
+ * из него не закрыли, возвращается долей. Обещание держится только если список машинный, а не
+ * написанный на глаз. Здесь он и рождается: берётся собранный аудит, каждая находка раскладывается
+ * на «закроем сами», «нужны факты клиента» и «платформа не позволяет», и на выходе получается
+ * письмо клиенту и чек-лист исполнителю.
+ *
+ * Классификация не про сложность, а про то, чьи знания нужны:
+ *   always  закрываем на любой платформе, ничего не спрашивая
+ *   files   нужен доступ к исходникам сайта, на готовой CMS не выйдет
+ *   client  нужны факты и тексты клиента, это уже Foundation
+ *   never   не обещаем вообще: либо не в нашей власти, либо данные платные
+ *
+ * Язык письма задаётся покупкой, а не догадкой: кто купил за рубли, читает по-русски, кто за
+ * доллары, по-английски. Смешивать нельзя, человек должен понимать, за что платит. Названия и
+ * значения проверок приходят из аудита, поэтому язык аудита здесь тоже сверяется: русское письмо
+ * с английскими названиями проверок это брак, который клиент видит первым.
+ */
+import { localiseChecks } from './i18n.mjs';
+
+/** Что мы делаем по каждой проверке. Без этого «закроем» это слово, а не работа. */
+export const FIX_ACTIONS = {
+  https: { scope: 'never', why: { ru: 'сертификат выпускает хостинг, это не наша работа', en: 'the certificate is issued by the host, not by us' } },
+  www: { scope: 'always', action: { ru: 'Поставить постоянную переадресацию с www на основной адрес и проверить кодом ответа', en: 'Add a permanent redirect from www to the main address and confirm it by response code' } },
+  ttfb: { scope: 'never', why: { ru: 'время ответа определяется хостингом клиента, обещать его нельзя', en: 'response time is set by your hosting, so we cannot promise it' } },
+  robots: { scope: 'always', action: { ru: 'Переписать robots.txt: убрать лишние запреты, добавить строку с картой сайта', en: 'Rewrite robots.txt: drop the needless blocks, add the sitemap line' } },
+  'robots-block': { scope: 'always', action: { ru: 'Снять Disallow: / из блока для всех роботов', en: 'Remove Disallow: / from the all-robots block' } },
+  'ai-search-access': { scope: 'always', action: { ru: 'Открыть поисковые роботы ИИ в robots.txt, это они достают страницу для цитаты', en: 'Allow the AI search fetchers in robots.txt: they are what pull a page in to quote it' } },
+  'robots-ai': { scope: 'always', action: { ru: 'Зафиксировать политику по обучающим краулерам письменно и привести robots.txt в соответствие', en: 'Write down your policy on training crawlers and make robots.txt match it' } },
+  sitemap: { scope: 'always', action: { ru: 'Починить или сгенерировать карту сайта и сослаться на неё из robots.txt', en: 'Fix or generate the sitemap and point robots.txt at it' } },
+  'sitemap-foreign': { scope: 'always', action: { ru: 'Убрать из карты сайта адреса на чужих хостах', en: 'Remove URLs on other hosts from the sitemap' } },
+  'sitemap-health': { scope: 'always', action: { ru: 'Вычистить из карты сайта адреса, которые отвечают редиректом или ошибкой', en: 'Clear out sitemap URLs that answer with a redirect or an error' } },
+  llms: { scope: 'always', action: { ru: 'Сгенерировать llms.txt из корпуса так, чтобы ссылки вели на страницы самого сайта', en: 'Generate llms.txt from the corpus so every link points at a page of this site' } },
+  title: { scope: 'always', action: { ru: 'Переписать заголовок главной в пределах 60 знаков', en: 'Rewrite the home page title within 60 characters' } },
+  description: { scope: 'always', action: { ru: 'Переписать описание главной, убрать служебный код, уложиться в выдачу', en: 'Rewrite the home page description, strip leftover markup, fit the snippet' } },
+  h1: { scope: 'always', action: { ru: 'Оставить на главной ровно один заголовок H1', en: 'Leave exactly one H1 on the home page' } },
+  canonical: { scope: 'always', action: { ru: 'Проставить канонический адрес', en: 'Set the canonical address' } },
+  viewport: { scope: 'always', action: { ru: 'Задать мобильный viewport и снять запрет масштабирования', en: 'Set the mobile viewport and lift the zoom lock' } },
+  og: { scope: 'always', action: { ru: 'Добавить карточки для соцсетей: заголовок, описание, картинка', en: 'Add social cards: title, description, image' } },
+  schema: { scope: 'always', action: { ru: 'Добавить разметку организации и сайта на главную', en: 'Add Organization and WebSite markup to the home page' } },
+  'faq-schema': { scope: 'always', action: { ru: 'Разметить блоки вопросов и ответов схемой FAQPage', en: 'Mark up question and answer blocks with FAQPage' } },
+  'org-schema': { scope: 'always', action: { ru: 'Добавить разметку организации с адресом и профилями', en: 'Add Organization markup with the address and the profiles' } },
+  resources: { scope: 'files', action: { ru: 'Сократить число подключаемых файлов и включить годовой кеш для статики', en: 'Cut the number of linked files and set a year-long cache for static assets' } },
+  hreflang: { scope: 'always', action: { ru: 'Проставить hreflang, если у сайта несколько языков', en: 'Set hreflang where the site has more than one language' } },
+  xmlrpc: { scope: 'always', action: { ru: 'Закрыть открытую точку xmlrpc.php', en: 'Close the open xmlrpc.php endpoint' } },
+  alt: { scope: 'always', action: { ru: 'Проставить подписи ко всем картинкам по их содержимому', en: 'Write alt text for every image from what it actually shows' } },
+  'h1-sample': { scope: 'always', action: { ru: 'Свести заголовки к одному H1 на страницу', en: 'Reduce headings to one H1 per page' } },
+  'dup-titles': { scope: 'always', action: { ru: 'Развести повторяющиеся заголовки страниц', en: 'Separate duplicated page titles' } },
+  utility: { scope: 'always', action: { ru: 'Исключить служебные адреса из карты сайта, оставив их доступными людям', en: 'Drop utility URLs from the sitemap while keeping them reachable for people' } },
+  dates: { scope: 'always', action: { ru: 'Вывести дату публикации и обновления в разметку страниц', en: 'Expose published and updated dates in the page markup' } },
+  'trust-entity': { scope: 'always', action: { ru: 'Добавить город и страну в разметку организации', en: 'Add the city and country to the Organization markup' } },
+  'trust-contact': { scope: 'always', action: { ru: 'Опубликовать прямые контакты и вывести их в разметку', en: 'Publish direct contacts and expose them in the markup' } },
+  'trust-profiles': { scope: 'always', action: { ru: 'Заявить в разметке профили, которые у клиента действительно есть', en: 'Declare in the markup the profiles you actually have' } },
+  'trust-about': { scope: 'always', action: { ru: 'Сделать страницу о компании доступной со всех страниц', en: 'Make the about page reachable from every page' } },
+  'trust-policies': { scope: 'always', action: { ru: 'Добавить политику конфиденциальности и условия и сослаться на них из подвала', en: 'Add a privacy policy and terms and link them from the footer' } },
+  'conv-contact-path': { scope: 'always', action: { ru: 'Дать способ связаться с любой страницы', en: 'Give a way to get in touch from any page' } },
+  'conv-cta': { scope: 'always', action: { ru: 'Поставить призыв к действию в первый экран', en: 'Put a call to action in the first screen' } },
+  'conv-form-depth': { scope: 'files', action: { ru: 'Поднять форму выше по странице', en: 'Move the form higher up the page' } },
+  'conv-form-fields': { scope: 'files', action: { ru: 'Сократить форму до четырёх полей', en: 'Cut the form down to four fields' } },
+  'conv-messenger': { scope: 'always', action: { ru: 'Добавить ссылку на мессенджер', en: 'Add a messenger link' } },
+  'answer-first': { scope: 'client', why: { ru: 'первый абзац с цифрой пишется по фактам клиента', en: 'the opening paragraph with a number is written from your facts' } },
+  sources: { scope: 'client', why: { ru: 'источник цифры знает только клиент', en: 'only you know where each number came from' } },
+  thin: { scope: 'client', why: { ru: 'наполнение тонких страниц это тексты по фактам клиента', en: 'filling thin pages means writing from your facts' } },
+  sections: { scope: 'client', why: { ru: 'разбивка на разделы это переписывание текста', en: 'splitting into sections means rewriting the text' } },
+  tables: { scope: 'client', why: { ru: 'таблица собирается из данных клиента', en: 'a table is built from your data' } },
+  'links-profile': { scope: 'never', why: { ru: 'данные по ссылкам платные и ни в одну оценку не входят', en: 'link data is paid, and it moves no score of ours' } },
+};
+
+const OPEN = new Set(['warn', 'bad']);
+
+/** Слова письма и чек-листа. Цифры одни и те же, меняется только язык. */
+const T = {
+  ru: {
+    planTitle: (h) => `# Что мы закроем на сайте ${h}`,
+    checkedOn: (d) => `Проверено ${d}. Ниже список работ, который вы согласовываете до оплаты.`,
+    willClose: (n) => `## Закроем: ${n} ${plural(n, 'проверка', 'проверки', 'проверок')}`,
+    nowIs: 'Сейчас',
+    willDo: 'Что сделаем',
+    price: (p, c, s) => `Цена: ${p} ${c}. Доля одной проверки ${s} ${c}: если какую-то из списка мы не закроем, эта доля возвращается.`,
+    thin: (n, s, c) => `**Скажем прямо: закрывать у вас почти нечего.** ${n} ${plural(n, 'проверка выходит', 'проверки выходят', 'проверок выходят')} по ${s} ${c} за штуку, и это дорого. Сайт в хорошем состоянии. Либо сделайте эти правки сами по списку выше, он для этого и написан, либо посмотрите на пакет Foundation: судя по проверкам, вам нужна работа с текстами, а не с техникой.`,
+    nothing: '**Покупать нечего.** Ни одной проверки, которую мы закрываем без ваших фактов, на сайте не открыто. Брать с вас деньги не за что.',
+    needsClient: (n) => `## Не входит: нужны ваши факты (${n})`,
+    needsClientLead: 'Это работа с текстами, её делает пакет Foundation, и цена у него считается отдельно.',
+    notPossible: (n) => `## Не обещаем (${n})`,
+    verify: 'Каждую строку вы сможете проверить сами тем же бесплатным инструментом, которым мы её нашли.',
+    unlisted: 'проверка не описана в наборе работ, разберём вручную',
+    cmsBlocked: 'нужен доступ к исходникам сайта, на готовой системе управления не выйдет',
+    listTitle: (h) => `# Чек-лист Fix: ${h}`,
+    listHead: (p, price, c, s) => `Платформа: ${p === 'files' ? 'исходники в файлах' : 'готовая система управления'}. Оплачено ${price} ${c}, доля проверки ${s}.`,
+    was: 'было',
+    todo: 'сделать',
+    listTail: 'После работы: повторный прогон и `fix-report`, он скажет, что закрыто и сколько возвращать.',
+    reportTitle: (h) => `# Отчёт о работах: ${h}`,
+    closedOf: (n, t) => `Закрыто ${n} из ${t}.`,
+    openRefund: (n, r, c) => `Не закрыто ${n}, к возврату ${r} ${c}.`,
+    noRefund: 'Не закрытого нет, возвращать нечего.',
+    closedHead: '## Закрыто',
+    openHead: '## Не закрыто, возвращаем долю',
+    before: 'Было',
+    after: 'Стало',
+    nowLabel: 'Сейчас',
+    gone: 'проверка исчезла из прогона',
+    recheck: 'Любую строку можно перепроверить бесплатным инструментом на oper-stack.ru/ai-visibility/',
+  },
+  en: {
+    planTitle: (h) => `# What we will fix on ${h}`,
+    checkedOn: (d) => `Checked ${d}. Below is the list of work you agree to before paying.`,
+    willClose: (n) => `## We will close ${n} check${n === 1 ? '' : 's'}`,
+    nowIs: 'Now',
+    willDo: 'What we do',
+    price: (p, c, s) => `Price: ${p} ${c}. One check is worth ${s} ${c}: anything on this list we fail to close comes back to you as that share.`,
+    thin: (n, s, c) => `**Plainly: there is little here to fix.** ${n} check${n === 1 ? '' : 's'} at ${s} ${c} each is expensive, and your site is in good shape. Either make these edits yourself from the list above, which is written to be followed, or look at Foundation: judging by the checks, what you need is work on the text, not on the plumbing.`,
+    nothing: '**There is nothing to buy.** Not one check we close without your facts is open on this site. There is nothing to charge you for.',
+    needsClient: (n) => `## Not included: we need your facts (${n})`,
+    needsClientLead: 'This is work on the text. The Foundation package does it, and it is priced separately.',
+    notPossible: (n) => `## Not promised (${n})`,
+    verify: 'You can verify every line yourself with the same free tool we found it with.',
+    unlisted: 'this check is not in our list of standard work; we will look at it by hand',
+    cmsBlocked: 'this needs access to the site source; a hosted site builder will not allow it',
+    listTitle: (h) => `# Fix checklist: ${h}`,
+    listHead: (p, price, c, s) => `Platform: ${p === 'files' ? 'source files' : 'hosted site builder'}. Paid ${price} ${c}, one check is worth ${s}.`,
+    was: 'was',
+    todo: 'do',
+    listTail: 'When the work is done: run the audit again and `fix-report`, it says what closed and what to refund.',
+    reportTitle: (h) => `# Work report: ${h}`,
+    closedOf: (n, t) => `Closed ${n} of ${t}.`,
+    openRefund: (n, r, c) => `${n} not closed, ${r} ${c} to refund.`,
+    noRefund: 'Nothing left open, nothing to refund.',
+    closedHead: '## Closed',
+    openHead: '## Not closed, share refunded',
+    before: 'Was',
+    after: 'Now',
+    nowLabel: 'Now',
+    gone: 'the check disappeared from the run',
+    recheck: 'Every line can be re-checked with the free tool at oper-stack.com/ai-visibility/',
+  },
+};
+
+const dict = (lang) => T[lang === 'en' ? 'en' : 'ru'];
+const pick = (field, lang) => (field && typeof field === 'object' ? field[lang === 'en' ? 'en' : 'ru'] : field);
+
+/**
+ * Список работ по собранному аудиту.
+ * @param {object} audit результат collect()
+ * @param {{platform?: 'files'|'cms', price?: number, currency?: string, lang?: 'ru'|'en'}} opts
+ */
+export function buildFixPlan(audit, opts = {}) {
+  const platform = opts.platform === 'cms' ? 'cms' : 'files';
+  const price = Number(opts.price ?? 249);
+  const lang = opts.lang === 'en' ? 'en' : 'ru';
+  const currency = opts.currency || (lang === 'en' ? 'USD' : 'RUB');
+  const t = dict(lang);
+
+  // Аудит мог быть собран на другом языке. На русский названия проверок переводятся здесь же,
+  // обратно на английский нет: английский текст надо собирать заново командой collect --lang en.
+  const auditLang = audit.meta?.lang === 'ru' ? 'ru' : 'en';
+  const langMismatch = lang === 'en' && auditLang === 'ru';
+  const checks = lang === 'ru' && auditLang !== 'ru' ? localiseChecks(audit.checks || [], 'ru') : (audit.checks || []);
+
+  const open = checks.filter((c) => OPEN.has(c.status));
+  const unknown = open.filter((c) => !FIX_ACTIONS[c.id]).map((c) => c.id);
+
+  const included = [];
+  const needsClient = [];
+  const notPossible = [];
+  for (const c of open) {
+    const rule = FIX_ACTIONS[c.id];
+    if (!rule) { needsClient.push({ check: c, why: t.unlisted }); continue; }
+    if (rule.scope === 'always') included.push({ check: c, action: pick(rule.action, lang) });
+    else if (rule.scope === 'files') {
+      if (platform === 'files') included.push({ check: c, action: pick(rule.action, lang) });
+      else notPossible.push({ check: c, why: t.cmsBlocked });
+    } else if (rule.scope === 'client') needsClient.push({ check: c, why: pick(rule.why, lang) });
+    else notPossible.push({ check: c, why: pick(rule.why, lang) });
+  }
+
+  const share = included.length ? Math.round((price / included.length) * 100) / 100 : 0;
+  // На здоровом сайте закрывать почти нечего, и продавать ему пакет по полной цене нечестно.
+  // Порог не выдуман: ниже него доля одной проверки превышает треть чека.
+  const thin = included.length > 0 && included.length < 5;
+  return { platform, price, currency, lang, langMismatch, included, needsClient, notPossible, share, thin, unknown, checkedAt: audit.meta?.collectedAt, host: audit.meta?.host };
+}
+
+/** Письмо клиенту: то, что он согласовывает до оплаты. */
+export function renderFixPlan(plan) {
+  const t = dict(plan.lang);
+  const L = [];
+  L.push(t.planTitle(plan.host));
+  L.push('');
+  L.push(t.checkedOn(String(plan.checkedAt || '').slice(0, 10)));
+  L.push('');
+  L.push(t.willClose(plan.included.length));
+  L.push('');
+  plan.included.forEach((x, i) => {
+    L.push(`${i + 1}. **${x.check.label}.** ${t.nowIs}: ${x.check.value}`);
+    L.push(`   ${t.willDo}: ${x.action}`);
+  });
+  L.push('');
+  L.push(t.price(plan.price, plan.currency, plan.share));
+  if (plan.thin) { L.push(''); L.push(t.thin(plan.included.length, plan.share, plan.currency)); }
+  if (!plan.included.length) { L.push(''); L.push(t.nothing); }
+  if (plan.needsClient.length) {
+    L.push('');
+    L.push(t.needsClient(plan.needsClient.length));
+    L.push('');
+    L.push(t.needsClientLead);
+    L.push('');
+    for (const x of plan.needsClient) L.push(`- **${x.check.label}.** ${x.check.value}. ${x.why}`);
+  }
+  if (plan.notPossible.length) {
+    L.push('');
+    L.push(t.notPossible(plan.notPossible.length));
+    L.push('');
+    for (const x of plan.notPossible) L.push(`- **${x.check.label}.** ${x.why}`);
+  }
+  L.push('');
+  L.push(t.verify);
+  return L.join('\n');
+}
+
+/** Чек-лист исполнителю: тот же список, но по порядку работы. */
+export function renderFixChecklist(plan) {
+  const t = dict(plan.lang);
+  const L = [t.listTitle(plan.host), '', t.listHead(plan.platform, plan.price, plan.currency, plan.share), ''];
+  plan.included.forEach((x, i) => {
+    L.push(`- [ ] ${i + 1}. ${x.check.label} (\`${x.check.id}\`)`);
+    L.push(`      ${t.was}: ${x.check.value}`);
+    L.push(`      ${t.todo}: ${x.action}`);
+  });
+  L.push('');
+  L.push(t.listTail);
+  return L.join('\n');
+}
+
+/**
+ * Отчёт о закрытии: сравнение прогонов до и после по согласованному списку.
+ * Возвращает, что закрыто, что осталось, и сколько денег вернуть.
+ */
+export function buildFixReport(plan, after) {
+  const t = dict(plan.lang);
+  const now = Object.fromEntries((after.checks || []).map((c) => [c.id, c]));
+  const closed = [];
+  const stillOpen = [];
+  for (const x of plan.included) {
+    const c = now[x.check.id];
+    if (!c) { stillOpen.push({ ...x, now: t.gone }); continue; }
+    if (OPEN.has(c.status)) stillOpen.push({ ...x, now: c.value });
+    else closed.push({ ...x, now: c.value });
+  }
+  const refund = Math.round(stillOpen.length * plan.share * 100) / 100;
+  return { host: plan.host, lang: plan.lang, closed, stillOpen, refund, currency: plan.currency, total: plan.included.length };
+}
+
+export function renderFixReport(report) {
+  const t = dict(report.lang);
+  const L = [t.reportTitle(report.host), ''];
+  L.push(t.closedOf(report.closed.length, report.total));
+  if (report.stillOpen.length) L.push(t.openRefund(report.stillOpen.length, report.refund, report.currency));
+  else L.push(t.noRefund);
+  L.push('');
+  L.push(t.closedHead);
+  L.push('');
+  for (const x of report.closed) L.push(`- **${x.check.label}.** ${t.before}: ${x.check.value}. ${t.after}: ${x.now}`);
+  if (report.stillOpen.length) {
+    L.push('');
+    L.push(t.openHead);
+    L.push('');
+    for (const x of report.stillOpen) L.push(`- **${x.check.label}.** ${t.before}: ${x.check.value}. ${t.nowLabel}: ${x.now}`);
+  }
+  L.push('');
+  L.push(t.recheck);
+  return L.join('\n');
+}
+
+function plural(n, one, few, many) {
+  const d = n % 10; const dd = n % 100;
+  return d === 1 && dd !== 11 ? one : d >= 2 && d <= 4 && (dd < 10 || dd >= 20) ? few : many;
+}

package/src/i18n.mjs

@@ -0,0 +1,152 @@
+/**
+ * Перевод собранных проверок на русский.
+ *
+ * Отдельный слой поверх сборщика: логика проверок не трогается вообще, поэтому перевод не может
+ * сломать ни одну оценку. Каждая запись знает идентификатор проверки и умеет пересобрать её текст
+ * по числам, которые уже посчитаны. Если для проверки записи нет, она остаётся как есть, и тест
+ * это показывает, а не прячет.
+ *
+ *   import { localiseChecks } from '@operstack/audit/i18n'
+ *   audit.checks = localiseChecks(audit.checks, 'ru')
+ */
+
+/** Достаёт все целые и дробные числа из строки по порядку. */
+const nums = (s) => (String(s).match(/\d+(?:[.,]\d+)?/g) || []).map((x) => x.replace(',', '.'));
+/** Склонение: 1 страница, 2 страницы, 5 страниц. */
+const plural = (n, one, few, many) => {
+  const d = Math.abs(n) % 10; const dd = Math.abs(n) % 100;
+  return `${n} ${d === 1 && dd !== 11 ? one : d >= 2 && d <= 4 && (dd < 10 || dd >= 20) ? few : many}`;
+};
+const pages = (n) => plural(Number(n), 'страница', 'страницы', 'страниц');
+const pagesOf = (a, b) => `${a} из ${pages(b)}`;
+
+/** Перевод «сколько проверок пройдено» из подписи под оценкой. */
+export function localiseBasisNote(note) {
+  const m = String(note || '').match(/^(\d+) of (\d+) checks pass(?:, (\d+) needs? attention)?(?:, (\d+) fails?)?$/);
+  if (!m) {
+    if (/^not measured/.test(String(note || ''))) return String(note).replace(/^not measured:\s*/, 'не измерялось: ');
+    return note;
+  }
+  const [, ok, total, warn, bad] = m;
+  const parts = [`${ok} из ${plural(Number(total), 'проверки', 'проверок', 'проверок')} пройдено`];
+  if (warn) parts.push(plural(Number(warn), 'спорная', 'спорные', 'спорных'));
+  if (bad) parts.push(plural(Number(bad), 'провалена', 'провалены', 'провалено'));
+  return parts.join(', ');
+}
+
+/**
+ * Записи перевода. value и comment получают исходный английский текст и возвращают русский,
+ * пересобирая его из тех же чисел. Там, где текст постоянный, возвращается константа.
+ */
+const RU = {
+  https: { label: 'HTTPS', value: (v) => (/certificate active/.test(v) ? 'сертификат активен' : 'сайт отдаётся по http, без шифрования') },
+  www: {
+    label: 'Склейка адреса с www',
+    value: (v) => (/redirects to/.test(v) ? 'адрес с www перенаправляется на основной'
+      : /does not resolve/.test(v) ? 'адрес с www не существует'
+        : `адрес с www отвечает ${nums(v)[0] || ''} и не перенаправляет`),
+  },
+  ttfb: { label: 'Время до первого байта', value: (v) => `${nums(v)[0]} мс`, comment: () => 'один запрос от проверяющего, а не лабораторный тест' },
+  robots: {
+    label: 'robots.txt',
+    value: (v) => { const n = nums(v); return /HTTP/.test(v) ? `не отдаётся, код ${n[0]}` : `${plural(Number(n[0]), 'запрещающее правило', 'запрещающих правила', 'запрещающих правил')} в ${plural(Number(n[1]), 'блоке', 'блоках', 'блоках')} агентов, ${plural(Number(n[2]), 'строка', 'строки', 'строк')} с картой сайта`; },
+    comment: (c) => (/no Sitemap/.test(c) ? 'нет строки Sitemap' : ''),
+  },
+  'robots-block': { label: 'robots.txt закрывает весь сайт', value: () => 'Disallow: / под User-agent: *', comment: () => 'поисковым системам сказано не обходить ничего' },
+  'ai-search-access': {
+    label: 'Доступ поисковых роботов ИИ',
+    value: (v) => (/every AI search fetcher/.test(v) ? 'все поисковые роботы ИИ могут читать сайт' : `закрыто: ${v.replace(/^\d+ blocked: /, '')}`),
+    comment: (c) => (c ? 'именно эти роботы достают страницу, чтобы процитировать её в ответе' : ''),
+  },
+  'robots-ai': {
+    label: 'Обучающие краулеры закрыты (решение владельца)',
+    value: (v) => `${plural(Number(nums(v)[0]), 'агент закрыт', 'агента закрыты', 'агентов закрыто')} полностью: ${v.split(': ').slice(1).join(': ')}`,
+    comment: () => 'это выбор владельца, а не дефект: эти системы не будут учиться на сайте и не процитируют его из собственного обхода',
+  },
+  sitemap: {
+    label: 'Карта сайта XML',
+    value: (v) => (/URL\(s\) in/.test(v) ? `${plural(Number(nums(v)[0]), 'адрес', 'адреса', 'адресов')} в карте сайта` : /not found|missing/i.test(v) ? 'не найдена' : `не отдаётся, код ${nums(v)[0]}`),
+  },
+  'sitemap-foreign': { label: 'В карте сайта чужие хосты', value: (v) => `${plural(Number(nums(v)[0]), 'адрес', 'адреса', 'адресов')} на других хостах` },
+  'sitemap-health': { label: 'Адреса из карты сайта отвечают 200', value: (v) => { const n = nums(v); return `${n[0]} из ${n[1]} проверенных адресов отвечают 200${/redirect/.test(v) ? `, ${n[2]} перенаправляют` : ''}${/broken/.test(v) ? ', есть битые' : ''}`; } },
+  llms: {
+    label: 'llms.txt',
+    value: (v) => (/not present/.test(v) ? 'нет'
+      : /HTML page/.test(v) ? 'отдаёт HTML-страницу вместо текстового индекса'
+        : `${plural(Number(nums(v)[0]), 'ссылка', 'ссылки', 'ссылок')}, ${nums(v)[1]} на другие хосты`),
+    comment: (c) => (/nothing to read/.test(c) ? 'ответным системам нечего читать, генерация индекса это работа на день' : c ? 'система ИИ может принять сайт за чужой' : ''),
+  },
+  title: { label: 'Заголовок главной', value: (v) => { const n = nums(v); return `${plural(Number(n[n.length - 1]), 'знак', 'знака', 'знаков')}${Number(n[n.length - 1]) > 60 ? ', в выдаче обрежется' : ', укладывается в выдачу'}`; } },
+  description: { label: 'Описание главной', value: (v) => (/missing|none/i.test(v) ? 'нет' : /shortcode|garbage/i.test(v) ? 'содержит служебный код вместо текста' : `${plural(Number(nums(v)[0]), 'знак', 'знака', 'знаков')}`) },
+  h1: { label: 'Заголовок H1 на главной', value: (v) => `${plural(Number(nums(v)[0] || 0), 'заголовок', 'заголовка', 'заголовков')} H1` },
+  canonical: { label: 'Канонический адрес', value: (v) => (/missing|none/i.test(v) ? 'не указан' : 'указан') },
+  viewport: { label: 'Мобильный viewport', value: (v) => (/missing/.test(v) ? 'не задан' : v), comment: (c) => (c ? 'запрещает масштабирование: плохо для доступности и мобильного поиска' : '') },
+  og: { label: 'Карточки для соцсетей', value: (v) => (/none/.test(v) ? 'нет' : v) },
+  schema: { label: 'Разметка на главной', value: (v) => (/no JSON-LD/.test(v) ? 'разметки нет' : /invalid/.test(v) ? 'разметка есть, но с ошибкой' : v) },
+  'faq-schema': { label: 'Разметка вопросов FAQPage', value: (v) => (/not found/.test(v) ? 'не найдена в выборке' : `есть на ${pages(nums(v)[0])} выборки`) },
+  'org-schema': { label: 'Разметка организации', value: (v) => (/not found/.test(v) ? 'не найдена: ответным системам не к чему привязать сайт' : 'есть') },
+  resources: { label: 'Вес главной страницы', value: (v) => { const n = nums(v); return `${plural(Number(n[0]), 'файл скриптов', 'файла скриптов', 'файлов скриптов')}, ${plural(Number(n[1]), 'стиль', 'стиля', 'стилей')}, ${plural(Number(n[2]), 'изображение', 'изображения', 'изображений')}`; } },
+  hreflang: { label: 'hreflang', value: (v) => (/none/.test(v) ? 'нет, сайт одноязычный' : `${plural(Number(nums(v)[0]), 'альтернатива', 'альтернативы', 'альтернатив')}`) },
+  cms: { label: 'Движок сайта', value: (v) => v },
+  xmlrpc: { label: 'xmlrpc.php', value: (v) => `отвечает ${nums(v)[0]}`, comment: () => 'открытая точка для атак, пользы для поиска никакой' },
+  alt: { label: 'Подписи к картинкам', value: (v) => { const n = nums(v); return `${n[0]} из ${n[1]} картинок имеют подпись, это ${n[2]} процентов, на ${pages(n[3])} выборки`; } },
+  'h1-sample': { label: 'Структура заголовков', value: (v) => (/one H1 per page/.test(v) ? 'по одному H1 на страницу' : `${nums(v)[0]} из ${pages(nums(v)[1])} имеют больше одного H1`) },
+  'dup-titles': { label: 'Повторы заголовков', value: (v) => (/its own title/.test(v) ? 'у каждой проверенной страницы свой заголовок' : `${plural(Number(nums(v)[0]), 'заголовок повторяется', 'заголовка повторяются', 'заголовков повторяются')} на разных страницах`) },
+  thin: { label: 'Тонкие страницы', value: (v) => (/median/.test(v) ? `медиана ${plural(Number(nums(v)[0]), 'слово', 'слова', 'слов')} на страницу` : `${nums(v)[0]} из ${pages(nums(v)[1])} короче 300 слов`) },
+  utility: { label: 'Служебные страницы в карте сайта', value: (v) => `${plural(Number(nums(v)[0]), 'адрес', 'адреса', 'адресов')}, например ${v.split('such as ')[1] || ''}`, comment: () => 'корзина, избранное, теги и страницы авторов засоряют индекс' },
+  'answer-first': {
+    label: 'Ответ в первом абзаце',
+    value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки начинаются с 20-90 слов, где есть цифра, сразу после H1`; },
+    comment: (c) => (c ? 'именно этот абзац ответная система забирает в цитату' : ''),
+  },
+  sections: { label: 'Разбивка на разделы', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки имеют три и более подзаголовка H2`; }, comment: (c) => (c ? 'системы цитируют разделы, а не сплошной текст' : '') },
+  tables: { label: 'Таблицы в тексте', value: (v) => (/no table/.test(v) ? 'на проверенных страницах таблиц нет' : `${nums(v)[0]} из ${pages(nums(v)[1])} выборки используют таблицу`), comment: (c) => (c ? 'таблица это второй по частоте формат цитирования после первого абзаца' : '') },
+  sources: { label: 'Названные источники цифр', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки называют, откуда взята цифра, словами или ссылкой рядом с ней`; }, comment: (c) => (c ? 'цифра без источника это первое, что система выбрасывает' : '') },
+  dates: { label: 'Открытые даты публикации', value: (v) => (/no article dates/.test(v) ? 'дат в выборке нет: ответные системы не поймут, что здесь актуально' : `${nums(v)[0]} из ${pages(nums(v)[1])} выборки показывают дату`) },
+  'links-profile': { label: 'Профиль внешних ссылок (необязательное дополнение)', value: (v) => { const n = nums(v); return `${plural(Number(n[0]), 'ссылающийся домен', 'ссылающихся домена', 'ссылающихся доменов')}, ${plural(Number(n[1]), 'ссылка', 'ссылки', 'ссылок')}, ${n[2]} процентов передают вес, показатель авторитета ${n[3]} из 100`; }, comment: (c) => `${c.split('.')[0]}. Платный инструмент, для этого отчёта не обязателен и ни в одну оценку не входит.` },
+  'trust-entity': { label: 'Кто это, в машиночитаемом виде', value: (v) => (/no postal address/.test(v) ? 'почтового адреса в разметке нет' : 'почтовый адрес опубликован в разметке'), comment: (c) => (c ? 'рейтинговые системы и ответные движки по нему отличают одну компанию от другой' : '') },
+  'trust-contact': {
+    label: 'Прямые контакты',
+    value: (v) => (/no phone, email or messenger/.test(v) ? 'ни телефона, ни почты, ни мессенджера не опубликовано'
+      : v.replace(/\bphone\b/g, 'телефон').replace(/\bemail\b/g, 'почта').replace(/a messenger/g, 'мессенджер').replace(/ and /g, ' и ')),
+  },
+  'trust-profiles': { label: 'Профили на других площадках', value: (v) => (/no sameAs/.test(v) ? 'в разметке не заявлено ни одного профиля на других площадках' : `${nums(v)[0]}: ${v.split(': ').slice(1).join(': ')}`), comment: (c) => (c ? 'самый дешёвый внешний сигнал, и он бесплатный' : '') },
+  'trust-about': { label: 'Страница о компании', value: (v) => (/no about/.test(v) ? 'страницы о компании нет или на неё не ведут ссылки' : 'на неё ведут ссылки с проверенных страниц') },
+  'trust-policies': { label: 'Политика и условия', value: (v) => (/neither/.test(v) ? 'ни политики конфиденциальности, ни условий на сайте нет' : `есть: ${v.replace(/privacy/g, 'политика').replace(/terms/g, 'условия').replace(/legal/g, 'правовая страница').replace(/cookie/g, 'куки').replace(/disclaimer/g, 'оговорка')}`) },
+  'conv-contact-path': { label: 'Способ связаться', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки дают форму, контактную ссылку или страницу контактов`; } },
+  'conv-cta': { label: 'Призыв к действию в первом экране', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки ставят его в первых ${n[2]} процентах страницы`; }, comment: (c) => (c ? 'читателю, которого убедили сверху, не должно приходиться искать' : '') },
+  'conv-form-depth': { label: 'На какой глубине лежит форма', value: (v) => (/no form/.test(v) ? 'на проверенных страницах формы нет' : /could not be measured/.test(v) ? 'положение формы измерить не удалось' : `медиана ${nums(v)[0]} процентов вниз по странице, измерено на ${pages(nums(v)[1])}`), comment: (c) => (c ? 'на длинной странице дотуда почти никто не доходит, особенно с телефона' : '') },
+  'conv-form-fields': { label: 'Сколько полей просит форма', value: (v) => `медиана ${plural(Number(nums(v)[0]), 'поле', 'поля', 'полей')} до отправки`, comment: (c) => (c ? 'каждое лишнее поле стоит ответов, а телефон дороже всех' : '') },
+  'conv-messenger': { label: 'Ссылка на мессенджер', value: (v) => (/none/.test(v) ? 'на проверенных страницах нет' : `на ${nums(v)[0]} из ${pages(nums(v)[1])} выборки`), comment: (c) => (c ? 'для международной аудитории с телефона одна ссылка на мессенджер обычно ценнее формы' : '') },
+};
+
+/** Проверки, для которых перевода нет. Пусто означает, что покрыто всё. */
+export function untranslated(checks) {
+  return [...new Set((checks || []).map((c) => c.id).filter((id) => !RU[id]))];
+}
+
+/**
+ * Возвращает копию списка проверок с русскими названиями и текстами.
+ * Проверка без записи возвращается как есть: молча английский текст не прячем.
+ */
+export function localiseChecks(checks, lang = 'ru') {
+  if (lang !== 'ru') return checks;
+  return (checks || []).map((c) => {
+    const r = RU[c.id];
+    if (!r) return c;
+    const out = { ...c, label: r.label || c.label };
+    try { if (r.value) out.value = r.value(c.value ?? ''); } catch { /* оставляем исходный текст */ }
+    try { if (r.comment) out.comment = r.comment(c.comment ?? ''); } catch { /* оставляем исходный текст */ }
+    return out;
+  });
+}
+
+/** Русские названия шести областей. */
+export const AREAS_RU = {
+  'SEO, technical': 'SEO, техническая часть',
+  'SEO, content and structure': 'SEO, контент и структура',
+  'AEO, answers and snippets': 'AEO, ответы и сниппеты',
+  'GEO, visibility in AI systems': 'GEO, видимость в системах ИИ',
+  'Off-page and trust': 'Ссылки и доверие',
+  'Conversion and UX': 'Конверсия и удобство',
+};

package/src/index.mjs

@@ -1,2 +1,4 @@
-export { collect } from './collect.mjs';
+export { collect, computeScores, verifyScores, SCORE_AREAS } from './collect.mjs';
 export { render, checkNarrative } from './render.mjs';
+export { localiseChecks, localiseBasisNote, untranslated, AREAS_RU } from './i18n.mjs';
+export { buildFixPlan, renderFixPlan, renderFixChecklist, buildFixReport, renderFixReport, FIX_ACTIONS } from './fix.mjs';

package/src/render.mjs

@@ -8,6 +8,7 @@ import { spawnSync } from 'node:child_process';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { computeScores } from './collect.mjs';
+import { localiseBasisNote, AREAS_RU } from './i18n.mjs';
 
 const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 const isPlaceholder = (s) => typeof s === 'string' && /\{\{[^}]*\}\}/.test(s);
@@ -55,21 +56,8 @@ const LABELS = {
     secRoadmap: 'План работ', roadmapEyebrow: '10 · План', roadmapTitle: 'Что делать и в каком порядке', keyMessage: 'Главное сообщение:',
     runningHead: 'Аудит SEO, AEO и GEO',
     statusOk: '✓ Норма', statusWarn: '△ Частично', statusBad: '✗ Проблема', statusNa: '· Заметка',
-    areas: {
-      'SEO, technical': 'SEO, техническая часть',
-      'SEO, content and structure': 'SEO, контент и структура',
-      'AEO, answers and snippets': 'AEO, ответы и сниппеты',
-      'GEO, visibility in AI systems': 'GEO, видимость в системах ИИ',
-      'Off-page and trust': 'Ссылки и доверие',
-      'Conversion and UX': 'Конверсия и удобство',
-    },
-    basisNote: (b) => {
-      const w = (n, one, few, many) => { const d = n % 10, dd = n % 100; return n + ' ' + (d === 1 && dd !== 11 ? one : d >= 2 && d <= 4 && (dd < 10 || dd >= 20) ? few : many); };
-      const parts = [`${b.ok} из ${w(b.counted, 'проверки', 'проверок', 'проверок')} пройдено`];
-      if (b.warn) parts.push(`${w(b.warn, 'спорная', 'спорные', 'спорных')}`);
-      if (b.bad) parts.push(`${w(b.bad, 'провалена', 'провалены', 'провалено')}`);
-      return parts.join(', ');
-    },
+    areas: AREAS_RU,
+    basisNote: (b) => localiseBasisNote(`${b.ok} of ${b.counted} checks pass${b.warn ? `, ${b.warn} ${b.warn === 1 ? 'needs' : 'need'} attention` : ''}${b.bad ? `, ${b.bad} ${b.bad === 1 ? 'fails' : 'fail'}` : ''}`),
     notMeasuredReason: { 'Off-page and trust': 'данные по ссылкам и упоминаниям не собирались', 'Conversion and UX': 'сигналы конверсии не собирались' },
   },
 };

package/src/test-fix.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/** Пакет Fix: раскладка проверок, доля возврата, отчёт о закрытии, два языка. */
+import { buildFixPlan, renderFixPlan, renderFixChecklist, buildFixReport, renderFixReport, FIX_ACTIONS } from './fix.mjs';
+import { readFileSync } from 'node:fs';
+
+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 = (checks) => ({ meta: { host: 'x.ru', collectedAt: '2026-09-11T00:00:00.000Z' }, checks });
+const c = (id, status, value = 'текст') => ({ id, status, value, label: id, group: 'technical' });
+
+const many = audit([
+  c('robots', 'bad'), c('sitemap', 'warn'), c('llms', 'bad'), c('og', 'warn'), c('canonical', 'warn'),
+  c('trust-entity', 'warn'), c('conv-messenger', 'warn'),
+  c('answer-first', 'warn'), c('sources', 'bad'),
+  c('conv-form-depth', 'bad'),
+  c('links-profile', 'warn'),
+  c('https', 'ok'), c('viewport', 'ok'),
+]);
+
+const plan = buildFixPlan(many, { platform: 'files', price: 21000, currency: 'RUB' });
+is('закрываем восемь', plan.included.length, 8);
+is('фактов клиента требуют две', plan.needsClient.length, 2);
+is('не обещаем одну', plan.notPossible.length, 1);
+is('пройденные проверки в список не попадают', plan.included.some((x) => x.check.id === 'https'), false);
+is('доля считается от числа включённых', plan.share, Math.round((21000 / 8) * 100) / 100);
+ok('список не тонкий', !plan.thin);
+ok('у каждой включённой проверки есть действие', plan.included.every((x) => typeof x.action === 'string' && x.action.length > 10));
+ok('платные данные по ссылкам не обещаются', plan.notPossible.some((x) => x.check.id === 'links-profile'));
+
+const cms = buildFixPlan(many, { platform: 'cms', price: 21000, currency: 'RUB' });
+ok('на готовой CMS работа с исходниками не обещается', cms.notPossible.some((x) => x.check.id === 'conv-form-depth'));
+is('и в список она не попадает', cms.included.some((x) => x.check.id === 'conv-form-depth'), false);
+ok('доля на CMS выше, потому что работ меньше', cms.share > plan.share);
+
+const thin = buildFixPlan(audit([c('og', 'warn'), c('canonical', 'warn')]), { price: 21000, currency: 'RUB' });
+ok('тонкий список помечен', thin.thin);
+ok('письмо про тонкий список говорит прямо', renderFixPlan(thin).includes('закрывать у вас почти нечего'));
+
+const empty = buildFixPlan(audit([c('https', 'ok')]), { price: 21000 });
+is('пустой список', empty.included.length, 0);
+is('доля при пустом списке ноль', empty.share, 0);
+ok('письмо говорит, что покупать нечего', renderFixPlan(empty).includes('Покупать нечего'));
+
+const letter = renderFixPlan(plan);
+ok('в письме есть цена и доля', letter.includes('21000 RUB') && letter.includes(String(plan.share)));
+ok('в письме названо, что не входит', letter.includes('нужны ваши факты'));
+ok('в чек-листе есть все включённые', plan.included.every((x) => renderFixChecklist(plan).includes(x.check.label)));
+
+// Язык. Покупка за доллары не должна приходить письмом по-русски. Названия и значения проверок
+// приходят из сборщика уже на языке аудита, поэтому и фикстура здесь английская.
+const ce = (id, status, value = 'plain text') => ({ id, status, value, label: id, group: 'technical' });
+const manyEn = { meta: { host: 'x.com', collectedAt: '2026-09-11T00:00:00.000Z' }, checks: many.checks.map((x) => ce(x.id, x.status)) };
+const en = buildFixPlan(manyEn, { platform: 'files', price: 249, lang: 'en' });
+is('валюта по умолчанию для английского', en.currency, 'USD');
+is('валюта по умолчанию для русского', buildFixPlan(many, { price: 21000 }).currency, 'RUB');
+is('раскладка от языка не зависит', [en.included.length, en.needsClient.length, en.notPossible.length], [8, 2, 1]);
+const letterEn = renderFixPlan(en);
+ok('английское письмо без кириллицы', !/[А-Яа-яЁё]/.test(letterEn));
+ok('английский чек-лист без кириллицы', !/[А-Яа-яЁё]/.test(renderFixChecklist(en)));
+ok('в английском письме есть цена', letterEn.includes('249 USD'));
+const thinEn = buildFixPlan({ meta: { host: 'x.com' }, checks: [ce('og', 'warn')] }, { price: 249, lang: 'en' });
+ok('английское предупреждение о тонком списке', renderFixPlan(thinEn).includes('little here to fix'));
+ok('единственное число по-английски', renderFixPlan(thinEn).includes('1 check at'));
+
+const after = audit([
+  c('robots', 'ok', 'починено'), c('sitemap', 'ok', 'починено'), c('llms', 'ok', 'починено'),
+  c('og', 'ok', 'починено'), c('canonical', 'ok', 'починено'), c('trust-entity', 'ok', 'починено'),
+  c('conv-messenger', 'warn', 'так и не сделали'), c('conv-form-depth', 'ok', 'починено'),
+]);
+const rep = buildFixReport(plan, after);
+is('закрыто семь', rep.closed.length, 7);
+is('осталось одно', rep.stillOpen.length, 1);
+is('возврат равен доле одной проверки', rep.refund, plan.share);
+is('незакрытой осталась именно та проверка', rep.stillOpen[0].check.id, 'conv-messenger');
+ok('в отчёте она названа', renderFixReport(rep).includes(rep.stillOpen[0].check.label));
+ok('в отчёте есть сумма возврата', renderFixReport(rep).includes(String(rep.refund)));
+ok('английский отчёт без кириллицы', !/[А-Яа-яЁё]/.test(renderFixReport(buildFixReport(en, { checks: [] }))));
+
+const repAll = buildFixReport(buildFixPlan(audit([c('robots', 'bad')]), { price: 249 }), audit([c('robots', 'ok')]));
+is('всё закрыто, возврата нет', repAll.refund, 0);
+ok('отчёт так и говорит', renderFixReport(repAll).includes('возвращать нечего'));
+
+// пропавшая из прогона проверка считается незакрытой, а не закрытой молча
+const gone = buildFixReport(buildFixPlan(audit([c('robots', 'bad'), c('og', 'warn')]), { price: 100 }), audit([c('robots', 'ok')]));
+is('пропавшая проверка не закрыта', gone.stillOpen.length, 1);
+is('и за неё возвращается доля', gone.refund, 50);
+
+// Язык аудита. Русское письмо переводит названия проверок само, английское по русскому аудиту не собрать.
+const enAudit = { meta: { host: 'x.com', lang: 'en', collectedAt: '2026-09-11T00:00:00.000Z' }, checks: [{ id: 'www', status: 'warn', label: 'www canonicalisation', value: 'www.x.com answers 200 without redirecting', group: 'technical' }] };
+const ruLetter = buildFixPlan(enAudit, { price: 21000 });
+ok('русское письмо по английскому аудиту переводит названия', /[А-Яа-я]/.test(ruLetter.included[0].check.label));
+ok('и это не считается расхождением языков', !ruLetter.langMismatch);
+const ruAudit = { meta: { host: 'x.ru', lang: 'ru', collectedAt: '2026-09-11T00:00:00.000Z' }, checks: [c('www', 'warn')] };
+ok('английское письмо по русскому аудиту помечено как брак', buildFixPlan(ruAudit, { lang: 'en', price: 249 }).langMismatch);
+
+// у каждого действия есть оба языка
+const noEn = Object.entries(FIX_ACTIONS).filter(([, r]) => {
+  const f = r.action || r.why;
+  return !f || typeof f !== 'object' || !f.ru || !f.en;
+}).map(([id]) => id);
+is('у каждого действия есть русский и английский текст', noEn, []);
+
+// покрытие: у каждой проверки, которую умеет собирать сборщик, есть решение
+const files = process.argv.slice(2);
+if (files.length) {
+  const ids = new Set();
+  for (const f of files) for (const x of JSON.parse(readFileSync(f, 'utf8')).checks) ids.add(x.id);
+  const missing = [...ids].filter((id) => !FIX_ACTIONS[id]);
+  is('для каждой собираемой проверки описано решение', missing, []);
+}
+
+if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
+console.log('\nвсе тесты пакета Fix прошли');

package/src/test-i18n.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/** Перевод проверок: покрытие, отсутствие английских хвостов, целость чисел. */
+import { readFileSync } from 'node:fs';
+import { localiseChecks, untranslated, localiseBasisNote } from './i18n.mjs';
+
+let bad = 0;
+const ok = (n, c) => { if (!c) { bad++; console.error(`FAIL ${n}`); } else console.log(`ok   ${n}`); };
+const is = (n, a, b) => { const g = JSON.stringify(a) === JSON.stringify(b); if (!g) { bad++; console.error(`FAIL ${n}\n  ждали ${JSON.stringify(b)}\n  вышло ${JSON.stringify(a)}`); } else console.log(`ok   ${n}`); };
+
+const files = process.argv.slice(2);
+if (!files.length) { console.error('нужен хотя бы один audit.json для проверки покрытия'); process.exit(2); }
+const all = [];
+for (const f of files) all.push(...JSON.parse(readFileSync(f, 'utf8')).checks);
+
+is('перевод есть для всех собранных проверок', untranslated(all), []);
+
+const ru = localiseChecks(all, 'ru');
+is('количество проверок не изменилось', ru.length, all.length);
+ok('статусы не тронуты', ru.every((c, i) => c.status === all[i].status));
+ok('идентификаторы не тронуты', ru.every((c, i) => c.id === all[i].id));
+
+// в русском тексте не должно остаться английских слов, кроме технических имён
+const TECH = /https?|robots\.txt|llms\.txt|sitemap|xmlrpc|HTTP|HTTPS|H1|H2|og:|twitter:|JSON-LD|FAQPage|Organization|WebSite|Article|LocalBusiness|viewport|width|initial-scale|device-width|user-scalable|maximum-scale|Disallow|User-agent|gptbot|google-extended|ccbot|anthropic-ai|claudebot|applebot-extended|facebookbot|meta-externalagent|bytespider|oai-searchbot|chatgpt-user|perplexitybot|claude-searchbot|duckassistbot|applebot|sameAs|com|ru|org|io|me|net|dev|github|npmjs|apify|producthunt|wikidata|moregroup|estate|Content|Type|Cache|Control|OperStack|SEO|AEO|GEO|AI|XML|CMS|PDF|URL/gi;
+const leftovers = [];
+for (const c of ru) {
+  for (const field of ['label', 'value', 'comment']) {
+    const t = String(c[field] || '')
+      .replace(/\/[A-Za-z0-9_\-/.]+\/?/g, ' ')        // пути страниц клиента
+      .replace(/\b[a-z-]+:[a-z_:]+/gi, ' ')            // og:title, twitter:summary_large_image
+      .replace(/\bhreflang\b/gi, ' ')                  // имя атрибута
+      .replace(TECH, '').replace(/[^A-Za-z]/g, ' ');
+    const words = t.split(/\s+/).filter((w) => w.length > 3);
+    if (words.length) leftovers.push(`${c.id}.${field}: ${words.join(' ')}`);
+  }
+}
+is('английских слов в русском тексте не осталось', leftovers, []);
+
+// числа не потерялись
+const digits = (s) => (String(s).match(/\d+/g) || []).join(',');
+const lostNumbers = ru.filter((c, i) => {
+  const before = digits(all[i].value);
+  const after = digits(c.value);
+  return before && after && before.split(',').some((n) => !after.split(',').includes(n));
+}).map((c) => `${c.id}: было ${digits(all[all.findIndex((x) => x.id === c.id)].value)}, стало ${digits(c.value)}`);
+is('числа в тексте сохранились', lostNumbers, []);
+
+is('подпись под оценкой переведена', localiseBasisNote('10 of 11 checks pass, 1 needs attention'), '10 из 11 проверок пройдено, 1 спорная');
+is('склонение на пяти', localiseBasisNote('3 of 5 checks pass, 2 need attention'), '3 из 5 проверок пройдено, 2 спорные');
+is('провал тоже склоняется', localiseBasisNote('1 of 3 checks pass, 1 needs attention, 1 fails'), '1 из 3 проверок пройдено, 1 спорная, 1 провалена');
+is('неизмеренное переводится', localiseBasisNote('not measured: no link data was collected'), 'не измерялось: no link data was collected');
+
+is('английский язык ничего не меняет', localiseChecks(all, 'en'), all);
+
+if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
+console.log(`\nперевод проверен на ${all.length} проверках, всё чисто`);