dsh-desktop-kit 1.0.0 → 2.0.1

package/skills/wow-design/references/report-template.md

@@ -0,0 +1,21 @@
+# Шаблон отчёта по дизайну
+
+> Часть навыка wow-design. ≈0.4k токенов. Читать, когда: сдаёшь UI-работу и нужен формат отчёта
+> с доказательствами (скриншоты, рубрика, проверки, интеграция).
+
+```markdown
+## Дизайн: <страница / лендинг / дашборд / компонент>
+Арт-направление: <пресет>, <3 слова>, signature: <деталь>
+Что сделано: <3–6 пунктов>
+Скриншоты: <пути: 1440 light, 768, 390, dark, ключевые состояния>
+Рубрика: <средний балл>/5, слабые места: <критерии и оценки>
+Проверено: 1440/768/390, light/dark, axe (critical/serious = 0), keyboard/focus, reduced-motion
+Интеграция: <какие файлы/токены/классы переиспользовать; что не тронуто>
+Риски/что дальше: <1–3 пункта>
+```
+
+Правила:
+- без скриншотов и путей работа не считается сданной;
+- рубрика — средневзвешенный балл, обязательно минимум по критериям;
+- rationale — 3–5 строк: почему такой пресет, шрифт, композиция, signature-деталь;
+- если правился чужой UI — приложить «до/после» и список P0/P1.

package/skills/wow-design/references/stack-recipes.md

@@ -1,5 +1,8 @@
 # Stack Recipes — как встраивать AURORA в реальные проекты
 
+> Часть навыка wow-design. ≈2.3k токенов. Читать, когда: встраиваешь кит в React/Laravel/Bitrix
+> или статический HTML.
+
 > Принцип: **не переписывай проект, а перенеси токены и компоненты**. Сначала посмотри, что уже есть
 > (тема, переменные, UI-кит), и замапь новое на существующее. Ничего не ломать — часть дизайна.
 

package/skills/wow-design/references/visual-qa.md

@@ -1,5 +1,8 @@
 # Visual QA — петля «собрал → снял → раскритиковал → исправил»
 
+> Часть навыка wow-design. ≈1.7k токенов. Читать, когда: запускаешь capture/audit, разбираешь
+> скриншоты, настраиваешь CI или скрипты не стартуют.
+
 > Без скриншотов дизайн не считается проверенным. Глазами по PNG видно то, чего не видно в коде:
 > иерархию, воздух, ритм, «дёшево/дорого», поломки адаптива.
 

package/skills/wow-design/references/wow-levers.md

@@ -0,0 +1,43 @@
+# Рычаги «ВАУ» — 8 приёмов с параметрами
+
+> Часть навыка wow-design. ≈1k токенов. Читать, когда: выбираешь 3–5 приёмов «ВАУ» для страницы
+> и нужны конкретные параметры, чтобы приём не превратился в декор.
+
+Выбирай **3–5 из 8**, не все сразу. Каждый приём должен работать на задачу экрана, а не «чтобы было красиво».
+
+## 1. Типографический контраст — 80% впечатления
+Огромный serif-display + мелкий капс-лейбл с трекингом + спокойный body. Display 56–96px
+(`clamp(3rem,7vw,6rem)`), лейблы 11–12px капсом с трекингом `.12–.14em`, body 16–18px.
+Одна display-пара на страницу; не смешивать два похожих гротеска.
+
+## 2. Редакционная сетка
+Асимметрия 7/5 или 8/4, номерные секции (01/02/03), волосяные линии, поля-воздух. Контейнер
+1200–1360px, 12 колонок, gutter `clamp(20px,4.5vw,56px)`; секции `clamp(64px,8vw,128px)`.
+Сетка должна читаться по краям: всё выровнено по одной линии.
+
+## 3. Одна смелая деталь
+Гигантская цифра/буква, эмблема, вертикальный текст, необычный разделитель — **ровно одна**,
+повторённая в 2–3 местах. Пять «фишек» сразу (градиент + блоб + стекло + 3D + карусель) = шум.
+
+## 4. Материальность
+Тёплая бумага, лёгкое зерно 2–3% (`--grain-opacity:.022`), hairline-бордеры, слоистые тени из
+2 слоёв, без «пластика». Статичные карточки — hairline, тени только у всплывающих слоёв.
+
+## 5. Точные данные
+SVG-графики, sparklines, таблицы с `font-variant-numeric:tabular-nums`, моно-цифры для ID и кодов,
+правые числа. Точность и выравнивание цифр читаются как «дорого» даже без декора.
+
+## 6. Микродетали
+Offset у подчёркиваний, цвет `::selection`, аккуратный скроллбар, видимое фокус-кольцо
+(`2px` + offset `3px`), иконки stroke 1.5–1.6, оптическое выравнивание иконок в строке.
+Мелочи не объясняют — они создают ощущение качества.
+
+## 7. Движение с достоинством
+Reveal 700ms `cubic-bezier(.16,1,.3,1)`, stagger 60ms, hover 180ms; только `transform`/`opacity`.
+Без bounce, parallax-цирка и бесконечных анимаций. `prefers-reduced-motion` отключает всё,
+контент остаётся видимым.
+
+## 8. Копирайт
+Глаголы, конкретика, числа, польза. Заголовок продаёт результат, а не описывает отдел:
+«Запись к кардиологу за 2 минуты», «94% заявок закрыты в SLA». Без «инновационных решений»
+и «команды профессионалов».

