@operstack/audit 0.7.1 → 0.8.0

package/README.md

@@ -46,6 +46,18 @@ 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).
 
+## Writing the report: `draft`
+
+**If you have never done SEO, start here.** An audit tells you what a search engine and an AI see when they open your site. This tool writes that report for you. It does not guess anything about your business: every sentence in it comes from something that was measured on your pages, and where nothing could be measured it says so instead of filling the gap with words. You read it, correct what only you know, and send it.
+
+```
+npx @operstack/audit collect https://example.com --out audit.json
+npx @operstack/audit draft audit.json --lang en
+npx @operstack/audit render audit.json --pdf
+```
+
+Technically: `draft` fills the narrative fields (`summary`, `client.subject`, `overview.note`, `content`, `aeo`, `geo`, `offpage`, `conversion`, `roadmap`, `closing`) from the collected checks. Priorities and roadmap items are written as actions, taken from the same table the Fix checklist uses, so a finding and the work that closes it read the same. Fields an analyst has already written are left alone; anything still empty is listed at the end. For a Russian report over an English audit, check and area names are translated first.
+
 ## 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.
@@ -79,7 +91,7 @@ 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.
+The letter states the scope and the shares; `--price` adds the money, because a short page is sometimes short on purpose and an automatic invoice for rewriting it is an invoice for work that should not happen. 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
 

package/bin/audit.mjs

@@ -14,6 +14,8 @@
  *       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 draft audit.json [--lang ru|en] [--out audit.json]
+ *       fills the narrative fields from the checks so the analyst edits instead of writing
  *   operstack-audit check audit.json
  *       lists narrative fields still holding placeholders and any score the checks do not support
  *
@@ -23,6 +25,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 { draftNarrative, stillEmpty } from '../src/narrative.mjs';
 import { render, checkNarrative } from '../src/render.mjs';
 import { writeFileSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
@@ -38,6 +41,8 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
     '      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 draft <audit.json> [--lang ru|en] [--out audit.json]',
+    '      fill the narrative from the checks: the analyst edits a draft instead of writing one',
     '  operstack-audit check <audit.json>',
     '      list narrative fields still holding placeholders and any score the checks do not support',
     '',
@@ -45,8 +50,8 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
     '      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',
+    '  operstack-audit foundation-scope <audit.json> [--lang ru|en] [--new-pages 3] [--gsc] [--price] [--out base]',
+    '      the text work the Foundation package would do, page by page; --price also states the money',
   ].join('\n'));
   process.exit(cmd ? 0 : 2);
 }
@@ -76,6 +81,17 @@ 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 === 'draft') {
+  const audit = JSON.parse(readFileSync(resolve(target), 'utf8'));
+  const before = stillEmpty(audit).length;
+  const drafted = draftNarrative(audit, { lang: opt('--lang', audit.meta?.lang || 'en') });
+  const after = stillEmpty(drafted);
+  const out = resolve(opt('--out', target));
+  writeFileSync(out, JSON.stringify(drafted, null, 2));
+  console.log(`${before} field(s) were empty, ${after.length} left`);
+  if (after.length) for (const f of after) console.log(`  still yours to write: ${f}`);
+  console.log(`wrote ${out}`);
+  console.log('read it before sending: the draft states only what was measured, and says so where nothing was.');
 } else if (cmd === 'fix-plan') {
   const audit = JSON.parse(readFileSync(resolve(target), 'utf8'));
   // Язык покупки решает и валюту, и письмо: за доллары платят по английскому списку, за рубли по русскому.
@@ -114,6 +130,7 @@ if (cmd === 'collect') {
     lang,
     newPages: Number(opt('--new-pages', 0)),
     hasSearchConsole: has("--gsc"),
+    withPrice: has('--price'),
     unit: opt('--unit') ? Number(opt('--unit')) : undefined,
     minimum: opt('--minimum') ? Number(opt('--minimum')) : undefined,
     currency: opt('--currency'),
@@ -123,6 +140,7 @@ if (cmd === 'collect') {
   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)` : ''}`);
+  if (scope.withPrice) console.log(`price ${scope.price} ${scope.currency}${scope.atMinimum ? ` (raw ${scope.raw}, lifted to the package minimum)` : ''}`);
+  else console.log('no price in the letter: add --price once the list is agreed and you have decided what to charge');
   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.7.1",
+  "version": "0.8.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",
@@ -13,7 +13,8 @@
     "./package.json": "./package.json",
     "./i18n": "./src/i18n.mjs",
     "./fix": "./src/fix.mjs",
-    "./foundation": "./src/foundation.mjs"
+    "./foundation": "./src/foundation.mjs",
+    "./narrative": "./src/narrative.mjs"
   },
   "files": [
     "bin",
@@ -24,7 +25,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "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",
+    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.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

@@ -59,9 +59,22 @@ function analysePage(url, html) {
       walk(j);
     } catch { schemaTypes.push('(invalid JSON-LD)'); }
   }
+  // Служебная обвязка вырезается, кроме <header>, в котором стоит H1: это шапка статьи, а не сайта.
+  const bodyHtml = (html.match(/<body[\s\S]*<\/body>/i) || [html])[0]
+    .replace(/<(nav|footer|aside|script|style)[\s\S]*?<\/\1>/gi, ' ')
+    .replace(/<header[\s\S]*?<\/header>/gi, (block) => (/<h1[\s>]/i.test(block) ? block : ' '));
+  const plain = (x) => x.replace(/<[^>]+>/g, ' ').replace(/&nbsp;/g, ' ').replace(/\s+/g, ' ').trim();
+  const countWords = (x) => (x.match(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu) || []).length;
   const body = root.querySelector('body');
-  const text = (body?.text ?? '').replace(/\s+/g, ' ').trim();
-  const words = (text.match(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu) || []).length;
+  // Парсер иногда не находит body в большом или неаккуратном HTML и молча возвращает пустой текст,
+  // а пустой текст это приговор «страница пустая». Проверено на css-tricks.com: 178 КБ, body не
+  // найден, слов ноль при живых 978. Поэтому берём тот текст, которого больше: пустоту показывать
+  // клиенту нельзя, это ложное обвинение, за которое он ещё и заплатит в смете.
+  const parsedText = (body?.text ?? '').replace(/\s+/g, ' ').trim();
+  const text = countWords(parsedText) >= countWords(plain(bodyHtml)) ? parsedText : plain((html.match(/<body[\s\S]*<\/body>/i) || [html])[0].replace(/<(script|style)[\s\S]*?<\/\1>/gi, ' '));
+  // Слова считаем по содержимому без меню и подвала: иначе страница из одного абзаца в большом
+  // шаблоне выглядит на три тысячи слов и проверка на пустые страницы не значит ничего.
+  const words = countWords(plain(bodyHtml)) || countWords(text);
   const links = root.querySelectorAll('a[href]').map((a) => a.getAttribute('href') || '');
   const ld = root.querySelectorAll('script[type="application/ld+json"]').map((x) => x.text).join('\n');
   const dates = { published: attr('meta[property="article:published_time"]', 'content') || (ld.match(/"datePublished"\s*:\s*"([^"]+)"/) || [])[1] || '', modified: attr('meta[property="article:modified_time"]', 'content') || (ld.match(/"dateModified"\s*:\s*"([^"]+)"/) || [])[1] || '' };
