@operstack/audit 0.6.0 → 0.7.1

package/README.md

@@ -69,6 +69,18 @@ Every open check is sorted into one of three buckets by whose knowledge it needs
 
 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

@@ -12,6 +12,8 @@
  *       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
  *
@@ -20,6 +22,7 @@
  */
 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';
@@ -29,7 +32,22 @@ 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] [--lang ru]\n  operstack-audit render <audit.json> [--out report.html] [--pdf]\n  operstack-audit check <audit.json>');
+  console.log([
+    'Usage:',
+    '  operstack-audit collect <url> [--pages 20] [--out audit.json] [--backlinks links.json] [--lang ru]',
+    '      collect the public signals of a site into audit.json',
+    '  operstack-audit render <audit.json> [--out report.html] [--pdf]',
+    '      render the report; --pdf also prints a PDF with headless Chrome',
+    '  operstack-audit check <audit.json>',
+    '      list narrative fields still holding placeholders and any score the checks do not support',
+    '',
+    '  operstack-audit fix-plan <audit.json> [--platform files|cms] [--lang ru|en] [--price 249] [--out base]',
+    '      what the Fix package closes on this site: plan, client letter, executor checklist',
+    '  operstack-audit fix-report <audit-fix-plan.json> <after.json> [--out report.md]',
+    '      what was closed, what was not, and how much to refund',
+    '  operstack-audit foundation-scope <audit.json> [--lang ru|en] [--new-pages 3] [--gsc] [--unit 50] [--minimum 500] [--out base]',
+    '      the text work the Foundation package would do, page by page, and the price it adds up to',
+  ].join('\n'));
   process.exit(cmd ? 0 : 2);
 }
 if (cmd === 'collect') {
@@ -85,4 +103,26 @@ if (cmd === 'collect') {
   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.6.0",
+  "version": "0.7.1",
   "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,8 +10,10 @@
   },
   "exports": {
     ".": "./src/index.mjs",
+    "./package.json": "./package.json",
     "./i18n": "./src/i18n.mjs",
-    "./fix": "./src/fix.mjs"
+    "./fix": "./src/fix.mjs",
+    "./foundation": "./src/foundation.mjs"
   },
   "files": [
     "bin",
@@ -22,7 +24,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "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",
+    "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/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

@@ -2,3 +2,4 @@ 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-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 прошли');