dsh-desktop-kit 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +87 -2
  3. package/client.js +3349 -0
  4. package/cordis.patch.yml +5 -0
  5. package/index.js +80 -0
  6. package/package.json +60 -4
  7. package/plugins/dsh-gkb-ru-ui/cordis.patch.yml +6 -0
  8. package/plugins/dsh-gkb-ru-ui/lib/client.js +1083 -0
  9. package/plugins/dsh-gkb-ru-ui/lib/index.js +142 -0
  10. package/plugins/dsh-gkb-ru-ui/lib/skills.js +376 -0
  11. package/plugins/dsh-gkb-ru-ui/package.json +28 -0
  12. package/plugins/dsh-peak-guard/README.md +70 -0
  13. package/plugins/dsh-peak-guard/client.js +741 -0
  14. package/plugins/dsh-peak-guard/cordis.patch.yml +5 -0
  15. package/plugins/dsh-peak-guard/icon.svg +12 -0
  16. package/plugins/dsh-peak-guard/index.js +2 -0
  17. package/plugins/dsh-peak-guard/locale/en.json +6 -0
  18. package/plugins/dsh-peak-guard/locale/ru.json +6 -0
  19. package/plugins/dsh-peak-guard/locale/zh.json +6 -0
  20. package/plugins/dsh-peak-guard/package.json +33 -0
  21. package/plugins/dsh-profile-transfer/README.md +62 -0
  22. package/plugins/dsh-profile-transfer/bootstrap/01-INSTALL.cmd +7 -0
  23. package/plugins/dsh-profile-transfer/bootstrap/README-ARCHIVE.md +54 -0
  24. package/plugins/dsh-profile-transfer/bootstrap/README-/320/243/320/241/320/242/320/220/320/235/320/236/320/222/320/232/320/220.md +42 -0
  25. package/plugins/dsh-profile-transfer/bootstrap/install-on-clean-machine.ps1 +119 -0
  26. package/plugins/dsh-profile-transfer/bootstrap//320/243/320/241/320/242/320/220/320/235/320/236/320/222/320/230/320/242/320/254.cmd +5 -0
  27. package/plugins/dsh-profile-transfer/client.js +806 -0
  28. package/plugins/dsh-profile-transfer/cordis.patch.yml +3 -0
  29. package/plugins/dsh-profile-transfer/icon.svg +13 -0
  30. package/plugins/dsh-profile-transfer/index.js +375 -0
  31. package/plugins/dsh-profile-transfer/locale/en.json +6 -0
  32. package/plugins/dsh-profile-transfer/locale/ru.json +6 -0
  33. package/plugins/dsh-profile-transfer/locale/zh.json +6 -0
  34. package/plugins/dsh-profile-transfer/package.json +36 -0
  35. package/plugins/dsh-profile-transfer/transfer.js +1004 -0
  36. package/plugins/dsh-project-memory/README.md +71 -0
  37. package/plugins/dsh-project-memory/cordis.patch.yml +4 -0
  38. package/plugins/dsh-project-memory/icon.svg +12 -0
  39. package/plugins/dsh-project-memory/index.js +1240 -0
  40. package/plugins/dsh-project-memory/locale/en.json +6 -0
  41. package/plugins/dsh-project-memory/locale/ru.json +6 -0
  42. package/plugins/dsh-project-memory/locale/zh.json +6 -0
  43. package/plugins/dsh-project-memory/package.json +26 -0
  44. package/plugins/dsh-session-move/README.md +67 -0
  45. package/plugins/dsh-session-move/client.js +719 -0
  46. package/plugins/dsh-session-move/cordis.patch.yml +5 -0
  47. package/plugins/dsh-session-move/icon.svg +14 -0
  48. package/plugins/dsh-session-move/index.js +497 -0
  49. package/plugins/dsh-session-move/locale/en.json +6 -0
  50. package/plugins/dsh-session-move/locale/ru.json +6 -0
  51. package/plugins/dsh-session-move/locale/zh.json +6 -0
  52. package/plugins/dsh-session-move/package.json +31 -0
  53. package/skills/code-review-checklist/SKILL.md +37 -0
  54. package/skills/content-writing/README.md +87 -0
  55. package/skills/content-writing/SKILL.md +348 -0
  56. package/skills/content-writing/assets/checklists/fact-check.md +53 -0
  57. package/skills/content-writing/assets/checklists/publish.md +65 -0
  58. package/skills/content-writing/assets/checklists/social.md +40 -0
  59. package/skills/content-writing/assets/templates/article.md +47 -0
  60. package/skills/content-writing/assets/templates/brief.md +44 -0
  61. package/skills/content-writing/assets/templates/doctor-card.md +41 -0
  62. package/skills/content-writing/assets/templates/image-prompts.md +128 -0
  63. package/skills/content-writing/assets/templates/post-telegram.md +36 -0
  64. package/skills/content-writing/assets/templates/post-vk.md +42 -0
  65. package/skills/content-writing/assets/templates/press-release.md +56 -0
  66. package/skills/content-writing/assets/templates/science-pop-note.md +55 -0
  67. package/skills/content-writing/assets/templates/service-card.md +46 -0
  68. package/skills/content-writing/references/anti-ai-style.md +248 -0
  69. package/skills/content-writing/references/editing.md +185 -0
  70. package/skills/content-writing/references/fact-checking.md +205 -0
  71. package/skills/content-writing/references/government-medical.md +246 -0
  72. package/skills/content-writing/references/images.md +212 -0
  73. package/skills/content-writing/references/journalism.md +252 -0
  74. package/skills/content-writing/references/science-popular.md +218 -0
  75. package/skills/content-writing/references/seo-content.md +172 -0
  76. package/skills/content-writing/references/social-media.md +253 -0
  77. package/skills/content-writing/references/templates.md +291 -0
  78. package/skills/database-safety/SKILL.md +31 -0
  79. package/skills/debugging-playbook/SKILL.md +39 -0
  80. package/skills/design-critique/SKILL.md +118 -0
  81. package/skills/dev-workflow/SKILL.md +41 -0
  82. package/skills/git-and-ci/SKILL.md +40 -0
  83. package/skills/pg-upgrade-verify/SKILL.md +48 -0
  84. package/skills/project-deep-dive/SKILL.md +170 -0
  85. package/skills/project-deep-dive/references/recon-commands.md +78 -0
  86. package/skills/project-deep-dive/references/section-templates.md +102 -0
  87. package/skills/project-memory-maintenance/SKILL.md +170 -0
  88. package/skills/project-memory-maintenance/references/journal-template.md +48 -0
  89. package/skills/project-memory-maintenance/references/section-rules.md +57 -0
  90. package/skills/release-and-deploy/SKILL.md +39 -0
  91. package/skills/requirements-and-planning/SKILL.md +115 -0
  92. package/skills/security-review/SKILL.md +36 -0
  93. package/skills/seo/README.md +60 -0
  94. package/skills/seo/SKILL.md +329 -0
  95. package/skills/seo/assets/README.md +66 -0
  96. package/skills/seo/assets/scripts/LICENSE-playwright-core.txt +202 -0
  97. package/skills/seo/assets/scripts/README.md +179 -0
  98. package/skills/seo/assets/scripts/lib/args.mjs +105 -0
  99. package/skills/seo/assets/scripts/lib/browser.mjs +620 -0
  100. package/skills/seo/assets/scripts/lib/zip.mjs +191 -0
  101. package/skills/seo/assets/scripts/seo-audit.mjs +1675 -0
  102. package/skills/seo/assets/snippets/jsonld-breadcrumb.json +30 -0
  103. package/skills/seo/assets/snippets/jsonld-faq.json +39 -0
  104. package/skills/seo/assets/snippets/jsonld-medical-clinic.json +49 -0
  105. package/skills/seo/assets/snippets/jsonld-medical-webpage.json +33 -0
  106. package/skills/seo/assets/snippets/jsonld-organization.json +74 -0
  107. package/skills/seo/assets/snippets/jsonld-physician.json +46 -0
  108. package/skills/seo/assets/snippets/meta.blade.php +61 -0
  109. package/skills/seo/assets/snippets/robots.txt +61 -0
  110. package/skills/seo/assets/snippets/sitemap-urlset-example.xml +72 -0
  111. package/skills/seo/assets/snippets/sitemap.xml +36 -0
  112. package/skills/seo/references/audit-checklist.md +305 -0
  113. package/skills/seo/references/content-seo.md +198 -0
  114. package/skills/seo/references/eeat-medical.md +217 -0
  115. package/skills/seo/references/measurement.md +223 -0
  116. package/skills/seo/references/on-page.md +209 -0
  117. package/skills/seo/references/stack-recipes.md +693 -0
  118. package/skills/seo/references/structured-data.md +485 -0
  119. package/skills/seo/references/technical-seo.md +294 -0
  120. package/skills/service-desk-conventions/SKILL.md +40 -0
  121. package/skills/service-desk-db-safety/SKILL.md +52 -0
  122. package/skills/service-desk-release/SKILL.md +43 -0
  123. package/skills/service-desk-testing/SKILL.md +47 -0
  124. package/skills/service-desk-ui/SKILL.md +33 -0
  125. package/skills/skills-router/SKILL.md +91 -0
  126. package/skills/testing-strategy/SKILL.md +37 -0
  127. package/skills/ui-design-system/SKILL.md +45 -0
  128. package/skills/web-research/SKILL.md +40 -0
  129. package/skills/wow-design/SKILL.md +168 -0
  130. package/skills/wow-design/assets/kit/README.md +195 -0
  131. package/skills/wow-design/assets/kit/assets/css/base.css +158 -0
  132. package/skills/wow-design/assets/kit/assets/css/components.css +1001 -0
  133. package/skills/wow-design/assets/kit/assets/css/fonts.css +73 -0
  134. package/skills/wow-design/assets/kit/assets/css/pages.css +737 -0
  135. package/skills/wow-design/assets/kit/assets/css/tokens.css +218 -0
  136. package/skills/wow-design/assets/kit/assets/fonts/LICENSE-golos-text.txt +93 -0
  137. package/skills/wow-design/assets/kit/assets/fonts/LICENSE-lora.txt +93 -0
  138. package/skills/wow-design/assets/kit/assets/fonts/LICENSE-unbounded.txt +93 -0
  139. package/skills/wow-design/assets/kit/assets/fonts/golos-text-cyrillic-400-normal.woff2 +0 -0
  140. package/skills/wow-design/assets/kit/assets/fonts/golos-text-cyrillic-500-normal.woff2 +0 -0
  141. package/skills/wow-design/assets/kit/assets/fonts/golos-text-cyrillic-600-normal.woff2 +0 -0
  142. package/skills/wow-design/assets/kit/assets/fonts/golos-text-cyrillic-700-normal.woff2 +0 -0
  143. package/skills/wow-design/assets/kit/assets/fonts/golos-text-latin-400-normal.woff2 +0 -0
  144. package/skills/wow-design/assets/kit/assets/fonts/golos-text-latin-500-normal.woff2 +0 -0
  145. package/skills/wow-design/assets/kit/assets/fonts/golos-text-latin-600-normal.woff2 +0 -0
  146. package/skills/wow-design/assets/kit/assets/fonts/golos-text-latin-700-normal.woff2 +0 -0
  147. package/skills/wow-design/assets/kit/assets/fonts/lora-cyrillic-400-italic.woff2 +0 -0
  148. package/skills/wow-design/assets/kit/assets/fonts/lora-cyrillic-400-normal.woff2 +0 -0
  149. package/skills/wow-design/assets/kit/assets/fonts/lora-cyrillic-500-normal.woff2 +0 -0
  150. package/skills/wow-design/assets/kit/assets/fonts/lora-cyrillic-600-normal.woff2 +0 -0
  151. package/skills/wow-design/assets/kit/assets/fonts/lora-latin-400-normal.woff2 +0 -0
  152. package/skills/wow-design/assets/kit/assets/fonts/lora-latin-500-normal.woff2 +0 -0
  153. package/skills/wow-design/assets/kit/assets/fonts/lora-latin-600-normal.woff2 +0 -0
  154. package/skills/wow-design/assets/kit/assets/fonts/unbounded-cyrillic-400-normal.woff2 +0 -0
  155. package/skills/wow-design/assets/kit/assets/fonts/unbounded-cyrillic-500-normal.woff2 +0 -0
  156. package/skills/wow-design/assets/kit/assets/fonts/unbounded-cyrillic-600-normal.woff2 +0 -0
  157. package/skills/wow-design/assets/kit/assets/fonts/unbounded-latin-400-normal.woff2 +0 -0
  158. package/skills/wow-design/assets/kit/assets/fonts/unbounded-latin-500-normal.woff2 +0 -0
  159. package/skills/wow-design/assets/kit/assets/fonts/unbounded-latin-600-normal.woff2 +0 -0
  160. package/skills/wow-design/assets/kit/assets/js/kit.js +550 -0
  161. package/skills/wow-design/assets/kit/pages/dashboard.html +539 -0
  162. package/skills/wow-design/assets/kit/pages/hospital.html +430 -0
  163. package/skills/wow-design/assets/kit/showcase.html +1164 -0
  164. package/skills/wow-design/assets/scripts/LICENSE-axe-core.txt +362 -0
  165. package/skills/wow-design/assets/scripts/LICENSE-playwright-core.txt +202 -0
  166. package/skills/wow-design/assets/scripts/README.md +312 -0
  167. package/skills/wow-design/assets/scripts/audit.mjs +1200 -0
  168. package/skills/wow-design/assets/scripts/capture.mjs +337 -0
  169. package/skills/wow-design/assets/scripts/package.json +30 -0
  170. package/skills/wow-design/references/anti-patterns.md +249 -0
  171. package/skills/wow-design/references/critique-rubric.md +259 -0
  172. package/skills/wow-design/references/design-brief-template.md +46 -0
  173. package/skills/wow-design/references/inspiration.md +200 -0
  174. package/skills/wow-design/references/presets.md +96 -0
  175. package/skills/wow-design/references/principles.md +368 -0
  176. package/skills/wow-design/references/stack-recipes.md +93 -0
  177. package/skills/wow-design/references/visual-qa.md +79 -0
