@operstack/audit 0.32.0 → 0.32.1

package/README.md

@@ -1,3 +1,5 @@
+<img src="https://raw.githubusercontent.com/oper-stack/brand/main/og-audit.png" alt="OperStack audit-generator" width="100%">
+
 # @operstack/audit
 
 The SEO, AEO and GEO audit generator behind the OperStack audit service. It collects the public signals of a site into one JSON file, leaves the narrative to an analyst or an agent, and renders a print-ready report.
@@ -90,10 +92,10 @@ Technically: `draft` fills the narrative fields (`summary`, `client.subject`, `o
 **If you do not edit the site yourself.** Most people who read an audit now fix their site by telling an AI assistant what to do. This turns every finding into a task written for that assistant: copy it, paste it into Cursor or Claude Code, and it does the work. Each task says what the state is today, what to change, and how you will know it is finished, so the assistant cannot wander off and cannot quietly invent facts about your business.
 
 ```
-npx @operstack/audit prompts audit.json --lang en --limit 3
+npx @operstack/audit prompts audit.json --lang en
 ```
 
-Technically: every open check is rendered as a Markdown block with `Now` (the measured value), `Task` (the action and its boundaries) and `How to check` (the acceptance test), plus a standing rule against inventing business facts. Twenty checks carry text written for that specific finding; the rest fall back to the Fix action with a generic acceptance test. `--limit 3` is what the free tier hands out; the full list ships with the paid audit. `renderFixChecklist(plan, { withPrompts: true })` embeds the same tasks in the executor checklist.
+Technically: every open check is rendered as a Markdown block with `Now` (the measured value), `Task` (the action and its boundaries) and `How to check` (the acceptance test), plus a standing rule against inventing business facts. Twenty checks carry text written for that specific finding; the rest fall back to the Fix action with a generic acceptance test. Every open finding becomes a task, and that is the free behaviour: no account, no key, no trimmed preview. `--limit 3` is there when you want only the three tasks that move the score most. The paid audit sells the reading and the work, not the list. `renderFixChecklist(plan, { withPrompts: true })` embeds the same tasks in the executor checklist.
 
 ## The Fix package: turning findings into agreed work
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.32.0",
+  "version": "0.32.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",
@@ -29,7 +29,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.mjs && node src/test-prompts.mjs && node src/test-sitemap.mjs && node src/test-overall.mjs && node src/test-blocked.mjs && node src/test-unmeasured.mjs && node src/test-rendered.mjs && node src/test-sample.mjs && node src/test-demand.mjs && node src/test-agent-surface.mjs && node src/test-agency.mjs && node src/test-i18n.mjs examples/sample-audit.json && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html && node src/test-ru-sources.mjs && node src/test-sample-fairness.mjs && node test-engines.mjs && node test-seo-basics.mjs && node test-polite.mjs && node src/test-handover.mjs",
+    "test": "node src/test-scores.mjs && node src/test-fix.mjs && node src/test-foundation.mjs && node src/test-narrative.mjs && node src/test-prompts.mjs && node src/test-sitemap.mjs && node src/test-overall.mjs && node src/test-blocked.mjs && node src/test-unmeasured.mjs && node src/test-rendered.mjs && node src/test-sample.mjs && node src/test-demand.mjs && node src/test-agent-surface.mjs && node src/test-agency.mjs && node src/test-i18n.mjs examples/sample-audit.json && node bin/audit.mjs check examples/sample-audit.json && node bin/audit.mjs render examples/sample-audit.json --out /tmp/operstack-audit-sample.html && node src/test-ru-sources.mjs && node src/test-sample-fairness.mjs && node test-engines.mjs && node test-seo-basics.mjs && node test-polite.mjs && node src/test-handover.mjs && node src/test-prospect-count.mjs",
     "sample": "node bin/audit.mjs render examples/sample-audit.json --pdf",
     "verify:live": "node src/verify-live.mjs"
   },

package/src/prospect.mjs

@@ -85,9 +85,24 @@ export const OWNER_LINES = {
     en: 'On a phone your page cannot be pinched to zoom: the code forbids it.',
     ru: 'С телефона страницу нельзя увеличить пальцами, масштабирование запрещено в коде.',
   },
+  /*
+   * Фраза от числа (задание Максима 26.09.2026): «Not one page…» стояло и при «5 of 8», то есть
+   * письмо говорило неправду про сайт, где половина страниц в порядке. Число берётся из самой
+   * проверки («5 of 8 sampled page(s) open…»).
+   */
   'answer-first': {
-    en: 'Not one page opens with a short direct answer, and that opening is exactly what gets quoted.',
-    ru: 'Ни на одной странице нет короткого прямого ответа в первом абзаце, а цитируют именно его.',
+    en: (c) => {
+      const [have, of] = countOf(c);
+      return have > 0 && of > have
+        ? `Only ${have} of your ${of} checked pages open with a short direct answer, and that opening is exactly what gets quoted.`
+        : 'Not one page opens with a short direct answer, and that opening is exactly what gets quoted.';
+    },
+    ru: (c) => {
+      const [have, of] = countOf(c);
+      return have > 0 && of > have
+        ? `Короткий прямой ответ в первом абзаце есть только на ${have} из ${of} проверенных страниц, а цитируют именно его.`
+        : 'Ни на одной странице нет короткого прямого ответа в первом абзаце, а цитируют именно его.';
+    },
   },
   'tables': {
     en: 'Your pages have no tables, and a table is the easiest thing for an assistant to lift and quote.',
@@ -164,8 +179,17 @@ const LEAD_ORDER = [
   'conv-form-fields', 'conv-contact-path', 'agent-markdown', 'h1', 'dates', 'utility',
 ];
 
+/** «5 of 8 sampled page(s)…» в находке: сколько страниц в порядке и сколько проверено. */
+function countOf(check) {
+  const m = String(check?.value || '').match(/(\d+)\s+(?:of|из)\s+(\d+)/);
+  return m ? [Number(m[1]), Number(m[2])] : [0, 0];
+}
+
 /** Фраза владельцу на нужном языке. Нет перевода, значит нет фразы, и печатается сама находка. */
-const line = (id, lang = 'en') => (OWNER_LINES[id] || {})[lang === 'ru' ? 'ru' : 'en'] || '';
+const line = (id, lang = 'en', check = null) => {
+  const say = (OWNER_LINES[id] || {})[lang === 'ru' ? 'ru' : 'en'];
+  return (typeof say === 'function' ? say(check) : say) || '';
+};
 
 /** Вес области при подсчёте одной общей оценки. Считаем только то, что правда измерено. */
 const WEIGHT = {
@@ -207,15 +231,15 @@ export function worstFindings(audit, limit = 3, lang = 'en') {
       const s = (SEVERITY[a.status] ?? 2) - (SEVERITY[b.status] ?? 2);
       if (s) return s;
       // При равной тяжести вперёд идёт то, для чего есть фраза владельцу: она и попадёт в письмо.
-      return (line(b.id, lang) ? 1 : 0) - (line(a.id, lang) ? 1 : 0);
+      return (line(b.id, lang, b) ? 1 : 0) - (line(a.id, lang, a) ? 1 : 0);
     });
   return open.slice(0, limit).map((c) => ({
     id: c.id,
     status: c.status,
     label: c.label,
     value: c.value,
-    say: line(c.id, lang) || `${c.label}: ${c.value}`,
-    translated: Boolean(line(c.id, lang)),
+    say: line(c.id, lang, c) || `${c.label}: ${c.value}`,
+    translated: Boolean(line(c.id, lang, c)),
   }));
 }
 

package/src/test-prospect-count.mjs

@@ -0,0 +1,12 @@
+// Фраза про короткий ответ зависит от числа страниц (задание 26.09.2026): «Not one page» только при нуле.
+import assert from 'node:assert/strict';
+import { prospectRow } from './prospect.mjs';
+const audit = (value, status) => ({ meta: { host: 'a.test' }, scores: {}, checks: [{ id: 'answer-first', status, label: 'Answer-first opening paragraph', value }] });
+const warn = prospectRow(audit('5 of 8 sampled page(s) open with 20 to 90 words carrying a figure, right after the H1', 'warn'));
+assert.equal(warn.say, 'Only 5 of your 8 checked pages open with a short direct answer, and that opening is exactly what gets quoted.');
+const bad = prospectRow(audit('0 of 8 sampled page(s) open with 20 to 90 words carrying a figure, right after the H1', 'bad'));
+assert.match(bad.say, /^Not one page opens/);
+const ru = prospectRow(audit('5 of 8 sampled page(s) open with 20 to 90 words carrying a figure, right after the H1', 'warn'), { lang: 'ru' });
+assert.equal(ru.say, 'Короткий прямой ответ в первом абзаце есть только на 5 из 8 проверенных страниц, а цитируют именно его.');
+assert.match(prospectRow(audit('', 'bad')).say, /^Not one page opens/, 'без числа прежняя фраза');
+console.log('test-prospect-count: ok');