@operstack/audit 0.5.0 → 0.7.0

package/README.md

@@ -46,6 +46,41 @@ 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.
+
+## The Foundation package: pricing the writing
+
+Fix closes what needs no knowledge of the business. Everything else is text, and text is priced per page.
+
+```
+npx @operstack/audit foundation-scope audit.json --lang en --new-pages 3
+```
+
+Each sampled page is read for five things: does it open with an answer carrying a figure, are the figures sourced, is it broken into sections, does it carry a table worth quoting, and is there enough of it at all. A page needing one edit is one share of work, two or three defects is two, four or more (or an empty page) is three, and a page that does not exist yet is three. Shares times the unit price, lifted to the package minimum.
+
+Utility pages are excluded and counted separately: nobody rewrites a privacy policy to open with a figure. Sources are asked for only where the page actually carries figures. Without Search Console access the scope is built on a sitemap sample, and the letter says so rather than implying we picked the pages that matter.
+
 ## 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

@@ -7,6 +7,13 @@
  *       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 foundation-scope audit.json [--lang ru|en] [--new-pages 3] [--gsc]
+ *       the text work the Foundation package would do, page by page, with the price it adds up to
  *   operstack-audit check audit.json
  *       lists narrative fields still holding placeholders and any score the checks do not support
  *
