Дмитрий
59f8ca04bb
При первом запуске pre-push hook'ов после установки lefthook (`4eee06f`)
обнаружились 3 проблемы — все легитимны, не в самом lefthook'е:
1. **gitleaks-full-history** ловил 42 хита `ru-phone-unmasked` в HTML-концептах
handoff Платона (liderra_v8_handoff/concepts/v8_*.html и web/v8/v8_*.html).
Это ДЕМО-данные для визуализации, не реальные ПДн. Добавлены в allowlist
.gitleaks.toml: `liderra_v8_handoff/concepts/.*\.html` + `web/v8/.*\.html`
+ `app/composer.lock`.
2. **lychee-links** ловил 21 ошибку «Cannot resolve root-relative link» на
ссылки `/login`, `/register`, `/legal/*` в HTML-концептах. Эти маршруты
появятся только в фазе 2+ (Vue+Vuetify реализация). Сужен glob
pre-push lychee — выкинут `web/**/*.html`. Дополнительно добавлены
`liderra_v8_handoff/concepts` и `web/v8` в .lychee.toml exclude_path
как защита для других вариантов запуска.
3. **2 РЕАЛЬНЫХ битых ссылки** в narrative — спасибо lychee, нашёл:
- `docs/CRM_bp-gr_Инструкция_v8_5.md:6128` ссылался на `brandbook.md`,
но этот файл удалён 08.05.2026 (заменён на `liderra_v8_handoff/docs/
BRANDBOOK_v2.md` v8 Forest). Исправлен относительный путь.
- `README.md:88` ссылался на `docs/README_АРХИВ_v8_4.md`, но переименован
в `_v8_5.md` коммитом `4ffc19a` от 07.05.2026. Поправлено + bump v8.4→v8.5
в подписи.
Финальный smoke-test после правок:
- gitleaks detect (full history): «no leaks found»
- lychee на narrative .md: 122 OK / 0 Errors / 5 Excluded
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
104 lines
5.3 KiB
YAML
104 lines
5.3 KiB
YAML
# =============================================================================
|
||
# lefthook.yml — Лидерра (фаза 0)
|
||
# =============================================================================
|
||
# Документация: https://lefthook.dev
|
||
# Установка хуков: npx lefthook install
|
||
# Удаление хуков: npx lefthook uninstall
|
||
# Ручной pre-commit: npx lefthook run pre-commit
|
||
# Пропуск (один раз): LEFTHOOK=0 git commit -m "..."
|
||
#
|
||
# Принципы (Прил. Н §1):
|
||
# - Pre-commit для быстрых проверок: gitleaks, markdownlint, cspell, Stylelint
|
||
# - Pre-push для медленных: полный gitleaks по истории + lychee
|
||
# - Pa11y — только в CI (требует Chromium)
|
||
# =============================================================================
|
||
|
||
min_version: 2.0.0
|
||
|
||
# Pre-commit: проверки на staged-файлах перед каждым git commit
|
||
pre-commit:
|
||
parallel: false
|
||
jobs:
|
||
# 1. gitleaks — поиск ПДн / токенов / API-ключей в staged
|
||
# Правило §5.2 правил Claude. Блокирует коммит при находке.
|
||
- name: gitleaks
|
||
run: ./bin/gitleaks.exe protect --staged --config .gitleaks.toml --no-banner
|
||
fail_text: |
|
||
gitleaks нашёл потенциальные ПДн / токены / API-ключи в diff.
|
||
Если это маска / тестовое значение — добавь в allowlist .gitleaks.toml.
|
||
Если реальные данные — удали и используй маски (+7XXXXXXXXXX, ***@***).
|
||
|
||
# 2. markdownlint — стиль Markdown с авто-fix
|
||
- name: markdownlint
|
||
glob: "*.md"
|
||
run: npx markdownlint-cli2 --fix {staged_files}
|
||
stage_fixed: true
|
||
fail_text: |
|
||
markdownlint нашёл проблемы, которые не исправляются автоматически.
|
||
Запусти `npm run lint:md:fix` или поправь руками.
|
||
|
||
# 3. cspell — орфография на staged .md
|
||
- name: cspell
|
||
glob: "*.md"
|
||
run: npx cspell --no-progress --no-summary {staged_files}
|
||
fail_text: |
|
||
cspell нашёл слова, отсутствующие в словаре.
|
||
Если это валидное слово проекта — добавь в cspell-words.txt.
|
||
Если опечатка — поправь.
|
||
|
||
# 4. Stylelint — стиль CSS в HTML-прототипах
|
||
- name: stylelint
|
||
glob: "*.html"
|
||
run: npx stylelint {staged_files}
|
||
fail_text: |
|
||
Stylelint нашёл проблемы в CSS прототипа.
|
||
Запусти `npx stylelint --fix <file>` где возможно.
|
||
|
||
# 5. Pint — code style PHP (фаза 1, Прил. Н #11). Авто-fix на staged .php в app/.
|
||
- name: pint
|
||
glob: "app/**/*.php"
|
||
root: "app/"
|
||
run: php vendor/bin/pint {staged_files}
|
||
stage_fixed: true
|
||
fail_text: |
|
||
Pint не смог отформатировать какие-то файлы (синтаксическая ошибка PHP?).
|
||
Запусти `cd app && composer pint` локально, посмотри вывод.
|
||
|
||
# 6. Larastan — статанализ PHP (фаза 1, Прил. Н #12). Полный анализ при любой правке
|
||
# *.php в app/ (точечный анализ только staged-файлов невозможен — phpstan нужен граф
|
||
# классов). Скорость: ~5-10 с на default scaffold + baseline 3.
|
||
- name: larastan
|
||
glob: "app/**/*.php"
|
||
root: "app/"
|
||
run: php vendor/bin/phpstan analyse --no-progress --memory-limit=512M
|
||
fail_text: |
|
||
Larastan нашёл новые ошибки выше baseline.
|
||
Запусти `cd app && composer stan` локально и поправь.
|
||
Если ошибка ложная — обнови `app/phpstan-baseline.neon`
|
||
(см. feedback_environment.md п.25 — генерация baseline в 2 шага).
|
||
|
||
# Pre-push: проверки перед git push (медленнее, но реже запускаются)
|
||
pre-push:
|
||
parallel: false
|
||
jobs:
|
||
# 5. Полный gitleaks-скан всей истории (не только staged)
|
||
- name: gitleaks-full-history
|
||
run: ./bin/gitleaks.exe detect --source . --no-banner --config .gitleaks.toml --redact
|
||
fail_text: |
|
||
gitleaks нашёл утечки в истории коммитов.
|
||
Перед push разберись с каждой находкой.
|
||
|
||
# 6. lychee — проверка ссылок в narrative-доках (.md). HTML-концепты в web/v8/
|
||
# и liderra_v8_handoff/concepts/ намеренно НЕ проверяются — там root-relative
|
||
# ссылки на будущие маршруты Vue+Vuetify (/login, /register, /legal/*).
|
||
- name: lychee-links
|
||
run: ./bin/lychee.exe --config .lychee.toml "docs/**/*.md" "db/**/*.md" "*.md"
|
||
fail_text: |
|
||
lychee нашёл битые ссылки в .md.
|
||
Запусти `npm run links` локально, поправь URL или добавь в `.lychee.toml` exclude.
|
||
|
||
# Подавить служебный вывод
|
||
skip_output:
|
||
- meta
|
||
- skips
|