@@ -0,0 +1,179 @@
1
+ # seo-audit — технический SEO-аудитор страницы
2
+
3
+ CLI-инструмент для проверки технического SEO, структурированных данных и Core Web Vitals одной страницы.
4
+ Работает через уже запущенный headless Chrome по CDP (`http://127.0.0.1:9333`) и общую инфраструктуру
5
+ `tools/design-qa/lib` (fallback-запуск браузера там же).
6
+
7
+ | | |
8
+ |---|---|
9
+ | Вход | локальный HTML-файл (`file://`) или URL (`http://`/`https://`) |
10
+ | Выход | `seo-audit.json` + `seo-audit.md` (или `<name>-seo-audit.*`) в `--out` (по умолчанию `tmp/qa-artifacts/`) |
11
+ | Коды выхода | `0` — нет critical/serious; `2` — есть critical/serious; `1` — сбой инструмента |
12
+
13
+ ## Требования
14
+
15
+ - Node.js 24.
16
+ - Chrome с `--remote-debugging-port=9333` (уже запущен в окружении). Если CDP недоступен — auditor
17
+ поднимет `chrome.exe` из `ms-playwright` с временным профилем (см. `tools/design-qa/lib/browser.mjs`).
18
+ - `playwright-core` берётся из `tools/design-qa/node_modules` (общая QA-инфраструктура).
19
+ Ставить ничего не нужно.
20
+ - Переопределения: `--cdp <url>` / env `CDP_URL`, путь к браузеру — env `CHROME_PATH`.
21
+
22
+ ## Быстрый старт
23
+
24
+ ```powershell
25
+ cd %USERPROFILE%\Documents\deepseek-harness\default-workspace
26
+
27
+ # Локальная страница
28
+ node tools/seo-audit/seo-audit.mjs projects/design-kit/pages/hospital.html --name seo-hospital
29
+
30
+ # Реальный сайт (read-only, 1 страница)
31
+ node tools/seo-audit/seo-audit.mjs https://example.org/ --name seo-service-desk --max-links 80
32
+
33
+ # JSON в stdout (для автоматизации), логи — в stderr
34
+ node tools/seo-audit/seo-audit.mjs https://example.org/ --json > seo.json
35
+ ```
36
+
37
+ ## Опции
38
+
39
+ | Опция | Описание |
40
+ |---|---|
41
+ | `--out <dir>` | Каталог отчётов (по умолчанию `tmp/qa-artifacts`) |
42
+ | `--name <name>` | Имена файлов `<name>-seo-audit.json` / `<name>-seo-audit.md`; без `--name` — `seo-audit.json` / `seo-audit.md` |
43
+ | `--viewports <list>` | `desktop` (по умолчанию), `mobile`, или `1440x900,390x844` |
44
+ | `--max-links <n>` | Сколько same-origin ссылок проверить на битость (по умолчанию 80, максимум 400) |
45
+ | `--no-links` | Не проверять битые ссылки (быстрее) |
46
+ | `--no-robots` | Не запрашивать `robots.txt` / `sitemap.xml` |
47
+ | `--serve` | Отдать локальную страницу локальным HTTP-сервером (для `<script type="module">`/fetch) |
48
+ | `--cdp <url>` | CDP-эндпоинт (по умолчанию env `CDP_URL` или `http://127.0.0.1:9333`) |
49
+ | `--timeout <ms>` | Таймаут загрузки страницы (по умолчанию 30000) |
50
+ | `--json` | Полный JSON в stdout (логи — в stderr) |
51
+ | `-h, --help` | Справка |
52
+
53
+ ## Что проверяется
54
+
55
+ ### Meta и индексируемость
56
+ - `title`: наличие, длина 30–65 символов, отсутствие дублей `<title>` на странице;
57
+ - `meta description`: наличие, длина 70–160 символов, дубли;
58
+ - `html lang`: наличие и формат;
59
+ - `meta charset` / кодировка;
60
+ - `meta viewport`: наличие `width=device-width`, не блокируется ли зум;
61
+ - `robots` meta и `X-Robots-Tag`: `noindex` → **critical**, `nofollow` → moderate;
62
+ - `link rel="canonical"`: наличие, ровно один, абсолютный, self-referencing;
63
+ - `robots.txt`, `sitemap.xml` (только для http/https): доступность, `Disallow: /` для `*`,
64
+ наличие URL страницы в sitemap (поддерживается sitemap-index + первый дочерний sitemap).
65
+
66
+ ### Заголовки
67
+ - ровно один непустой `h1` (0 или >1 → serious);
68
+ - порядок `h1 → h2 → h3` без пропуска уровней.
69
+
70
+ ### Open Graph / Twitter
71
+ - `og:title`, `og:description`, `og:image`, `og:url` (отсутствие → moderate);
72
+ - `og:image` абсолютный и не SVG (SVG соцсети не отображают);
73
+ - `twitter:card` (minor).
74
+
75
+ ### JSON-LD schema.org
76
+ - валидность JSON (**critical** при ошибке парсинга), `@context`, `@type`;
77
+ - обязательные поля для типов: `Organization`, `MedicalClinic`/`MedicalOrganization`/`Hospital`/
78
+ `LocalBusiness` (name + address), `MedicalWebPage`, `WebPage`, `WebSite`, `Physician`, `Article`/
79
+ `NewsArticle`/`BlogPosting` (headline + author + datePublished), `FAQPage` (mainEntity → Question →
80
+ acceptedAnswer.text), `BreadcrumbList` (itemListElement → position + name/item), `Product`;
81
+ - поддержка `@graph` и массивов.
82
+
83
+ ### Изображения
84
+ - отсутствие `alt` (важно также для доступности);
85
+ - отсутствие `width`/`height` (риск CLS);
86
+ - `loading="lazy"` ниже первого экрана;
87
+ - доля устаревших форматов (PNG/JPEG/GIF) — рекомендация WebP/AVIF.
88
+
89
+ ### Ссылки
90
+ - пустые анкоры без текста/`aria-label` (moderate);
91
+ - `href="#"`, пустой `href=""`, `javascript:` (moderate/minor);
92
+ - `target="_blank"` без `rel="noopener"` (minor);
93
+ - битые **same-origin** ссылки: HEAD-запрос (при 403/405/501 — GET), `4xx/5xx` и сетевые ошибки →
94
+ **serious**; внешние ссылки не хаммерятся (только считаются);
95
+ - якоря `#id` без цели на странице (moderate);
96
+ - ссылки на `http://` (minor), mixed content на https (serious).
97
+
98
+ ### hreflang
99
+ - формат (`ru`, `en-US`, `x-default`), абсолютность, дубли, наличие `x-default` (minor).
100
+
101
+ ### Производительность / Core Web Vitals
102
+ - **LCP** через PerformanceObserver: >4 c → critical, >2.5 c → serious;
103
+ - **CLS** через PerformanceObserver: >0.25 → serious, >0.1 → moderate;
104
+ - TTFB, число длинных задач, размер HTML (150 КБ / 600 КБ), число запросов (100),
105
+ суммарный вес (3 / 6 МБ), размер DOM (800 / 1500 элементов);
106
+ - render-blocking CSS (>4 в `<head>`) и синхронные скрипты в `<head>`;
107
+ - отсутствие gzip/brotli для HTML (только http/https);
108
+ - **INP** в headless-браузере не измеряется (нет взаимодействий) — отчёт явно это указывает;
109
+ для INP использовать PageSpeed Insights / поле.
110
+
111
+ Severity: `critical` и `serious` влияют на код выхода (2), `moderate`/`minor` — нет.
112
+
113
+ ## Как читать отчёт
114
+
115
+ `seo-audit.md` содержит:
116
+
117
+ 1. **Вердикт** и метрики (LCP, CLS, TTFB, HTML, запросов, вес, DOM, HTTP-статус, код выхода).
118
+ 2. **Что чинить в первую очередь** — топ-10 с готовыми рекомендациями.
119
+ 3. **Сводка по категориям** (critical/serious/moderate/minor по meta, indexing, headings, schema, images, links, performance…).
120
+ 4. Разделы: Meta и индексируемость, Заголовки, JSON-LD, Open Graph/Twitter, Изображения, Ссылки,
121
+ hreflang, Производительность/CWV, Mixed content, robots.txt/sitemap.xml.
122
+ 5. Таблица всех замечаний `severity | id | что не так`.
123
+
124
+ `seo-audit.json` — машиночитаемо: `summary` (counts, verdict, exitCode, metrics),
125
+ `issues[]` (`id`, `severity`, `category`, `help`, `fix`, `nodes`), `pages[]` (сырые данные по каждому
126
+ viewport: meta, headings, images, links, resources, perf), `schema`, `hreflang`, `robots`, `sitemap`,
127
+ `performance`, `meta`, `http`.
128
+
129
+ ## Проверка инструмента на фикстуре
130
+
131
+ `fixtures/bad-seo.html` — намеренно проблемная страница: нет canonical/OG/JSON-LD, два H1, пропуск h2,
132
+ битый JSON-LD, noindex, картинки без alt, битые/пустые ссылки, http-ссылки, дубли title/description,
133
+ 5 render-blocking CSS, блокирующий скрипт.
134
+
135
+ ```powershell
136
+ node tools/seo-audit/seo-audit.mjs tools/seo-audit/fixtures/bad-seo.html --name seo-bad --max-links 20
137
+ # ожидается FAIL (exit 2): ≈2 critical, ≈9–10 serious, ≈10 moderate, ≈5 minor
138
+ ```
139
+
140
+ ## Результаты реальных прогонов (2026-11-04)
141
+
142
+ | страница | вердикт | critical | serious | moderate | minor | LCP | CLS |
143
+ |---|---|---:|---:|---:|---:|---|---|
144
+ | `projects/design-kit/pages/hospital.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 2 | 924 мс | 0.003 |
145
+ | `projects/design-kit/pages/dashboard.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 2 | 136 мс | 0.001 |
146
+ | `projects/design-kit/showcase.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 4 | 984 мс | 0.000 |
147
+ | `https://example.org/` | FAIL | 0 | 3 (canonical, H1 нет, alt у 8 img) | 10 | 6 | 540 мс | 0.004 |
148
+
149
+ Демо-страницы дизайн-кита на `file://` не имеют canonical/OG/JSON-LD и не являются индексируемыми
150
+ продакшн-страницами — для них это ожидаемые замечания, инструмент показывает их корректно.
151
+ Для example.org найдено: нет `<h1>` на главной, нет canonical и JSON-LD, 8 изображений без alt,
152
+ 25 без width/height, 22 ссылки с пустым href, 8 блокирующих скриптов в `<head>`, тяжёлый DOM (3426),
153
+ description 181 символ, `maximum-scale=1` блокирует зум, `og:image` — SVG, sitemap — индекс из 13 файлов.
154
+
155
+ ## Ограничения
156
+
157
+ - Проверяется **одна страница**, это не краулер: не проверяются дубли между страницами, битые ссылки
158
+ на другие страницы (только same-origin HEAD по ссылкам текущей страницы), вложенность.
159
+ - Внешние ссылки не запрашиваются (HEAD только same-origin) — чтобы не создавать нагрузку чужим сайтам.
160
+ - LCP/CLS зависят от окружения (headless + CDP, без троттлинга сети/CPU): сравнивать между итерациями
161
+ в одном окружении, не как абсолютные полевые значения.
162
+ - INP не измеряется (нет пользовательских взаимодействий в headless).
163
+ - `robots.txt`/`sitemap.xml` проверяются только для `http(s)://` (для `file://` — раздел отчёта пуст).
164
+ - Sitemap-index забирает только первый дочерний sitemap (1 доп. запрос), наличие URL в остальных не проверяется.
165
+ - JSON-LD-валидация структурная (поля/типы), без полного schema.org-валидатора и без проверки E-E-A-T/YMYL
166
+ контента; медицинская тематика требует отдельной экспертной проверки (см. скилл `seo`).
167
+ - Инструмент не заменяет PageSpeed Insights / Search Console (полевые данные, реальные пользователи).
168
+
169
+ ## Состав каталога
170
+
171
+ ```
172
+ tools/seo-audit/
173
+ seo-audit.mjs # аудитор
174
+ fixtures/bad-seo.html # фикстура с нарушениями
175
+ README.md # этот файл
176
+ ```
177
+
178
+ Зависимость: `tools/design-qa/lib/{args,browser}.mjs` и `tools/design-qa/node_modules/playwright-core`
179
+ (единая QA-инфраструктура; при переносе инструмента в другой профиль — переносить вместе с `tools/design-qa`).
@@ -0,0 +1,105 @@
1
+ // Мини-парсер CLI-аргументов для инструментов design-qa.
2
+ // Поддерживает: --flag, --no-flag, --key value, --key=value, короткие алиасы (-h),
3
+ // позиционные аргументы (в result._), значения-списки через запятую.
4
+
5
+ export class UsageError extends Error {
6
+ constructor(message) {
7
+ super(message);
8
+ this.name = 'UsageError';
9
+ this.isUsageError = true;
10
+ }
11
+ }
12
+
13
+ const camel = (s) => s.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
14
+
15
+ /**
16
+ * @param {string[]} argv process.argv.slice(2)
17
+ * @param {{booleans?: string[], values?: string[], aliases?: Record<string,string>, defaults?: Record<string, any>}} spec
18
+ */
19
+ export function parseArgs(argv, { booleans = [], values = [], aliases = {}, defaults = {} } = {}) {
20
+ const boolSet = new Set(booleans.map(camel));
21
+ const valueSet = new Set(values.map(camel));
22
+ const aliasMap = new Map(Object.entries(aliases)); // alias -> canonical (camelCase)
23
+ const out = { ...defaults, _: [] };
24
+
25
+ for (let i = 0; i < argv.length; i++) {
26
+ const raw = argv[i];
27
+ if (raw === '--') {
28
+ out._.push(...argv.slice(i + 1));
29
+ break;
30
+ }
31
+ if (raw.startsWith('--') || (raw.startsWith('-') && raw.length === 2 && !/^-?\d/.test(raw))) {
32
+ let body = raw.startsWith('--') ? raw.slice(2) : raw.slice(1);
33
+ let val;
34
+ const eq = body.indexOf('=');
35
+ if (eq !== -1) {
36
+ val = body.slice(eq + 1);
37
+ body = body.slice(0, eq);
38
+ }
39
+
40
+ // --no-xxx для булевых флагов
41
+ if (body.startsWith('no-') && boolSet.has(camel(body.slice(3)))) {
42
+ const key = camel(body.slice(3));
43
+ out[key] = val === undefined ? false : !isTruthy(val);
44
+ continue;
45
+ }
46
+
47
+ const canonical = aliasMap.get(body) ?? camel(body);
48
+ if (boolSet.has(canonical)) {
49
+ out[canonical] = val === undefined ? true : isTruthy(val);
50
+ continue;
51
+ }
52
+ if (valueSet.has(canonical)) {
53
+ if (val === undefined) {
54
+ const next = argv[i + 1];
55
+ if (next === undefined || next.startsWith('--')) {
56
+ throw new UsageError(`Опция ${raw} требует значения`);
57
+ }
58
+ val = next;
59
+ i++;
60
+ }
61
+ out[canonical] = val;
62
+ continue;
63
+ }
64
+ throw new UsageError(`Неизвестная опция ${raw}`);
65
+ }
66
+ out._.push(raw);
67
+ }
68
+ return out;
69
+ }
70
+
71
+ function isTruthy(v) {
72
+ return !['false', '0', 'no', 'off'].includes(String(v).toLowerCase());
73
+ }
74
+
75
+ /** "a,b, c" -> ['a','b','c'] (trim, без пустых, без дублей) */
76
+ export function csv(value) {
77
+ if (value === undefined || value === null) return [];
78
+ const arr = Array.isArray(value) ? value : String(value).split(',');
79
+ const seen = new Set();
80
+ const out = [];
81
+ for (const item of arr) {
82
+ const v = String(item).trim();
83
+ if (v && !seen.has(v)) {
84
+ seen.add(v);
85
+ out.push(v);
86
+ }
87
+ }
88
+ return out;
89
+ }
90
+
91
+ /** Положить строку в безопасное имя файла. */
92
+ export function safeFileName(value, fallback = 'page') {
93
+ const s = String(value ?? '')
94
+ .normalize('NFKD')
95
+ .replace(/[^\w.\-]+/g, '-')
96
+ .replace(/^-+|-+$/g, '')
97
+ .slice(0, 80);
98
+ return s || fallback;
99
+ }
100
+
101
+ /** Вывести строку-справку и завершиться с кодом 0. */
102
+ export function printHelpAndExit(text) {
103
+ process.stdout.write(text.trimEnd() + '\n');
104
+ process.exit(0);
105
+ }