@@ -108,11 +121,6 @@ function analysePage(url, html) {
     author: /"author"\s*:/.test(ld),
   };
   // Answer-first family, the same measures the free AI visibility check uses, so the two agree.
-  // Site chrome is stripped, except a <header> that carries the H1: that is the article head, not chrome.
-  const bodyHtml = (html.match(/<body[\s\S]*<\/body>/i) || [html])[0]
-    .replace(/<(nav|footer|aside|script|style)[\s\S]*?<\/\1>/gi, ' ')
-    .replace(/<header[\s\S]*?<\/header>/gi, (block) => (/<h1[\s>]/i.test(block) ? block : ' '));
-  const plain = (x) => x.replace(/<[^>]+>/g, ' ').replace(/&nbsp;/g, ' ').replace(/\s+/g, ' ').trim();
   const afterH1 = bodyHtml.split(/<\/h1>/i)[1] || '';
   const firstPara = plain((afterH1.match(/<p[^>]*>([\s\S]*?)<\/p>/i) || ['', ''])[1]);
   const firstParaWords = (firstPara.match(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu) || []).length;
@@ -125,13 +133,18 @@ function analysePage(url, html) {
   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;
+  // Абзацы берём разбором дерева, а не регуляркой: на странице с незакрытым <p> регулярка
+  // склеивает переключатель валют, заголовок и текст в один «абзац с цифрой». Порог в двенадцать
+  // слов отсекает служебные обрывки: цена в карточке это не утверждение, которому нужен источник.
+  const PROSE_WORDS = 12;
+  const paras = (body ? body.querySelectorAll('p') : []).map((el) => ({
+    text: (el.text || '').replace(/\s+/g, ' ').trim(),
+    hrefs: el.querySelectorAll('a[href]').map((a) => a.getAttribute('href') || ''),
+  })).filter((x) => countWords(x.text) >= PROSE_WORDS && /\d/.test(x.text));
+  const figureParagraphs = paras.length;
+  const citedParagraphs = paras.filter((x) => x.hrefs.some((h) => {
+    try { return new URL(h, url).hostname.replace(/^www\./, '') !== ownHostname; } catch { return false; }
+  })).length;
   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 };
 }
 

package/src/foundation.mjs

@@ -13,6 +13,10 @@
  * Чего этот расчёт не знает: какие страницы приносят показы. Это видно только в Search Console,
  * доступ к которой даёт клиент, и это бесплатно. Без доступа мы считаем по выборке и говорим
  * об этом прямо, а не делаем вид, что выбрали важные страницы.
+ *
+ * Деньги в письмо по умолчанию не попадают. Объём работы машина считает честно, а цену называет
+ * человек: короткая страница бывает короткой намеренно, и счёт, выставленный автоматом, окажется
+ * счётом за работу, которой не нужно было делать. Цена включается флагом, осознанно.
  */
 
 /**
@@ -84,13 +88,17 @@ export function buildFoundationScope(audit, opts = {}) {
   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 withPrice = opts.withPrice === true;
 
   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));
+    let issues = PAGE_ISSUES.filter((i) => i.test(p));
+    // Странице, которую пишем заново, незачем отдельной строкой советовать переписать первый
+    // абзац: это та же работа, названная дважды, и в списке она выглядит как две.
+    if (issues.some((i) => i.heavy)) issues = issues.filter((i) => i.heavy);
     if (!issues.length) continue;
     const tier = tierOf(issues);
     pages.push({
@@ -112,7 +120,7 @@ export function buildFoundationScope(audit, opts = {}) {
   const price = Math.max(minimum, raw);
 
   return {
-    lang, currency, unit, minimum, newPages,
+    lang, currency, unit, minimum, newPages, withPrice,
     host: audit.meta?.host,
     checkedAt: audit.meta?.collectedAt,
     sampledPages: sampled.length,
@@ -134,6 +142,9 @@ const T = {
     tier: { rewrite: 'написать заново', rework: 'переработать', touch: 'одна правка' },
     words: (n) => `${n} ${plural(n, 'слово', 'слова', 'слов')}`,
     newPages: (n, s) => `## Новые страницы: ${n}\n\nСтраниц, которых у вас нет, а рынок их спрашивает: ${n}. Каждая считается как страница с нуля, это ${s} ${plural(s, 'доля', 'доли', 'долей')}.`,
+    workHead: '## Объём работы',
+    workBody: (s) => `Всего ${s} ${plural(s, 'доля', 'доли', 'долей')} работы. Доля это работа над одной страницей: одна правка доля, две или три две доли, четыре и больше или пустая страница три. Цену мы назовём отдельно, когда вы согласуете сам список.`,
+    thinWarn: 'Среди них есть страницы короче трёхсот слов. Если такие страницы у вас задуманы короткими, это анонсы, новости или ссылки на чужой материал, скажите, и мы уберём их из списка: писать их заново незачем.',
     priceHead: '## Цена',
     priceBody: (s, u, c, raw) => `Доля работы над одной страницей стоит ${u} ${c}. Долей набралось ${s}, это ${raw} ${c}.`,
     atMin: (min, c) => `Минимум пакета ${min} ${c}, поэтому в счёте будет ${min} ${c}: меньше этой суммы браться нет смысла ни нам, ни вам.`,
@@ -157,6 +168,9 @@ const T = {
     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'}.`,
+    workHead: '## Scope of work',
+    workBody: (s) => `${s} share${s === 1 ? '' : 's'} of work in total. A share is the work on one page: one edit is a share, two or three defects are two, four or more (or an empty page) three. We name the price separately, once you have agreed the list itself.`,
+    thinWarn: 'Some of these are under 300 words. If those pages are meant to be short, link posts, news items, announcements, say so and we will drop them from the list: there is nothing to rewrite.',
     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.`,
@@ -194,11 +208,18 @@ export function renderFoundationScope(scope) {
   }
   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));
+  if (scope.withPrice) {
+    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));
+  } else {
+    L.push(t.workHead);
+    L.push('');
+    L.push(t.workBody(scope.shares));
+  }
+  if (scope.pages.some((p) => p.issues.some((i) => i.id === 'thin'))) { L.push(''); L.push(t.thinWarn); }
   L.push('');
   L.push(t.needHead);
   L.push('');
@@ -216,7 +237,7 @@ export function renderFoundationScope(scope) {
 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}.`, ''];
+    `${scope.lang === 'en' ? 'Shares' : 'Долей'}: ${scope.shares} (${scope.pageShares} + ${scope.newShares} ${scope.lang === 'en' ? 'new' : 'новых'}).${scope.withPrice ? ` ${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}`);

package/src/i18n.mjs

@@ -17,6 +17,8 @@ const plural = (n, one, few, many) => {
   const d = Math.abs(n) % 10; const dd = Math.abs(n) % 100;
   return `${n} ${d === 1 && dd !== 11 ? one : d >= 2 && d <= 4 && (dd < 10 || dd >= 20) ? few : many}`;
 };
+/** Проценты по-русски склоняются: 31 процент, 32 процента, 35 процентов. */
+const pct = (n) => plural(Number(n), 'процент', 'процента', 'процентов');
 const pages = (n) => plural(Number(n), 'страница', 'страницы', 'страниц');
 const pagesOf = (a, b) => `${a} из ${pages(b)}`;
 