@@ -14,6 +21,8 @@
  * 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 { buildFoundationScope, renderFoundationScope, renderFoundationChecklist } from '../src/foundation.mjs';
 import { render, checkNarrative } from '../src/render.mjs';
 import { writeFileSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
@@ -52,4 +61,53 @@ 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 if (cmd === 'foundation-scope') {
+  const audit = JSON.parse(readFileSync(resolve(target), 'utf8'));
+  const lang = opt('--lang', 'ru') === 'en' ? 'en' : 'ru';
+  if (!(audit.sample || []).some((p) => p.answerFirst !== undefined)) {
+    console.error('this audit was collected before the text fields were kept in the sample: re-run collect to scope Foundation');
+    process.exit(1);
+  }
+  const scope = buildFoundationScope(audit, {
+    lang,
+    newPages: Number(opt('--new-pages', 0)),
+    hasSearchConsole: has("--gsc"),
+    unit: opt('--unit') ? Number(opt('--unit')) : undefined,
+    minimum: opt('--minimum') ? Number(opt('--minimum')) : undefined,
+    currency: opt('--currency'),
+  });
+  const base = opt('--out', target.replace(/\.json$/, ''));
+  writeFileSync(resolve(`${base}-foundation-scope.json`), JSON.stringify(scope, null, 2));
+  writeFileSync(resolve(`${base}-foundation-letter.md`), renderFoundationScope(scope));
+  writeFileSync(resolve(`${base}-foundation-checklist.md`), renderFoundationChecklist(scope));
+  console.log(`${scope.pages.length} page(s) need text work of ${scope.sampledPages} sampled, ${scope.shares} share(s)`);
+  console.log(`price ${scope.price} ${scope.currency}${scope.atMinimum ? ` (raw ${scope.raw}, lifted to the package minimum)` : ''}`);
+  console.log(`wrote ${base}-foundation-scope.json, ${base}-foundation-letter.md, ${base}-foundation-checklist.md`);
 } else { console.error(`unknown command ${cmd}`); process.exit(2); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.5.0",
+  "version": "0.7.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",
@@ -10,7 +10,9 @@
   },
   "exports": {
     ".": "./src/index.mjs",
-    "./i18n": "./src/i18n.mjs"
+    "./i18n": "./src/i18n.mjs",
+    "./fix": "./src/fix.mjs",
+    "./foundation": "./src/foundation.mjs"
   },
   "files": [
     "bin",
@@ -21,7 +23,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 src/test-foundation.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

@@ -123,13 +123,16 @@ function analysePage(url, html) {
   // somebody else's site sitting in the same paragraph as the figure it backs.
   const sourcePhrases = (text.match(/\b(according to|source:|sources:|data from|reported by|published by|registry|statistics office|central bank)\b/gi) || []).length;
   const ownHostname = (() => { try { return new URL(url).hostname.replace(/^www\./, ''); } catch { return ''; } })();
+  // Абзацы, в которых вообще есть цифра. Без этого счётчика «цифры без источника» вменяется
+  // странице, где цифр нет ни одной, например политике конфиденциальности.
+  const figureParagraphs = (bodyHtml.match(/<p[^>]*>[\s\S]*?<\/p>/gi) || []).filter((para) => /\d/.test(plain(para))).length;
   const citedParagraphs = (bodyHtml.match(/<p[^>]*>[\s\S]*?<\/p>/gi) || []).filter((para) => {
     if (!/\d/.test(plain(para))) return false;
     return [...para.matchAll(/<a[^>]+href=["'](https?:\/\/[^"']+)["']/gi)].some((m) => {
       try { return new URL(m[1]).hostname.replace(/^www\./, '') !== ownHostname; } catch { return false; }
     });
   }).length;
-  return { url, title, citedParagraphs, titleLength: title.length, description, descriptionLength: description.length, descriptionGarbage: shortcode, h1Count: h1s.length, h1: h1s[0] || '', images: imgs.length, imagesNoAlt: imgsNoAlt, canonical, robots, viewport, og, twitter, generator, hreflang, scripts, stylesheets, schemaTypes: [...new Set(schemaTypes)], words, links, dates, firstPara: firstPara.slice(0, 220), firstParaWords, answerFirst, h2Count, tables, sourcePhrases , telLinks, mailLinks, messengerLinks, contactPages, forms: realForms.length, formFields, formDepth, ctaFirstScreen, trust };
+  return { url, title, citedParagraphs, figureParagraphs, titleLength: title.length, description, descriptionLength: description.length, descriptionGarbage: shortcode, h1Count: h1s.length, h1: h1s[0] || '', images: imgs.length, imagesNoAlt: imgsNoAlt, canonical, robots, viewport, og, twitter, generator, hreflang, scripts, stylesheets, schemaTypes: [...new Set(schemaTypes)], words, links, dates, firstPara: firstPara.slice(0, 220), firstParaWords, answerFirst, h2Count, tables, sourcePhrases , telLinks, mailLinks, messengerLinks, contactPages, forms: realForms.length, formFields, formDepth, ctaFirstScreen, trust };
 }
 
 async function readSitemap(url, seen = new Set(), depth = 0) {
@@ -347,7 +350,9 @@ export async function collect(startUrl, { pages = 20, log = () => {}, backlinks
       { badge: 'Months 2 to 3', title: 'Organic growth, AEO and GEO', items: ['{{content clusters, schema, PR, reviews}}'] },
     ],
     closing: '{{Key message for the client in three sentences.}}',
-    sample: sample.map((p) => p.title !== undefined ? { url: p.url, title: p.title, words: p.words, h1Count: p.h1Count, images: p.images, imagesNoAlt: p.imagesNoAlt, schemaTypes: p.schemaTypes } : p),
+    // В выборке остаётся и то, из чего считается работа с текстами: без этих полей пакет
+    // Foundation пришлось бы оценивать на глаз, как раньше оценивался Fix.
+    sample: sample.map((p) => p.title !== undefined ? { url: p.url, title: p.title, words: p.words, h1Count: p.h1Count, images: p.images, imagesNoAlt: p.imagesNoAlt, schemaTypes: p.schemaTypes, answerFirst: p.answerFirst, sourcePhrases: p.sourcePhrases, citedParagraphs: p.citedParagraphs, figureParagraphs: p.figureParagraphs, h2Count: p.h2Count, tables: p.tables, firstParaWords: p.firstParaWords, dates: p.dates } : p),
     notes,
   };
 }

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/foundation.mjs

@@ -0,0 +1,232 @@
+/**
+ * Пакет Foundation: работа с текстами, посчитанная по страницам, а не на глаз.
+ *
+ * Fix закрывает то, для чего не нужно знать бизнес клиента. Всё остальное, начала страниц,
+ * источники цифр, разделы, таблицы и недостающие страницы, это Foundation. Цена такой работы
+ * зависит от того, сколько страниц придётся тронуть и насколько глубоко, поэтому считать её
+ * надо по выборке страниц, а не называть числом из головы.
+ *
+ * Единица счёта здесь одна: доля работы над одной страницей. Страница, которую надо написать
+ * заново, стоит три доли, переработка двух и более дефектов две, одна правка одну. Итог это
+ * сумма долей, умноженная на цену доли, но не ниже минимума пакета.
+ *
+ * Чего этот расчёт не знает: какие страницы приносят показы. Это видно только в Search Console,
+ * доступ к которой даёт клиент, и это бесплатно. Без доступа мы считаем по выборке и говорим
+ * об этом прямо, а не делаем вид, что выбрали важные страницы.
+ */
+
+/**
+ * Служебные страницы. Политику конфиденциальности не переписывают под ответ с цифрой, и таблица
+ * в контактах никому не нужна. Счёт за такую работу это счёт за работу, которой не будет.
+ */
+// Слоги в двух алфавитах: русские сайты пишут те же страницы своими словами.
+const UTILITY = /\/(privacy|privacy-policy|terms|terms-of-use|terms-and-conditions|cookie|cookies|refund|refunds|legal|disclaimer|imprint|contact|contacts|sitemap|search|404|thanks|thank-you|cart|checkout|wishlist|compare|my-account|tag|tags|author|category|feed|politika-konfidencialnosti|politika|konfidencialnost|usloviya|oferta|publichnaya-oferta|dogovor|vozvrat|vozvraty|kontakty|kontakt|spasibo|karta-sajta|poisk|pravila)(\/|$)/i;
+
+export const isUtilityPage = (url) => { try { return UTILITY.test(new URL(url).pathname); } catch { return false; } };
+
+/** Что не так с текстом страницы. Каждая строка это работа, а не наблюдение. */
+const PAGE_ISSUES = [
+  {
+    id: 'thin',
+    test: (p) => p.words < 300,
+    ru: { what: 'страница пустая', action: 'написать заново по вашим фактам' },
+    en: { what: 'the page is empty', action: 'write it from your facts' },
+    heavy: true,
+  },
+  {
+    id: 'answer-first',
+    test: (p) => p.answerFirst === false,
+    ru: { what: 'нет ответа в первом абзаце', action: 'переписать начало так, чтобы в первых 20 - 90 словах стоял ответ с цифрой' },
+    en: { what: 'no answer in the opening paragraph', action: 'rewrite the opening so the first 20 to 90 words carry an answer with a figure' },
+  },
+  {
+    id: 'sources',
+    // Спрашиваем источники только там, где цифры вообще есть.
+    test: (p) => (p.figureParagraphs || 0) > 0 && (p.sourcePhrases || 0) === 0 && (p.citedParagraphs || 0) === 0 && p.words >= 300,
+    ru: { what: 'цифры без источников', action: 'подписать к каждой цифре, откуда она, словами или ссылкой рядом' },
+    en: { what: 'figures with no sources', action: 'name where each figure comes from, in words or as a link beside it' },
+  },
+  {
+    id: 'sections',
+    test: (p) => (p.h2Count || 0) < 3 && p.words >= 300,
+    ru: { what: 'нет разделов', action: 'разбить на разделы с заголовками, которые повторяют вопросы читателя' },
+    en: { what: 'no sections', action: 'break it into sections whose headings repeat the reader\'s questions' },
+  },
+  {
+    id: 'tables',
+    test: (p) => (p.tables || 0) === 0 && p.words >= 600,
+    ru: { what: 'нечего процитировать таблицей', action: 'собрать таблицу из ваших данных: её цитируют охотнее абзаца' },
+    en: { what: 'nothing a table could quote', action: 'build a table from your data: tables get quoted more readily than prose' },
+  },
+];
+
+/**
+ * Доли работы. Пустую страницу пишем заново, это всегда три доли. Дальше по числу дефектов:
+ * одна правка одна доля, две или три две, четыре и больше это по сути та же работа заново.
+ */
+const SHARES = { rewrite: 3, rework: 2, touch: 1 };
+function tierOf(issues) {
+  if (issues.some((i) => i.heavy)) return 'rewrite';
+  if (issues.length >= 4) return 'rewrite';
+  return issues.length > 1 ? 'rework' : 'touch';
+}
+
+const pick = (o, lang) => o[lang === 'en' ? 'en' : 'ru'];
+
+/**
+ * Смета по собранному аудиту.
+ * @param {object} audit результат collect()
+ * @param {{lang?: 'ru'|'en', unit?: number, minimum?: number, currency?: string, newPages?: number, hasSearchConsole?: boolean}} opts
+ */
+export function buildFoundationScope(audit, opts = {}) {
+  const lang = opts.lang === 'en' ? 'en' : 'ru';
+  const currency = opts.currency || (lang === 'en' ? 'USD' : 'RUB');
+  const unit = Number(opts.unit ?? (lang === 'en' ? 50 : 4200));
+  const minimum = Number(opts.minimum ?? (lang === 'en' ? 500 : 42000));
+  const newPages = Math.max(0, Number(opts.newPages ?? 0));
+
+  const sampled = (audit.sample || []).filter((p) => p.title !== undefined && typeof p.words === 'number');
+  const utility = sampled.filter((p) => isUtilityPage(p.url));
+  const content = sampled.filter((p) => !isUtilityPage(p.url));
+  const pages = [];
+  for (const p of content) {
+    const issues = PAGE_ISSUES.filter((i) => i.test(p));
+    if (!issues.length) continue;
+    const tier = tierOf(issues);
+    pages.push({
+      url: p.url,
+      title: p.title,
+      words: p.words,
+      tier,
+      shares: SHARES[tier],
+      issues: issues.map((i) => ({ id: i.id, what: pick(i, lang).what, action: pick(i, lang).action })),
+    });
+  }
+  pages.sort((a, b) => b.shares - a.shares || a.words - b.words);
+
+  // Новая страница это всегда работа с нуля, то есть столько же, сколько переписывание пустой.
+  const pageShares = pages.reduce((n, p) => n + p.shares, 0);
+  const newShares = newPages * SHARES.rewrite;
+  const shares = pageShares + newShares;
+  const raw = shares * unit;
+  const price = Math.max(minimum, raw);
+
+  return {
+    lang, currency, unit, minimum, newPages,
+    host: audit.meta?.host,
+    checkedAt: audit.meta?.collectedAt,
+    sampledPages: sampled.length,
+    contentPages: content.length,
+    utilityPages: utility.length,
+    cleanPages: content.length - pages.length,
+    pages, shares, pageShares, newShares, raw, price,
+    atMinimum: price > raw,
+    hasSearchConsole: Boolean(opts.hasSearchConsole),
+  };
+}
+
+const T = {
+  ru: {
+    title: (h) => `# Работа с текстами на сайте ${h}`,
+    checked: (d, n, u) => `Проверено ${d}. Смотрели ${n} ${plural(n, 'страницу', 'страницы', 'страниц')} из карты сайта${u ? `, не считая ${u} ${plural(u, 'служебной', 'служебных', 'служебных')}: политику, условия, контакты и подобные мы в работу не берём и в счёт не ставим` : ''}.`,
+    none: '**Работы нет.** Ни на одной из просмотренных страниц мы не нашли того, что чинит Foundation. Предлагать вам этот пакет не за что.',
+    found: (n, c) => `## Что нашли: ${n} ${plural(n, 'страница требует', 'страницы требуют', 'страниц требуют')} работы${c ? `, ещё ${c} в порядке` : ''}`,
+    tier: { rewrite: 'написать заново', rework: 'переработать', touch: 'одна правка' },
+    words: (n) => `${n} ${plural(n, 'слово', 'слова', 'слов')}`,
+    newPages: (n, s) => `## Новые страницы: ${n}\n\nСтраниц, которых у вас нет, а рынок их спрашивает: ${n}. Каждая считается как страница с нуля, это ${s} ${plural(s, 'доля', 'доли', 'долей')}.`,
+    priceHead: '## Цена',
+    priceBody: (s, u, c, raw) => `Доля работы над одной страницей стоит ${u} ${c}. Долей набралось ${s}, это ${raw} ${c}.`,
+    atMin: (min, c) => `Минимум пакета ${min} ${c}, поэтому в счёте будет ${min} ${c}: меньше этой суммы браться нет смысла ни нам, ни вам.`,
+    total: (p, c) => `Итого ${p} ${c}.`,
+    needHead: '## Что нужно от вас',
+    needs: [
+      'Факты: цифры, сроки, условия, которые мы поставим в начала страниц. Мы не выдумываем цифры за клиента.',
+      'Источники этих цифр: ссылка, документ или ваш внутренний отчёт, на который можно сослаться словами.',
+      'Доступ к сайту: репозиторий или редактор в вашей системе управления.',
+    ],
+    gscHead: 'Про Search Console',
+    gscNo: 'Доступа к Search Console у нас нет, поэтому мы считали по выборке страниц из карты сайта, а не по тем, которые уже приносят показы. Если дадите доступ на чтение, это бесплатно и делается в два клика, мы пересчитаем смету по страницам, которые уже что-то собирают: обычно так работы становится меньше, а толку больше.',
+    gscYes: 'Доступ к Search Console есть, поэтому в первую очередь мы берём страницы, которые уже собирают показы: правка такой страницы окупается быстрее, чем новая.',
+    tail: 'Каждую строку этой сметы видно на самой странице, её можно проверить, открыв страницу глазами.',
+  },
+  en: {
+    title: (h) => `# Text work on ${h}`,
+    checked: (d, n, u) => `Checked ${d}. We looked at ${n} page${n === 1 ? '' : 's'} from the sitemap${u ? `, not counting ${u} utility page${u === 1 ? '' : 's'}: policies, terms, contact and the like are not work we take on or charge for` : ''}.`,
+    none: '**There is no work here.** On none of the pages we looked at did we find what Foundation fixes. There is nothing to sell you.',
+    found: (n, c) => `## What we found: ${n} page${n === 1 ? '' : 's'} ${n === 1 ? 'needs' : 'need'} work${c ? `, ${c} more ${c === 1 ? 'is' : 'are'} fine` : ''}`,
+    tier: { rewrite: 'write from scratch', rework: 'rework', touch: 'one edit' },
+    words: (n) => `${n} word${n === 1 ? '' : 's'}`,
+    newPages: (n, s) => `## New pages: ${n}\n\nPages you do not have and the market asks for: ${n}. Each counts as a page written from scratch, ${s} share${s === 1 ? '' : 's'}.`,
+    priceHead: '## Price',
+    priceBody: (s, u, c, raw) => `One share of work on a page costs ${u} ${c}. The scope came to ${s} shares, which is ${raw} ${c}.`,
+    atMin: (min, c) => `The package minimum is ${min} ${c}, so the invoice will say ${min} ${c}: below that it is not worth either side's time.`,
+    total: (p, c) => `Total ${p} ${c}.`,
+    needHead: '## What we need from you',
+    needs: [
+      'Facts: the figures, timings and terms we will put at the top of each page. We do not invent a client\'s numbers.',
+      'Where those figures come from: a link, a document, or an internal report we can name in words.',
+      'Access to the site: the repository, or an editor account in your CMS.',
+    ],
+    gscHead: 'About Search Console',
+    gscNo: 'We have no Search Console access, so this is scoped on a sample of pages from the sitemap rather than on the pages that already earn impressions. Grant us read-only access, which is free and takes two clicks, and we will re-scope on the pages that already collect something: that usually means less work and more return.',
+    gscYes: 'With Search Console access we start from the pages that already earn impressions: editing one of those pays back faster than a new page does.',
+    tail: 'Every line of this scope is visible on the page itself; you can check it by opening the page and reading it.',
+  },
+};
+
+const dict = (lang) => T[lang === 'en' ? 'en' : 'ru'];
+
+/** Письмо клиенту: смета, которую он согласовывает до оплаты. */
+export function renderFoundationScope(scope) {
+  const t = dict(scope.lang);
+  const L = [t.title(scope.host), '', t.checked(String(scope.checkedAt || '').slice(0, 10), scope.contentPages ?? scope.sampledPages, scope.utilityPages || 0), ''];
+  if (!scope.pages.length && !scope.newPages) { L.push(t.none); return L.join('\n'); }
+
+  if (scope.pages.length) {
+    L.push(t.found(scope.pages.length, scope.cleanPages));
+    L.push('');
+    scope.pages.forEach((p, i) => {
+      L.push(`${i + 1}. **${p.title}** (${t.words(p.words)}) — ${t.tier[p.tier]}, ${p.shares}`);
+      L.push(`   ${p.url}`);
+      for (const is of p.issues) L.push(`   - ${is.what}: ${is.action}`);
+    });
+    L.push('');
+  }
+  if (scope.newPages) { L.push(t.newPages(scope.newPages, scope.newShares)); L.push(''); }
+
+  L.push(t.priceHead);
+  L.push('');
+  L.push(t.priceBody(scope.shares, scope.unit, scope.currency, scope.raw));
+  if (scope.atMinimum) L.push(t.atMin(scope.minimum, scope.currency));
+  L.push(t.total(scope.price, scope.currency));
+  L.push('');
+  L.push(t.needHead);
+  L.push('');
+  for (const n of t.needs) L.push(`- ${n}`);
+  L.push('');
+  L.push(`### ${t.gscHead}`);
+  L.push('');
+  L.push(scope.hasSearchConsole ? t.gscYes : t.gscNo);
+  L.push('');
+  L.push(t.tail);
+  return L.join('\n');
+}
+
+/** Чек-лист исполнителю: страницы по убыванию работы. */
+export function renderFoundationChecklist(scope) {
+  const t = dict(scope.lang);
+  const L = [`# ${scope.lang === 'en' ? 'Foundation checklist' : 'Чек-лист Foundation'}: ${scope.host}`, '',
+    `${scope.lang === 'en' ? 'Shares' : 'Долей'}: ${scope.shares} (${scope.pageShares} + ${scope.newShares} ${scope.lang === 'en' ? 'new' : 'новых'}). ${scope.lang === 'en' ? 'Price' : 'Цена'}: ${scope.price} ${scope.currency}.`, ''];
+  for (const p of scope.pages) {
+    L.push(`- [ ] ${p.title} (${t.tier[p.tier]}, ${p.shares})`);
+    L.push(`      ${p.url}`);
+    for (const is of p.issues) L.push(`      - [ ] ${is.id}: ${is.action}`);
+  }
+  if (scope.newPages) L.push(`- [ ] ${scope.lang === 'en' ? 'New pages' : 'Новые страницы'}: ${scope.newPages} × ${SHARES.rewrite}`);
+  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/index.mjs

@@ -1,3 +1,5 @@
 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';
+export { buildFoundationScope, renderFoundationScope, renderFoundationChecklist } from './foundation.mjs';

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-foundation.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/** Пакет Foundation: раскладка страниц, доли работы, цена, два языка. */
+import { buildFoundationScope, renderFoundationScope, renderFoundationChecklist } from './foundation.mjs';
+
+let bad = 0;
+const is = (n, a, b) => { const ok = JSON.stringify(a) === JSON.stringify(b); if (!ok) { bad++; console.error(`FAIL ${n}\n  ждали ${JSON.stringify(b)}\n  вышло ${JSON.stringify(a)}`); } else console.log(`ok   ${n}`); };
+const ok = (n, c) => is(n, Boolean(c), true);
+
+const page = (over) => ({ url: 'https://x.ru/p', title: 'Страница', words: 900, answerFirst: true, sourcePhrases: 2, citedParagraphs: 1, figureParagraphs: 4, h2Count: 5, tables: 1, ...over });
+const audit = (sample) => ({ meta: { host: 'x.ru', collectedAt: '2026-09-11T00:00:00.000Z' }, sample });
+
+const clean = buildFoundationScope(audit([page(), page({ url: 'https://x.ru/b' })]));
+is('чистые страницы в смету не попадают', clean.pages.length, 0);
+is('и считаются как в порядке', clean.cleanPages, 2);
+ok('письмо говорит, что работы нет', renderFoundationScope(clean).includes('Работы нет'));
+is('цена без работы ноль долей', clean.shares, 0);
+
+const thin = buildFoundationScope(audit([page({ words: 120 })]));
+is('пустая страница это три доли', thin.pages[0].shares, 3);
+is('и помечена как «написать заново»', thin.pages[0].tier, 'rewrite');
+
+const one = buildFoundationScope(audit([page({ answerFirst: false })]));
+is('одна беда это одна доля', one.pages[0].shares, 1);
+is('и это «одна правка»', one.pages[0].tier, 'touch');
+
+const two = buildFoundationScope(audit([page({ answerFirst: false, h2Count: 1 })]));
+is('две беды это две доли', two.pages[0].shares, 2);
+is('и обе названы', two.pages[0].issues.map((i) => i.id), ['answer-first', 'sections']);
+
+// Пороги: короткой странице не вменяем отсутствие таблицы, пустой не вменяем всё подряд дважды
+const short = buildFoundationScope(audit([page({ words: 400, tables: 0 })]));
+is('таблицу спрашиваем только с длинных страниц', short.pages.length, 0);
+const noSrc = buildFoundationScope(audit([page({ words: 250, sourcePhrases: 0, citedParagraphs: 0, h2Count: 0 })]));
+is('с пустой страницы не спрашиваем источники и разделы отдельно', noSrc.pages[0].issues.map((i) => i.id), ['thin']);
+
+// Цена
+const many = buildFoundationScope(audit([page({ words: 100 }), page({ url: 'https://x.ru/b', answerFirst: false, h2Count: 1 }), page({ url: 'https://x.ru/c', answerFirst: false })]));
+is('доли складываются', many.shares, 6);
+is('цена это доли на цену доли', many.raw, 6 * 4200);
+is('но не ниже минимума', many.price, Math.max(42000, 6 * 4200));
+ok('минимум сработал', many.atMinimum === (many.price > many.raw));
+const big = buildFoundationScope(audit(Array.from({ length: 12 }, (_, i) => page({ url: `https://x.ru/${i}`, words: 100 }))));
+is('на большом объёме цена выше минимума', big.price, 36 * 4200);
+ok('и это уже не минимум', !big.atMinimum);
+
+const withNew = buildFoundationScope(audit([page({ answerFirst: false })]), { newPages: 2 });
+is('новая страница считается как написанная с нуля', withNew.newShares, 6);
+is('и входит в общую сумму долей', withNew.shares, 7);
+ok('в письме названы новые страницы', renderFoundationScope(withNew).includes('Новые страницы: 2'));
+
+// Порядок: тяжёлое сверху
+const order = buildFoundationScope(audit([page({ url: 'https://x.ru/a', answerFirst: false }), page({ url: 'https://x.ru/b', words: 100 })]));
+is('самая тяжёлая страница идёт первой', order.pages[0].url, 'https://x.ru/b');
+
+// Search Console: без доступа говорим об этом прямо
+const noGsc = renderFoundationScope(many);
+ok('без доступа к Search Console письмо это признаёт', noGsc.includes('Доступа к Search Console у нас нет'));
+ok('и говорит, что доступ бесплатный', noGsc.includes('бесплатно'));
+const yesGsc = renderFoundationScope(buildFoundationScope(audit([page({ answerFirst: false })]), { hasSearchConsole: true }));
+ok('с доступом письмо берёт страницы с показами', yesGsc.includes('уже собирают показы'));
+
+// Язык
+const en = buildFoundationScope(audit([page({ words: 100 }), page({ url: 'https://x.ru/b', answerFirst: false })]), { lang: 'en' });
+is('валюта английской сметы', en.currency, 'USD');
+is('цена доли по умолчанию', en.unit, 50);
+is('минимум пакета', en.minimum, 500);
+const letterEn = renderFoundationScope({ ...en, host: 'x.com', pages: en.pages.map((p) => ({ ...p, title: 'A page' })) });
+ok('английское письмо без кириллицы', !/[А-Яа-яЁё]/.test(letterEn));
+ok('в английском письме есть цена', letterEn.includes('500 USD'));
+
+// Чек-лист
+const list = renderFoundationChecklist(many);
+ok('в чек-листе все страницы сметы', many.pages.every((p) => list.includes(p.url)));
+ok('и все работы по ним', many.pages.every((p) => p.issues.every((i) => list.includes(i.id))));
+
+// Страницы без разбора (редиректы, ошибки) в смету не лезут
+const junk = buildFoundationScope(audit([{ url: 'https://x.ru/r', redirect: 'https://x.ru/', status: 301 }, { url: 'https://x.ru/e', status: 404 }, page({ answerFirst: false })]));
+is('нечитаемые страницы пропускаются', junk.sampledPages, 1);
+is('и не превращаются в работу', junk.pages.length, 1);
+
+// Служебные страницы: политику и контакты в работу не берём и в счёт не ставим
+const util = buildFoundationScope(audit([
+  page({ url: 'https://x.ru/privacy/', words: 1100, answerFirst: false, sourcePhrases: 0, citedParagraphs: 0, tables: 0 }),
+  page({ url: 'https://x.ru/terms/', words: 1100, answerFirst: false, sourcePhrases: 0, citedParagraphs: 0, tables: 0 }),
+  page({ url: 'https://x.ru/contact/', words: 1100, answerFirst: false, h2Count: 1 }),
+  page({ url: 'https://x.ru/guides/kak-vybrat/', answerFirst: false }),
+]));
+is('служебные страницы в счёт не идут', util.pages.length, 1);
+is('и посчитаны отдельно', util.utilityPages, 3);
+is('содержательных страниц одна', util.contentPages, 1);
+ok('письмо объясняет, почему служебные не в счёте', renderFoundationScope(util).includes('в работу не берём и в счёт не ставим'));
+ok('в счёте осталась только содержательная', util.pages[0].url.includes('/guides/'));
+
+// Источники спрашиваем только там, где цифры есть
+const noFigures = buildFoundationScope(audit([page({ url: 'https://x.ru/o-nas/', figureParagraphs: 0, sourcePhrases: 0, citedParagraphs: 0 })]));
+is('страница без цифр не должна источников', noFigures.pages.length, 0);
+const withFigures = buildFoundationScope(audit([page({ url: 'https://x.ru/o-nas/', figureParagraphs: 3, sourcePhrases: 0, citedParagraphs: 0 })]));
+is('страница с цифрами без источников это работа', withFigures.pages[0].issues.map((i) => i.id), ['sources']);
+
+// Четыре беды это уже работа заново, а не «переработка» по цене двух долей
+const four = buildFoundationScope(audit([page({ url: 'https://x.ru/g/', words: 700, answerFirst: false, sourcePhrases: 0, citedParagraphs: 0, h2Count: 1, tables: 0 })]));
+is('четыре беды дают четыре работы', four.pages[0].issues.length, 4);
+is('и три доли, а не две', four.pages[0].shares, 3);
+is('с честной пометкой', four.pages[0].tier, 'rewrite');
+
+// Английское множественное число
+const en1 = buildFoundationScope(audit([page({ url: 'https://x.ru/a/', answerFirst: false }), page({ url: 'https://x.ru/b/' })]), { lang: 'en' });
+const txt1 = renderFoundationScope(en1);
+ok('одна страница: needs work, ещё одна is fine', txt1.includes('1 page needs work, 1 more is fine'));
+
+if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
+console.log('\nвсе тесты пакета Foundation прошли');