@operstack/audit 0.21.2 → 0.21.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.21.2",
+  "version": "0.21.4",
   "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",

package/src/render.mjs

@@ -77,7 +77,7 @@ const LABELS = {
       const read = o.basis ? `Прочитано ${p} ${pl} сайта${o.basis.sitemapUnchecked ? ', а карта сайта не ответила вовремя, и это не зачтено ни в плюс, ни в минус' : o.basis.sitemapRead ? ' и его карта' : ''}. ` : '';
       const where = o.source === 'visibility:reused'
         ? `Это ровно то число, которое вы уже видели в бесплатной проверке${o.measuredAt ? ` ${String(o.measuredAt).slice(0, 10)}` : ''}. Здесь оно не меряется заново, поэтому страница, письмо и этот отчёт всегда несут одно число. `
-        : 'Измерено здесь тем же кодом и с теми же настройками, что у бесплатной проверки на oper-stack.com/ai-visibility. ';
+        : 'Измерено здесь тем же кодом и с теми же настройками, что у бесплатной проверки на oper-stack.ru/ai-visibility. ';
       const areas = Array.isArray(o.areas) ? o.areas : [];
       const measured = areas.filter((a) => a.measured !== false && a.score !== null);
       const sumUp = areas.length && measured.length < areas.length

package/src/test-flaky-files.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * Один сбой сети не должен менять балл.
+ *
+ * 15.09.2026 сайт avtokomissar-app.ru получил 52 на русской площадке и 67 на английской с
+ * разницей в две минуты. Движок, его версия и параметры у обеих одинаковые, значит дело было в
+ * самом прогоне: служебные файлы читались по одному разу, и один неудачный ответ решал судьбу
+ * целой области. robots.txt стоит 25 очков, llms.txt 15. Владелец сайта читает такое расхождение
+ * как «вы врёте», и он прав.
+ *
+ * Здесь сервер отдаёт llms.txt отказом только на первый запрос, а со второго нормально. Балл
+ * обязан совпасть с тем, что даёт всегда исправный сервер.
+ *
+ * Сервер поднимается на loopback, а зовётся по имени lvh.me: оно публично указывает на 127.0.0.1,
+ * и так проверка проходит свой же запрет на частные адреса честно, без лазейки в коде продукта.
+ */
+import { createServer } from 'node:http';
+import { lookup } from 'node:dns/promises';
+import { checkVisibility } from './visibility.mjs';
+
+let bad = 0;
+const ok = (n, c) => { if (c) console.log(`ok   ${n}`); else { bad++; console.error(`FAIL ${n}`); } };
+const is = (n, a, b) => ok(`${n} (ждали ${JSON.stringify(b)}, вышло ${JSON.stringify(a)})`, JSON.stringify(a) === JSON.stringify(b));
+
+const PAGE = `<!doctype html><html lang="ru"><head><title>Пример</title><meta name="description" content="Описание"></head>
+<body><main><h1>Пример сайта</h1>${'<p>Обычный абзац текста про товар и услугу, чтобы было что цитировать. </p>'.repeat(40)}</main></body></html>`;
+const LLMS = `# Пример\n\n> Короткое описание сайта.\n\n## Разделы\n\n${Array.from({ length: 6 }, (_, i) => `- [Страница ${i}](http://HOST/p${i}.html): о чём она`).join('\n')}\n`;
+
+/** @param failFirst сколько первых запросов к llms.txt отдать отказом */
+const serve = (failFirst) => new Promise((resolve) => {
+  let asked = 0;
+  const s = createServer((req, res) => {
+    if (req.url.startsWith('/llms.txt')) {
+      asked += 1;
+      if (asked <= failFirst) { res.writeHead(503, { 'content-type': 'text/html' }); res.end('<html>занято</html>'); return; }
+      res.writeHead(200, { 'content-type': 'text/plain; charset=utf-8' });
+      res.end(LLMS.replaceAll('HOST', req.headers.host));
+      return;
+    }
+    if (req.url.startsWith('/robots.txt')) { res.writeHead(200, { 'content-type': 'text/plain' }); res.end('User-agent: *\nAllow: /\n'); return; }
+    res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' }); res.end(PAGE);
+  });
+  s.listen(0, '127.0.0.1', () => resolve({ s, url: `http://lvh.me:${s.address().port}/`, asked: () => asked }));
+});
+
+let dnsOk = true;
+try { const a = await lookup('lvh.me'); dnsOk = a.address === '127.0.0.1'; } catch { dnsOk = false; }
+
+if (!dnsOk) {
+  console.log('ПРОПУЩЕНО: lvh.me не указывает на 127.0.0.1 с этой машины');
+} else {
+  const opts = { budgetMs: 9000, samplePages: 3, lang: 'ru' };
+
+  const good = await serve(0);
+  let clean;
+  try { clean = await checkVisibility(good.url, opts); } finally { good.s.close(); }
+  ok('исправный сервер: проверка прошла', clean.ok === true);
+  const cleanIndex = clean.areas.find((a) => a.id === 'index');
+  ok('и карта для агентов зачтена', cleanIndex.score > 0);
+
+  const flaky = await serve(1);
+  let shaky;
+  try { shaky = await checkVisibility(flaky.url, opts); } finally { flaky.s.close(); }
+  ok('сервер с одним сбоем: проверка прошла', shaky.ok === true);
+  ok('к llms.txt обратились дважды, а не один раз', flaky.asked() >= 2);
+  const shakyIndex = shaky.areas.find((a) => a.id === 'index');
+  is('область карты дала тот же балл', shakyIndex.score, cleanIndex.score);
+  is('и общий балл совпал', shaky.score, clean.score);
+
+  // Постоянный отказ это не сбой сети: область честно остаётся неизмеренной.
+  const dead = await serve(99);
+  let never;
+  try { never = await checkVisibility(dead.url, opts); } finally { dead.s.close(); }
+  const neverIndex = never.areas.find((a) => a.id === 'index');
+  is('при постоянном отказе область не измерена', neverIndex.measured, false);
+  is('и балла у неё нет, а не ноль', neverIndex.score, null);
+  ok('и это не выдаётся за «у вас нет llms.txt»', !neverIndex.findings.some((f) => /Нет llms\.txt/.test(f.text)));
+}
+
+console.log(bad ? `\nПРОВАЛЕНО: ${bad}` : '\nодин сбой сети балл не меняет, постоянный отказ не считается ни в плюс, ни в минус');
+process.exit(bad ? 1 : 0);

package/src/test-i18n.mjs

@@ -56,5 +56,13 @@ is('неизмеренное переводится', localiseBasisNote('not mea
 
 is('английский язык ничего не меняет', localiseChecks(all, 'en'), all);
 
+// Русские тексты не отправляют человека на английский сайт: подпись под баллом вела на
+// oper-stack.com, и русский читатель попадал на страницу и цены не на своём языке.
+{
+  const ru = readFileSync(new URL('./render.mjs', import.meta.url), 'utf8').split('\n')
+    .filter((l) => /[А-Яа-яЁё]/.test(l) && /oper-stack\.com/.test(l) && !l.trim().startsWith('*') && !l.trim().startsWith('//'));
+  is('в русских строках нет ссылок на английский сайт', ru, []);
+}
+
 if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
 console.log(`\nперевод проверен на ${all.length} проверках, всё чисто`);

package/src/visibility.mjs

@@ -383,7 +383,32 @@ export async function checkVisibility(input, { budgetMs = 8500, lang = 'en', sam
   const url = normaliseInput(input);
   if (!url) return { ok: false, error: T.badInput };
   const origin = new URL(url).origin; const host = new URL(url).host;
-  const [home, robotsRes, llmsRes] = await Promise.all([get(url, { timeout: Math.min(6000, left() - 300) }), get(`${origin}/robots.txt`, { timeout: Math.min(4000, left() - 300) }), get(`${origin}/llms.txt`, { timeout: Math.min(4000, left() - 300) })]);
+  /*
+   * Служебные файлы читаются с одним повтором, и это не украшение.
+   *
+   * Один ответ решает судьбу целой области: robots.txt стоит 25 очков, llms.txt 15. До 16.09.2026
+   * повтора не было, и одна неудачная выборка меняла балл на пятнадцать пунктов. 15.09.2026
+   * avtokomissar-app.ru получил 52 на русском сайте и 67 на английском с разницей в две минуты,
+   * при том что движок, версия и параметры у обоих одинаковые. Владелец сайта читает такое
+   * расхождение как «вы врёте», и он прав.
+   *
+   * Повторяем только неопределённый ответ: таймаут, отказ защиты, ошибку сервера. Честные 404 и
+   * 410 значат, что файла правда нет, их переспрашивать незачем и это удвоило бы запросы почти
+   * на каждом сайте.
+   */
+  const settled = (r) => r.ok || r.status === 404 || r.status === 410;
+  const once = (u, ms) => get(u, { timeout: Math.min(ms, left() - 300) });
+  const twice = async (u, ms) => {
+    const first = await once(u, ms);
+    if (settled(first) || left() < 1200) return first;
+    const again = await once(u, Math.min(ms, 2500));
+    return settled(again) ? again : first;
+  };
+  const [home, robotsRes, llmsRes] = await Promise.all([
+    once(url, 6000),
+    twice(`${origin}/robots.txt`, 4000),
+    twice(`${origin}/llms.txt`, 4000),
+  ]);
   if (!home.ok || !/html/i.test(home.type)) {
     // Код 401/403/405/429 это бот-стена, а не сломанный сайт, и это находка сама по себе: та же
     // стена, что развернула эту проверку, разворачивает и роботов ответных систем.