@@ -89,7 +91,7 @@ const RU = {
   hreflang: { label: 'hreflang', value: (v) => (/none/.test(v) ? 'нет, сайт одноязычный' : `${plural(Number(nums(v)[0]), 'альтернатива', 'альтернативы', 'альтернатив')}`) },
   cms: { label: 'Движок сайта', value: (v) => v },
   xmlrpc: { label: 'xmlrpc.php', value: (v) => `отвечает ${nums(v)[0]}`, comment: () => 'открытая точка для атак, пользы для поиска никакой' },
-  alt: { label: 'Подписи к картинкам', value: (v) => { const n = nums(v); return `${n[0]} из ${n[1]} картинок имеют подпись, это ${n[2]} процентов, на ${pages(n[3])} выборки`; } },
+  alt: { label: 'Подписи к картинкам', value: (v) => { const n = nums(v); return `${n[0]} из ${n[1]} картинок имеют подпись, это ${pct(n[2])}, на ${pages(n[3])} выборки`; } },
   'h1-sample': { label: 'Структура заголовков', value: (v) => (/one H1 per page/.test(v) ? 'по одному H1 на страницу' : `${nums(v)[0]} из ${pages(nums(v)[1])} имеют больше одного H1`) },
   'dup-titles': { label: 'Повторы заголовков', value: (v) => (/its own title/.test(v) ? 'у каждой проверенной страницы свой заголовок' : `${plural(Number(nums(v)[0]), 'заголовок повторяется', 'заголовка повторяются', 'заголовков повторяются')} на разных страницах`) },
   thin: { label: 'Тонкие страницы', value: (v) => (/median/.test(v) ? `медиана ${plural(Number(nums(v)[0]), 'слово', 'слова', 'слов')} на страницу` : `${nums(v)[0]} из ${pages(nums(v)[1])} короче 300 слов`) },
@@ -103,7 +105,7 @@ const RU = {
   tables: { label: 'Таблицы в тексте', value: (v) => (/no table/.test(v) ? 'на проверенных страницах таблиц нет' : `${nums(v)[0]} из ${pages(nums(v)[1])} выборки используют таблицу`), comment: (c) => (c ? 'таблица это второй по частоте формат цитирования после первого абзаца' : '') },
   sources: { label: 'Названные источники цифр', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки называют, откуда взята цифра, словами или ссылкой рядом с ней`; }, comment: (c) => (c ? 'цифра без источника это первое, что система выбрасывает' : '') },
   dates: { label: 'Открытые даты публикации', value: (v) => (/no article dates/.test(v) ? 'дат в выборке нет: ответные системы не поймут, что здесь актуально' : `${nums(v)[0]} из ${pages(nums(v)[1])} выборки показывают дату`) },
-  'links-profile': { label: 'Профиль внешних ссылок (необязательное дополнение)', value: (v) => { const n = nums(v); return `${plural(Number(n[0]), 'ссылающийся домен', 'ссылающихся домена', 'ссылающихся доменов')}, ${plural(Number(n[1]), 'ссылка', 'ссылки', 'ссылок')}, ${n[2]} процентов передают вес, показатель авторитета ${n[3]} из 100`; }, comment: (c) => `${c.split('.')[0]}. Платный инструмент, для этого отчёта не обязателен и ни в одну оценку не входит.` },
+  'links-profile': { label: 'Профиль внешних ссылок (необязательное дополнение)', value: (v) => { const n = nums(v); return `${plural(Number(n[0]), 'ссылающийся домен', 'ссылающихся домена', 'ссылающихся доменов')}, ${plural(Number(n[1]), 'ссылка', 'ссылки', 'ссылок')}, ${pct(n[2])} передают вес, показатель авторитета ${n[3]} из 100`; }, comment: (c) => `${c.split('.')[0]}. Платный инструмент, для этого отчёта не обязателен и ни в одну оценку не входит.` },
   'trust-entity': { label: 'Кто это, в машиночитаемом виде', value: (v) => (/no postal address/.test(v) ? 'почтового адреса в разметке нет' : 'почтовый адрес опубликован в разметке'), comment: (c) => (c ? 'рейтинговые системы и ответные движки по нему отличают одну компанию от другой' : '') },
   'trust-contact': {
     label: 'Прямые контакты',
@@ -115,7 +117,7 @@ const RU = {
   'trust-policies': { label: 'Политика и условия', value: (v) => (/neither/.test(v) ? 'ни политики конфиденциальности, ни условий на сайте нет' : `есть: ${v.replace(/privacy/g, 'политика').replace(/terms/g, 'условия').replace(/legal/g, 'правовая страница').replace(/cookie/g, 'куки').replace(/disclaimer/g, 'оговорка')}`) },
   'conv-contact-path': { label: 'Способ связаться', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки дают форму, контактную ссылку или страницу контактов`; } },
   'conv-cta': { label: 'Призыв к действию в первом экране', value: (v) => { const n = nums(v); return `${n[0]} из ${pages(n[1])} выборки ставят его в первых ${n[2]} процентах страницы`; }, comment: (c) => (c ? 'читателю, которого убедили сверху, не должно приходиться искать' : '') },
-  'conv-form-depth': { label: 'На какой глубине лежит форма', value: (v) => (/no form/.test(v) ? 'на проверенных страницах формы нет' : /could not be measured/.test(v) ? 'положение формы измерить не удалось' : `медиана ${nums(v)[0]} процентов вниз по странице, измерено на ${pages(nums(v)[1])}`), comment: (c) => (c ? 'на длинной странице дотуда почти никто не доходит, особенно с телефона' : '') },
+  'conv-form-depth': { label: 'На какой глубине лежит форма', value: (v) => (/no form/.test(v) ? 'на проверенных страницах формы нет' : /could not be measured/.test(v) ? 'положение формы измерить не удалось' : `медиана ${pct(nums(v)[0])} вниз по странице, измерено на ${pages(nums(v)[1])}`), comment: (c) => (c ? 'на длинной странице дотуда почти никто не доходит, особенно с телефона' : '') },
   'conv-form-fields': { label: 'Сколько полей просит форма', value: (v) => `медиана ${plural(Number(nums(v)[0]), 'поле', 'поля', 'полей')} до отправки`, comment: (c) => (c ? 'каждое лишнее поле стоит ответов, а телефон дороже всех' : '') },
   'conv-messenger': { label: 'Ссылка на мессенджер', value: (v) => (/none/.test(v) ? 'на проверенных страницах нет' : `на ${nums(v)[0]} из ${pages(nums(v)[1])} выборки`), comment: (c) => (c ? 'для международной аудитории с телефона одна ссылка на мессенджер обычно ценнее формы' : '') },
 };