package/tools/skill-cost.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+// Token budget report for the bundled skills.
+//
+// Every SKILL.md is loaded whole when the model calls `skill`, so the core file
+// is a hard context cost. This script prints that cost and fails CI when a core
+// crosses the budget, which keeps the library honest as it grows.
+//
+//   node tools/skill-cost.mjs            table + totals
+//   node tools/skill-cost.mjs --json     machine-readable report
+//   node tools/skill-cost.mjs --check     exit 1 when a core exceeds --budget
+import fs from "node:fs";
+import path from "node:path";
+
+const repoRoot = path.resolve(import.meta.dirname, "..");
+const skillsRoot = path.join(repoRoot, "skills");
+const args = process.argv.slice(2);
+const json = args.includes("--json");
+const check = args.includes("--check");
+const budgetIndex = args.indexOf("--budget");
+const budget = budgetIndex >= 0 ? Number(args[budgetIndex + 1]) || 6000 : 6000;
+
+const rows = [];
+for (const entry of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
+  if (!entry.isDirectory()) continue;
+  const file = path.join(skillsRoot, entry.name, "SKILL.md");
+  if (!fs.existsSync(file)) continue;
+  const text = fs.readFileSync(file, "utf8");
+  const bytes = Buffer.byteLength(text, "utf8");
+  let references = 0;
+  let referenceBytes = 0;
+  const refDir = path.join(skillsRoot, entry.name, "references");
+  if (fs.existsSync(refDir)) {
+    for (const reference of fs.readdirSync(refDir, { withFileTypes: true })) {
+      if (!reference.isFile()) continue;
+      references += 1;
+      referenceBytes += fs.statSync(path.join(refDir, reference.name)).size;
+    }
+  }
+  rows.push({
+    name: entry.name,
+    bytes,
+    tokens: Math.round(bytes / 3.2),
+    references,
+    referenceTokens: Math.round(referenceBytes / 3.2),
+  });
+}
+rows.sort((left, right) => right.tokens - left.tokens);
+
+const totalTokens = rows.reduce((sum, row) => sum + row.tokens, 0);
+const totalReferences = rows.reduce((sum, row) => sum + row.referenceTokens, 0);
+const over = rows.filter((row) => row.tokens > budget);
+
+if (json) {
+  console.log(JSON.stringify({ budget, totalTokens, totalReferences, rows, over }, null, 2));
+} else {
+  console.log(`Навыков: ${rows.length}. Ядра: ${totalTokens} токенов, references: ${totalReferences} токенов.`);
+  console.log(`Бюджет ядра: ${budget} токенов${over.length > 0 ? ` · превышают: ${over.length}` : " · все в бюджете"}`);
+  console.log("");
+  const header = ["навык", "ядро", "токены", "refs", "ref-токены"].map((label, index) => label.padEnd(index === 0 ? 30 : 10));
+  console.log(header.join(""));
+  for (const row of rows) {
+    const mark = row.tokens > budget ? " !" : "";
+    console.log([
+      (row.name + mark).padEnd(30),
+      String(row.bytes + " Б").padEnd(10),
+      String(row.tokens).padEnd(10),
+      String(row.references).padEnd(10),
+      String(row.referenceTokens).padEnd(10),
+    ].join(""));
+  }
+}
+
+if (check && over.length > 0) {
+  console.error(`\nПеребор бюджета: ${over.map((row) => `${row.name} (${row.tokens})`).join(", ")}`);
+  process.exit(1);
+}