package/src/index.mjs

@@ -3,3 +3,4 @@ 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';
+export { draftNarrative, stillEmpty } from './narrative.mjs';

package/src/narrative.mjs

@@ -0,0 +1,272 @@
+/**
+ * Черновик текста аудита, собранный из проверок.
+ *
+ * Раньше десятиcтраничный отчёт выходил из сборщика с тридцатью двумя дырами: резюме, приоритеты,
+ * разбор контента, вывод. Их писал человек, то есть каждая продажа стоила часа работы, и продать
+ * десять аудитов в неделю было физически нельзя. Здесь эти дыры закрываются словами, собранными
+ * из тех же цифр, что уже измерены. Аналитику остаётся править, а не писать с нуля.
+ *
+ * Два правила, которые тут важнее всего.
+ *
+ * Первое: ни одного факта о бизнесе клиента мы не выдумываем. Всё, что пишется, либо посчитано
+ * проверками, либо прочитано с самой страницы, и тогда помечено как прочитанное, чтобы аналитик
+ * подтвердил. Там, где знания нет, стоит честная строка «не измеряли», а не догадка.
+ *
+ * Второе: отчёт читает не сеошник. Его читает владелец, который платил агентству, результата не
+ * увидел и теперь разбирается сам. Поэтому каждая мысль сначала объясняется человеческими словами
+ * (что это значит для него и его денег), и только потом называется технически.
+ */
+
+const T = {
+  ru: {
+    subjectFrom: (d) => `По описанию на главной: ${d}. Подтвердите, что это верно.`,
+    subjectNone: 'На главной не сказано, чем занимается компания. Это и есть первая проблема: если это непонятно человеку, это непонятно и поисковику, и ИИ.',
+    unknownLang: 'не указан в коде страниц',
+    sells: (d) => d ? `${d} (взято из описания главной, подтвердите)` : 'из описания на главной не понять, подтвердите',
+    leadWhat: (h, n) => `${h} это сайт из ${n} ${plural(n, 'страницы', 'страниц', 'страниц')}, и он читается машинами: мы открыли его так же, как их открывают поисковик и ИИ.`,
+    leadGood: (areas) => areas.length ? `Хорошо сделано вот что: ${listRu(areas)}.` : 'Ни одна из шести областей пока не выглядит сильной стороной.',
+    leadBad: (area, n) => n ? `Держит сайт назад другое: ${n} ${plural(n, 'проверка провалена', 'проверки провалены', 'проверок провалено')}, тяжелее всего дела в области «${area}».` : `Проваленных проверок нет, но до потолка не хватает мелочей, тяжелее всего в области «${area}».`,
+    verdict: (openN, mech) => openN
+      ? `Главное: ${openN} ${plural(openN, 'вещь мешает', 'вещи мешают', 'вещей мешают')} сайту показываться и попадать в ответы ИИ. Из них ${mech} ${plural(mech, 'правится', 'правятся', 'правятся')} технически, без переписывания текстов, то есть быстро, а ${openN - mech} ${plural(openN - mech, 'потребует', 'потребуют', 'потребуют')} ваших фактов: цифр, источников, ответов на вопросы покупателей.`
+      : 'Главное: критичных поломок нет. Дальше сайт растёт не починкой, а текстами: ответами на вопросы покупателей, цифрами и источниками, по которым вас можно процитировать.',
+    noteOffer: (cta, contact) => `Что видит человек, попавший на сайт: ${cta}. ${contact[0].toUpperCase()}${contact.slice(1)}.`,
+    ctaYes: 'на первом экране есть понятный призыв к действию',
+    ctaNo: 'на первом экране нечего нажать, и это значит, что пришедший уходит',
+    contactYes: 'связаться можно почти с любой страницы',
+    contactNo: 'связаться с большинства страниц нельзя, человеку приходится искать',
+    strengthNone: 'Сильных сторон в текстах проверки не нашли.',
+    weakNone: 'Слабых мест в текстах проверки не нашли.',
+    gapsNone: 'Пробелов по страницам из выборки не видно.',
+    aeoWorksNone: 'Пока ничего из того, что помогает попасть в ответы, на сайте не работает.',
+    aeoBlocksNone: 'Прямых помех для попадания в ответы не нашли.',
+    aeoRec: (p) => p ? `Начните с одной страницы: ${p}. Поставьте в её начало прямой ответ с цифрой и назовите источник этой цифры рядом. Так страницу можно процитировать.` : 'Поставьте в начало каждой важной страницы прямой ответ с цифрой и назовите рядом источник. Цитируют то, что можно вырезать одним абзацем.',
+    geoEntity: ['Кто вы, понятно машине', (ok) => ok ? 'да' : 'нет'],
+    notMeasured: 'не измеряли',
+    geoMentions: 'Упоминания на чужих сайтах',
+    geoReviews: 'Отзывы и публикации',
+    geoMentionsNote: 'Не измеряли: данные о ссылках и упоминаниях продаются за деньги, а мы обещали отчёт только по бесплатным источникам.',
+    geoCallout: (ok) => ok
+      ? 'Роботы, которые достают страницу, чтобы процитировать её в ответе, на сайт пущены. Это половина дела: дальше вопрос в том, есть ли что цитировать.'
+      : 'Роботы, которые достают страницу для цитаты в ответе ИИ, на сайт не пущены. Пока это так, попасть в ответы невозможно физически, чего бы вы ни написали.',
+    offpageListed: (profiles) => profiles.length ? `Заявлены профили: ${profiles.join(', ')}.` : 'Ни одного профиля компании на других площадках в коде сайта не заявлено.',
+    offpageNote: 'Мы не покупаем данные о ссылках, поэтому не пишем ни цифр про их количество, ни оценок за них. Что проверяемо бесплатно: сказал ли сайт сам, где ещё вас искать, и совпадает ли это с реальностью.',
+    convForm: (v) => v,
+    priceRow: 'Цена видна',
+    priceNo: 'на проверенных страницах цены нет',
+    closing: (host, bad) => bad
+      ? `Мы посмотрели ${host} глазами машины и написали, что увидели, без общих слов. Сначала делается то, что чинится технически: это быстро и это видно в цифрах. Потом берутся тексты, и вот там понадобитесь вы, потому что цифры и факты про ваш бизнес знаете только вы.`
+      : `Мы посмотрели ${host} глазами машины. Технически сайт в порядке, чинить нечего, и это честный вывод, а не комплимент. Рост дальше только через тексты: ответы на вопросы покупателей с цифрами и источниками.`,
+    weekFill: 'Больше ничего срочного не нашли',
+    monthFill: 'Тексты по вашим фактам: ответы в начале страниц, источники к цифрам, недостающие страницы',
+    quarterFill: 'Повторная проверка и сравнение с этим отчётом',
+  },
+  en: {
+    subjectFrom: (d) => `From the homepage description: ${d}. Please confirm this is right.`,
+    subjectNone: 'The homepage does not say what the business does. That is the first problem: if a person cannot tell, neither can a search engine or an AI.',
+    unknownLang: 'not declared in the page code',
+    sells: (d) => d ? `${d} (taken from the homepage description, please confirm)` : 'the homepage description does not say, please confirm',
+    leadWhat: (h, n) => `${h} is a site of ${n} page${n === 1 ? '' : 's'}, and it was read the way machines read it: the way a search engine and an AI open it.`,
+    leadGood: (areas) => areas.length ? `What is done well: ${listEn(areas)}.` : 'None of the six areas reads as a strength yet.',
+    leadBad: (area, n) => n ? `What holds it back: ${n} check${n === 1 ? '' : 's'} failed, and the hardest area is "${area}".` : `No check is failing, but the last points are missing, mostly in "${area}".`,
+    verdict: (openN, mech) => openN
+      ? `The point: ${openN} thing${openN === 1 ? '' : 's'} stop this site from being shown and from being quoted by AI. ${mech} of them are mechanical, fixable without rewriting a word, which means quickly; the other ${openN - mech} need your facts: figures, sources, answers to what buyers ask.`
+      : 'The point: nothing is broken. From here the site grows through text, not repair: answers to what buyers ask, figures, and the sources behind them.',
+    noteOffer: (cta, contact) => `What a visitor meets: ${cta}. ${contact[0].toUpperCase()}${contact.slice(1)}.`,
+    ctaYes: 'the first screen has a clear thing to do',
+    ctaNo: 'the first screen has nothing to click, which means arrivals leave',
+    contactYes: 'getting in touch is possible from almost any page',
+    contactNo: 'most pages offer no way to get in touch, so a visitor has to go looking',
+    strengthNone: 'The checks found no strength in the text.',
+    weakNone: 'The checks found no weakness in the text.',
+    gapsNone: 'No gaps are visible across the sampled pages.',
+    aeoWorksNone: 'Nothing that helps a page get quoted is working yet.',
+    aeoBlocksNone: 'Nothing directly blocks a page from being quoted.',
+    aeoRec: (p) => p ? `Start with one page: ${p}. Put a direct answer carrying a figure at the top and name where that figure comes from, right beside it. That is what makes a page quotable.` : 'Put a direct answer carrying a figure at the top of every page that matters, and name the source beside it. What gets quoted is what can be lifted in one paragraph.',
+    notMeasured: 'not measured',
+    geoMentions: 'Mentions elsewhere',
+    geoReviews: 'Reviews and press',
+    geoMentionsNote: 'Not measured: link and mention data is sold for money, and this report was promised on free sources only.',
+    geoCallout: (ok) => ok
+      ? 'The fetchers that pull a page in order to quote it in an answer are allowed in. That is half the job: the rest is whether there is anything worth quoting.'
+      : 'The fetchers that pull a page to quote it in an AI answer are blocked. While that is true, being quoted is physically impossible, whatever you write.',
+    offpageListed: (profiles) => profiles.length ? `Profiles declared: ${profiles.join(', ')}.` : 'The site declares no company profile anywhere else.',
+    offpageNote: 'We do not buy link data, so we print no number of links and no score built on one. What is checkable for free: whether the site says where else to find you, and whether that matches reality.',
+    priceRow: 'Price visible',
+    priceNo: 'no price on the pages we read',
+    closing: (host, bad) => bad
+      ? `We looked at ${host} the way a machine looks at it and wrote down what we saw, without generalities. What gets fixed first is what is mechanical: it is quick and it shows in the numbers. Then comes the text, and there we need you, because only you know the figures and facts of your business.`
+      : `We looked at ${host} the way a machine looks at it. Technically it is in order and there is nothing to repair, and that is a finding, not a compliment. Growth from here comes through text: answers to buyers' questions, with figures and sources.`,
+    weekFill: 'Nothing else is urgent',
+    monthFill: 'Text from your facts: answers at the top of pages, sources beside figures, the pages you are missing',
+    quarterFill: 'A second run, compared against this report',
+  },
+};
+
+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;
+}
+const listRu = (a) => a.length > 1 ? `${a.slice(0, -1).join(', ')} и ${a[a.length - 1]}` : a[0] || '';
+const listEn = (a) => a.length > 1 ? `${a.slice(0, -1).join(', ')} and ${a[a.length - 1]}` : a[0] || '';
+
+/** Проверки, которые Fix закрывает технически: ими меряется «сколько чинится быстро». */
+const MECHANICAL = new Set(['robots', 'robots-block', 'ai-search-access', 'sitemap', 'sitemap-foreign', 'sitemap-health', 'llms', 'title', 'description', 'h1', 'canonical', 'viewport', 'og', 'schema', 'faq-schema', 'org-schema', 'hreflang', 'xmlrpc', 'alt', 'h1-sample', 'dup-titles', 'utility', 'dates', 'trust-entity', 'trust-contact', 'trust-profiles', 'trust-about', 'trust-policies', 'conv-contact-path', 'conv-cta', 'conv-messenger', 'www', 'resources', 'conv-form-depth', 'conv-form-fields']);
+
+import { localiseChecks, AREAS_RU } from './i18n.mjs';
+import { FIX_ACTIONS } from './fix.mjs';
+
+const byId = (checks, id) => (checks || []).find((c) => c.id === id);
+const open = (c) => c && (c.status === 'warn' || c.status === 'bad');
+
+/**
+ * Заполняет пустые поля отчёта словами, собранными из проверок.
+ * @param {object} audit результат collect()
+ * @param {{lang?: 'ru'|'en'}} opts
+ */
+export function draftNarrative(audit, opts = {}) {
+  const lang = opts.lang || audit.meta?.lang || 'en';
+  const t = T[lang === 'ru' ? 'ru' : 'en'];
+  const a = JSON.parse(JSON.stringify(audit));
+  // Отчёт по-русски по английскому аудиту: названия проверок и областей переводим здесь же,
+  // иначе владелец читает русский текст с английскими вставками и перестаёт нам верить.
+  const needsRu = lang === 'ru' && a.meta?.lang !== 'ru';
+  const checks = needsRu ? localiseChecks(a.checks || [], 'ru') : (a.checks || []);
+  const areaName = (k) => (needsRu ? (AREAS_RU[k] || k) : k);
+  const host = a.meta?.host || '';
+  const sample = (a.sample || []).filter((p) => p.title !== undefined);
+  const home = sample[0] || {};
+
+  const bad = checks.filter((c) => c.status === 'bad');
+  const warn = checks.filter((c) => c.status === 'warn');
+  const mechanical = [...bad, ...warn].filter((c) => MECHANICAL.has(c.id)).length;
+  const scores = Object.entries(a.scores || {}).filter(([, v]) => typeof v === 'number');
+  const strong = scores.filter(([, v]) => v >= 8).map(([k]) => areaName(k));
+  const weakest = areaName(scores.slice().sort((x, y) => x[1] - y[1])[0]?.[0] || '');
+
+  // Кто клиент. Имя это адрес сайта, предмет прочитан с главной и помечен как прочитанный.
+  const desc = String(home.description || '').trim().slice(0, 180);
+  a.client.name = a.client.name?.includes('{{') ? host : a.client.name;
+  if (String(a.client.subject).includes('{{')) a.client.subject = desc ? t.subjectFrom(desc) : t.subjectNone;
+
+  // Резюме.
+  if (String(a.summary.lead).includes('{{')) {
+    a.summary.lead = [t.leadWhat(host, sample.length), t.leadGood(strong), t.leadBad(weakest, bad.length)].join(' ');
+  }
+  if (String(a.summary.verdict).includes('{{')) a.summary.verdict = t.verdict(bad.length + warn.length, mechanical);
+  // Приоритет это не название проверки, а действие: владелец должен прочитать и понять, что делать.
+  const actionText = (c) => {
+    const rule = FIX_ACTIONS[c.id];
+    const L = lang === 'ru' ? 'ru' : 'en';
+    if (rule && rule.action) return rule.action[L];
+    // Проверки, которые закрываются только фактами клиента: называем работу, а не оправдание.
+    const TEXT_WORK = {
+      ru: { thin: 'Наполнить короткие страницы фактами: цифрами, условиями, сроками', 'answer-first': 'Поставить в начало страницы прямой ответ с цифрой', sources: 'Подписать к каждой цифре, откуда она взята', sections: 'Разбить страницу на разделы по вопросам читателя', tables: 'Собрать таблицу из ваших данных: таблицы цитируют охотнее абзацев' },
+      en: { thin: 'Fill the short pages with facts: figures, terms, timings', 'answer-first': 'Put a direct answer carrying a figure at the top of the page', sources: 'Name where each figure comes from', sections: 'Break the page into sections that follow the reader\'s questions', tables: 'Build a table from your data: tables get quoted more readily than prose' },
+    };
+    const own = TEXT_WORK[L][c.id];
+    if (own) return own;
+    if (rule && rule.why) return L === 'ru' ? `Это работа с текстами: ${rule.why.ru}` : `This is text work: ${rule.why.en}`;
+    return c.label;
+  };
+  const action = (c) => `${actionText(c)}. ${lang === 'ru' ? 'Сейчас' : 'Now'}: ${c.value}`;
+  const top = [...bad, ...warn].slice(0, 3);
+  a.summary.priorities = (a.summary.priorities || []).map((p, i) => {
+    if (!String(p).includes('{{')) return p;
+    const c = top[i];
+    return c ? action(c) : (lang === 'ru' ? 'Ничего срочного больше не нашли' : 'Nothing else is urgent');
+  });
+
+  // Обзор.
+  a.overview.rows = (a.overview.rows || []).map(([k, v]) => {
+    if (!String(v).includes('{{')) return [k, v];
+    if (/language|язык/i.test(k)) return [k, a.meta?.language || t.unknownLang];
+    if (/sold|продаётся|продается/i.test(k)) return [k, t.sells(desc)];
+    return [k, t.notMeasured];
+  });
+  if (String(a.overview.note).includes('{{')) {
+    const cta = byId(checks, 'conv-cta');
+    const path = byId(checks, 'conv-contact-path');
+    a.overview.note = t.noteOffer(open(cta) ? t.ctaNo : t.ctaYes, open(path) ? t.contactNo : t.contactYes);
+  }
+
+  // Контент, AEO, GEO, ссылки, конверсия: строки собираются из своих же групп проверок.
+  const group = (g) => checks.filter((c) => c.group === g);
+  const fillList = (arr, source, empty) => (arr || []).map((x, i) => {
+    if (!String(x).includes('{{')) return x;
+    const c = source[i];
+    return c ? `${c.label}: ${c.value}` : empty;
+  });
+  a.content.strengths = fillList(a.content.strengths, group('content').filter((c) => c.status === 'ok'), t.strengthNone);
+  a.content.weaknesses = fillList(a.content.weaknesses, group('content').filter(open), t.weakNone);
+  a.content.gaps = fillList(a.content.gaps, group('content').filter((c) => c.status === 'bad'), t.gapsNone);
+  a.aeo.works = fillList(a.aeo.works, group('aeo').filter((c) => c.status === 'ok'), t.aeoWorksNone);
+  a.aeo.blocks = fillList(a.aeo.blocks, group('aeo').filter(open), t.aeoBlocksNone);
+  if (String(a.aeo.recommendation).includes('{{')) {
+    const thinnest = sample.filter((p) => p.answerFirst === false).sort((x, y) => (y.words || 0) - (x.words || 0))[0];
+    a.aeo.recommendation = t.aeoRec(thinnest ? thinnest.url : '');
+  }
+
+  const entity = byId(checks, 'trust-entity') || byId(checks, 'org-schema');
+  a.geo.rows = (a.geo.rows || []).map((row, i) => {
+    const [label, status, detail] = row;
+    if (!String(status).includes('{{') && !String(detail).includes('{{')) return row;
+    if (i === 0) return [label, entity && entity.status === 'ok' ? (lang === 'ru' ? 'да' : 'yes') : (lang === 'ru' ? 'нет' : 'no'), entity ? entity.value : t.notMeasured];
+    if (i === 1) return [t.geoMentions, t.notMeasured, t.geoMentionsNote];
+    return [t.geoReviews, t.notMeasured, t.geoMentionsNote];
+  });
+  if (String(a.geo.callout).includes('{{')) {
+    const fetchers = byId(checks, 'ai-search-access');
+    a.geo.callout = t.geoCallout(!fetchers || fetchers.status === 'ok');
+  }
+
+  const profilesCheck = byId(checks, 'trust-profiles');
+  const profiles = profilesCheck && profilesCheck.status === 'ok' ? String(profilesCheck.value).split(/[,:]/).slice(1).map((s) => s.trim()).filter(Boolean) : [];
+  a.offpage.listed = (a.offpage.listed || []).map((x) => String(x).includes('{{') ? t.offpageListed(profiles) : x);
+  if (String(a.offpage.note).includes('{{')) a.offpage.note = t.offpageNote;
+
+  a.conversion.rows = (a.conversion.rows || []).map(([label, status]) => {
+    if (!String(status).includes('{{')) return [label, status];
+    if (/form|форм/i.test(label)) { const c = byId(checks, 'conv-form-fields') || byId(checks, 'conv-form-depth'); return [label, c ? c.value : t.notMeasured]; }
+    if (/messenger|мессендж/i.test(label)) { const c = byId(checks, 'conv-messenger'); return [label, c ? c.value : t.notMeasured]; }
+    if (/price|цена/i.test(label)) return [label, t.priceNo];
+    return [label, t.notMeasured];
+  });
+
+  // Дорожная карта: недостающие строки берутся из открытых проверок по их же смыслу.
+  const mech = [...bad, ...warn].filter((c) => MECHANICAL.has(c.id));
+  const textWork = [...bad, ...warn].filter((c) => !MECHANICAL.has(c.id));
+  // Строки, которые сборщик уже написал по-английски, в русском отчёте переводим по той же проверке.
+  const labelToCheck = new Map(checks.map((c) => [c.label, c]));
+  const englishLabel = new Map((a.checks || []).map((c, i) => [c.label, checks[i]]));
+  const retitle = (item) => {
+    const m = /^Fix:\s*(.+)$/.exec(String(item));
+    if (!m) return item;
+    const c = labelToCheck.get(m[1]) || englishLabel.get(m[1]);
+    return c ? actionText(c) : item;
+  };
+  a.roadmap = (a.roadmap || []).map((phase, pi) => ({
+    ...phase,
+    items: (phase.items || []).map((item, ii) => {
+      if (!String(item).includes('{{')) return needsRu ? retitle(item) : item;
+      const pool = pi === 0 ? mech : pi === 1 ? textWork : [];
+      const c = pool[ii];
+      if (c) return actionText(c);
+      return pi === 0 ? t.weekFill : pi === 1 ? t.monthFill : t.quarterFill;
+    }),
+  }));
+
+  if (String(a.closing).includes('{{')) a.closing = t.closing(host, bad.length);
+  return a;
+}
+
+/** Что осталось пустым после черновика: аналитик правит только это. */
+export function stillEmpty(audit) {
+  const out = [];
+  const walk = (o, path = '') => {
+    if (typeof o === 'string') { if (o.includes('{{')) out.push(path); return; }
+    if (Array.isArray(o)) { o.forEach((x, i) => walk(x, `${path}[${i}]`)); return; }
+    if (o && typeof o === 'object') for (const k of Object.keys(o)) walk(o[k], path ? `${path}.${k}` : k);
+  };
+  walk(audit);
+  return out;
+}

package/src/test-foundation.mjs

@@ -17,6 +17,7 @@ is('цена без работы ноль долей', clean.shares, 0);
 
 const thin = buildFoundationScope(audit([page({ words: 120 })]));
 is('пустая страница это три доли', thin.pages[0].shares, 3);
+is('и одна работа, а не список повторов', buildFoundationScope(audit([page({ words: 90, answerFirst: false, h2Count: 0, tables: 0 })])).pages[0].issues.map((i) => i.id), ['thin']);
 is('и помечена как «написать заново»', thin.pages[0].tier, 'rewrite');
 
 const one = buildFoundationScope(audit([page({ answerFirst: false })]));
@@ -66,7 +67,20 @@ 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'));
+
+// Деньги в письме только по флагу: цену называет человек, а не машина
+ok('по умолчанию цены в письме нет', !/USD|RUB/.test(letterEn));
+ok('вместо неё объём работы', letterEn.includes('share') && letterEn.includes('name the price separately'));
+const priced = buildFoundationScope(audit([page({ url: 'https://x.ru/a/', words: 100 })]), { lang: 'en', withPrice: true });
+ok('с флагом цена появляется', renderFoundationScope(priced).includes('500 USD'));
+ok('и в чек-листе тоже', renderFoundationChecklist(priced).includes('500 USD'));
+ok('без флага чек-лист без денег', !/USD|RUB/.test(renderFoundationChecklist(en)));
+is('доли считаются в обоих случаях', [en.shares > 0, priced.shares > 0], [true, true]);
+
+// Короткие страницы бывают короткими намеренно, поэтому их просим подтвердить
+const thinLetter = renderFoundationScope(buildFoundationScope(audit([page({ url: 'https://x.ru/n/', words: 90 })])));
+ok('письмо просит подтвердить короткие страницы', thinLetter.includes('задуманы короткими'));
+ok('без коротких страниц такой оговорки нет', !renderFoundationScope(buildFoundationScope(audit([page({ url: 'https://x.ru/a/', answerFirst: false })]))).includes('задуманы короткими'));
 
 // Чек-лист
 const list = renderFoundationChecklist(many);

package/src/test-narrative.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/** Черновик текста аудита: заполняет всё, ничего не выдумывает, читается человеком. */
+import { draftNarrative, stillEmpty } from './narrative.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 audit = (over = {}) => ({
+  meta: { host: 'x.ru', site: 'https://x.ru', collectedAt: '2026-09-11T00:00:00.000Z', lang: 'en', language: '' },
+  client: { name: '{{CLIENT NAME}}', subject: '{{What the site sells and where}}', reportDate: '2026-09-11', preparedBy: 'OperStack' },
+  scores: { 'SEO, technical': 9, 'SEO, content and structure': 4, 'AEO, answers and snippets': 6, 'GEO, visibility in AI systems': 8, 'Off-page and trust': null, 'Conversion and UX': 5 },
+  summary: { lead: '{{a}}', verdict: '{{b}}', priorities: ['{{1}}', '{{2}}', '{{3}}'] },
+  overview: { rows: [['CMS / stack', 'Astro'], ['Pages in sitemap', '40'], ['Language', '{{language}}'], ['What is sold', '{{products}}']], note: '{{note}}' },
+  content: { strengths: ['{{s}}'], weaknesses: ['{{w}}'], gaps: ['{{g}}'] },
+  aeo: { works: ['{{x}}'], blocks: ['{{y}}'], recommendation: '{{r}}' },
+  geo: { rows: [['Entity clarity', '{{s}}', '{{d}}'], ['Third-party mentions', '{{s}}', '{{d}}'], ['Reviews and PR', '{{s}}', '{{d}}']], callout: '{{c}}' },
+  offpage: { listed: ['{{l}}'], note: '{{n}}' },
+  conversion: { rows: [['Contact form', '{{s}}'], ['Price visible', '{{s}}'], ['Messengers', '{{s}}']] },
+  roadmap: [
+    { badge: 'Week 1', title: 'Critical', items: ['Fix: Image alt text', '{{...}}'] },
+    { badge: 'Weeks 2 to 4', title: 'Foundation', items: ['{{...}}'] },
+    { badge: 'Months 2 to 3', title: 'Growth', items: ['{{...}}'] },
+  ],
+  closing: '{{close}}',
+  sample: [{ url: 'https://x.ru/', title: 'Дом', description: 'Мы продаём станки', words: 900, answerFirst: false }],
+  checks: [
+    { id: 'alt', group: 'onpage', label: 'Image alt text', status: 'bad', value: '3 of 10 images carry alt text (30%) across 5 sampled page(s)' },
+    { id: 'thin', group: 'content', label: 'Thin pages in sample', status: 'warn', value: '4 of 20 pages under 300 words' },
+    { id: 'answer-first', group: 'aeo', label: 'Answer-first opening paragraph', status: 'bad', value: '2 of 20 sampled page(s) open with a figure' },
+    { id: 'sources', group: 'aeo', label: 'Sources named in the text', status: 'ok', value: '18 of 20 name a source' },
+    { id: 'dates', group: 'content', label: 'Publication dates exposed', status: 'ok', value: '19 of 20 expose dates' },
+    { id: 'conv-cta', group: 'conversion', label: 'A call to action in the first screen', status: 'bad', value: '1 of 20 put it in the first 30%' },
+    { id: 'conv-messenger', group: 'conversion', label: 'Messenger link', status: 'ok', value: 'telegram found' },
+    { id: 'trust-entity', group: 'trust', label: 'Who the business is', status: 'ok', value: 'city and country in the structured data' },
+    { id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'ok', value: 'every AI search fetcher may read the site' },
+  ],
+  ...over,
+});
+
+const d = draftNarrative(audit(), { lang: 'ru' });
+is('не осталось ни одной дыры', stillEmpty(d), []);
+ok('имя клиента это адрес сайта, а не выдумка', d.client.name === 'x.ru');
+ok('предмет взят с главной и помечен как прочитанный', d.client.subject.includes('Мы продаём станки') && /подтвердите/i.test(d.client.subject));
+
+// Ничего не выдумываем: там, где не мерили, так и написано
+ok('упоминания на чужих сайтах помечены как неизмеренные', d.geo.rows[1][1] === 'не измеряли');
+ok('и объяснено почему', /за деньги/.test(d.geo.rows[1][2]));
+ok('в разделе ссылок сказано, что данные платные', /не покупаем данные/.test(d.offpage.note));
+ok('язык не выдуман, если его нет в коде', /не указан/.test(d.overview.rows[2][1]));
+
+// Числа сходятся между собой
+const openN = 4; const mech = 2; // alt, conv-cta механические; thin и answer-first это тексты
+ok('в выводе число открытых проверок верное', d.summary.verdict.includes(`${openN} вещи`) || d.summary.verdict.includes(`${openN} вещей`));
+ok('и механических не больше, чем всех', d.summary.verdict.includes(`${mech} правятся`) || d.summary.verdict.includes(`${mech} правится`));
+
+// Приоритеты это действие, а не название проверки
+ok('приоритет говорит, что делать', /Проставить подписи/.test(d.summary.priorities[0]));
+ok('и показывает, как сейчас', /Сейчас:/.test(d.summary.priorities[0]));
+ok('работа с текстами названа работой, а не отговоркой', d.summary.priorities.some((p) => /Наполнить короткие страницы|прямой ответ/.test(p)));
+
+// Русский отчёт по английскому аудиту не должен содержать английских названий проверок
+const ruText = JSON.stringify([d.summary, d.content, d.aeo, d.roadmap, d.closing]);
+ok('в русском черновике нет английских названий проверок', !/Image alt text|Thin pages|call to action/.test(ruText));
+ok('области названы по-русски', /техническая часть|Конверсия/.test(d.summary.lead));
+
+// Дорожная карта: уже написанные строки переведены, пустые заполнены
+ok('готовая строка карты переведена', d.roadmap[0].items[0].includes('подписи'));
+ok('пустая строка карты заполнена делом', !d.roadmap[1].items[0].includes('{{'));
+
+// Английский отчёт остаётся английским
+const e = draftNarrative(audit(), { lang: 'en' });
+is('по-английски тоже без дыр', stillEmpty(e), []);
+ok('английский черновик без кириллицы', !/[А-Яа-яЁё]/.test(JSON.stringify([e.summary, e.aeo, e.closing])));
+ok('и приоритет тоже действие', /Write alt text/.test(e.summary.priorities[0]));
+
+// Здоровый сайт: вывод не пугает, а говорит правду
+const clean = draftNarrative(audit({ checks: [
+  { id: 'alt', group: 'onpage', label: 'Image alt text', status: 'ok', value: 'all images carry alt text' },
+  { id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'ok', value: 'allowed' },
+] }), { lang: 'ru' });
+ok('на чистом сайте вывод говорит, что чинить нечего', /критичных поломок нет/.test(clean.summary.verdict));
+ok('и заключение не выдумывает проблем', /нечего/.test(clean.closing));
+
+// Ничего уже написанного человеком не затирается
+const edited = audit();
+edited.summary.lead = 'Текст, который написал аналитик.';
+const keep = draftNarrative(edited, { lang: 'ru' });
+is('правку аналитика черновик не трогает', keep.summary.lead, 'Текст, который написал аналитик.');
+
+// Заблокированные фетчеры это прямой приговор, а не намёк
+const blocked = draftNarrative(audit({ checks: [{ id: 'ai-search-access', group: 'geo', label: 'AI search fetchers allowed', status: 'bad', value: '3 blocked' }] }), { lang: 'ru' });
+ok('если роботы ИИ закрыты, об этом сказано прямо', /невозможно физически/.test(blocked.geo.callout));
+
+if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
+console.log('\nвсе тесты черновика прошли');