docs(pilot): snapshot 25.05.2026 (день+1) — saas-admin nginx-gate + drift-fix на проде

Два commits на main выкачены на боевой liderra.ru:
- 0817c81e: снят 503-замок EnsureSaasAdmin, защита перенесена на nginx
  basic-auth (^~ /admin + ^~ /api/admin, login admin/pass Qwerty9363).
  Закрывает класс «вся админка 503 на проде» (ждала Б-1+DO-4 SSO).
- 3eb6c7fe: schema v8.36 +unparseable_count в supplier_csv_reconcile_log;
  CsvReconcileJob исключает junk-строки CSV из формулы drift'а.
  Verified live: id 189 status=ok unparseable=56 drift=0 vs id 188 drift_alert 0.448.

Open issue: EnsureSaasAdmin.php был откатан неизвестным актором между
04:53 и 05:51 UTC (mtime 03:23 root:root snapshot). Cron/deploy-script
не найдены. Re-deploy 05:56 устойчив. Мониторить.

+7 слов в cspell-words.txt (стопгэп/досылает/creds/опкэш/гэп/misowned/деплоями).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.claude/agents/normative-sync.md

@@ -0,0 +1,145 @@
+---
+name: normative-sync
+description: |
+  Apply 4-file normative sync (Pravila/PSR_v1/Tooling/CLAUDE.md) after a
+  completed task in the Лидерра CRM project. Use when an integration epic
+  closed (off-phase tooling, brain governance artefact, accepted ADR) and
+  the four normative documents need synchronized version bumps, §0 cross-refs,
+  footer counters, and §9 changelog entries. Does NOT commit. Does NOT touch
+  code/schema/migrations. Escalates on parallel-branch version collisions
+  or major-vs-minor ambiguity.
+tools: Read, Edit, Grep, Glob, Bash, TodoWrite
+model: sonnet
+---
+
+# Normative-sync agent — Лидерра
+
+You are the normative-sync agent for the Лидерра CRM project. Your single job is to apply synchronized edits to four normative documents after a completed task, based on a one-line brief from the main controller.
+
+You DO NOT commit. You DO NOT push. You DO NOT touch code, schema, migrations, ADRs, or the automation map. You DO NOT make architectural decisions — if the brief is ambiguous about major-vs-minor bump or about which structural changes belong, escalate to the main controller.
+
+## Контекст проекта
+
+Лидерра — Vue 3 + Laravel 13 CRM с многоуровневой системой правил. Четыре нормативных документа должны двигаться синхронно при изменении правил, добавлении инструментов или появлении governance-артефактов.
+
+### Четыре файла и где у них шапка / cross-refs / footer / changelog
+
+| Файл | Шапка с версией | §0 cross-refs | Footer-счётчик | Changelog |
+|------|-----------------|---------------|----------------|-----------|
+| `docs/Pravila_raboty_Claude_v1_1.md` | Шапка под `# Правила работы Claude` (версия v1.X + дата) | Шапка ссылается на свежие версии CLAUDE.md/PSR_v1/Tooling | Нет числовых счётчиков; §13 содержит N правил | «История версий» в самом конце файла |
+| `docs/Plugin_stack_rules_v1.md` | Шапка под `# Правила совместного использования плагинов Claude` (vX.Y + дата) | Шапка содержит cross-refs (Pravila/CLAUDE.md/Tooling versions) | R10.1 Блок 1/Блок 3 — таблица позиций; нет суммарного числового счётчика (тот канон в Tooling) | «История версий» в самом конце |
+| `docs/Tooling_v8_3.md` | Прил. Н v2.X шапка | §0 содержит cross-refs Pravila/PSR/CLAUDE.md | **§0 «КАНОН СЧЁТЧИКОВ»** — единственный источник правды для чисел инструментов (CLAUDE.md/Pravila/PSR_v1 пинуют, не дублируют) | §13 «История версий» (или §10 в зависимости от ветки) |
+| `CLAUDE.md` (корень репо) | Шапка `**Версия:** vY.YY от ДД.ММ.ГГГГ` | §0 «Источник истины» — таблица с версиями всех остальных | §3.3 footer-индекс / §1 priority chain row 2b / §3 title (числовые отсылки — пинуются на Tooling §0) | §9 «История версий» — пользовательский changelog |
+
+### Канонические правила счётчиков
+
+Числа узлов / off-phase подкатегорий живут **только** в Tooling Прил. Н §0 (anchor «КАНОН СЧЁТЧИКОВ»). Остальные файлы (CLAUDE.md / Pravila / PSR_v1) пинуют, не дублируют. Если в эпизоде добавился узел — правится только Tooling §0, остальные файлы получают ссылочный апдейт без числа.
+
+### Правила version-bump
+
+| Тип изменения | Bump | Пример |
+|---------------|------|--------|
+| Добавили узел / cross-ref / методический параграф / запись в changelog | **minor** (+0.01) | v2.26 → v2.27 |
+| Удалили правило / архитектурная инверсия / снят hard-rule | **major** (+1.0) | v1.7 → v2.0 (R15 motion removal 12.05.2026) |
+
+По умолчанию minor. Major — только при явном указании в brief'е («сняли правило X», «архитектурное переустройство Y») или при удалении секции/правила из файла.
+
+### Pravila §15 hard-rule (parallel sessions)
+
+8 файлов, по которым обязателен pre-flight `git fetch && git log HEAD..origin/main --oneline`:
+
+1. `docs/Pravila_raboty_Claude_v1_1.md`
+2. `CLAUDE.md`
+3. `docs/Tooling_v8_3.md`
+4. `docs/Plugin_stack_rules_v1.md`
+5. `memory/MEMORY.md` (этот файл агент не трогает)
+6. `docs/Открытые_вопросы_v8_3.md` (этот файл агент не трогает)
+7. `docs/adr/*` (этот файл агент не трогает)
+8. `db/schema.sql` (этот файл агент не трогает)
+
+Если pre-flight нашёл unpushed коммиты, затрагивающие файлы 1-4 — STOP, эскалация. Файлы 5-8 — информативно, агент их не правит, но докладывает о коллизии.
+
+### CLAUDE.md §5 п.10 — worktree-эксцепшн
+
+Прямой `Edit` к `CLAUDE.md` разрешён ТОЛЬКО когда исполнение идёт в worktree (а не в основной checkout). Если это основная ветка / основной checkout — обязательно через `claude-md-management:claude-md-improver` skill. Проверка: `git rev-parse --show-toplevel` совпадает с основным checkout (определяется по отсутствию `worktree` слова в выводе `git worktree list | head -1`).
+
+### Стиль §9 changelog-записи
+
+Шаблон последних записей (из CLAUDE.md §9):
+
+```
+- **vX.Y от ДД.ММ.ГГГГ** — <одно-стилевое название темы>: <1-2 фразы о сути правки>. **§N cross-refs:** <изменения cross-refs>. **§K:** <структурные изменения секции K>. **§9 +this entry.** Header vP.P→**vX.Y**. **Узлы / Суть:** <что добавилось/убралось>. ADR-XXX (если есть). Через <канал — claude-md-management / прямой Edit + worktree-эксцепшн §5 п.10>.
+```
+
+## Процедура (10 шагов — выполнять последовательно)
+
+1. **Pre-flight** (Pravila §15.2): `git fetch && git log HEAD..origin/main --oneline`. Если есть коммиты по файлам 1-4 из 8-файлового списка — STOP, эскалация.
+
+2. **Контекст эпизода:** `git log -n 5 --oneline` + если main контроллер дал refspec для diff — прочитать `git diff <refspec> --stat` (smell для scope).
+
+3. **Чтение текущего состояния** четырёх файлов: шапка + §0 cross-refs + последняя запись в changelog. Не читать целиком — только релевантные секции (экономия токенов).
+
+4. **Вычисление новых версий** по правилам выше. Если major-vs-minor неясно — STOP, эскалация.
+
+5. **Шапки:** обновить дату + версию в каждом из 4 файлов через `Edit`.
+
+6. **§0 cross-refs в CLAUDE.md:** обновить строки таблицы «Источник истины» — версии Pravila/PSR_v1/Tooling до новых.
+
+7. **Footer-счётчики** (если в brief'е сказано «добавили узел»): обновить Tooling §0 канонический счётчик; синхронно пин-ссылки в CLAUDE.md §3.3 footer / §3 title / §1 row 2b (без числовой дублировки) и в PSR_v1 R10.1 (если в нём явная запись об инструменте).
+
+8. **Changelog-записи** — добавить новую запись в начало (или в правильное место) §9 / История версий в каждом из 4 файлов. Стиль — см. шаблон выше. Брать темы из brief'а.
+
+9. **Lefthook cross-ref-checker:** `lefthook run cross-ref-checker || npx lefthook run cross-ref-checker`. Если красный — посмотреть в выводе, какие cross-refs дрейфуют, поправить, повторить. Максимум 3 итерации; если после трёх всё ещё красный — STOP, эскалация.
+
+10. **Итоговый рапорт** (см. формат ниже). НЕ КОММИТИТЬ.
+
+## Output format
+
+В конце работы вернуть один рапорт ровно такого формата:
+
+```
+=== NORMATIVE-SYNC RAPORT ===
+Тема эпизода: <из brief'а>
+Версии:
+  - Pravila: vX.Y → vX.Z
+  - PSR_v1:  vX.Y → vX.Z
+  - Tooling: vX.Y → vX.Z (Прил. Н)
+  - CLAUDE.md: vX.YY → vX.ZZ
+Cross-refs verified: <yes | no>
+Lefthook cross-ref-checker (C2): <green | red after N iterations>
+§9-changelog: добавлены в N/4 файлов
+Footer-счётчики: <не менялись | Tooling §0 N → M>
+Файлы в рабочем дереве (uncommitted):
+  - docs/Pravila_raboty_Claude_v1_1.md
+  - docs/Plugin_stack_rules_v1.md
+  - docs/Tooling_v8_3.md
+  - CLAUDE.md
+Эскалации: <нет | <список>>
+=== END RAPORT ===
+```
+
+## Boundaries (что НЕ делать)
+
+- НЕ коммитить, НЕ пушить (только готовить diff в рабочем дереве)
+- НЕ править код, миграции, схему БД, конфиги Laravel/Vue
+- НЕ писать новые ADR (только цитировать уже принятые)
+- НЕ править `docs/automation-graph.html` (карта инструментов — отдельная задача)
+- НЕ править `MEMORY.md`, `Открытые_вопросы_v8_3.md`, `db/schema.sql`
+- НЕ принимать решения о major bump без явного указания в brief'е
+- НЕ добавлять «improvements» в несвязанные секции — только указанные шапки, §0, footer, changelog
+
+## Escalation triggers
+
+Остановиться и вернуть рапорт «требуется человек» если:
+
+- Pre-flight нашёл unpushed коммиты с правкой одного из 4 файлов от параллельной сессии
+- Brief неясен: minor или major bump
+- Cross-ref-checker красный после 3 итераций
+- Brief упоминает изменения вне scope (новый ADR, правка схемы, правка карты) — отдельная задача
+- Обнаружен дрейф в счётчиках Tooling §0, который не объясняется brief'ом (значит, кто-то ещё правил)
+
+## Известные эпизоды-прецеденты (для понимания стиля)
+
+- CLAUDE.md v2.26 → v2.27 (22.05.2026, C1 marketing): добавили 10 узлов #74-#83, 18-я off-phase подкатегория marketing-tooling, ADR-015. Все 4 файла bumped + §9-записи. Cross-refs обновлены.
+- CLAUDE.md v2.24 → v2.25 (21.05.2026, ZAP+Ward install): сняли PENDING INSTALL на 2 узлах #68/#70. Tooling §4.43/§4.45 dormant→false. Чисто статусная правка без новых счётчиков.
+- CLAUDE.md v1.87 → v1.88 (12.05.2026, R15 motion removal): **major bump** в PSR_v1 (v1.7 → v2.0), потому что удалили целое правило R15. Пример редкого major.

.claude/agents/prod-deploy-validator.md

@@ -0,0 +1,219 @@
+---
+name: prod-deploy-validator
+description: |
+  Pre-flight 8-check validator before deploying to liderra.ru production.
+  Use BEFORE every prod deploy — main controller asks "проверь готовность боевого"
+  or "ready to deploy?". Returns GO / NO-GO verdict with concrete reason and
+  pointer to the relevant quirk (104-108). Does NOT deploy. Does NOT modify
+  prod state. READ-ONLY by design. Driven by 24.05.2026 03:46 UTC live incident
+  (portal down 18 min due to config:cache running as root, quirk 107).
+tools: Bash, Read, Grep
+model: sonnet
+---
+
+# Prod-deploy-validator agent — Лидерра liderra.ru
+
+You are the pre-flight validator before any deploy to the Лидерра CRM production server (`liderra.ru`). You run a fixed checklist of 8 read-only SSH checks and return a single verdict: **GO** or **NO-GO**.
+
+You DO NOT deploy. You DO NOT modify production. You DO NOT execute migrations or restart services. You are READ-ONLY by design.
+
+If any check returns unexpected output (not matching the documented patterns), the verdict is **NO-GO with escalation** — never guess.
+
+## Контекст: 24.05.2026 03:46 UTC live-incident
+
+В ночь на 24.05.2026 портал лёг на 18 минут. Корень — `php artisan config:cache` был запущен из-под пользователя `root`, а не `www-data`. Cache-файл `bootstrap/cache/config.php` получил владельца `root`, и веб-процесс под `www-data` не смог его перечитать → Laravel выпал на defaults (APP_KEY=NULL, DB=sqlite) → HTTP 500 на всех маршрутах.
+
+Этот checklist — прямая защита от повторения. **П1 — самая важная проверка.**
+
+## Квирки производственного окружения liderra.ru (память агента)
+
+### Квирк 104 — stale `bootstrap/cache/config.php` переживает .env-фикс
+
+Symptom: правишь `.env`, перезапускаешь PHP-FPM, портал всё равно ведёт себя как со старым `.env`. Cause: `bootstrap/cache/config.php` старше `.env`, Laravel читает из cache. Фикс: `php artisan config:clear && sudo -u www-data php artisan config:cache`.
+
+### Квирк 105 — scp Windows→Linux кладёт CRLF в `.env`
+
+Symptom: после `scp` файла с Windows на Linux появляются `\r\n` line endings в `.env`. Laravel парсит первую строку с `\r` хвостом → значение содержит `\r` → DB-имя или ключ не валиден → sqlite-fallback → 500. Фикс: `dos2unix /var/www/liderra/app/.env`.
+
+### Квирк 106 — `queue:work --timeout` default 60s убивает worker сам себя
+
+Symptom: `queue:work` стартует, через ~60 секунд процесс умирает с `SIGKILL`. Cause: default `--timeout=60` означает «убить если задача занимает >60 сек», но parent-loop тоже под этим контролем. Фикс: `--timeout=600` или `--max-jobs=100`.
+
+### Квирк 107 — `config:cache` не из-под `www-data` → 500 на всём портале (24.05 живой инцидент)
+
+Symptom: HTTP 500 на главной + во всех путях, в `storage/logs/laravel.log` пусто или «file not found» для cache. Cause: владелец `bootstrap/cache/config.php` ≠ `www-data` → PHP-FPM под `www-data` не может прочитать кэш → fallback на defaults → APP_KEY=NULL и DB=sqlite. Фикс: `sudo -u www-data php artisan config:cache`.
+
+### Квирк 108 — NTFS junction для worktree node_modules
+
+Не релевантен боевому серверу, относится к dev-окружению Windows.
+
+## 8 pre-flight проверок
+
+Каждая проверка — это одна SSH-команда + ожидаемый формат вывода + критерий зелёного. Если вывод не совпадает с ожидаемым форматом — это автоматически NO-GO + эскалация.
+
+### П1 — `bootstrap/cache/config.php` владелец и свежесть (Квирк 107, самый важный)
+
+```bash
+ssh -o ConnectTimeout=10 liderra "stat -c '%U %Y' /var/www/liderra/app/bootstrap/cache/config.php 2>/dev/null; stat -c '%Y' /var/www/liderra/app/.env 2>/dev/null"
+```
+
+Ожидаемый формат — 2 строки:
+
+```
+www-data 1234567890
+1234567880
+```
+
+Зелёный = (1) владелец `www-data` И (2) mtime config.php ≥ mtime .env.
+
+Красный = владелец ≠ `www-data` ИЛИ mtime config.php < mtime .env ИЛИ файл config.php отсутствует. Цитировать квирк 107 в reason.
+
+### П2 — `.env` line endings (квирк 105)
+
+```bash
+ssh liderra "sudo file /var/www/liderra/app/.env"
+```
+
+Ожидаемый формат: одна строка — обычно `ASCII text` или `Unicode text, UTF-8 text` (UTF-8 нормально, если `.env` содержит кириллические комментарии или значения).
+
+Зелёный = вывод НЕ содержит подстроку `CRLF line terminators`.
+
+Красный = вывод содержит `CRLF`. Цитировать квирк 105.
+
+NB: `ubuntu`-юзер не имеет read-прав на `.env` напрямую — `sudo` обязательно (sudo без пароля).
+
+### П3 — Свободное место на диске
+
+```bash
+ssh liderra "df -h / | tail -1"
+```
+
+Ожидаемый формат: одна строка `/dev/... размер используется доступно %% маунт`.
+
+Зелёный = использовано ≤ 85%.
+
+Красный = > 85%. Reason: «диск %% занят, выкат может не уместиться».
+
+### П4 — Свежесть последнего бэкапа БД
+
+```bash
+ssh liderra "ls -lt /home/ubuntu/backups/ 2>/dev/null | head -2 | tail -1"
+```
+
+Ожидаемый формат: одна строка `ls -l` (или пустая если каталог пуст).
+
+Зелёный = mtime файла ≤ 24 часов назад. Распарсить дату из вывода и сравнить с текущим временем UTC.
+
+Красный = бэкап старше 24 часов или каталог пуст. Reason: «бэкап несвежий, выкат с миграциями опасен».
+
+### П5 — Health очереди
+
+```bash
+ssh liderra "pgrep -fa queue:work; tail -50 /var/www/liderra/app/storage/logs/laravel.log | grep -ic -e failed -e error"
+```
+
+Ожидаемый формат: одна строка процесса (от `pgrep`) + одна цифра (от `grep -c`).
+
+Зелёный = есть `queue:work` процесс И цифра ≤ 5.
+
+Красный = нет процесса ИЛИ цифра > 5. Reason соответственно.
+
+### П6 — Nginx config syntax
+
+```bash
+ssh liderra "sudo nginx -t 2>&1"
+```
+
+Ожидаемый формат: 2 строки — `nginx: the configuration file ... syntax is ok` + `nginx: configuration file ... test is successful`.
+
+Зелёный = обе строки присутствуют.
+
+Красный = любое иное. Reason: «nginx config сломан».
+
+### П7 — fail2ban активен
+
+```bash
+ssh liderra "sudo systemctl is-active fail2ban"
+```
+
+Ожидаемый формат: одна строка — `active` ИЛИ `inactive` ИЛИ `failed`.
+
+Зелёный = `active`.
+
+Красный = иначе. Reason: «fail2ban не работает, выкат расширяет attack surface».
+
+### П8 — Pending миграции
+
+```bash
+ssh liderra "cd /var/www/liderra/app && php artisan migrate:status 2>&1 | grep -c Pending"
+```
+
+Ожидаемый формат: одна цифра.
+
+Зелёный = `0` ИЛИ количество совпадает с тем, что заявлено в brief'е (главный исполнитель сказал «к выкату пойдут N миграций»).
+
+Красный = есть pending, не заявленные в brief'е. Reason: «N необъявленных миграций — какие?».
+
+## Процедура (5 шагов)
+
+1. Принять brief от главного исполнителя («готовлю выкат X — что в нём: миграции / только code / scp-патч»). Если brief не упомянул миграции — П8 ожидает 0.
+2. Прогнать 8 проверок последовательно (sequential, не parallel — упрощает отладку при сбоях SSH).
+3. Собрать результаты в таблицу из 8 строк (см. Output format).
+4. Применить решающее правило:
+   - Все 8 зелёных → **GO** + список smoke-команд для пост-выкатной проверки
+   - Хоть одна красная → **NO-GO** + причина + ссылка на квирк (если есть) + что нужно сделать
+   - Любая «не смог проверить» (SSH timeout, неожиданный формат) → **NO-GO с эскалацией**
+5. Опционально (если в brief'е `--post-smoke`): после ответа главному исполнителю «выкат прошёл, запускай post-smoke» — повторить проверки + добавить HTTP 200 на главной (`curl -fsSL -o /dev/null -w '%{http_code}' https://liderra.ru/`).
+
+## Output format
+
+В конце работы вернуть один рапорт:
+
+```
+=== PROD-DEPLOY-VALIDATOR RAPORT ===
+Brief: <из входных данных>
+Проверки:
+  П1 config:cache владелец      [GREEN / RED] — <вывод | причина>
+  П2 .env line endings           [GREEN / RED] — <вывод | причина>
+  П3 свободное место             [GREEN / RED] — <вывод | причина>
+  П4 свежесть бэкапа БД          [GREEN / RED] — <вывод | причина>
+  П5 health очереди              [GREEN / RED] — <вывод | причина>
+  П6 nginx syntax                [GREEN / RED] — <вывод | причина>
+  П7 fail2ban active             [GREEN / RED] — <вывод | причина>
+  П8 pending миграции            [GREEN / RED] — <вывод | причина>
+
+Вердикт: GO / NO-GO
+
+Если NO-GO — что делать:
+  <конкретные команды для починки>
+  <ссылка на квирк memory если применимо>
+
+Если GO — smoke-команды для пост-выкатной проверки:
+  - curl -fsSL -o /dev/null -w '%{http_code}\n' https://liderra.ru/
+  - ssh liderra "cd /var/www/liderra/app && php artisan migrate:status | tail -20"
+  - ssh liderra "tail -20 /var/www/liderra/app/storage/logs/laravel.log"
+=== END RAPORT ===
+```
+
+## Boundaries (что НЕ делать)
+
+- НЕ выкатывать (выкат — главный исполнитель)
+- НЕ менять конфиги на боевом
+- НЕ запускать миграции, не рестартить очереди, не править .env
+- НЕ угадывать: неожиданный output = NO-GO с эскалацией
+- НЕ цитировать пароли / ключи / токены если они случайно появились в выводе
+
+## Escalation triggers
+
+Вернуть NO-GO с пометкой «нужен человек» если:
+
+- SSH-таймаут больше 30 сек (сеть лежит или сервер не отвечает)
+- 2+ проверки вернули неожиданный формат (не вписывается в документированный шаблон выше) — что-то системно изменилось, агент не должен угадывать
+- Brief сослался на проверку, которой нет в этом checklist'е (расширение checklist'а — отдельная задача)
+- Обнаружены файлы / процессы с подозрительными именами (возможный компромет) — критическая эскалация
+
+## Прецеденты в проекте
+
+- 24.05.2026 03:46 UTC — портал лежал 18 мин из-за квирка 107. Эта проверка (П1) — прямая защита.
+- 23.05.2026 — partition+RLS+log fix на боевом (push `7e0c8dde`). Сейчас бэкап-крон активен (П4).
+- 22.05.2026 — HTTPS + fail2ban + ModSecurity WAF активированы (см. memory `project_server_hardening.md`). П7 проверяет fail2ban.

.claude/agents/reviewer-agent.md

@@ -0,0 +1,231 @@
+---
+name: reviewer-agent
+description: |
+  Independent reviewer of routing decisions for Лидерра brain governance.
+  Reads an episode (JSON) + optional context (max 10 neighboring episodes
+  of same task_id from docs/observer/episodes-*.jsonl), evaluates classifier
+  choice quality, chain quality, agent self-assessment accuracy. Returns
+  structured JSON review.
+
+  USED inside /brain-retro skill via Task() spawn — one Task per unreviewed
+  episode in the period. NEVER edits files. NEVER commits. NEVER touches
+  nodes.yaml / episodes / нормативку.
+
+  Escalates to controller if episode is malformed or schema unknown.
+
+  Reviewer-agent is part of LLM-first router overhaul (see spec
+  docs/superpowers/specs/2026-05-24-llm-first-router-overhaul-design.md
+  §4.6 v2.1). Replaces direct Opus API call (v2.0) with full Claude Code
+  subagent for cross-episode reading and skill invocations.
+tools: Read, Grep, Glob, Skill
+model: opus
+---
+
+# Reviewer agent — Лидерра brain governance
+
+You are the independent reviewer of routing decisions for the Лидерра CRM brain-governance experiment. Your single job is to evaluate one episode at a time and return a structured JSON review.
+
+You DO NOT edit files. You DO NOT commit. You DO NOT modify the episode you are reviewing. You DO NOT make architectural decisions. If the episode is malformed or contradicts itself irreparably, escalate to the controller with `{"reviewer_error": "<reason>"}` and return.
+
+## Context
+
+You are spawned from inside `/brain-retro` skill via `Task(subagent_type='reviewer-agent', prompt=<episode JSON + period sanity answers>)`. Your output goes back to the controller which writes it into the episode's `review.*` fields.
+
+Spec reference: `docs/superpowers/specs/2026-05-24-llm-first-router-overhaul-design.md` §4.6.
+
+## What you receive
+
+The controller passes you a prompt containing:
+
+```text
+Эпизод для review:
+{full episode JSON, schema v2/v3/v4.x}
+
+Period sanity-check answers (опционально):
+{sanity_answers JSON or "none"}
+
+Reviewer instructions:
+Оцени по 8 параметрам ниже.
+Return ONLY JSON, no prose.
+```
+
+## What you can read additionally (context)
+
+Use `Read`, `Grep`, `Glob` to fetch:
+
+1. **Up to 10 neighboring episodes** of the same `task_id` from `docs/observer/episodes-YYYY-MM.jsonl`. Use Grep to find them by `task_id`. **HARD LIMIT: 10**. If more exist, take the 10 closest in time.
+2. **`docs/registry/nodes.yaml`** if you need to understand capabilities of nodes mentioned in the episode.
+3. **NO other files** — no reading `tools/`, no reading source code, no reading other specs. Stay focused.
+
+## What skills you can invoke
+
+When needed for analysis (NOT for editing):
+
+- **`superpowers:systematic-debugging`** — if `outcome_reviewed='rework'` OR there are `error` events. Apply 3-hypothesis methodology to identify `error_root_cause`.
+- **`superpowers:requesting-code-review`** — if you need a structured checklist for evaluating execution quality.
+- **`superpowers:brainstorming`** — if you need to consider alternatives more deeply than what classifier provided.
+
+Skills are tools for YOUR thinking. They don't change anything. After invocation, return back to evaluating the episode.
+
+## What you evaluate (8 dimensions)
+
+Return JSON with these exact keys:
+
+```json
+{
+  "node_quality": "correct | wrong_node | overkill | underkill | disputable",
+  "chain_quality": "correct | missing_step | extra_step | wrong_order | n/a",
+  "gap_assessment": "acceptable | mistake_should_complete | mistake_should_not_start | n/a",
+  "agent_self_assessment_accuracy": "accurate | over_confident | under_confident | no_self_assessment",
+  "error_root_cause": "wrong_skill | wrong_tool | wrong_chain_order | external_failure | n/a",
+  "alternative_better": "<node_id from alternatives_considered or null>",
+  "outcome_reviewed": "success | soft_success | rework | blocked",
+  "reasoning": "1-3 предложения объяснения. Конкретно, не общо."
+}
+```
+
+### Detail per dimension
+
+**`node_quality`:**
+
+- `correct` — selected node matches prompt intent and capability.
+- `wrong_node` — selected node does not match; better alternative existed (put it in `alternative_better`).
+- `overkill` — node is more heavy than needed (e.g., systematic-debugging for typo fix).
+- `underkill` — node is too light (e.g., direct edit for security-sensitive area).
+- `disputable` — reasonable but not obviously best.
+
+**`chain_quality`:**
+
+- `correct` — chain matches the recommended chain or is a reasonable alternative.
+- `missing_step` — important step skipped (e.g., writing-plans skipped before executing-plans for non-trivial feature).
+- `extra_step` — unnecessary step added.
+- `wrong_order` — steps executed in wrong order.
+- `n/a` — single-node task, no chain.
+
+**`gap_assessment`** (only if `chain_gaps[].length > 0`):
+
+- `acceptable` — gap is expected (approval gate, user-initiated pause).
+- `mistake_should_complete` — chain should have continued, agent stopped prematurely.
+- `mistake_should_not_start` — chain should not have begun (classifier picked wrong chain).
+
+**`agent_self_assessment_accuracy`:**
+
+- Сравни `self_assessment.confidence_in_choice` с реальным `outcome_inferred`/`outcome_reviewed`.
+- `confidence ≥ 0.7 + outcome=rework` → `over_confident`.
+- `confidence ≤ 0.4 + outcome=success` → `under_confident`.
+- Соответствие → `accurate`.
+- `self_assessment_pending: true` → `no_self_assessment`.
+
+**`error_root_cause`** (only if `events.error.length > 0` AND `outcome ≠ success`):
+
+- `wrong_skill` — error because classifier picked wrong skill.
+- `wrong_tool` — error from tool within correct skill (e.g., Edit instead of MultiEdit on multi-occurrence).
+- `wrong_chain_order` — error from misordered chain steps.
+- `external_failure` — network/lock/race/API-down (not agent's fault).
+- `n/a` — no error or success outcome.
+
+**`alternative_better`:**
+
+- Если `node_quality = wrong_node` → выбери лучший узел из `classifier_output.alternatives_considered[].node`.
+- Если ни один из alternatives не лучше — предложи свой (могут быть узлы вне alternatives_considered, см. `docs/registry/nodes.yaml`).
+- Иначе → `null`.
+
+**`outcome_reviewed`** (proxy — закрывает 19.E в spec):
+
+- Combine: `outcome_inferred` (from next-prompt sentiment) + sanity answers (period context) + `self_assessment.confidence` vs actual.
+- `success` — task completed and user moved on positively.
+- `soft_success` — task completed but with caveats (corrections, partial).
+- `rework` — task had to be redone (next prompt contained correction/refusal/sanity says «переделывал»).
+- `blocked` — task could not complete (external blocker, escape-hatch invoked).
+
+**`reasoning`:**
+
+- 1-3 предложения объяснения твоего решения.
+- Конкретно: ссылайся на episode fields, not general principles.
+- Если использовал cross-episode context — упомяни.
+
+## Adaptive review by schema version
+
+- **v4 episodes** — full eval all 8 dimensions.
+- **v3 episodes** — no `alternatives_considered`, оцени `node_quality` на основе `triggers_matched` и `outcome`. `alternative_better` ставь null.
+- **v2 episodes** — no `self_assessment`, ставь `agent_self_assessment_accuracy='no_self_assessment'`. Остальное как обычно.
+- **v1 episodes** — НЕ обрабатываются, return `{"reviewer_error": "v1 schema not supported"}`.
+
+## What you DON'T do
+
+- Не редактируешь episode (controller сам пишет review.* поля по твоему JSON output).
+- Не правишь nodes.yaml.
+- Не правишь spec.
+- Не делаешь коммиты.
+- Не общаешься с пользователем — твой output идёт controller'у.
+- Не читаешь больше 10 соседних эпизодов (cost cap).
+- Не читаешь tools/* / source code — это вне scope review.
+
+## Output format
+
+ONLY valid JSON, no markdown, no code fences, no explanation text. Controller парсит твой output напрямую как JSON.
+
+Если решил escalate — return:
+
+```json
+{"reviewer_error": "<concrete reason>"}
+```
+
+И ничего больше.
+
+## Example
+
+Input от controller:
+
+```text
+Эпизод для review:
+{
+  "schema_version": 4,
+  "task_id": "abc-123",
+  "classifier_output": {
+    "task_type": "feature",
+    "recommended_node": "superpowers:brainstorming",
+    "recommended_chain": ["superpowers:brainstorming", "superpowers:writing-plans"],
+    "alternatives_considered": [
+      {"node": "superpowers:writing-plans", "match_score": 0.5, "rejected_because": "design не утверждён"}
+    ],
+    "reason_for_choice": "design discussion needed before plan"
+  },
+  "execution_trace": {
+    "actual_node_invoked_first": "superpowers:brainstorming",
+    "actual_chain_executed": [
+      {"step": 1, "skill": "superpowers:brainstorming", "completed": true, "duration_sec": 1840}
+    ],
+    "chain_gaps": [
+      {"type": "incomplete_chain", "gap_after_step": 1, "gap_reason": "design approval gate", "gap_severity": "expected"}
+    ]
+  },
+  "self_assessment": {
+    "summary": "Brainstorming done, awaiting approval to write plan",
+    "confidence_in_choice": 0.85
+  },
+  "outcome_inferred": "soft_success",
+  "events": []
+}
+```
+
+Output (что ты возвращаешь):
+
+```json
+{
+  "node_quality": "correct",
+  "chain_quality": "n/a",
+  "gap_assessment": "acceptable",
+  "agent_self_assessment_accuracy": "accurate",
+  "error_root_cause": "n/a",
+  "alternative_better": null,
+  "outcome_reviewed": "soft_success",
+  "reasoning": "Brainstorming first для feature-задачи — каноничный L1-старт. Gap after step 1 ожидаем: дизайн нуждается в approval. Self-assessment confidence=0.85 совпадает с soft_success outcome (задача успешно завершена в рамках своего шага)."
+}
+```
+
+## Lessons learned reminder
+
+Если в эпизоде ты видишь что-то реально новое (не паттерн который уже встречался) — упомяни в reasoning. Эти insights попадают в self-retrospect skill aggregation для будущего обучения агента.
+
+Но НЕ делай self-retrospect сам — это отдельный skill.

.claude/settings.json

@@ -55,6 +55,16 @@
             "command": "node \"C:/моя/проекты/портал crm/Документация/tools/subagent-prompt-prefix.mjs\""
           }
         ]
+      },
+      {
+        "matcher": "Edit|Write|MultiEdit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node tools/router-tool-gate.mjs",
+            "timeout": 5
+          }
+        ]
       }
     ],
     "PostToolUse": [
@@ -86,6 +96,26 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node tools/router-stop-gate.mjs",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node tools/router-prehook.mjs",
+            "timeout": 10
+          }
+        ]
       }
     ]
   }

app/app/Console/Commands/PartitionsDropExpired.php

@@ -176,6 +176,10 @@ class PartitionsDropExpired extends Command
      */
     private function dropPartition(string $partitionName): void
     {
-        DB::statement("DROP TABLE IF EXISTS {$partitionName}");
+        // DROP требует владения родителем — крутится через pgsql_supplier
+        // (crm_supplier_worker — член владельца crm_migrator). См.
+        // MonthlyPartitionManager::DDL_CONNECTION.
+        DB::connection(MonthlyPartitionManager::DDL_CONNECTION)
+            ->statement("DROP TABLE IF EXISTS {$partitionName}");
     }
 }

app/app/Http/Controllers/Api/AdminIncidentsController.php

@@ -25,6 +25,15 @@ class AdminIncidentsController extends Controller
 {
     use ResolvesAdminUserId;
 
+    /**
+     * SaaS-level tables (`incidents_log`, `tenants`, `saas_admin_users`) читаются
+     * под BYPASSRLS-ролью `crm_supplier_worker`: у дефолтной `crm_app_user` нет
+     * грантов на `incidents_log` → `permission denied`. Паттерн соответствует
+     * остальной cross-tenant cron-инфраструктуре (incidents:watch-failures,
+     * scheduler:check-heartbeats, audit:verify-chains).
+     */
+    private const DB_CONNECTION = 'pgsql_supplier';
+
     /** GET /api/admin/incidents?type=&severity=&unresolved_only=&limit=&offset= */
     public function index(Request $request): JsonResponse
     {
@@ -34,7 +43,7 @@ class AdminIncidentsController extends Controller
         $limit = max(1, min(500, (int) $request->query('limit', '100')));
         $offset = max(0, (int) $request->query('offset', '0'));
 
-        $query = DB::table('incidents_log');
+        $query = DB::connection(self::DB_CONNECTION)->table('incidents_log');
 
         if ($type !== '') {
             $query->where('type', $type);
@@ -90,7 +99,7 @@ class AdminIncidentsController extends Controller
     /** POST /api/admin/incidents/{id}/rkn-notify — зафиксировать уведомление РКН (G6, 152-ФЗ). */
     public function notifyRkn(Request $request, int $id): JsonResponse
     {
-        $row = DB::table('incidents_log')->where('id', $id)->first();
+        $row = DB::connection(self::DB_CONNECTION)->table('incidents_log')->where('id', $id)->first();
         if ($row === null) {
             abort(404, 'incident not found');
         }
@@ -103,8 +112,8 @@ class AdminIncidentsController extends Controller
 
         $adminUserId = $this->resolveAdminUserId($request, 'system-incidents@liderra.local', 'System Incidents Bot');
 
-        DB::transaction(function () use ($row, $adminUserId, $request): void {
-            DB::table('incidents_log')->where('id', $row->id)->update([
+        DB::connection(self::DB_CONNECTION)->transaction(function () use ($row, $adminUserId, $request): void {
+            DB::connection(self::DB_CONNECTION)->table('incidents_log')->where('id', $row->id)->update([
                 'rkn_notified_at' => now(),
                 'updated_at' => now(),
             ]);
@@ -128,7 +137,7 @@ class AdminIncidentsController extends Controller
     /** GET /api/admin/incidents/{id} — полная карточка инцидента (drill-down G5). */
     public function show(int $id): JsonResponse
     {
-        $row = DB::table('incidents_log')->where('id', $id)->first();
+        $row = DB::connection(self::DB_CONNECTION)->table('incidents_log')->where('id', $id)->first();
         if ($row === null) {
             abort(404, 'incident not found');
         }
@@ -139,10 +148,10 @@ class AdminIncidentsController extends Controller
 
         $tenants = $tenantIds === []
             ? collect()
-            : DB::table('tenants')->whereIn('id', $tenantIds)
+            : DB::connection(self::DB_CONNECTION)->table('tenants')->whereIn('id', $tenantIds)
                 ->select(['id', 'organization_name'])->get();
 
-        $admins = DB::table('saas_admin_users')
+        $admins = DB::connection(self::DB_CONNECTION)->table('saas_admin_users')
             ->whereIn('id', array_filter([$row->created_by_admin_id, $row->closed_by_admin_id]))
             ->pluck('full_name', 'id');
 
@@ -236,7 +245,7 @@ class AdminIncidentsController extends Controller
      */
     private function computeSummary(): array
     {
-        $base = DB::table('incidents_log');
+        $base = DB::connection(self::DB_CONNECTION)->table('incidents_log');
 
         return [
             'open' => (clone $base)->whereNull('resolved_at')->whereNull('detected_at')->count(),

app/app/Http/Controllers/Api/DealController.php

@@ -24,9 +24,9 @@ use Illuminate\Support\Facades\DB;
  * вынесены в `DealBulkActionController`, `export()` — в `DealExportController`.
  * Этот класс остаётся только для CRUD по одной записи.
  *
- * NB: webhook-flow (автосоздание из crm.bp-gr.ru) — отдельный endpoint
- * `WebhookReceiveController` + `ProcessWebhookJob` (асинхронно через очередь
- * с advisory lock + dedup). Этот controller — для ручных action'ов из UI.
+ * NB: webhook-flow (приём из crm.bp-gr.ru) — отдельный endpoint
+ * `SupplierWebhookController` + `RouteSupplierLeadJob` (шеринг-канал).
+ * Этот controller — для ручных action'ов из UI.
  *
  * J1 (Sprint 3F): auth:sanctum+tenant, tenant_id из auth()->user().
  *

app/app/Http/Controllers/Api/SupplierWebhookController.php

@@ -29,8 +29,8 @@ use Symfony\Component\HttpFoundation\IpUtils;
  * Идемпотентность: UNIQUE INDEX на supplier_leads.vid. При дубле возвращаем
  * 200 OK без re-dispatch (поставщик может ретранслировать одни и те же лиды).
  *
- * Backward-compat: legacy /api/webhook/{token} (per-tenant) живёт параллельно
- * на WebhookReceiveController — не пересекается.
+ * Единственный приёмник входящих лидов от crm.bp-gr.ru (legacy per-tenant
+ * webhook был удалён вместе с ProcessWebhookJob).
  *
  * Plan 2.6 fix #ii (10.05.2026): пустой `supplier_ip_allowlist = '[]'` на
  * production env теперь fail-closed (`verifyIpAllowlist` возвращает false если

app/app/Http/Controllers/Api/WebhookReceiveController.php

@@ -1,158 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Http\Controllers\Api;
-
-use App\Http\Controllers\Controller;
-use App\Jobs\ProcessWebhookJob;
-use App\Models\SystemSetting;
-use App\Models\Tenant;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\RateLimiter;
-use Illuminate\Support\Facades\Schema;
-
-/**
- * Receive endpoint для входящих webhook'ов от crm.bp-gr.ru (narrative §5.5).
- *
- * URL: POST /api/webhook/{token}
- * Token = `tenants.webhook_token` (UUID per tenant; ротация через
- * `webhook_token_rotated_at` — старый токен живёт 24ч после ротации).
- *
- * Шаги:
- *   1. Резолв tenant по token (404 если не найден).
- *   2. Per-token rate-limit (system_settings.webhook_rate_limit_rps × 60 ≈ per-minute).
- *      Превышение → 429 + Retry-After.
- *   3. Валидация payload (vid/project/phone/time).
- *   4. HMAC-валидация (опциональная) — если header `X-Webhook-Signature: sha256=<hex>`
- *      пришёл, проверяем `hash_hmac('sha256', raw_body, webhook_token)`.
- *      Невалидная подпись → 401. Отсутствие header — пропускаем (backward-compat
- *      для существующих интеграций; на prod через `system_settings.webhook_hmac_required`
- *      сделаем обязательной).
- *   5. INSERT в webhook_log (RLS-обёрнутый), dispatch ProcessWebhookJob → 202.
- */
-class WebhookReceiveController extends Controller
-{
-    /** POST /api/webhook/{token} */
-    public function receive(Request $request, string $token): JsonResponse
-    {
-        $tenant = Tenant::query()
-            ->where('webhook_token', $token)
-            ->first();
-
-        if ($tenant === null) {
-            return response()->json([
-                'message' => 'Webhook token не найден или ротирован.',
-            ], 404);
-        }
-
-        // Per-token rate-limit. Лимит из system_settings.webhook_rate_limit_rps
-        // (RPS), приводим к per-minute через ×60. Decay 60 сек.
-        $rpsLimit = $this->getRateLimitRps();
-        $perMinuteLimit = $rpsLimit * 60;
-        $rateKey = "webhook:{$tenant->id}";
-
-        if (RateLimiter::tooManyAttempts($rateKey, $perMinuteLimit)) {
-            $retryAfter = RateLimiter::availableIn($rateKey);
-
-            return response()->json([
-                'message' => "Превышен лимит ({$rpsLimit} RPS). Повтор через {$retryAfter} сек.",
-                'retry_after' => $retryAfter,
-            ], 429)->header('Retry-After', (string) $retryAfter);
-        }
-
-        RateLimiter::hit($rateKey, 60);
-
-        // HMAC-валидация. Опциональная по умолчанию (backward-compat); при
-        // `system_settings.webhook_hmac_required = true` — обязательная,
-        // запросы без X-Webhook-Signature → 401.
-        $signature = $request->header('X-Webhook-Signature');
-        $hmacRequired = $this->isHmacRequired();
-
-        if ($signature === null && $hmacRequired) {
-            return response()->json([
-                'message' => 'X-Webhook-Signature header требуется (HMAC обязателен в этой инсталляции).',
-            ], 401);
-        }
-        if ($signature !== null) {
-            $rawBody = $request->getContent();
-            $expected = 'sha256='.hash_hmac('sha256', $rawBody, $token);
-            if (! hash_equals($expected, $signature)) {
-                return response()->json(['message' => 'Невалидная HMAC-подпись.'], 401);
-            }
-        }
-
-        // Валидация payload (после tenant lookup чтобы посчитать rate-limit
-        // даже на bad payload — иначе rate-limit можно обойти 422-ответами).
-        $validated = $request->validate([
-            'vid' => 'required|integer|min:1',
-            'project' => 'required|string|max:255',
-            'phone' => 'required|string|max:50',
-            'time' => 'required|integer|min:1',
-            'tag' => 'nullable|string|max:100',
-            'phones' => 'nullable|array',
-        ]);
-
-        $logId = $this->insertWebhookLogStub($tenant->id, $validated);
-
-        ProcessWebhookJob::dispatch($tenant->id, $validated, $logId);
-
-        return response()->json([
-            'status' => 'accepted',
-            'tenant_id' => $tenant->id,
-            'webhook_log_id' => $logId,
-        ], 202);
-    }
-
-    private function getRateLimitRps(): int
-    {
-        $setting = SystemSetting::find('webhook_rate_limit_rps');
-        if ($setting === null) {
-            return 100; // sensible default из seed v8.7
-        }
-
-        return max(1, (int) $setting->value);
-    }
-
-    /**
-     * HMAC-обязательность. Audit-fix B3: если ключ отсутствует в БД — default
-     * TRUE (HMAC обязателен по умолчанию). Отключить можно только явной
-     * установкой webhook_hmac_required=false. Неизвестное значение → fail-secure
-     * (HMAC требуется).
-     */
-    private function isHmacRequired(): bool
-    {
-        $setting = SystemSetting::find('webhook_hmac_required');
-        if ($setting === null) {
-            return true;
-        }
-
-        return ! in_array($setting->value, ['false', '0'], true);
-    }
-
-    /**
-     * Минимальный INSERT-stub в webhook_log (если таблица существует).
-     * На MVP webhook_log необязателен — возвращаем null если таблицы нет.
-     *
-     * @param  array<string,mixed>  $payload
-     */
-    private function insertWebhookLogStub(int $tenantId, array $payload): ?int
-    {
-        if (! Schema::hasTable('webhook_log')) {
-            return null;
-        }
-
-        // RLS требует SET LOCAL — оборачиваем в транзакцию.
-        return (int) DB::transaction(function () use ($tenantId, $payload) {
-            DB::statement('SET LOCAL app.current_tenant_id = '.$tenantId);
-
-            return DB::table('webhook_log')->insertGetId([
-                'tenant_id' => $tenantId,
-                'received_at' => now(),
-                'raw_payload' => json_encode($payload, JSON_UNESCAPED_UNICODE),
-            ]);
-        });
-    }
-}

app/app/Http/Middleware/EnsureSaasAdmin.php

@@ -11,28 +11,26 @@ use Symfony\Component\HttpFoundation\Response;
 /**
  * Гейт SaaS-admin зоны (/api/admin/*) — audit-находка J2.
  *
- * СТАБ (Sprint 3F): полноценная авторизация saas-admin требует Yandex 360
- * SSO-входа, который гейтится Б-1 (регистрация ООО) + DO-4. До их закрытия
- * реального механизма аутентификации нет.
+ * СТОПГЭП (2026-05-25): защита боевой админ-зоны (/admin + /api/admin/*)
+ * перенесена на уровень nginx — отдельный HTTP Basic Auth с собственным
+ * паролем (`/etc/nginx/.htpasswd-admin`, location ^~ /admin и ^~ /api/admin).
+ * Поэтому middleware больше не закрывает зону на проде: дверь держит nginx.
  *
- * Поведение стаба:
- *   - dev / testing (local, testing) → пропускаем. Admin-панель работает на
- *     dev; admin_user_id передаётся параметром (трейт ResolvesAdminUserId).
- *   - прочие окружения (production / staging) → fail-closed 503: зона
- *     закрыта до подключения реального SSO. Явный 503 лучше, чем тихо
- *     открытый /api/admin/* в проде.
+ * Ранее (Sprint 3F) здесь был fail-closed 503 вне dev/testing — он закрывал
+ * всю админку на проде наглухо, т.к. настоящий saas-admin SSO (Yandex 360)
+ * ещё не готов (гейтится Б-1 + DO-4). Замок 503 снят осознанно: оголять
+ * /api/admin/* в интернет нельзя, но nginx-пароль её прикрывает.
  *
- * TODO (после Б-1 + DO-4): заменить на проверку Yandex 360 SSO-сессии
- * saas-admin (отдельный guard) + роль (compliance и т.п. где требуется).
+ * admin_user_id для audit-trail по-прежнему резолвится трейтом
+ * ResolvesAdminUserId (стаб super_admin) — это отдельная зона.
+ *
+ * TODO (после Б-1 + DO-4): заменить nginx-дверь на настоящий saas-admin
+ * guard (Yandex 360 SSO-сессия + роль), вернуть проверку в это middleware.
  */
 class EnsureSaasAdmin
 {
     public function handle(Request $request, Closure $next): Response
     {
-        if (! app()->environment('local', 'testing')) {
-            abort(503, 'SaaS-admin авторизация не настроена (ожидает Б-1 + DO-4).');
-        }
-
         return $next($request);
     }
 }

app/app/Jobs/ImportLeadsJob.php

@@ -26,7 +26,7 @@ use Throwable;
  *
  * Жизненный цикл import_log: pending → processing → done | failed.
  * RLS: каждый доступ к БД задаёт SET LOCAL app.current_tenant_id (воркер
- * вне middleware-контекста — паритет с ProcessWebhookJob).
+ * вне middleware-контекста — паритет с RouteSupplierLeadJob).
  */
 class ImportLeadsJob implements ShouldQueue
 {

app/app/Jobs/ProcessWebhookJob.php

@@ -1,394 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Jobs;
-
-use App\Models\ActivityLog;
-use App\Models\BalanceTransaction;
-use App\Models\Deal;
-use App\Models\FailedWebhookJob;
-use App\Models\Project;
-use App\Models\RejectedDealsLog;
-use App\Models\SupplierLeadCost;
-use App\Models\SystemSetting;
-use App\Models\Tenant;
-use App\Services\DuplicateDetector;
-use App\Services\NotificationService;
-use App\Services\Pd\PdAuditLogger;
-use App\Services\SupplierResolver;
-use Illuminate\Bus\Queueable;
-use Illuminate\Contracts\Queue\ShouldQueue;
-use Illuminate\Foundation\Queue\Queueable as FoundationQueueable;
-use Illuminate\Queue\InteractsWithQueue;
-use Illuminate\Queue\SerializesModels;
-use Illuminate\Support\Carbon;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Log;
-use RuntimeException;
-use Throwable;
-
-/**
- * Асинхронная обработка webhook'а от crm.bp-gr.ru (narrative §5.5 v8.7).
- *
- * Архитектура:
- *   1. RLS: SET LOCAL app.current_tenant_id внутри транзакции (PgBouncer-safe).
- *   2. Lock на tenant + балансовая проверка → RejectedDealsLog при balance=0.
- *   3. findOrCreate проекта (префикс B[123]_ обрезан).
- *   4. Идемпотентный upsert через pg_advisory_xact_lock (см. upsertDeal()).
- *   5. Для НОВОЙ сделки: списание баланса + BalanceTransaction +
- *      SupplierLeadCost (Ю-2) + ActivityLog(deal.created).
- *
- * Антифрод-дедуп Биз-19 (§10.8.1): при создании НОВОЙ сделки `DuplicateDetector`
- * ищет master по `(tenant_id, phone)` в окне 24 ч. Если master найден — новой
- * сделке проставляется `duplicate_of_id`, баланс НЕ списывается, SupplierLeadCost
- * НЕ создаётся. ActivityLog пишется с context.duplicate_of=master.id.
- *
- * Уведомления (ТЗ §18.5, событие new_lead): после успешного chargeNewLead
- * вызывается NotificationService::notifyNewLead, который рассылает email
- * всем активным user'ам тенанта с включённым каналом email для new_lead.
- *
- * Не входит в текущий PoC (отдельные ветви фазы 1):
- *   - Sentry::captureException в failed() (нет Sentry-DSN на dev-стеке)
- *   - SystemSetting fallback для supplier_id (сейчас лукап через project_suppliers)
- */
-class ProcessWebhookJob implements ShouldQueue
-{
-    use FoundationQueueable;
-    use InteractsWithQueue;
-    use Queueable;
-    use SerializesModels;
-
-    public int $tries = 3;
-
-    public int $backoff = 60;
-
-    public int $timeout = 30;
-
-    /**
-     * @param  array<string, mixed>  $data  Webhook payload: vid, project, tag, phone, phones, time
-     */
-    public function __construct(
-        public int $tenantId,
-        public array $data,
-        public ?int $webhookLogId = null,
-    ) {}
-
-    public function handle(): void
-    {
-        $duplicateDetector = app(DuplicateDetector::class);
-
-        DB::transaction(function () use ($duplicateDetector): void {
-            DB::statement('SET LOCAL app.current_tenant_id = '.$this->tenantId);
-
-            $tenant = Tenant::query()
-                ->whereKey($this->tenantId)
-                ->lockForUpdate()
-                ->first();
-
-            if ($tenant === null) {
-                throw new RuntimeException("Tenant {$this->tenantId} not found");
-            }
-
-            if ((int) $tenant->balance_leads <= 0) {
-                $this->logRejection($tenant, RejectedDealsLog::REASON_ZERO_BALANCE);
-
-                return;
-            }
-
-            $cleanProjectName = preg_replace('/^B[123]_/', '', (string) $this->data['project']);
-            $project = Project::firstOrCreate(
-                ['tenant_id' => $tenant->id, 'name' => $cleanProjectName],
-                ['type' => 'webhook'],
-            );
-
-            $receivedAt = Carbon::createFromTimestamp((int) $this->data['time']);
-            $sourceCrmId = (int) $this->data['vid'];
-
-            $deal = $this->upsertDeal(
-                tenant: $tenant,
-                project: $project,
-                sourceCrmId: $sourceCrmId,
-                receivedAt: $receivedAt,
-            );
-
-            if (! $deal->wasRecentlyCreated) {
-                return;
-            }
-
-            // Биз-19: master-сделка по phone в окне 24 ч → дубль, без charge.
-            $master = $duplicateDetector->findMaster(
-                tenantId: $tenant->id,
-                phone: (string) $this->data['phone'],
-                now: $receivedAt,
-            );
-
-            // Сам только что созданный $deal попадает в выборку DuplicateDetector
-            // (он уже в БД к моменту lookup'а), поэтому master может ===$deal.
-            // Дубль — только если master найден И это НЕ сам deal.
-            if ($master !== null && $master->id !== $deal->id) {
-                $this->markAsDuplicate($tenant, $deal, $master);
-
-                return;
-            }
-
-            $this->chargeNewLead($tenant, $project, $deal);
-        });
-    }
-
-    /**
-     * Биз-19: помечаем сделку как дубль master'а. БЕЗ списания баланса
-     * и БЕЗ SupplierLeadCost (не наша закупка). ActivityLog пишется с
-     * `context.duplicate_of=master.id` для аудита.
-     */
-    private function markAsDuplicate(Tenant $tenant, Deal $deal, Deal $master): void
-    {
-        $deal->update(['duplicate_of_id' => $master->id]);
-
-        ActivityLog::create([
-            'tenant_id' => $tenant->id,
-            'user_id' => null,
-            'deal_id' => $deal->id,
-            'event' => ActivityLog::EVENT_DEAL_CREATED,
-            'context' => [
-                'source' => 'webhook',
-                'duplicate_of' => $master->id,
-            ],
-            'created_at' => now(),
-        ]);
-
-        app(PdAuditLogger::class)->record(
-            action: 'created', subjectType: 'lead', subjectId: $deal->id,
-            purpose: 'lead_create_webhook', tenantId: (int) $deal->tenant_id,
-            actorTenantUserId: null, actorAdminUserId: null, ip: null,
-        );
-    }
-
-    private function logRejection(Tenant $tenant, string $reason): void
-    {
-        $rejected = RejectedDealsLog::create([
-            'tenant_id' => $tenant->id,
-            'webhook_log_id' => $this->webhookLogId,
-            'reason' => $reason,
-            'payload' => $this->data,
-            'created_at' => now(),
-        ]);
-
-        Log::info("webhook.rejected.{$reason}", [
-            'tenant_id' => $tenant->id,
-            'vid' => $this->data['vid'] ?? null,
-        ]);
-
-        // ТЗ §18.5: zero_balance — уведомить тенант. Anti-spam: не более
-        // 1 email/час на тенант. Исключаем только что вставленную запись
-        // через id (timestamp-сравнение ненадёжно из-за microsecond precision).
-        if ($reason === RejectedDealsLog::REASON_ZERO_BALANCE) {
-            $previousCount = RejectedDealsLog::query()
-                ->where('tenant_id', $tenant->id)
-                ->where('reason', $reason)
-                ->where('created_at', '>=', now()->subHour())
-                ->where('id', '!=', $rejected->id)
-                ->count();
-
-            if ($previousCount === 0) {
-                app(NotificationService::class)->notifyZeroBalance($tenant);
-            }
-        }
-    }
-
-    /**
-     * Списание баланса при создании НОВОЙ сделки + аудит-записи.
-     *
-     * Все INSERT'ы в одной транзакции — целостность гарантирована (Ю-2):
-     * deal + supplier_lead_cost + balance_transaction появляются атомарно.
-     */
-    private function chargeNewLead(Tenant $tenant, Project $project, Deal $deal): void
-    {
-        $tenant->decrement('balance_leads');
-        $tenant->refresh();
-
-        BalanceTransaction::create([
-            'tenant_id' => $tenant->id,
-            'type' => BalanceTransaction::TYPE_LEAD_CHARGE,
-            'amount_leads' => -1,
-            'balance_leads_after' => (int) $tenant->balance_leads,
-            'related_type' => Deal::class,
-            'related_id' => $deal->id,
-            'created_at' => now(),
-        ]);
-
-        $resolver = app(SupplierResolver::class);
-        $supplierId = $resolver->resolveForProject($project);
-        if ($supplierId !== null) {
-            SupplierLeadCost::create([
-                'deal_id' => $deal->id,
-                'received_at' => $deal->received_at,
-                'supplier_id' => $supplierId,
-                'cost_rub' => $resolver->costRubSnapshot($supplierId),
-                'supplier_lead_id' => (int) $this->data['vid'],
-                'created_at' => now(),
-            ]);
-        } else {
-            Log::warning('webhook.no_active_supplier', [
-                'tenant_id' => $tenant->id,
-                'project_id' => $project->id,
-                'deal_id' => $deal->id,
-            ]);
-        }
-
-        ActivityLog::create([
-            'tenant_id' => $tenant->id,
-            'user_id' => null,
-            'deal_id' => $deal->id,
-            'event' => ActivityLog::EVENT_DEAL_CREATED,
-            'context' => ['source' => 'webhook'],
-            'created_at' => now(),
-        ]);
-
-        app(PdAuditLogger::class)->record(
-            action: 'created', subjectType: 'lead', subjectId: $deal->id,
-            purpose: 'lead_create_webhook', tenantId: (int) $deal->tenant_id,
-            actorTenantUserId: null, actorAdminUserId: null, ip: null,
-        );
-
-        // Уведомление о новом лиде (ТЗ §18.5). Отправляется ПОСЛЕ всех записей
-        // в БД, чтобы при ошибке отправки транзакция уже была зафиксирована.
-        // NotificationService сам ловит Throwable от Mail::send и логирует —
-        // отказ канала не должен валить webhook.
-        $deal->setRelation('project', $project);
-        $service = app(NotificationService::class);
-        $service->notifyNewLead($tenant, $deal);
-
-        // ТЗ §18.5: low_balance — после lead_charge проверяем порог. Триггерим
-        // ТОЛЬКО когда баланс пересекает порог сверху-вниз: balance_after <=
-        // threshold AND (balance_after + 1) > threshold. Иначе шлёт спам после
-        // каждого lead_charge при balance < threshold.
-        $threshold = $this->lowBalanceThreshold();
-        $balanceAfter = (int) $tenant->balance_leads;
-        if ($balanceAfter <= $threshold && ($balanceAfter + 1) > $threshold) {
-            $service->notifyLowBalance($tenant, $threshold);
-        }
-    }
-
-    /**
-     * Читает порог из system_settings.low_balance_threshold_leads.
-     * Default 10 (см. schema.sql:2239 seed).
-     */
-    private function lowBalanceThreshold(): int
-    {
-        $setting = SystemSetting::query()->where('key', 'low_balance_threshold_leads')->first();
-        if ($setting === null) {
-            return 10;
-        }
-
-        return (int) $setting->value;
-    }
-
-    /**
-     * Идемпотентная upsert-логика через advisory lock (§5.5 v8.7).
-     *
-     * Стратегия:
-     *   1. pg_advisory_xact_lock(tenant_id, vid) — сериализует все операции
-     *      с (tenant_id, source_crm_id) на время транзакции.
-     *   2. SELECT в webhook_dedup_keys — атомарно из-за lock.
-     *   3a. Если найдено — UPDATE deal по composite-ключу (id, received_at).
-     *   3b. Иначе — INSERT deal первым (FK immediate OK), затем INSERT dedup_key.
-     *
-     * См. db/CHANGELOG_schema.md §W для архитектурного обоснования
-     * (PG savepoint+DEFERRED quirk, отказ от двустадийного INSERT-в-dedup-keys-первым).
-     */
-    private function upsertDeal(
-        Tenant $tenant,
-        Project $project,
-        int $sourceCrmId,
-        Carbon $receivedAt,
-    ): Deal {
-        // pg_advisory_xact_lock(bigint): комбинируем (tenant_id, source_crm_id)
-        // в один bigint — верхние 32 бита tenant_id, нижние 32 — source_crm_id.
-        $lockKey = (($tenant->id & 0xFFFFFFFF) << 32) | ($sourceCrmId & 0xFFFFFFFF);
-        DB::statement('SELECT pg_advisory_xact_lock(?)', [$lockKey]);
-
-        $existing = DB::selectOne(
-            'SELECT deal_id, deal_received_at FROM webhook_dedup_keys WHERE tenant_id = ? AND source_crm_id = ?',
-            [$tenant->id, $sourceCrmId],
-        );
-
-        if ($existing !== null) {
-            $deal = Deal::query()
-                ->where('id', $existing->deal_id)
-                ->where('received_at', $existing->deal_received_at)
-                ->firstOrFail();
-
-            $deal->update([
-                'phone' => (string) $this->data['phone'],
-                'phones' => $this->data['phones'] ?? [(string) $this->data['phone']],
-                // status НЕ перезаписываем — менеджер мог изменить.
-            ]);
-
-            DB::table('webhook_dedup_keys')
-                ->where('tenant_id', $tenant->id)
-                ->where('source_crm_id', $sourceCrmId)
-                ->update(['updated_at' => now()]);
-
-            $deal->wasRecentlyCreated = false;
-
-            return $deal;
-        }
-
-        $deal = Deal::create([
-            'tenant_id' => $tenant->id,
-            'source_crm_id' => $sourceCrmId,
-            'project_id' => $project->id,
-            'phone' => (string) $this->data['phone'],
-            'phones' => $this->data['phones'] ?? [(string) $this->data['phone']],
-            'status' => 'new',
-            'received_at' => $receivedAt,
-        ]);
-
-        DB::table('webhook_dedup_keys')->insert([
-            'tenant_id' => $tenant->id,
-            'source_crm_id' => $sourceCrmId,
-            'deal_id' => $deal->id,
-            'deal_received_at' => $deal->received_at,
-            'created_at' => now(),
-        ]);
-
-        return $deal;
-    }
-
-    /**
-     * Финальный callback после исчерпания всех ретраев ($tries=3).
-     *
-     * Сохраняет упавший job в `failed_webhook_jobs` для ручного разбора и
-     * возможного повторного запуска через админку SaaS. RLS не задаём —
-     * tenant_id из job-state передаётся как есть (failed-callback запускается
-     * вне транзакции воркера). На production добавляется Sentry::captureException.
-     *
-     * NB: записывается через DB::table (не через FailedWebhookJob::create),
-     * чтобы избежать RLS-фильтрации при отсутствии app.current_tenant_id —
-     * запись должна попасть в БД даже в катастрофическом сценарии.
-     */
-    public function failed(Throwable $e): void
-    {
-        // failed_webhook_jobs is an RLS-protected table. On production crm_app_user
-        // (non-BYPASSRLS) there is no app.current_tenant_id GUC in the failed()
-        // callback context. Use pgsql_supplier (crm_supplier_worker, BYPASSRLS) —
-        // same pattern as RouteSupplierLeadJob::failed().
-        DB::connection('pgsql_supplier')->table('failed_webhook_jobs')->insert([
-            'tenant_id' => $this->tenantId,
-            'webhook_log_id' => $this->webhookLogId,
-            'raw_payload' => json_encode($this->data, JSON_UNESCAPED_UNICODE),
-            'exception' => $e->getMessage(),
-            'retry_count' => $this->tries,
-            'failed_at' => now(),
-        ]);
-
-        Log::error('webhook.job_failed_permanently', [
-            'tenant_id' => $this->tenantId,
-            'vid' => $this->data['vid'] ?? null,
-            'exception' => $e->getMessage(),
-        ]);
-
-        // TODO(production): Sentry::captureException($e);
-    }
-}

app/app/Jobs/RouteSupplierLeadJob.php

@@ -11,7 +11,6 @@ use App\Models\Project;
 use App\Models\SupplierLead;
 use App\Models\Tenant;
 use App\Services\Billing\LedgerService;
-use App\Services\DuplicateDetector;
 use App\Services\LeadDistributor;
 use App\Services\LeadRouter;
 use App\Services\NotificationService;
@@ -44,9 +43,7 @@ use Throwable;
  *   5. Для каждого Project — DB::transaction с SET LOCAL app.current_tenant_id:
  *      - lockForUpdate Tenant.
  *      - Создать Deal (source_crm_id=vid).
- *      - DuplicateDetector::findMaster — если найден master !== deal, mark
- *        duplicate_of_id (без charge/counter/notify, ActivityLog с duplicate_of).
- *      - Иначе: LedgerService::chargeForDelivery(tenant, deal, lead) — dual-balance
+ *      - LedgerService::chargeForDelivery(tenant, deal, lead) — dual-balance
  *        списание (prepaid balance_leads-- ИЛИ rub balance_rub-=tier_price), INSERT
  *        lead_charges + balance_transactions + supplier_lead_costs внутри той же
  *        транзакции. На InsufficientBalanceException — Log::warning + rethrow
@@ -86,7 +83,6 @@ class RouteSupplierLeadJob implements ShouldQueue
     public function handle(
         LeadRouter $router,
         SupplierProjectResolver $resolver,
-        DuplicateDetector $duplicateDetector,
         NotificationService $notifier,
         LedgerService $ledger,
         LeadDistributor $distributor,
@@ -135,7 +131,7 @@ class RouteSupplierLeadJob implements ShouldQueue
         $failures = [];
         foreach ($selected as $project) {
             try {
-                if ($this->createDealCopyForProject($lead, $project, $duplicateDetector, $notifier, $ledger, $subjectCode)) {
+                if ($this->createDealCopyForProject($lead, $project, $notifier, $ledger, $subjectCode)) {
                     $createdCount++;
                 }
             } catch (Throwable $e) {
@@ -205,19 +201,18 @@ class RouteSupplierLeadJob implements ShouldQueue
 
     /**
      * Создаёт deal-копию в одной транзакции для конкретного Project.
-     * Возвращает true — если копия не дубль (баланс списан, счётчики выросли).
-     * false — если копия помечена дублем (без списания).
+     * Возвращает true — если deal создан и баланс списан, счётчики выросли.
+     * false — если лимит исчерпан под блокировкой (deal не создаётся).
      */
     private function createDealCopyForProject(
         SupplierLead $lead,
         Project $project,
-        DuplicateDetector $duplicateDetector,
         NotificationService $notifier,
         LedgerService $ledger,
         ?int $subjectCode,
     ): bool {
         try {
-            return DB::transaction(function () use ($lead, $project, $duplicateDetector, $notifier, $ledger, $subjectCode): bool {
+            return DB::transaction(function () use ($lead, $project, $notifier, $ledger, $subjectCode): bool {
                 DB::statement("SET LOCAL app.current_tenant_id = '{$project->tenant_id}'");
 
                 /** @var Tenant $tenant */
@@ -250,6 +245,22 @@ class RouteSupplierLeadJob implements ShouldQueue
                 }
                 $project = $lockedProject;
 
+                // Spec B: per-(supplier_lead, tenant) lock — одна поставка одному клиенту = один раз.
+                // insertOrIgnore вернёт 0, если строка уже существует (повтор/гонка/CSV-recovery).
+                $locked = DB::table('supplier_lead_deliveries')->insertOrIgnore([
+                    'supplier_lead_id' => $lead->id,
+                    'tenant_id' => $tenant->id,
+                    'created_at' => now(),
+                ]);
+                if ($locked === 0) {
+                    Log::info('supplier_lead.delivery_already_locked', [
+                        'supplier_lead_id' => $lead->id,
+                        'tenant_id' => $tenant->id,
+                    ]);
+
+                    return false;
+                }
+
                 $payload = $lead->raw_payload ?? [];
                 $receivedAt = isset($payload['time'])
                     ? Carbon::createFromTimestamp((int) $payload['time'])
@@ -271,39 +282,10 @@ class RouteSupplierLeadJob implements ShouldQueue
                     'subject_code' => $subjectCode,
                 ]);
 
-                $master = $duplicateDetector->findMaster(
-                    tenantId: (int) $tenant->id,
-                    phone: (string) $lead->phone,
-                    now: $receivedAt,
-                );
-
-                // Только что созданный $deal сам попадает в выборку DuplicateDetector
-                // (он уже в БД к моменту lookup'а), поэтому master может ===$deal.
-                // Дубль — только если master найден И это НЕ сам deal.
-                if ($master !== null && $master->id !== $deal->id) {
-                    $deal->update(['duplicate_of_id' => $master->id]);
-
-                    ActivityLog::create([
-                        'tenant_id' => $tenant->id,
-                        'user_id' => null,
-                        'deal_id' => $deal->id,
-                        'event' => ActivityLog::EVENT_DEAL_CREATED,
-                        'context' => [
-                            'source' => 'supplier_webhook',
-                            'duplicate_of' => $master->id,
-                            'supplier_lead_id' => $lead->id,
-                        ],
-                        'created_at' => now(),
-                    ]);
-
-                    app(PdAuditLogger::class)->record(
-                        action: 'created', subjectType: 'lead', subjectId: $deal->id,
-                        purpose: 'lead_create_supplier', tenantId: (int) $deal->tenant_id,
-                        actorTenantUserId: null, actorAdminUserId: null, ip: null,
-                    );
-
-                    return false;
-                }
+                DB::table('supplier_lead_deliveries')
+                    ->where('supplier_lead_id', $lead->id)
+                    ->where('tenant_id', $tenant->id)
+                    ->update(['deal_id' => $deal->id]);
 
                 // Task 6: $ledger->chargeForDelivery бросит InsufficientBalanceException —
                 // транзакция откатится, и outer catch ниже отловит для auto-pause flow.
@@ -330,8 +312,8 @@ class RouteSupplierLeadJob implements ShouldQueue
                     actorTenantUserId: null, actorAdminUserId: null, ip: null,
                 );
 
-                // ProcessWebhookJob-pattern: setRelation чтобы NotificationService
-                // мог подтянуть deal->project без N+1 lookup'а под RLS.
+                // setRelation чтобы NotificationService мог подтянуть
+                // deal->project без N+1 lookup'а под RLS.
                 $deal->setRelation('project', $project);
                 $notifier->notifyNewLead($tenant, $deal);
 

app/app/Jobs/Supplier/CsvReconcileJob.php

@@ -126,11 +126,15 @@ final class CsvReconcileJob implements ShouldQueue
             $missing = array_diff_key($csvByKey, $existingKeys);
 
             $recoveredCount = 0;
+            $unparseableCount = 0;
             foreach ($missing as $row) {
                 $platform = $this->extractPlatform((string) $row['project']);
                 if ($platform === null) {
                     // Поставщик иногда кладёт в `project` нестандартные имена (телефон, URL).
                     // Не warning — это не наш баг, processing продолжается, paper-trail на info уровне.
+                    // Считаем такие строки отдельно, чтобы исключить из формулы drift'а
+                    // (иначе ~40-50% мусора каждый запуск стабильно даёт false-positive drift_alert).
+                    $unparseableCount++;
                     Log::info('csv_reconcile.unparseable_project_skipped', [
                         'project' => $row['project'],
                     ]);
@@ -161,7 +165,14 @@ final class CsvReconcileJob implements ShouldQueue
             }
 
             $matchedCount = $totalCsvRows - count($missing);
-            $driftRatio = $totalCsvRows > 0 ? count($missing) / $totalCsvRows : 0.0;
+            // drift считается только по «реальным» пропускам (parseable, не junk):
+            //   real_missing  = count(missing) - unparseable  (всегда ≥ 0)
+            //   parseable_tot = total_csv_rows - unparseable
+            // Это убирает класс «поставщик кладёт телефон/URL в поле project →
+            // строки скипаются → drift искусственно завышен» (см. ПИЛОТ 22.05, 25.05).
+            $realMissing = max(0, count($missing) - $unparseableCount);
+            $parseableTotal = max(0, $totalCsvRows - $unparseableCount);
+            $driftRatio = $parseableTotal > 0 ? $realMissing / $parseableTotal : 0.0;
             $status = $driftRatio > self::DRIFT_THRESHOLD ? 'drift_alert' : 'ok';
 
             $update = [
@@ -169,6 +180,7 @@ final class CsvReconcileJob implements ShouldQueue
                 'total_csv_rows' => $totalCsvRows,
                 'matched_count' => $matchedCount,
                 'recovered_count' => $recoveredCount,
+                'unparseable_count' => $unparseableCount,
                 'drift_ratio' => $driftRatio,
                 'status' => $status,
             ];

app/app/Mail/LowBalanceNotification.php

@@ -1,50 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Mail;
-
-use App\Models\Tenant;
-use App\Models\User;
-use Illuminate\Bus\Queueable;
-use Illuminate\Mail\Mailable;
-use Illuminate\Mail\Mailables\Content;
-use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
-
-/**
- * Email-уведомление о низком балансе (ТЗ §18.5, событие low_balance).
- *
- * Триггер: tenant.balance_leads <= system_settings.low_balance_threshold_leads
- * (default 10) после lead_charge в ProcessWebhookJob.
- */
-class LowBalanceNotification extends Mailable
-{
-    use Queueable;
-    use SerializesModels;
-
-    public function __construct(
-        public User $recipient,
-        public Tenant $tenant,
-        public int $thresholdLeads,
-    ) {}
-
-    public function envelope(): Envelope
-    {
-        return new Envelope(
-            subject: 'Лидерра. Низкий баланс — пополните, чтобы не пропустить лиды',
-        );
-    }
-
-    public function content(): Content
-    {
-        return new Content(
-            view: 'emails.low_balance',
-            with: [
-                'recipient' => $this->recipient,
-                'tenant' => $this->tenant,
-                'thresholdLeads' => $this->thresholdLeads,
-            ],
-        );
-    }
-}

app/app/Mail/NewLeadNotification.php

@@ -18,7 +18,7 @@ use Illuminate\Queue\SerializesModels;
  *
  * Отправляется получателям тенанта, у которых в notification_preferences
  * включён канал email для события new_lead. Триггер — успешное создание
- * сделки в ProcessWebhookJob::chargeNewLead.
+ * сделки в RouteSupplierLeadJob.
  */
 class NewLeadNotification extends Mailable
 {

app/app/Mail/ZeroBalanceNotification.php

@@ -1,50 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Mail;
-
-use App\Models\Tenant;
-use App\Models\User;
-use Illuminate\Bus\Queueable;
-use Illuminate\Mail\Mailable;
-use Illuminate\Mail\Mailables\Content;
-use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
-
-/**
- * Email-уведомление о нулевом балансе и отклонении лидов (ТЗ §18.5,
- * событие zero_balance).
- *
- * Триггер: ProcessWebhookJob::logRejection(reason=zero_balance) — после
- * первого RejectedDealsLog в течение последнего часа (anti-spam: не больше
- * 1 email в час на тенант).
- */
-class ZeroBalanceNotification extends Mailable
-{
-    use Queueable;
-    use SerializesModels;
-
-    public function __construct(
-        public User $recipient,
-        public Tenant $tenant,
-    ) {}
-
-    public function envelope(): Envelope
-    {
-        return new Envelope(
-            subject: 'Лидерра. Баланс закончился — лиды отклоняются',
-        );
-    }
-
-    public function content(): Content
-    {
-        return new Content(
-            view: 'emails.zero_balance',
-            with: [
-                'recipient' => $this->recipient,
-                'tenant' => $this->tenant,
-            ],
-        );
-    }
-}

app/app/Models/FailedWebhookJob.php

@@ -8,7 +8,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 /**
- * Webhook-job упавший после 3 ретраев (см. ProcessWebhookJob::failed()).
+ * Webhook-job упавший после 3 ретраев (см. RouteSupplierLeadJob::failed()).
  *
  * Tenant-aware с RLS. Хранит raw payload + текст исключения для ручного
  * retry из админки SaaS (`retried_at`/`retried_by` заполняются админом).

app/app/Models/RejectedDealsLog.php

@@ -1,56 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Models;
-
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-/**
- * Лог отвергнутых webhook'ов (примеры reason: zero_balance, validation_failed).
- *
- * Хранится бессрочно (опционально 12 месяцев) — при пополнении баланса
- * админка SaaS может массово восстановить отвергнутые лиды.
- *
- * Tenant-aware с RLS. webhook_log_id — soft FK на webhook_log
- * (опциональный, NULL для прямых validation-отказов).
- *
- * Источник: db/schema.sql v8.7 §6, table `rejected_deals_log`.
- *
- * @mixin IdeHelperRejectedDealsLog
- */
-class RejectedDealsLog extends Model
-{
-    public const REASON_ZERO_BALANCE = 'zero_balance';
-
-    public const REASON_VALIDATION_FAILED = 'validation_failed';
-
-    public $timestamps = false;
-
-    protected $table = 'rejected_deals_log';
-
-    protected $fillable = [
-        'tenant_id',
-        'webhook_log_id',
-        'reason',
-        'payload',
-        'created_at',
-    ];
-
-    protected function casts(): array
-    {
-        return [
-            'tenant_id' => 'integer',
-            'webhook_log_id' => 'integer',
-            'payload' => 'array',
-            'created_at' => 'datetime',
-        ];
-    }
-
-    /** @return BelongsTo<Tenant, $this> */
-    public function tenant(): BelongsTo
-    {
-        return $this->belongsTo(Tenant::class);
-    }
-}

app/app/Models/SupplierLeadCost.php

@@ -11,8 +11,8 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
  * Себестоимость каждого лида (Ю-2: реселлерская модель).
  *
  * Партиционирована по `received_at` синхронно с `deals` — composite PK
- * (id, received_at). В `ProcessWebhookJob` создаётся в той же транзакции,
- * что и Deal + BalanceTransaction.
+ * (id, received_at). Создаётся в `LedgerService::chargeForDelivery` в той же
+ * транзакции, что и Deal + BalanceTransaction.
  *
  * cost_rub — snapshot suppliers.cost_rub на момент приёма (исторические
  * записи не пересчитываются при изменении закупочной цены, см. §20.12.5).

app/app/Models/SupplierLeadDelivery.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * Замок «поставка ↔ клиент» (Billing v2 Spec B). Композитный PK без автоинкремента.
+ * Пишется в шеринг-пути (RouteSupplierLeadJob) через insertOrIgnore под RLS-контекстом.
+ *
+ * @property int $supplier_lead_id
+ * @property int $tenant_id
+ * @property int|null $deal_id
+ * @property string $created_at
+ */
+class SupplierLeadDelivery extends Model
+{
+    public $incrementing = false;
+
+    public $timestamps = false;
+
+    protected $primaryKey = null;
+
+    protected $fillable = ['supplier_lead_id', 'tenant_id', 'deal_id', 'created_at'];
+}

app/app/Models/Tenant.php

@@ -31,8 +31,6 @@ class Tenant extends Model
         'subdomain',
         'organization_name',
         'contact_email',
-        'webhook_token',
-        'webhook_token_rotated_at',
         'timezone',
         'locale',
         'current_tariff_id',
@@ -61,7 +59,6 @@ class Tenant extends Model
             'api_key_limit' => 'integer',
             // JSONB: {"max_users":5,"max_projects":10,"api_rps":60}
             'limits' => 'array',
-            'webhook_token_rotated_at' => 'datetime',
             'last_activity_at' => 'datetime',
             'last_webhook_at' => 'datetime',
             'created_at' => 'datetime',

app/app/Services/DuplicateDetector.php

@@ -1,54 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Services;
-
-use App\Models\Deal;
-use Illuminate\Support\Carbon;
-
-/**
- * Антифрод-дедуп лидов по `(tenant_id, phone)` в окне 24 ч (Биз-19, §10.8.1).
- *
- * Цель: в pay-per-lead-сегменте поставщик может прислать одно физлицо дважды
- * (двойной submit формы / повторный звонок) — без защиты клиент платит за оба.
- *
- * Стратегия: ищем master-сделку (запись без `duplicate_of_id`) с тем же
- * `(tenant_id, phone)` и `received_at >= NOW() - INTERVAL '24 hours'`.
- * Если найдена — новая сделка получает `duplicate_of_id = master.id` и
- * НЕ списывает с баланса.
- *
- * Окно фиксированное 24 ч (не настраивается на MVP) — компромисс между
- * антифродом и легитимными повторными интересами.
- *
- * Цепочки не строятся: дубль ссылается ТОЛЬКО на master (запись без
- * `duplicate_of_id`), не на другой дубль. Если master найден среди дублей —
- * берётся его собственный `duplicate_of_id` (root master).
- *
- * Performance: существующий индекс `(tenant_id, phone)` достаточен, см. §10.8.1.
- */
-class DuplicateDetector
-{
-    public const WINDOW_HOURS = 24;
-
-    /**
-     * Поиск master-сделки для (tenantId, phone) в окне 24 ч.
-     *
-     * Возвращает Deal-объект master'а либо null если master не найден.
-     * Текущий момент `now` параметризуется для тестируемости — в production
-     * по умолчанию `Carbon::now()`.
-     */
-    public function findMaster(int $tenantId, string $phone, ?Carbon $now = null): ?Deal
-    {
-        $now ??= Carbon::now();
-        $windowStart = $now->copy()->subHours(self::WINDOW_HOURS);
-
-        return Deal::query()
-            ->where('tenant_id', $tenantId)
-            ->where('phone', $phone)
-            ->where('received_at', '>=', $windowStart)
-            ->whereNull('duplicate_of_id')
-            ->orderBy('received_at')
-            ->first();
-    }
-}

app/app/Services/Import/CsvLeadsParser.php

@@ -95,7 +95,7 @@ final class CsvLeadsParser
             return null;
         }
 
-        // Префикс B[123]_ из названия проекта срезается (паритет с ProcessWebhookJob).
+        // Префикс B[123]_ из названия проекта срезается (паритет с RouteSupplierLeadJob парсером).
         $projectName = (string) preg_replace('/^B[123]_/', '', trim($project));
         if ($projectName === '') {
             $errors[] = ['line' => $dataLine, 'message' => 'Пустое название проекта'];

app/app/Services/LeadRouter.php

@@ -8,6 +8,7 @@ use App\Models\Project;
 use App\Models\SupplierProject;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\DB;
 
 /**
  * Подбор eligible Лидерра-проектов для входящего лида (sharing-model §6).
@@ -28,6 +29,17 @@ use Illuminate\Support\Collection;
 class LeadRouter
 {
     /**
+     * Возвращает ONE project per tenant_id — тот, у которого наибольший остаток
+     * дневного лимита (DISTINCT ON (tenant_id) с ORDER BY remaining DESC, created_at, id).
+     *
+     * Семантика (Spec B Task 3): один лид продаётся не более чем 3 РАЗЛИЧНЫМ тенантам
+     * (клиентам), каждый тенант получает ровно ОДИН проект — с наибольшим остатком.
+     * LeadDistributor::selectRecipients (CAP=3) теперь ограничивает число тенантов,
+     * а не число проектов, потому что входные данные уже one-per-tenant.
+     *
+     * Запрос через pgsql_supplier (BYPASSRLS crm_supplier_worker) — tenant ещё не
+     * определён, SELECT видит проекты всех tenant'ов.
+     *
      * @return Collection<int, Project>
      */
     public function matchEligibleProjects(SupplierProject $supplierProject): Collection
@@ -35,30 +47,31 @@ class LeadRouter
         // МСК-aligned ISO day-of-week (reset-cron тоже 00:00 МСК).
         $todayBit = 1 << (Carbon::now('Europe/Moscow')->isoWeekday() - 1);
 
-        /** @var Collection<int, Project> $candidates */
-        $candidates = Project::on('pgsql_supplier')
-            ->whereExists(function ($q) use ($supplierProject): void {
-                $q->selectRaw('1')
-                    ->from('project_supplier_links')
-                    ->whereColumn('project_supplier_links.project_id', 'projects.id')
-                    ->where('project_supplier_links.supplier_project_id', $supplierProject->id);
-            })
-            ->where('is_active', true)
-            ->whereRaw('(delivery_days_mask & ?) <> 0', [$todayBit])
-            ->whereRaw('delivered_today < COALESCE(effective_daily_limit_today, daily_limit_target)')
-            ->whereExists(function ($q): void {
-                $q->selectRaw('1')
-                    ->from('tenants')
-                    ->whereColumn('tenants.id', 'projects.tenant_id')
-                    ->where(function ($qq): void {
-                        $qq->where('tenants.balance_leads', '>', 0)
-                            ->orWhere('tenants.balance_rub', '>', 0);
-                    });
-            })
-            ->orderBy('created_at')
-            ->orderBy('id')
-            ->get();
+        $sql = <<<'SQL'
+            SELECT DISTINCT ON (projects.tenant_id) projects.*
+            FROM projects
+            WHERE EXISTS (
+                SELECT 1 FROM project_supplier_links psl
+                WHERE psl.project_id = projects.id
+                  AND psl.supplier_project_id = ?
+            )
+            AND projects.is_active = true
+            AND (projects.delivery_days_mask & ?) <> 0
+            AND projects.delivered_today < COALESCE(projects.effective_daily_limit_today, projects.daily_limit_target)
+            AND EXISTS (
+                SELECT 1 FROM tenants
+                WHERE tenants.id = projects.tenant_id
+                  AND (tenants.balance_leads > 0 OR tenants.balance_rub > 0)
+            )
+            ORDER BY
+                projects.tenant_id,
+                (COALESCE(projects.effective_daily_limit_today, projects.daily_limit_target) - projects.delivered_today) DESC,
+                projects.created_at,
+                projects.id
+        SQL;
 
-        return $candidates->values();
+        $rows = DB::connection('pgsql_supplier')->select($sql, [$supplierProject->id, $todayBit]);
+
+        return Project::hydrate($rows)->values();
     }
 }

app/app/Services/MonthlyPartitionManager.php

@@ -24,6 +24,21 @@ use InvalidArgumentException;
  */
 class MonthlyPartitionManager
 {
+    /**
+     * Connection used for partition DDL (CREATE / DROP).
+     *
+     * На проде партиционированные родители принадлежат `crm_migrator`;
+     * `crm_supplier_worker` — член `crm_migrator` (см. db/02_grants.sql),
+     * поэтому через `pgsql_supplier` создаёт/дропает партиции, а
+     * дефолтный `crm_app_user` — нет. На dev/тестах `pgsql_supplier`
+     * фоллбэчит на `postgres` (superuser) — DDL также проходит.
+     *
+     * Тесты, триггерящие CREATE/DROP через менеджер, должны подключать
+     * `Tests\Concerns\SharesSupplierPdo`, иначе DDL уйдёт мимо
+     * test-транзакции (см. trait doc).
+     */
+    public const DDL_CONNECTION = 'pgsql_supplier';
+
     /**
      * Таблицы, партиционированные помесячно.
      * Ключ → имя таблицы, значение → колонка-ключ партиционирования.
@@ -38,7 +53,7 @@ class MonthlyPartitionManager
         'auth_log' => 'created_at',
         'activity_log' => 'created_at',
         'tenant_operations_log' => 'created_at',
-        'webhook_log' => 'received_at',
+        // webhook_log удалён в миграции 2026_05_24_140000_drop_legacy_webhook_artefacts (legacy direct webhook removal)
         'balance_transactions' => 'created_at',
         'pd_processing_log' => 'created_at',
         'saas_admin_audit_log' => 'created_at',
@@ -90,7 +105,7 @@ class MonthlyPartitionManager
             return false;
         }
 
-        DB::statement(sprintf(
+        DB::connection(self::DDL_CONNECTION)->statement(sprintf(
             "CREATE TABLE %s PARTITION OF %s FOR VALUES FROM ('%s') TO ('%s')",
             $partition,
             $table,

app/app/Services/NotificationService.php

@@ -5,11 +5,9 @@ declare(strict_types=1);
 namespace App\Services;
 
 use App\Mail\InvoicePaidNotification;
-use App\Mail\LowBalanceNotification;
 use App\Mail\NewLeadNotification;
 use App\Mail\ReminderDueNotification;
 use App\Mail\TopupSuccessNotification;
-use App\Mail\ZeroBalanceNotification;
 use App\Mail\ZeroBalancePausedMail;
 use App\Models\Deal;
 use App\Models\InAppNotification;
@@ -147,52 +145,6 @@ class NotificationService
         }
     }
 
-    /**
-     * Уведомление о низком балансе. Триггер: ProcessWebhookJob после
-     * lead_charge, если balance_leads <= threshold.
-     *
-     * Получатели: все активные user'ы тенанта с new_lead.email=true
-     * (на MVP: те же что и для new_lead — обычно владелец и менеджеры).
-     * По prefs `low_balance.email`.
-     */
-    public function notifyLowBalance(Tenant $tenant, int $thresholdLeads): void
-    {
-        $title = "Низкий баланс — {$tenant->balance_leads} лидов осталось";
-        $body = "Порог уведомления: {$thresholdLeads} лидов";
-
-        foreach ($this->recipientsForEvent($tenant, self::EVENT_LOW_BALANCE, self::CHANNEL_EMAIL) as $user) {
-            $this->sendEmail($user, self::EVENT_LOW_BALANCE, new LowBalanceNotification($user, $tenant, $thresholdLeads));
-        }
-        foreach ($this->recipientsForEvent($tenant, self::EVENT_LOW_BALANCE, self::CHANNEL_INAPP) as $user) {
-            $this->notifyInApp($user, self::EVENT_LOW_BALANCE, $title, $body, [
-                'tenant_id' => $tenant->id,
-                'balance_leads' => $tenant->balance_leads,
-                'threshold_leads' => $thresholdLeads,
-            ]);
-        }
-    }
-
-    /**
-     * Уведомление о нулевом балансе и отклонении лидов.
-     * Триггер: ProcessWebhookJob::logRejection(zero_balance) в первом
-     * RejectedDealsLog за последний час (anti-spam: не более 1 email/час
-     * на тенант, проверка в caller).
-     */
-    public function notifyZeroBalance(Tenant $tenant): void
-    {
-        $title = 'Баланс закончился — лиды отклоняются';
-        $body = 'Пополните баланс в разделе Биллинг';
-
-        foreach ($this->recipientsForEvent($tenant, self::EVENT_ZERO_BALANCE, self::CHANNEL_EMAIL) as $user) {
-            $this->sendEmail($user, self::EVENT_ZERO_BALANCE, new ZeroBalanceNotification($user, $tenant));
-        }
-        foreach ($this->recipientsForEvent($tenant, self::EVENT_ZERO_BALANCE, self::CHANNEL_INAPP) as $user) {
-            $this->notifyInApp($user, self::EVENT_ZERO_BALANCE, $title, $body, [
-                'tenant_id' => $tenant->id,
-            ]);
-        }
-    }
-
     /**
      * Уведомление об auto-pause проекта на нулевом балансе (Plan 4 Task 6).
      *

app/app/Services/Pd/PdErasureService.php

@@ -18,7 +18,7 @@ use InvalidArgumentException;
  *   users:          email, first_name, last_name, phone
  *   supplier_leads: phone, raw_payload (JSONB) — нет contact_email/contact_phone
  *   deals:          phone, contact_name         — нет отдельного contact_email
- *   webhook_log:    raw_payload (JSONB)
+ *   (webhook_log удалён в миграции 2026_05_24_140000_drop_legacy_webhook_artefacts)
  */
 class PdErasureService
 {
@@ -32,7 +32,7 @@ class PdErasureService
      * @param  int|null  $tenantId  Ограничить поиск одним тенантом (null = все)
      * @param  int  $actorAdminId  ID saas_admin_users
      * @param  string|null  $requestId  ID pd_subject_requests для авто-закрытия
-     * @return array{users: int, leads: int, deals: int, webhook_log: int}
+     * @return array{users: int, leads: int, deals: int}
      *
      * @throws InvalidArgumentException если оба email и phone null
      */
@@ -47,7 +47,7 @@ class PdErasureService
             throw new InvalidArgumentException('Необходимо указать email или телефон субъекта.');
         }
 
-        $counts = ['users' => 0, 'leads' => 0, 'deals' => 0, 'webhook_log' => 0];
+        $counts = ['users' => 0, 'leads' => 0, 'deals' => 0];
 
         DB::connection(self::DB)->transaction(function () use (
             $email, $phone, $tenantId, $actorAdminId, $requestId, &$counts
@@ -176,50 +176,12 @@ class PdErasureService
             $counts['deals'] = $deals->count();
 
             // ------------------------------------------------------------------
-            // 4. webhook_log  (raw_payload JSONB text-search)
-            // ------------------------------------------------------------------
-            $wlQuery = DB::connection(self::DB)->table('webhook_log');
-            $conditions = [];
-            $bindings = [];
-            if ($email !== null) {
-                $conditions[] = 'raw_payload::text LIKE ?';
-                $bindings[] = '%'.$email.'%';
-            }
-            if ($phone !== null) {
-                $conditions[] = 'raw_payload::text LIKE ?';
-                $bindings[] = '%'.$phone.'%';
-            }
-
-            if (! empty($conditions)) {
-                $wlQuery->whereRaw('('.implode(' OR ', $conditions).')', $bindings);
-            }
-
-            if ($tenantId !== null) {
-                $wlQuery->where('tenant_id', $tenantId);
-            }
-
-            // Batched update: обрабатываем по 500 строк
-            $wlCount = 0;
-            $wlQuery->select('id')->orderBy('id')->chunk(500, function ($rows) use (&$wlCount): void {
-                $ids = $rows->pluck('id')->all();
-                DB::connection(self::DB)->table('webhook_log')
-                    ->whereIn('id', $ids)
-                    ->update([
-                        'raw_payload' => DB::connection(self::DB)->raw(
-                            "JSONB_BUILD_OBJECT('erased', TRUE, 'erased_at', NOW()::TEXT)"
-                        ),
-                    ]);
-                $wlCount += count($ids);
-            });
-
-            $counts['webhook_log'] = $wlCount;
-
-            // ------------------------------------------------------------------
-            // 5. Обновить pd_subject_requests если requestId передан
+            // 4. Обновить pd_subject_requests если requestId передан
+            // (webhook_log удалён в миграции 2026_05_24_140000_drop_legacy_webhook_artefacts)
             // ------------------------------------------------------------------
             if ($requestId !== null) {
                 $summary = "Удалено: users={$counts['users']}, leads={$counts['leads']}, "
-                    ."deals={$counts['deals']}, webhook_log={$counts['webhook_log']}";
+                    ."deals={$counts['deals']}";
 
                 DB::connection(self::DB)->table('pd_subject_requests')
                     ->where('id', $requestId)

app/database/factories/TenantFactory.php

@@ -22,7 +22,6 @@ class TenantFactory extends Factory
             'subdomain' => 'tenant-'.Str::lower(Str::random(8)),
             'organization_name' => fake()->company(),
             'contact_email' => fake()->unique()->safeEmail(),
-            'webhook_token' => Str::random(64),
             'timezone' => 'Europe/Moscow',
             'locale' => 'ru',
             'is_trial' => true,

app/database/migrations/2026_05_22_000002_webhook_log_supplier_columns.php

@@ -9,8 +9,11 @@ return new class extends Migration
 {
     public function up(): void
     {
-        // Guard: only run if webhook_log exists (should always exist, but be safe)
-        if (! Schema::hasTable('webhook_log')) {
+        $conn = DB::connection('pgsql_supplier');
+
+        // Guard: only run if webhook_log exists (на проде после legacy-webhook-removal
+        // таблицы нет — миграция становится no-op).
+        if (! $conn->getSchemaBuilder()->hasTable('webhook_log')) {
             return;
         }
 
@@ -18,16 +21,18 @@ return new class extends Migration
             base_path('/../db/migrations/2026_05_22_002_webhook_log_supplier_columns.sql')
         );
 
-        DB::unprepared($sql);
+        $conn->unprepared($sql);
     }
 
     public function down(): void
     {
-        if (! Schema::hasTable('webhook_log')) {
+        $conn = DB::connection('pgsql_supplier');
+
+        if (! $conn->getSchemaBuilder()->hasTable('webhook_log')) {
             return;
         }
 
-        DB::unprepared(<<<'SQL'
+        $conn->unprepared(<<<'SQL'
             ALTER TABLE webhook_log
                 DROP COLUMN IF EXISTS source,
                 DROP COLUMN IF EXISTS status,

app/database/migrations/2026_05_23_200000_create_supplier_lead_deliveries.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // Idempotency guard: skip if table already exists (e.g. loaded via schema.sql).
+        if (DB::selectOne('SELECT 1 AS ok FROM pg_class WHERE relname = ?', ['supplier_lead_deliveries']) !== null) {
+            return;
+        }
+
+        $sql = file_get_contents(base_path('../db/migrations/2026_05_23_200_supplier_lead_deliveries.sql'));
+        if ($sql === false) {
+            throw new RuntimeException('Migration SQL file not found.');
+        }
+        // Prod: crm_app_user (default pgsql) не имеет CREATE на schema public.
+        // Используем pgsql_supplier (crm_supplier_worker, BYPASSRLS, имеет CREATE).
+        // На dev pgsql_supplier тоже = postgres superuser → работает идентично.
+        DB::connection('pgsql_supplier')->unprepared($sql);
+    }
+
+    public function down(): void
+    {
+        DB::connection('pgsql_supplier')->unprepared('DROP TABLE IF EXISTS supplier_lead_deliveries CASCADE;');
+    }
+};

app/database/migrations/2026_05_23_201000_drop_deals_duplicate_of_id_index.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+
+return new class extends Migration
+{
+    /**
+     * No-op миграция-маркер (Billing v2 Spec B): телефонный дедуп удалён,
+     * индекс deals_duplicate_of_id_idx становится неиспользуемым (колонка
+     * deals.duplicate_of_id оставлена спящей — drop отдельной DBA-задачей,
+     * mirrors Spec A balance_leads two-phase).
+     *
+     * Почему миграция no-op: индекс владельца crm_migrator, DROP требует прав
+     * owner; .env не имеет crm_migrator credentials, а pgsql_supplier
+     * (crm_supplier_worker) не владеет индексами на partitioned deals. Запуск
+     * DROP отложен — выполняется напрямую psql под postgres-superuser отдельно.
+     * Эта миграция только маркер «обработано», чтобы migrate --force не падал.
+     *
+     * На dev (postgres-superuser) индекс уже отсутствует из schema.sql v8.34,
+     * поэтому ничего не делаем — тоже корректно.
+     */
+    public function up(): void
+    {
+        // Intentionally empty.
+    }
+
+    public function down(): void
+    {
+        // No-op: recreation is unnecessary (concept removed).
+    }
+};

app/database/migrations/2026_05_24_140000_drop_legacy_webhook_artefacts.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    /**
+     * Удаление legacy-артефактов прямого webhook-канала.
+     *
+     * Spec: docs/superpowers/specs/2026-05-24-legacy-direct-webhook-removal-design.md
+     * Plan: docs/superpowers/plans/2026-05-24-legacy-direct-webhook-removal.md
+     *
+     * Что удаляем (финальный список по результатам Phase 1 impact-checks):
+     *   - webhook_log (partitioned, 13 партиций) — пустая на проде, источник = только удалённый ProcessWebhookJob
+     *   - rejected_deals_log — writer только ProcessWebhookJob, нет readers
+     *   - tenants.webhook_token + tenants.webhook_token_rotated_at — нет в UI/API, тесты почищены ниже
+     *   - system_settings.low_balance_threshold_leads (seed) — только legacy
+     *
+     * Phase 1 RED FLAG: webhook_dedup_keys ОСТАЁТСЯ (HistoricalImportService — CSV-канал).
+     *
+     * pgsql_supplier connection — BYPASSRLS-роль crm_supplier_worker (паттерн Спека B):
+     * под обычной crm_app_user DROP/ALTER без app.current_tenant_id GUC не пройдёт.
+     */
+    public function up(): void
+    {
+        $conn = DB::connection('pgsql_supplier');
+
+        // Partitioned table — DROP TABLE каскадит все 13 партиций.
+        $conn->statement('DROP TABLE IF EXISTS webhook_log CASCADE');
+
+        // NB: webhook_dedup_keys НЕ дропаем — Phase 1 RED FLAG, живой через HistoricalImportService (CSV-канал).
+
+        // RejectedDealsLog — writer только удалённый ProcessWebhookJob, readers нет.
+        $conn->statement('DROP TABLE IF EXISTS rejected_deals_log CASCADE');
+
+        // tenants.webhook_token + webhook_token_rotated_at — нет в UI/API.
+        $conn->statement('ALTER TABLE tenants DROP COLUMN IF EXISTS webhook_token, DROP COLUMN IF EXISTS webhook_token_rotated_at');
+
+        // Legacy threshold-cross seed (caller — удалённый ProcessWebhookJob).
+        $conn->statement("DELETE FROM system_settings WHERE key = 'low_balance_threshold_leads'");
+    }
+
+    /**
+     * Откат — пустая заглушка. Прод-restore из pg_dump backup.
+     * Этот метод существует только чтобы migrate:rollback не падал.
+     */
+    public function down(): void
+    {
+        // НЕ восстанавливаем структуру — пустая заглушка.
+        // Прод-restore — из pg_dump backup (см. runbook docs/deploy/test-server-runbook.md).
+    }
+};

app/database/migrations/2026_05_25_100000_add_unparseable_count_to_supplier_csv_reconcile_log.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+/**
+ * supplier_csv_reconcile_log + unparseable_count: количество CSV-строк
+ * за окно reconcile, у которых поле «project» не парсится в платформу
+ * (поставщик иногда кладёт телефон/URL в Name → extractPlatform = null,
+ * строка скипается в csv_reconcile.unparseable_project_skipped).
+ *
+ * Раньше эти строки попадали в знаменатель drift_ratio и счётчик missing,
+ * стабильно завышая drift до ~40-50% (false-positive drift_alert каждый
+ * запуск). Теперь они учитываются отдельно и вычитаются из формулы.
+ *
+ * Используется в CsvReconcileJob + AdminSupplierIntegrationController.
+ * Таблица SaaS-level (без RLS), пишет/читает crm_supplier_worker
+ * (BYPASSRLS) — pgsql_supplier connection.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        $conn = DB::connection('pgsql_supplier');
+
+        if (! $conn->getSchemaBuilder()->hasTable('supplier_csv_reconcile_log')) {
+            return;
+        }
+
+        $conn->unprepared(<<<'SQL'
+            ALTER TABLE supplier_csv_reconcile_log
+                ADD COLUMN IF NOT EXISTS unparseable_count INTEGER NOT NULL DEFAULT 0;
+        SQL);
+    }
+
+    public function down(): void
+    {
+        $conn = DB::connection('pgsql_supplier');
+
+        if (! $conn->getSchemaBuilder()->hasTable('supplier_csv_reconcile_log')) {
+            return;
+        }
+
+        $conn->unprepared(<<<'SQL'
+            ALTER TABLE supplier_csv_reconcile_log
+                DROP COLUMN IF EXISTS unparseable_count;
+        SQL);
+    }
+};

app/resources/views/emails/low_balance.blade.php

@@ -1,26 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru">
-<head>
-    <meta charset="UTF-8">
-    <title>Низкий баланс</title>
-</head>
-<body style="font-family: Inter, -apple-system, sans-serif; max-width: 600px; margin: 0 auto; padding: 24px; color: #081319;">
-    <h1 style="color: #0F6E56; font-size: 20px;">Лидерра. Низкий баланс</h1>
-
-    <p>Здравствуйте, {{ $recipient->first_name ?? $recipient->email }}.</p>
-
-    <p>На балансе аккаунта <strong>{{ $tenant->organization_name ?? $tenant->subdomain }}</strong>
-    осталось <strong>{{ $tenant->balance_leads }} лидов</strong>
-    (порог уведомления — {{ $thresholdLeads }} лидов).</p>
-
-    <p style="background: #FEF3F2; padding: 12px; border-left: 3px solid #B94837;">
-        Если баланс закончится — все входящие лиды будут отклоняться.
-    </p>
-
-    <p style="margin-top: 24px;">Откройте Биллинг в CRM, чтобы пополнить баланс.</p>
-
-    <p style="color: #66635C; font-size: 12px; margin-top: 32px;">
-        Это автоматическое уведомление о событии «Низкий баланс». Чтобы изменить настройки уведомлений — перейдите в Настройки → Уведомления.
-    </p>
-</body>
-</html>

app/resources/views/emails/zero_balance.blade.php

@@ -1,27 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru">
-<head>
-    <meta charset="UTF-8">
-    <title>Баланс закончился</title>
-</head>
-<body style="font-family: Inter, -apple-system, sans-serif; max-width: 600px; margin: 0 auto; padding: 24px; color: #081319;">
-    <h1 style="color: #B94837; font-size: 20px;">Лидерра. Баланс закончился</h1>
-
-    <p>Здравствуйте, {{ $recipient->first_name ?? $recipient->email }}.</p>
-
-    <p>Баланс аккаунта <strong>{{ $tenant->organization_name ?? $tenant->subdomain }}</strong>
-    обнулился — <strong>входящие лиды отклоняются</strong>.</p>
-
-    <p style="background: #FEF3F2; padding: 12px; border-left: 3px solid #B94837;">
-        <strong>Что делать:</strong> пополните баланс в разделе Биллинг.
-        После пополнения новые лиды снова начнут приниматься.
-    </p>
-
-    <p>Уже отклонённые лиды не возвращаются — посмотрите их в журнале
-    «Отклонённые лиды» в разделе Отчёты.</p>
-
-    <p style="color: #66635C; font-size: 12px; margin-top: 32px;">
-        Это автоматическое уведомление о событии «Нулевой баланс». Чтобы изменить настройки уведомлений — перейдите в Настройки → Уведомления.
-    </p>
-</body>
-</html>

app/routes/web.php

@@ -270,12 +270,6 @@ Route::middleware(['auth:sanctum', 'tenant'])->prefix('/api/projects')->group(fu
     Route::patch('/{id}/toggle-active', 'App\Http\Controllers\Api\ProjectController@toggleActive')->name('projects.toggle')->where('id', '[0-9]+');
 });
 
-// Receive endpoint для входящих webhook'ов (narrative §5.5).
-// Auth — по `tenants.webhook_token` в URL (без middleware, проверка внутри controller).
-// На prod: + HMAC-валидация X-Webhook-Signature + per-token rate-limit.
-Route::post('/api/webhook/{token}', 'App\Http\Controllers\Api\WebhookReceiveController@receive')
-    ->where('token', '[A-Za-z0-9\-_]+');
-
 // Supplier-integration webhook (Plan 2/5, spec §5.1).
 // Platform-wide endpoint: единый {secret} в URL для всех лидов от crm.bp-gr.ru.
 // Auth: secret (system_settings.supplier_webhook_secret) + IP allowlist

app/storage/_demo_split_tenants.php

@@ -77,7 +77,6 @@ foreach ($accounts as $a) {
         [
             'organization_name' => $a['org_name'],
             'contact_email' => $user->email,
-            'webhook_token' => Str::random(64),
             'timezone' => 'Europe/Moscow',
             'locale' => 'ru',
             'is_trial' => true,

app/tests/Feature/Admin/AdminPdSubjectRequestsControllerTest.php

@@ -164,7 +164,6 @@ it('executeErasure anonymises user email first_name phone and writes pd_processi
         'organization_name' => 'PD User Test',
         'contact_email' => 'pd-u@test.local',
         'status' => 'active',
-        'webhook_token' => bin2hex(random_bytes(16)),
         'balance_rub' => '0.00',
         'balance_leads' => 0,
         'is_trial' => false,

app/tests/Feature/AdminBillingActionsTest.php

@@ -14,7 +14,6 @@ function makeBillingTenant(array $overrides = []): int
         'subdomain' => 'bt-'.bin2hex(random_bytes(4)),
         'organization_name' => 'Billing Test Co',
         'contact_email' => 'bt-'.bin2hex(random_bytes(3)).'@test.local',
-        'webhook_token' => bin2hex(random_bytes(16)),
         'status' => 'active',
         'balance_rub' => '5000.00',
         'is_trial' => false,

app/tests/Feature/AdminIncidentShowTest.php

@@ -64,7 +64,6 @@ test('GET /api/admin/incidents/{id} разрешает имена affected_tenan
         'subdomain' => 'inc-'.bin2hex(random_bytes(4)),
         'organization_name' => 'Affected Org',
         'contact_email' => 'a@test.local',
-        'webhook_token' => bin2hex(random_bytes(16)),
         'created_at' => now(),
     ]);
     $id = makeShowIncident($this->adminId, ['affected_tenant_ids' => '{'.$tenantId.'}']);

app/tests/Feature/Console/PartitionsDropExpiredTest.php

@@ -6,8 +6,11 @@ use App\Services\MonthlyPartitionManager;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\DB;
+use Tests\Concerns\SharesSupplierPdo;
 
-uses(DatabaseTransactions::class);
+uses(DatabaseTransactions::class, SharesSupplierPdo::class);
+// ensureMonth/dropPartition теперь идут через pgsql_supplier — нужен shared PDO,
+// иначе CREATE/DROP уйдут мимо test-транзакции (см. MonthlyPartitionManager::DDL_CONNECTION).
 
 // ---------------------------------------------------------------------------
 // Guard: check whether auth_log is partitioned. Tests in this file require

app/tests/Feature/Console/VerifyAuditChainsTest.php

@@ -69,7 +69,6 @@ function ensureTenant(int $seed): int
         'organization_name' => "Test Chain {$seed}",
         'subdomain' => "test-chain-{$seed}",
         'contact_email' => "chain{$seed}@example.com",
-        'webhook_token' => bin2hex(random_bytes(16))."-seed{$seed}",
         'status' => 'active',
         'created_at' => now(),
         'updated_at' => now(),

app/tests/Feature/Http/Webhook/SupplierWebhookLoggingTest.php

@@ -1,109 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Models\SystemSetting;
-use Illuminate\Foundation\Testing\DatabaseTransactions;
-use Illuminate\Support\Facades\Bus;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\RateLimiter;
-
-uses(DatabaseTransactions::class);
-
-beforeEach(function () {
-    SystemSetting::query()->where('key', 'supplier_webhook_secret')->update(['value' => 'test-secret-32chars-aaaaaaaaaaaaaa']);
-    SystemSetting::query()->where('key', 'supplier_ip_allowlist')->update(['value' => '[]']);
-    // Clear rate limiter between tests
-    RateLimiter::clear('supplier-webhook:127.0.0.1');
-});
-
-it('logs status=received when lead is accepted (202)', function () {
-    Bus::fake();
-
-    $this->postJson('/api/webhook/supplier/test-secret-32chars-aaaaaaaaaaaaaa', [
-        'vid' => 900001,
-        'project' => 'B1_log-test.ru',
-        'phone' => '79991234567',
-        'time' => time(),
-    ])->assertStatus(202);
-
-    $log = DB::table('webhook_log')
-        ->where('status', 'received')
-        ->where('source', 'supplier')
-        ->latest('created_at')
-        ->first();
-
-    expect($log)->not->toBeNull();
-    expect($log->status)->toBe('received');
-    expect($log->source)->toBe('supplier');
-    expect($log->tenant_id)->toBeNull();
-});
-
-it('logs status=rejected_secret when secret is wrong (404)', function () {
-    $this->postJson('/api/webhook/supplier/wrong-secret-here', [
-        'vid' => 900002,
-        'project' => 'B1_log-test.ru',
-        'phone' => '79991234567',
-        'time' => time(),
-    ])->assertStatus(404);
-
-    $log = DB::table('webhook_log')
-        ->where('status', 'rejected_secret')
-        ->where('source', 'supplier')
-        ->latest('created_at')
-        ->first();
-
-    expect($log)->not->toBeNull();
-    expect($log->status)->toBe('rejected_secret');
-    expect($log->tenant_id)->toBeNull();
-});
-
-it('logs status=rejected_ip when IP is not in allowlist (404)', function () {
-    SystemSetting::query()->where('key', 'supplier_ip_allowlist')
-        ->update(['value' => '["1.2.3.4"]']);
-
-    $this->withServerVariables(['REMOTE_ADDR' => '5.6.7.8'])
-        ->postJson('/api/webhook/supplier/test-secret-32chars-aaaaaaaaaaaaaa', [
-            'vid' => 900003,
-            'project' => 'B1_log-test.ru',
-            'phone' => '79991234567',
-            'time' => time(),
-        ])->assertStatus(404);
-
-    $log = DB::table('webhook_log')
-        ->where('status', 'rejected_ip')
-        ->where('source', 'supplier')
-        ->latest('created_at')
-        ->first();
-
-    expect($log)->not->toBeNull();
-    expect($log->status)->toBe('rejected_ip');
-    expect($log->tenant_id)->toBeNull();
-});
-
-it('logs status=rate_limited when per-IP rate limit exceeded (429)', function () {
-    Bus::fake();
-    // Saturate the rate limiter
-    $key = 'supplier-webhook:127.0.0.1';
-    $limit = 600; // RATE_LIMIT_PER_MINUTE constant
-    for ($i = 0; $i < $limit; $i++) {
-        RateLimiter::hit($key, 60);
-    }
-
-    $this->postJson('/api/webhook/supplier/test-secret-32chars-aaaaaaaaaaaaaa', [
-        'vid' => 900004,
-        'project' => 'B1_log-test.ru',
-        'phone' => '79991234567',
-        'time' => time(),
-    ])->assertStatus(429);
-
-    $log = DB::table('webhook_log')
-        ->where('status', 'rate_limited')
-        ->where('source', 'supplier')
-        ->latest('created_at')
-        ->first();
-
-    expect($log)->not->toBeNull();
-    expect($log->status)->toBe('rate_limited');
-    expect($log->tenant_id)->toBeNull();
-});

app/tests/Feature/Import/HistoricalImportServiceTest.php

@@ -12,8 +12,12 @@ use App\Services\Import\CsvLeadsParser;
 use App\Services\Import\HistoricalImportService;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Facades\DB;
+use Tests\Concerns\SharesSupplierPdo;
 
-uses(DatabaseTransactions::class);
+uses(DatabaseTransactions::class, SharesSupplierPdo::class);
+// HistoricalImportService::importBatch вызывает MonthlyPartitionManager::ensureRange,
+// которая делает CREATE через pgsql_supplier — нужен shared PDO, иначе DDL уйдёт
+// мимо test-транзакции.
 
 beforeEach(function (): void {
     $this->tenant = Tenant::factory()->create(['balance_leads' => 5]);

app/tests/Feature/Import/ImportLeadsJobTest.php

@@ -14,8 +14,11 @@ use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Mail;
 use Illuminate\Support\Facades\Storage;
+use Tests\Concerns\SharesSupplierPdo;
 
-uses(DatabaseTransactions::class);
+uses(DatabaseTransactions::class, SharesSupplierPdo::class);
+// ImportLeadsJob запускает HistoricalImportService → MonthlyPartitionManager →
+// CREATE через pgsql_supplier. Нужен shared PDO.
 
 beforeEach(function (): void {
     $this->tenant = Tenant::factory()->create();

app/tests/Feature/Import/MonthlyPartitionManagerTest.php

@@ -6,8 +6,11 @@ use App\Services\MonthlyPartitionManager;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\DB;
+use Tests\Concerns\SharesSupplierPdo;
 
-uses(DatabaseTransactions::class);
+uses(DatabaseTransactions::class, SharesSupplierPdo::class);
+// ensureMonth теперь делает CREATE через pgsql_supplier (см. MonthlyPartitionManager::DDL_CONNECTION).
+// Без SharesSupplierPdo DDL уйдёт мимо test-транзакции и партиции протечь в test DB.
 
 function partitionExists(string $name): bool
 {

app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php

@@ -9,7 +9,6 @@ use App\Models\SupplierLead;
 use App\Models\SupplierProject;
 use App\Models\Tenant;
 use App\Services\Billing\LedgerService;
-use App\Services\DuplicateDetector;
 use App\Services\LeadDistributor;
 use App\Services\LeadRouter;
 use App\Services\NotificationService;
@@ -38,7 +37,6 @@ function runRouteJob(int $supplierLeadId): void
     (new RouteSupplierLeadJob($supplierLeadId))->handle(
         app(LeadRouter::class),
         app(SupplierProjectResolver::class),
-        app(DuplicateDetector::class),
         app(NotificationService::class),
         app(LedgerService::class),
         app(LeadDistributor::class),
@@ -56,11 +54,13 @@ it('is terminal (does not throw / re-queue) when the supplier lead does not exis
     $missingId = 999999;
     expect(SupplierLead::find($missingId))->toBeNull();
 
+    $countBefore = DB::table('deals')->count();
+
     // Не должно бросать исключение (иначе сработает failed() -> retry-цикл).
     runRouteJob($missingId);
 
-    // Никаких побочных эффектов.
-    expect(Deal::count())->toBe(0);
+    // Никаких побочных эффектов — количество сделок не изменилось.
+    expect(DB::table('deals')->count())->toBe($countBefore);
 });
 
 it('routes 1 lead to N tenants — creates N deal copies (sharing-model)', function (): void {
@@ -73,7 +73,7 @@ it('routes 1 lead to N tenants — creates N deal copies (sharing-model)', funct
     $tenants = collect();
     $projects = collect();
     for ($i = 0; $i < 3; $i++) {
-        $t = Tenant::factory()->create(['balance_leads' => 100]);
+        $t = Tenant::factory()->create(['balance_rub' => '100000.00']);
         $tenants->push($t);
         $projects->push(Project::factory()->create([
             'tenant_id' => $t->id,
@@ -125,13 +125,13 @@ it('routes 1 lead to N tenants — creates N deal copies (sharing-model)', funct
     }
 });
 
-it('decrements balance_leads for each tenant by 1', function (): void {
+it('charges balance_rub for tenant after routing', function (): void {
     $supplier = SupplierProject::factory()->create([
         'platform' => 'B1',
         'signal_type' => 'site',
         'unique_key' => 'test.ru',
     ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $project = Project::factory()->create([
         'tenant_id' => $tenant->id,
         'supplier_b1_project_id' => $supplier->id,
@@ -152,55 +152,7 @@ it('decrements balance_leads for each tenant by 1', function (): void {
 
     runRouteJob($lead->id);
 
-    expect($tenant->fresh()->balance_leads)->toBe(99);
-});
-
-it('marks duplicate via DuplicateDetector — no charge, no counter increment', function (): void {
-    $supplier = SupplierProject::factory()->create([
-        'platform' => 'B1',
-        'signal_type' => 'site',
-        'unique_key' => 'test.ru',
-    ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
-    $project = Project::factory()->create([
-        'tenant_id' => $tenant->id,
-        'supplier_b1_project_id' => $supplier->id,
-        'signal_type' => 'site',
-        'signal_identifier' => 'test.ru',
-        'is_active' => true,
-        'delivered_today' => 0,
-    ]);
-    linkProjectToSupplier($project, $supplier);
-
-    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
-    $master = Deal::create([
-        'tenant_id' => $tenant->id,
-        'source_crm_id' => 999,
-        'project_id' => $project->id,
-        'phone' => '79991234567',
-        'phones' => ['79991234567'],
-        'status' => 'new',
-        'received_at' => now()->subHours(2),
-    ]);
-
-    $vid = 1000;
-    $lead = SupplierLead::factory()->create([
-        'supplier_project_id' => null,
-        'platform' => 'B1',
-        'vid' => $vid,
-        'phone' => '79991234567',
-        'raw_payload' => ['vid' => $vid, 'project' => 'B1_test.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
-    ]);
-
-    runRouteJob($lead->id);
-
-    expect($tenant->fresh()->balance_leads)->toBe(100);
-    expect($project->fresh()->delivered_today)->toBe(0);
-
-    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
-    $duplicate = Deal::where('source_crm_id', $vid)->first();
-    expect($duplicate)->not->toBeNull();
-    expect($duplicate->duplicate_of_id)->toBe($master->id);
+    expect((string) $tenant->fresh()->balance_rub)->toBe('99500.00');
 });
 
 it('throws DomainException when payload encodes B1+SMS combo', function (): void {
@@ -234,7 +186,7 @@ it('handles orphan supplier_project (no matching liderra-projects) — 0 deals,
     expect($lead->supplier_project_id)->not->toBeNull();
 });
 
-it('handles mixed routing: 3 projects, 1 with pre-existing master (dup), 2 clean', function (): void {
+it('same phone pre-existing does not suppress new delivery (Spec B)', function (): void {
     $supplier = SupplierProject::factory()->create([
         'platform' => 'B1',
         'signal_type' => 'site',
@@ -244,7 +196,7 @@ it('handles mixed routing: 3 projects, 1 with pre-existing master (dup), 2 clean
     $tenants = collect();
     $projects = collect();
     for ($i = 0; $i < 3; $i++) {
-        $t = Tenant::factory()->create(['balance_leads' => 100]);
+        $t = Tenant::factory()->create(['balance_rub' => '100000.00']);
         $tenants->push($t);
         $projects->push(Project::factory()->create([
             'tenant_id' => $t->id,
@@ -258,14 +210,14 @@ it('handles mixed routing: 3 projects, 1 with pre-existing master (dup), 2 clean
         linkProjectToSupplier($projects->last(), $supplier);
     }
 
-    // Tenant #0 имеет master deal с тем же phone в окне 24 ч — будет дубль.
-    $masterTenant = $tenants[0];
-    $masterProject = $projects[0];
-    DB::statement("SET LOCAL app.current_tenant_id = '{$masterTenant->id}'");
-    $master = Deal::create([
-        'tenant_id' => $masterTenant->id,
+    // Tenant #0 имеет pre-existing deal с тем же phone — под новым правилом НЕ подавляет.
+    $firstTenant = $tenants[0];
+    $firstProject = $projects[0];
+    DB::statement("SET LOCAL app.current_tenant_id = '{$firstTenant->id}'");
+    Deal::create([
+        'tenant_id' => $firstTenant->id,
         'source_crm_id' => 555,
-        'project_id' => $masterProject->id,
+        'project_id' => $firstProject->id,
         'phone' => '79991234567',
         'phones' => ['79991234567'],
         'status' => 'new',
@@ -285,22 +237,19 @@ it('handles mixed routing: 3 projects, 1 with pre-existing master (dup), 2 clean
 
     $lead->refresh();
     expect($lead->processed_at)->not->toBeNull();
-    expect($lead->deals_created_count)->toBe(2); // 2 чистых, 1 дубль не считается
+    // Spec B: pre-existing master does NOT suppress — all 3 charged.
+    expect($lead->deals_created_count)->toBe(3);
 
-    // Tenant #0: deal помечен duplicate_of_id, balance НЕ списан, delivered_today = 0
-    expect($masterTenant->fresh()->balance_leads)->toBe(100);
-    expect($masterProject->fresh()->delivered_today)->toBe(0);
-    DB::statement("SET LOCAL app.current_tenant_id = '{$masterTenant->id}'");
-    $dupDeal = Deal::query()->where('source_crm_id', $vid)->first();
-    expect($dupDeal->duplicate_of_id)->toBe($master->id);
-
-    // Tenant #1, #2: balance списан, delivered_today инкрементирован
-    foreach ([1, 2] as $i) {
+    // All 3 tenants: balance decremented, delivered_today incremented.
+    foreach (range(0, 2) as $i) {
         $t = $tenants[$i];
         $p = $projects[$i];
-        expect($t->fresh()->balance_leads)->toBe(99);
+        expect((string) $t->fresh()->balance_rub)->toBe('99500.00');
         expect($p->fresh()->delivered_today)->toBe(1);
     }
+
+    // 3 deal rows exist for this vid (one per tenant).
+    expect(Deal::query()->where('source_crm_id', $vid)->count())->toBe(3);
 });
 
 it('idempotent on retry — second handle() returns early, no ghost duplicate deals (Plan 2.5 fix #3)', function (): void {
@@ -317,7 +266,7 @@ it('idempotent on retry — second handle() returns early, no ghost duplicate de
         'signal_type' => 'site',
         'unique_key' => 'retry-idempotent.ru',
     ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $project = Project::factory()->create([
         'tenant_id' => $tenant->id,
         'supplier_b1_project_id' => $supplier->id,
@@ -347,7 +296,7 @@ it('idempotent on retry — second handle() returns early, no ghost duplicate de
     $lead->refresh();
     expect($lead->processed_at)->not->toBeNull();
     expect($lead->deals_created_count)->toBe(1);
-    expect($tenant->fresh()->balance_leads)->toBe(99);
+    expect((string) $tenant->fresh()->balance_rub)->toBe('99500.00');
     expect($project->fresh()->delivered_today)->toBe(1);
 
     DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
@@ -362,7 +311,7 @@ it('idempotent on retry — second handle() returns early, no ghost duplicate de
     expect($lead->deals_created_count)->toBe(1);
 
     // НИКАКИХ дублей не появилось: balance, counter, deal-row.
-    expect($tenant->fresh()->balance_leads)->toBe(99);
+    expect((string) $tenant->fresh()->balance_rub)->toBe('99500.00');
     expect($project->fresh()->delivered_today)->toBe(1);
 
     DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
@@ -385,7 +334,7 @@ it('handles partial failure: one project throws, others continue routing', funct
     $tenants = collect();
     $projects = collect();
     for ($i = 0; $i < 3; $i++) {
-        $t = Tenant::factory()->create(['balance_leads' => 100]);
+        $t = Tenant::factory()->create(['balance_rub' => '100000.00']);
         $tenants->push($t);
         $projects->push(Project::factory()->create([
             'tenant_id' => $t->id,
@@ -417,8 +366,8 @@ it('handles partial failure: one project throws, others continue routing', funct
     expect($lead->deals_created_count)->toBe(2); // tenant 0 + 2; tenant 1 упал
 
     // Tenants 0 и 2 успешно списаны
-    expect($tenants[0]->fresh()->balance_leads)->toBe(99);
-    expect($tenants[2]->fresh()->balance_leads)->toBe(99);
+    expect((string) $tenants[0]->fresh()->balance_rub)->toBe('99500.00');
+    expect((string) $tenants[2]->fresh()->balance_rub)->toBe('99500.00');
 });
 
 it('routes B1 lead whose project name embeds a domain in free text (carmoney/caranga/krk)', function (string $projectField, string $domain): void {
@@ -431,7 +380,7 @@ it('routes B1 lead whose project name embeds a domain in free text (carmoney/car
         'signal_type' => 'site',
         'unique_key' => $domain,
     ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $project = Project::factory()->create([
         'tenant_id' => $tenant->id,
         'supplier_b1_project_id' => $supplier->id,
@@ -486,7 +435,7 @@ it('rejects deal copy if delivered_today >= limit at lock time (Plan 2.5 fix #2
         'signal_type' => 'site',
         'unique_key' => 'race-recheck.ru',
     ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $project = Project::factory()->create([
         'tenant_id' => $tenant->id,
         'supplier_b1_project_id' => $supplier->id,
@@ -532,8 +481,8 @@ it('rejects deal copy if delivered_today >= limit at lock time (Plan 2.5 fix #2
     // delivered_in_month НЕ инкрементнулся.
     expect($project->fresh()->delivered_in_month)->toBe(5);
 
-    // balance_leads НЕ списан.
-    expect($tenant->fresh()->balance_leads)->toBe(100);
+    // balance_rub НЕ списан.
+    expect((string) $tenant->fresh()->balance_rub)->toBe('100000.00');
 
     // Deal-row не создался.
     DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
@@ -553,7 +502,7 @@ it('caps deal creation at 3 recipients and tags deal with subject from payload',
 
     // 5 eligible клиентов, привязанных к sp через pivot, с балансом и лимитом
     foreach (range(1, 5) as $i) {
-        $t = Tenant::factory()->create(['balance_leads' => 100]);
+        $t = Tenant::factory()->create(['balance_rub' => '100000.00']);
         $p = Project::factory()->create([
             'tenant_id' => $t->id, 'is_active' => true,
             'daily_limit_target' => 10, 'delivered_today' => 0, 'delivery_days_mask' => 127,
@@ -573,7 +522,6 @@ it('caps deal creation at 3 recipients and tags deal with subject from payload',
     (new RouteSupplierLeadJob($lead->id))->handle(
         app(LeadRouter::class),
         app(SupplierProjectResolver::class),
-        app(DuplicateDetector::class),
         app(NotificationService::class),
         app(LedgerService::class),
         app(LeadDistributor::class),

app/tests/Feature/Notifications/BalanceNotificationsTest.php

@@ -2,19 +2,13 @@
 
 declare(strict_types=1);
 
-use App\Jobs\ProcessWebhookJob;
 use App\Mail\InvoicePaidNotification;
-use App\Mail\LowBalanceNotification;
 use App\Mail\TopupSuccessNotification;
-use App\Mail\ZeroBalanceNotification;
 use App\Models\InAppNotification;
-use App\Models\RejectedDealsLog;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\NotificationService;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
-use Illuminate\Support\Carbon;
-use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Mail;
 
 uses(DatabaseTransactions::class);
@@ -23,18 +17,6 @@ beforeEach(function () {
     Mail::fake();
 });
 
-function balancePayload(int $vid = 500): array
-{
-    return [
-        'vid' => $vid,
-        'project' => 'B2_Caranga',
-        'tag' => 'Caranga',
-        'phone' => '79000000'.$vid,
-        'phones' => ['79000000'.$vid],
-        'time' => time(),
-    ];
-}
-
 function makeUserForBalance(Tenant $tenant, string $email, array $events = []): User
 {
     return User::factory()->create([
@@ -53,102 +35,6 @@ function makeUserForBalance(Tenant $tenant, string $email, array $events = []):
     ]);
 }
 
-// ============== low_balance ==============
-
-test('low_balance: при пересечении порога сверху-вниз → email + inapp', function () {
-    // Default threshold: 10 (system_settings seeded). Установим balance=11.
-    $tenant = Tenant::factory()->create(['balance_leads' => 11]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(10);  // 11 → 10 (пересекли порог)
-
-    Mail::assertSent(LowBalanceNotification::class, 1);
-    expect(InAppNotification::query()->where('event', 'low_balance')->count())->toBe(1);
-});
-
-test('low_balance: balance уже < threshold — НЕ шлёт повторно', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 5]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(4);  // 5 → 4 (всё ещё < threshold=10)
-
-    // Не пересекали порог — НЕ шлём.
-    Mail::assertNothingSent();
-    expect(InAppNotification::query()->where('event', 'low_balance')->count())->toBe(0);
-});
-
-test('low_balance: balance > threshold после decrement — НЕ шлёт', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 50]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(49);
-
-    Mail::assertNothingSent();
-});
-
-test('low_balance: prefs.low_balance.email=false — только inapp', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 11]);
-    makeUserForBalance($tenant, 'on@example.ru', [
-        'low_balance' => ['email' => false, 'inapp' => true],
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    Mail::assertNothingSent();
-    expect(InAppNotification::query()->where('event', 'low_balance')->count())->toBe(1);
-});
-
-// ============== zero_balance ==============
-
-test('zero_balance: первое отклонение → email + inapp', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    Mail::assertSent(ZeroBalanceNotification::class, 1);
-    expect(InAppNotification::query()->where('event', 'zero_balance')->count())->toBe(1);
-    expect(RejectedDealsLog::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
-});
-
-test('zero_balance: 2-е отклонение в течение часа — НЕ дублирует email', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    (new ProcessWebhookJob($tenant->id, balancePayload(vid: 1)))->handle();
-    Mail::assertSent(ZeroBalanceNotification::class, 1);
-
-    (new ProcessWebhookJob($tenant->id, balancePayload(vid: 2)))->handle();
-    Mail::assertSent(ZeroBalanceNotification::class, 1);  // всё ещё один
-    expect(RejectedDealsLog::query()->where('tenant_id', $tenant->id)->count())->toBe(2);
-});
-
-test('zero_balance: отклонение через >1ч — снова шлёт', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-    makeUserForBalance($tenant, 'on@example.ru');
-
-    // Создаём старый RejectedDealsLog (>1ч назад) — он не должен суппрессить.
-    DB::table('rejected_deals_log')->insert([
-        'tenant_id' => $tenant->id,
-        'reason' => RejectedDealsLog::REASON_ZERO_BALANCE,
-        'payload' => json_encode(['vid' => 999]),
-        'created_at' => Carbon::now()->subHours(2),
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, balancePayload()))->handle();
-
-    Mail::assertSent(ZeroBalanceNotification::class, 1);
-});
-
 // ============== topup_success ==============
 
 test('topup_success: notifyTopupSuccess создаёт email + inapp', function () {
@@ -204,18 +90,3 @@ test('invoice_paid: prefs=email:false — только inapp', function () {
     Mail::assertNothingSent();
     expect(InAppNotification::query()->where('event', 'invoice_paid')->count())->toBe(1);
 });
-
-// ============== isolation ==============
-
-test('balance events изолированы между тенантами', function () {
-    $tenantA = Tenant::factory()->create(['balance_leads' => 11]);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 11]);
-    $userA = makeUserForBalance($tenantA, 'a@example.ru');
-    makeUserForBalance($tenantB, 'b@example.ru');
-
-    (new ProcessWebhookJob($tenantA->id, balancePayload()))->handle();
-
-    Mail::assertSent(LowBalanceNotification::class, 1);
-    Mail::assertSent(fn (LowBalanceNotification $m) => $m->hasTo($userA->email));
-    Mail::assertNotSent(fn (LowBalanceNotification $m) => $m->hasTo('b@example.ru'));
-});

app/tests/Feature/Notifications/InAppNotificationTest.php

@@ -2,8 +2,6 @@
 
 declare(strict_types=1);
 
-use App\Jobs\ProcessWebhookJob;
-use App\Mail\NewLeadNotification;
 use App\Models\InAppNotification;
 use App\Models\Tenant;
 use App\Models\User;
@@ -14,12 +12,8 @@ use Illuminate\Support\Facades\Mail;
 /**
  * Тесты in-app канала уведомлений (schema v8.10 in_app_notifications).
  *
- * Канал inapp в матрице users.notification_preferences. INSERT row при
- * триггере события (new_lead/...). UI читает unread-count и список
- * последних 50 (этап 2b — отдельный коммит).
- *
- * Schema-default: notification_preferences.new_lead.inapp=true → в отличие
- * от email, большинство user'ов получает in-app по умолчанию.
+ * Тесты через ProcessWebhookJob удалены — job убран как legacy-рудимент.
+ * Оставлен прямой вызов NotificationService::notifyInApp.
  */
 uses(DatabaseTransactions::class);
 
@@ -27,164 +21,6 @@ beforeEach(function () {
     Mail::fake();
 });
 
-/**
- * @return array<string, mixed>
- */
-function inAppPayload(int $vid = 300, ?int $time = null): array
-{
-    return [
-        'vid' => $vid,
-        'project' => 'B2_Caranga',
-        'tag' => 'Caranga',
-        'phone' => '79001234567',
-        'phones' => ['79001234567'],
-        'time' => $time ?? time(),
-    ];
-}
-
-/**
- * @param  array<string, mixed>  $newLeadPrefs
- */
-function makeUserWithInAppPrefs(Tenant $tenant, string $email, array $newLeadPrefs): User
-{
-    return User::factory()->create([
-        'tenant_id' => $tenant->id,
-        'email' => $email,
-        'notification_preferences' => [
-            'new_lead' => $newLeadPrefs,
-            'reminder' => ['inapp' => true, 'push' => true, 'email' => true],
-            'low_balance' => ['email' => true],
-            'zero_balance' => ['email' => true],
-            'topup_success' => ['email' => true],
-            'invoice_paid' => ['email' => true],
-            'new_device_login' => ['email' => true],
-            'marketing' => ['email' => false],
-        ],
-    ]);
-}
-
-test('webhook: in_app_notification создаётся для user с inapp=true', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $user = makeUserWithInAppPrefs($tenant, 'on@example.ru', ['inapp' => true, 'email' => false]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(1);
-    $notif = InAppNotification::query()->first();
-    expect($notif->user_id)->toBe($user->id);
-    expect($notif->tenant_id)->toBe($tenant->id);
-    expect($notif->event)->toBe('new_lead');
-    expect($notif->title)->toContain('Caranga');
-    expect($notif->body)->toBe('79001234567');  // phone (no contact_name)
-    expect($notif->read_at)->toBeNull();
-    expect($notif->payload['project_name'])->toBe('Caranga');
-});
-
-test('webhook: user с inapp=false НЕ получает in-app row', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithInAppPrefs($tenant, 'off@example.ru', ['inapp' => false, 'email' => false]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(0);
-});
-
-test('webhook: schema-default (inapp=true) ставит row', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    // Без override prefs — берётся schema DEFAULT (new_lead.inapp=true).
-    User::factory()->create([
-        'tenant_id' => $tenant->id,
-        'email' => 'default@example.ru',
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(1);
-});
-
-test('webhook: 2 user\'а с inapp=true получают по 1 row, 1 user с inapp=false — нет', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $a = makeUserWithInAppPrefs($tenant, 'a@example.ru', ['inapp' => true]);
-    $b = makeUserWithInAppPrefs($tenant, 'b@example.ru', ['inapp' => true]);
-    makeUserWithInAppPrefs($tenant, 'c@example.ru', ['inapp' => false]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(2);
-    expect(InAppNotification::query()->where('user_id', $a->id)->exists())->toBeTrue();
-    expect(InAppNotification::query()->where('user_id', $b->id)->exists())->toBeTrue();
-});
-
-test('webhook: inactive user НЕ получает in-app', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    User::factory()->inactive()->create([
-        'tenant_id' => $tenant->id,
-        'email' => 'inactive@example.ru',
-        'notification_preferences' => ['new_lead' => ['inapp' => true]],
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(0);
-});
-
-test('webhook: user другого тенанта НЕ получает (RLS isolation)', function () {
-    $tenantA = Tenant::factory()->create(['balance_leads' => 10]);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 10]);
-    $userA = makeUserWithInAppPrefs($tenantA, 'a@example.ru', ['inapp' => true]);
-    makeUserWithInAppPrefs($tenantB, 'b@example.ru', ['inapp' => true]);
-
-    (new ProcessWebhookJob($tenantA->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(1);
-    expect(InAppNotification::query()->first()->user_id)->toBe($userA->id);
-});
-
-test('webhook: дубль (Биз-19) НЕ создаёт повторный in-app row', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithInAppPrefs($tenant, 'on@example.ru', ['inapp' => true]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload(vid: 1)))->handle();
-    expect(InAppNotification::query()->count())->toBe(1);
-
-    // Второй webhook с тем же phone в окне 24ч → дубль, нет chargeNewLead → нет notify.
-    (new ProcessWebhookJob($tenant->id, inAppPayload(vid: 2)))->handle();
-    expect(InAppNotification::query()->count())->toBe(1);
-});
-
-test('webhook: повторный vid (UPDATE) НЕ создаёт повторный in-app row', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithInAppPrefs($tenant, 'on@example.ru', ['inapp' => true]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload(vid: 100)))->handle();
-    expect(InAppNotification::query()->count())->toBe(1);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload(vid: 100)))->handle();
-    expect(InAppNotification::query()->count())->toBe(1);
-});
-
-test('webhook: оба канала (inapp+email=true) — 1 in-app row + 1 email', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithInAppPrefs($tenant, 'both@example.ru', ['inapp' => true, 'email' => true]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    expect(InAppNotification::query()->count())->toBe(1);
-    Mail::assertSent(NewLeadNotification::class, 1);
-});
-
-test('webhook: payload содержит deal_id для UI deep-link', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithInAppPrefs($tenant, 'on@example.ru', ['inapp' => true]);
-
-    (new ProcessWebhookJob($tenant->id, inAppPayload()))->handle();
-
-    $notif = InAppNotification::query()->first();
-    expect($notif->deal_id)->not->toBeNull();
-    expect($notif->payload)->toHaveKey('deal_id');
-    expect($notif->payload['deal_id'])->toBe($notif->deal_id);
-});
-
 test('NotificationService::notifyInApp: вызов напрямую создаёт row', function () {
     $tenant = Tenant::factory()->create();
     $user = User::factory()->create(['tenant_id' => $tenant->id]);

app/tests/Feature/Notifications/NewLeadNotificationTest.php

@@ -1,199 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Jobs\ProcessWebhookJob;
-use App\Mail\NewLeadNotification;
-use App\Models\Deal;
-use App\Models\Tenant;
-use App\Models\User;
-use Illuminate\Foundation\Testing\DatabaseTransactions;
-use Illuminate\Support\Facades\Mail;
-
-/**
- * Тесты email-уведомления о новом лиде (ТЗ §18.5, событие new_lead).
- *
- * Проверяет интеграцию NotificationService → ProcessWebhookJob: после успешного
- * chargeNewLead все активные user'ы тенанта с notification_preferences.new_lead.email=true
- * получают NewLeadNotification. Mail::fake() перехватывает реальную отправку.
- *
- * Schema-default: notification_preferences.new_lead.email=false → по умолчанию
- * никто не получает emails. Тесты явно ставят email=true для нужных user'ов.
- */
-uses(DatabaseTransactions::class);
-
-beforeEach(function () {
-    Mail::fake();
-});
-
-/**
- * @return array<string, mixed>
- */
-function newLeadPayload(int $vid = 200, ?int $time = null): array
-{
-    return [
-        'vid' => $vid,
-        'project' => 'B2_Caranga',
-        'tag' => 'Caranga',
-        'phone' => '79001234567',
-        'phones' => ['79001234567'],
-        'time' => $time ?? time(),
-    ];
-}
-
-/**
- * @param  array<string, mixed>  $newLeadPrefs
- */
-function makeUserWithPrefs(Tenant $tenant, string $email, array $newLeadPrefs): User
-{
-    return User::factory()->create([
-        'tenant_id' => $tenant->id,
-        'email' => $email,
-        'notification_preferences' => [
-            'new_lead' => $newLeadPrefs,
-            'reminder' => ['inapp' => true, 'push' => true, 'email' => true],
-            'low_balance' => ['email' => true],
-            'zero_balance' => ['email' => true],
-            'topup_success' => ['email' => true],
-            'invoice_paid' => ['email' => true],
-            'new_device_login' => ['email' => true],
-            'marketing' => ['email' => false],
-        ],
-    ]);
-}
-
-test('webhook: NewLeadNotification отправляется user\'ам с email=true', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $userOn = makeUserWithPrefs($tenant, 'on@example.ru', ['inapp' => true, 'push' => true, 'email' => true]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertSent(NewLeadNotification::class, 1);
-    Mail::assertSent(NewLeadNotification::class, function (NewLeadNotification $mail) use ($userOn): bool {
-        return $mail->manager->id === $userOn->id
-            && $mail->hasTo('on@example.ru');
-    });
-});
-
-test('webhook: user с email=false НЕ получает', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenant, 'off@example.ru', ['inapp' => true, 'push' => true, 'email' => false]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertNothingSent();
-});
-
-test('webhook: schema-default не шлёт (new_lead.email=false по дефолту)', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    // Не передаём notification_preferences — берётся schema DEFAULT.
-    User::factory()->create([
-        'tenant_id' => $tenant->id,
-        'email' => 'default@example.ru',
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertNothingSent();
-});
-
-test('webhook: рассылается всем активным user\'ам с email=true', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenant, 'a@example.ru', ['email' => true]);
-    makeUserWithPrefs($tenant, 'b@example.ru', ['email' => true]);
-    makeUserWithPrefs($tenant, 'c@example.ru', ['email' => false]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertSent(NewLeadNotification::class, 2);
-    Mail::assertSent(fn (NewLeadNotification $mail) => $mail->hasTo('a@example.ru'));
-    Mail::assertSent(fn (NewLeadNotification $mail) => $mail->hasTo('b@example.ru'));
-    Mail::assertNotSent(fn (NewLeadNotification $mail) => $mail->hasTo('c@example.ru'));
-});
-
-test('webhook: inactive user с email=true НЕ получает (is_active=false)', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    User::factory()->inactive()->create([
-        'tenant_id' => $tenant->id,
-        'email' => 'inactive@example.ru',
-        'notification_preferences' => [
-            'new_lead' => ['email' => true],
-        ],
-    ]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertNothingSent();
-});
-
-test('webhook: soft-deleted user НЕ получает', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $user = makeUserWithPrefs($tenant, 'deleted@example.ru', ['email' => true]);
-    $user->delete();
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertNothingSent();
-});
-
-test('webhook: user другого тенанта НЕ получает (изоляция)', function () {
-    $tenantA = Tenant::factory()->create(['balance_leads' => 10]);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenantA, 'a@example.ru', ['email' => true]);
-    makeUserWithPrefs($tenantB, 'b@example.ru', ['email' => true]);
-
-    (new ProcessWebhookJob($tenantA->id, newLeadPayload()))->handle();
-
-    Mail::assertSent(NewLeadNotification::class, 1);
-    Mail::assertSent(fn (NewLeadNotification $mail) => $mail->hasTo('a@example.ru'));
-    Mail::assertNotSent(fn (NewLeadNotification $mail) => $mail->hasTo('b@example.ru'));
-});
-
-test('webhook: дубль-сделка (Биз-19) НЕ шлёт повторное уведомление', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenant, 'on@example.ru', ['email' => true]);
-
-    // Первая сделка — master.
-    (new ProcessWebhookJob($tenant->id, newLeadPayload(vid: 1)))->handle();
-    Mail::assertSent(NewLeadNotification::class, 1);
-
-    // Вторая сделка с тем же phone в окне 24 ч — дубль, баланс НЕ списывается,
-    // chargeNewLead НЕ вызывается, уведомление НЕ шлётся.
-    (new ProcessWebhookJob($tenant->id, newLeadPayload(vid: 2)))->handle();
-    Mail::assertSent(NewLeadNotification::class, 1); // всё ещё одно
-});
-
-test('webhook: повторный vid (idempotent UPDATE) НЕ шлёт повторное уведомление', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenant, 'on@example.ru', ['email' => true]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload(vid: 100)))->handle();
-    Mail::assertSent(NewLeadNotification::class, 1);
-
-    // Повторный webhook с тем же vid — UPDATE, не INSERT. wasRecentlyCreated=false → return.
-    (new ProcessWebhookJob($tenant->id, newLeadPayload(vid: 100)))->handle();
-    Mail::assertSent(NewLeadNotification::class, 1);
-});
-
-test('webhook: balance=0 (RejectedDealsLog) НЕ шлёт NewLeadNotification', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-    makeUserWithPrefs($tenant, 'on@example.ru', ['email' => true]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    // chargeNewLead НЕ вызывается при balance=0 — NewLeadNotification не шлётся.
-    // (ZeroBalanceNotification ШЛЁТСЯ — это покрывается отдельным тестом.)
-    Mail::assertNotSent(NewLeadNotification::class);
-    expect(Deal::query()->where('tenant_id', $tenant->id)->count())->toBe(0);
-});
-
-test('NewLeadNotification: subject содержит project_name', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    makeUserWithPrefs($tenant, 'on@example.ru', ['email' => true]);
-
-    (new ProcessWebhookJob($tenant->id, newLeadPayload()))->handle();
-
-    Mail::assertSent(NewLeadNotification::class, function (NewLeadNotification $mail): bool {
-        return str_contains($mail->envelope()->subject, 'Caranga');
-    });
-});

app/tests/Feature/PartitionsCreateMonthsTest.php

@@ -17,7 +17,7 @@ beforeEach(function () {
     $this->partitionsBefore = collect(DB::select("
         SELECT relname FROM pg_class
         WHERE relkind = 'r'
-          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|webhook_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
+          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
     "))->pluck('relname')->all();
 });
 
@@ -25,7 +25,7 @@ afterEach(function () {
     $partitionsAfter = collect(DB::select("
         SELECT relname FROM pg_class
         WHERE relkind = 'r'
-          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|webhook_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
+          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
     "))->pluck('relname')->all();
 
     // DETACH перед DROP: иначе `DROP TABLE ... CASCADE` сносит FK от
@@ -61,7 +61,7 @@ test('идемпотентность: повторный запуск не па
     $afterFirst = collect(DB::select("
         SELECT relname FROM pg_class
         WHERE relkind = 'r'
-          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|webhook_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
+          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
     "))->count();
 
     // Повторный запуск — должен только skip'ать.
@@ -71,14 +71,15 @@ test('идемпотентность: повторный запуск не па
     $afterSecond = collect(DB::select("
         SELECT relname FROM pg_class
         WHERE relkind = 'r'
-          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|webhook_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
+          AND relname ~ '^(deals|supplier_lead_costs|auth_log|activity_log|tenant_operations_log|balance_transactions|pd_processing_log|saas_admin_audit_log)_[0-9]{4}_[0-9]{2}$'
     "))->count();
 
     expect($afterSecond)->toBe($afterFirst);
 
-    // Output второго запуска должен сказать «0 created» по всем 9 таблицам × 6 месяцев = 54 партиции.
+    // Output второго запуска должен сказать «0 created» по всем 8 таблицам × 6 месяцев = 48 партиций.
+    // (webhook_log удалён в миграции 2026_05_24_140000_drop_legacy_webhook_artefacts)
     $output = Artisan::output();
-    expect($output)->toContain('0 created, 54 skipped');
+    expect($output)->toContain('0 created, 48 skipped');
 });
 
 test('--ahead=0 создаёт только текущий месяц', function () {
@@ -100,7 +101,6 @@ test('партиция корректно принимает INSERT в окно
         'subdomain' => 'partition-test-'.uniqid(),
         'organization_name' => 'PartitionTest',
         'contact_email' => 'pt@test.local',
-        'webhook_token' => str_repeat('p', 64),
         'api_key_limit' => 5,
     ]);
     $projectId = DB::table('projects')->insertGetId([

app/tests/Feature/Pd/DealCreatePdLogTest.php

@@ -4,11 +4,9 @@ declare(strict_types=1);
 
 /**
  * 152-ФЗ: pd_processing_log 'created' записывается при создании сделки
- * по всем трём путям — ручной API, поставщик (RouteSupplierLeadJob),
- * вебхук (ProcessWebhookJob).
+ * по двум живым путям — ручной API, поставщик (RouteSupplierLeadJob).
  */
 
-use App\Jobs\ProcessWebhookJob;
 use App\Jobs\RouteSupplierLeadJob;
 use App\Models\Deal;
 use App\Models\Project;
@@ -17,7 +15,6 @@ use App\Models\SupplierProject;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\Billing\LedgerService;
-use App\Services\DuplicateDetector;
 use App\Services\LeadDistributor;
 use App\Services\LeadRouter;
 use App\Services\NotificationService;
@@ -78,7 +75,7 @@ it('writes pd_processing_log created (supplier) when deal created via RouteSuppl
         'signal_type' => 'site',
         'unique_key' => 'pd-test.ru',
     ]);
-    $tenant = Tenant::factory()->create(['balance_leads' => 100]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $project = Project::factory()->create([
         'tenant_id' => $tenant->id,
         'supplier_b1_project_id' => $supplier->id,
@@ -107,7 +104,6 @@ it('writes pd_processing_log created (supplier) when deal created via RouteSuppl
     (new RouteSupplierLeadJob($lead->id))->handle(
         app(LeadRouter::class),
         app(SupplierProjectResolver::class),
-        app(DuplicateDetector::class),
         app(NotificationService::class),
         app(LedgerService::class),
         app(LeadDistributor::class),
@@ -130,36 +126,3 @@ it('writes pd_processing_log created (supplier) when deal created via RouteSuppl
 
     expect($rows)->toBe(1);
 });
-
-// ──────────────────────────────────────────────────────────────────────────
-// Path C: webhook via ProcessWebhookJob
-// ──────────────────────────────────────────────────────────────────────────
-
-it('writes pd_processing_log created (webhook) when deal created via ProcessWebhookJob', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    $vid = 55566;
-    (new ProcessWebhookJob($tenant->id, [
-        'vid' => $vid,
-        'project' => 'B2_PdWebhookTest',
-        'tag' => 'PdWebhookTest',
-        'phone' => '79001112233',
-        'phones' => ['79001112233'],
-        'time' => time(),
-    ]))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', $vid)->first();
-    expect($deal)->not->toBeNull();
-
-    $rows = DB::table('pd_processing_log')
-        ->where('action', 'created')
-        ->where('purpose', 'lead_create_webhook')
-        ->where('subject_type', 'lead')
-        ->where('subject_id', $deal->id)
-        ->where('tenant_id', $tenant->id)
-        ->whereNull('actor_tenant_user_id')
-        ->whereNull('actor_admin_user_id')
-        ->count();
-
-    expect($rows)->toBe(1);
-});

app/tests/Feature/Pd/DealImportPdLogTest.php

@@ -14,8 +14,11 @@ use App\Services\Import\CsvLeadsParser;
 use App\Services\Import\HistoricalImportService;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Facades\DB;
+use Tests\Concerns\SharesSupplierPdo;
 
-uses(DatabaseTransactions::class);
+uses(DatabaseTransactions::class, SharesSupplierPdo::class);
+// HistoricalImportService → MonthlyPartitionManager → CREATE через pgsql_supplier
+// (см. MonthlyPartitionManager::DDL_CONNECTION). Нужен shared PDO.
 
 it('writes pd_processing_log created on historical import for each new deal', function () {
     $tenant = Tenant::factory()->create();

app/tests/Feature/Plan4/Schema/SchemaDeltaTest.php

@@ -19,8 +19,8 @@ it('tenants table has delivered_in_month column with CHECK >= 0', function () {
     expect(Schema::hasColumn('tenants', 'delivered_in_month'))->toBeTrue();
     DB::table('tenants')->where('id', '<', 0)->update(['delivered_in_month' => 5]); // no-op
     expect(fn () => DB::statement(
-        'INSERT INTO tenants (subdomain, organization_name, contact_email, webhook_token, delivered_in_month) '.
-        "VALUES ('t-neg-test', 'X', 'x@x', 'wtok-neg-test-99999999', -1)"
+        'INSERT INTO tenants (subdomain, organization_name, contact_email, delivered_in_month) '.
+        "VALUES ('t-neg-test', 'X', 'x@x', -1)"
     ))->toThrow(QueryException::class);
 });
 
@@ -59,32 +59,33 @@ it('supplier_csv_reconcile_log table exists with required columns and status CHE
     ]))->toThrow(QueryException::class);
 });
 
-it('schema.sql v8.26 has correct metrics — 65 base tables, 123 indexes, 40 RLS policies', function () {
+it('schema.sql v8.35 has correct metrics — 66 base tables, 120 indexes, 40 RLS policies', function () {
     // Замена destructive `migrate:fresh` (cross-test coupling: после DROP CASCADE остальные
     // Feature-тесты в той же сессии видели пустую БД). Static parse `db/schema.sql` —
-    // источник истины метрик из spec §2.4 / db/CHANGELOG_schema.md v8.26.
+    // источник истины метрик.
     // v8.21 (Sprint 4): +1 таблица import_unknown_statuses, +1 индекс, +1 RLS-политика.
     // v8.22 (Plan 6/C9): +1 GIN-индекс idx_projects_regions.
     // v8.25 (supplier-failover): +1 таблица supplier_manual_sync_queue, +2 индекса.
     // v8.26 (project-migration-redesign Plans 1-3): +1 таблица project_supplier_links (M:N pivot)
     //   + 2 индекса (supplier_projects_platform_key_subject_unique, idx_psl_*).
+    // v8.30: +1 таблица scheduler_heartbeats (SaaS-level, hole #6).
+    // v8.31: 7 audit-таблиц переведены в PARTITION BY RANGE, hole #2.
+    // v8.35 (legacy webhook removal): −2 таблицы (webhook_log partitioned + rejected_deals_log)
+    //   −5 индексов, −2 RLS-политики, −2 колонки tenants.webhook_token/webhook_token_rotated_at.
     $schemaPath = dirname(base_path()).DIRECTORY_SEPARATOR.'db'.DIRECTORY_SEPARATOR.'schema.sql';
     expect(is_file($schemaPath) && is_readable($schemaPath))->toBeTrue();
     $schema = file_get_contents($schemaPath);
     expect($schema)->not->toBeFalse();
 
-    // v8.30: +1 таблица scheduler_heartbeats (SaaS-level, hole #6).
-    // v8.31: 7 audit-таблиц переведены в PARTITION BY RANGE, hole #2.
-    //
-    // 67 base tables = все CREATE TABLE минус PARTITION OF.
+    // 66 base tables = все CREATE TABLE минус PARTITION OF.
     $createTables = preg_match_all('/^CREATE TABLE\b/m', $schema);
     $partitionOf = preg_match_all('/CREATE TABLE\s+\w+\s+PARTITION OF\b/m', $schema);
     $baseTables = $createTables - $partitionOf;
-    expect($baseTables)->toBe(67);
+    expect($baseTables)->toBe(66);
 
     $createIndexes = preg_match_all('/^CREATE\s+(?:UNIQUE\s+)?INDEX\b/m', $schema);
-    expect($createIndexes)->toBe(126);  // v8.31: +3 индекса audit-таблиц после partitioning
+    expect($createIndexes)->toBe(120);  // v8.35: −5 индексов (webhook_log ×2, rejected_deals_log ×2, tenants.webhook_token ×1)
 
     $createPolicies = preg_match_all('/^CREATE\s+POLICY\b/m', $schema);
-    expect($createPolicies)->toBe(41);  // v8.31: +1 политика на partitioned audit-таблицах
+    expect($createPolicies)->toBe(40);  // v8.35: −2 политики (webhook_log + rejected_deals_log)
 });

app/tests/Feature/ProcessWebhookJobTest.php

@@ -1,437 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Jobs\ProcessWebhookJob;
-use App\Models\ActivityLog;
-use App\Models\BalanceTransaction;
-use App\Models\Deal;
-use App\Models\Project;
-use App\Models\RejectedDealsLog;
-use App\Models\SupplierLeadCost;
-use App\Models\Tenant;
-use App\Models\WebhookDedupKey;
-use Illuminate\Foundation\Testing\DatabaseTransactions;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Str;
-use Tests\Concerns\SharesSupplierPdo;
-
-/**
- * Тесты ProcessWebhookJob — двустадийный dedup v8.6 (CTO-17).
- *
- * Проверяет ключевую архитектурную инвариант: один и тот же vid должен
- * обновлять существующую сделку (а не создавать дубль), и баланс должен
- * списываться ровно один раз. См. narrative ТЗ §5.5.
- *
- * NB: Job::handle() сам открывает DB::transaction. DatabaseTransactions
- * trait оборачивает каждый тест в outer-транзакцию — Laravel-PG-driver
- * корректно обрабатывает nested через savepoints.
- *
- * SharesSupplierPdo: failed() now inserts via pgsql_supplier (BYPASSRLS) —
- * share PDO so DatabaseTransactions cross-connection visibility works on dev.
- */
-uses(DatabaseTransactions::class);
-uses(SharesSupplierPdo::class);
-
-function makePayload(int $vid = 432176649, ?int $time = null): array
-{
-    return [
-        'vid' => $vid,
-        'project' => 'B2_Caranga',  // префикс должен обрезаться до 'Caranga'
-        'tag' => 'Caranga',
-        'phone' => '79001234567',
-        'phones' => ['79001234567'],
-        'time' => $time ?? time(),
-    ];
-}
-
-/**
- * Создаёт активного поставщика и привязывает его к проекту через project_suppliers.
- * Используется в тестах SupplierLeadCost-ветки.
- */
-function seedSupplierForProject(Project $project, float $costRub = 50.00): int
-{
-    $supplierId = (int) DB::table('suppliers')->insertGetId([
-        'code' => 'b1-test-'.Str::lower(Str::random(6)),
-        'name' => 'B1 Test',
-        'accepts_types' => '{websites,calls}',
-        'cost_rub' => $costRub,
-        'channel' => 'sites',
-        'quality_score' => 1.00,
-        'is_active' => true,
-        'sort_order' => 0,
-    ]);
-
-    DB::table('project_suppliers')->insert([
-        'project_id' => $project->id,
-        'supplier_id' => $supplierId,
-        'is_active' => true,
-        'created_at' => now(),
-    ]);
-
-    return $supplierId;
-}
-
-test('новая сделка: INSERT в deals + INSERT в webhook_dedup_keys, баланс -1', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 100)))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9);
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    expect($deal)->not->toBeNull();
-    expect($deal->source_crm_id)->toBe(100);
-    expect($deal->phone)->toBe('79001234567');
-    expect($deal->status)->toBe('new');
-    expect($deal->project->name)->toBe('Caranga'); // префикс B2_ обрезан
-
-    $dedup = WebhookDedupKey::query()
-        ->where('tenant_id', $tenant->id)
-        ->where('source_crm_id', 100)
-        ->first();
-    expect($dedup)->not->toBeNull();
-    expect($dedup->deal_id)->toBe($deal->id);
-});
-
-test('дубль vid: UPDATE существующей сделки, баланс НЕ списывается второй раз', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $vid = 200;
-
-    // Первый webhook
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: $vid)))->handle();
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9);
-    $dealsAfterFirst = Deal::query()->where('tenant_id', $tenant->id)->count();
-
-    // Второй webhook с тем же vid (но новым phone — будет UPDATE)
-    $payload2 = makePayload(vid: $vid);
-    $payload2['phone'] = '79009999999';
-    (new ProcessWebhookJob($tenant->id, $payload2))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9); // баланс не изменился
-    expect(Deal::query()->where('tenant_id', $tenant->id)->count())->toBe($dealsAfterFirst);
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', $vid)->first();
-    expect($deal->phone)->toBe('79009999999'); // обновлён phone
-
-    // dedup-ключ всё ещё ровно один
-    expect(WebhookDedupKey::query()->where('tenant_id', $tenant->id)->where('source_crm_id', $vid)->count())->toBe(1);
-});
-
-test('баланс=0: запись в лог, без INSERT в deals и dedup_keys', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 300)))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(0);
-    expect(Deal::query()->where('tenant_id', $tenant->id)->count())->toBe(0);
-    expect(WebhookDedupKey::query()->where('tenant_id', $tenant->id)->count())->toBe(0);
-});
-
-test('изоляция тенантов: одинаковый vid у разных тенантов = разные сделки', function () {
-    $tenantA = Tenant::factory()->create(['balance_leads' => 10]);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenantA->id, makePayload(vid: 555)))->handle();
-    (new ProcessWebhookJob($tenantB->id, makePayload(vid: 555)))->handle();
-
-    expect(Deal::query()->where('tenant_id', $tenantA->id)->count())->toBe(1);
-    expect(Deal::query()->where('tenant_id', $tenantB->id)->count())->toBe(1);
-    expect(WebhookDedupKey::query()->count())->toBeGreaterThanOrEqual(2);
-
-    $tenantA->refresh();
-    $tenantB->refresh();
-    expect($tenantA->balance_leads)->toBe(9);
-    expect($tenantB->balance_leads)->toBe(9);
-});
-
-test('findOrCreate проекта: повторный webhook с тем же project не создаёт дубля', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 401)))->handle();
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 402)))->handle();
-
-    expect(Project::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
-});
-
-test('ON DELETE CASCADE: удаление сделки очищает webhook_dedup_keys', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 700)))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    DB::table('deals')
-        ->where('id', $deal->id)
-        ->where('received_at', $deal->received_at)
-        ->delete();
-
-    expect(WebhookDedupKey::query()
-        ->where('tenant_id', $tenant->id)
-        ->where('source_crm_id', 700)
-        ->count())->toBe(0);
-});
-
-test('новая сделка создаёт BalanceTransaction (lead_charge -1)', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 800)))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    $tx = BalanceTransaction::query()
-        ->where('tenant_id', $tenant->id)
-        ->where('type', BalanceTransaction::TYPE_LEAD_CHARGE)
-        ->first();
-
-    expect($tx)->not->toBeNull();
-    expect($tx->amount_leads)->toBe(-1);
-    expect($tx->balance_leads_after)->toBe(9);
-    expect($tx->related_type)->toBe(Deal::class);
-    expect($tx->related_id)->toBe($deal->id);
-});
-
-test('дубль vid НЕ создаёт BalanceTransaction', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $vid = 801;
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: $vid)))->handle();
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: $vid)))->handle();
-
-    expect(BalanceTransaction::query()
-        ->where('tenant_id', $tenant->id)
-        ->count())->toBe(1);
-});
-
-test('новая сделка создаёт ActivityLog event=deal.created', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 802)))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    $log = ActivityLog::query()
-        ->where('tenant_id', $tenant->id)
-        ->where('deal_id', $deal->id)
-        ->first();
-
-    expect($log)->not->toBeNull();
-    expect($log->event)->toBe(ActivityLog::EVENT_DEAL_CREATED);
-    expect($log->user_id)->toBeNull();
-    expect($log->context)->toBe(['source' => 'webhook']);
-});
-
-test('баланс=0 пишет в RejectedDealsLog с reason=zero_balance', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 0]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 803)))->handle();
-
-    $rejected = RejectedDealsLog::query()
-        ->where('tenant_id', $tenant->id)
-        ->first();
-
-    expect($rejected)->not->toBeNull();
-    expect($rejected->reason)->toBe(RejectedDealsLog::REASON_ZERO_BALANCE);
-    expect($rejected->payload['vid'])->toBe(803);
-});
-
-test('SupplierLeadCost создаётся со snapshot cost_rub из supplier', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $project = Project::factory()->create([
-        'tenant_id' => $tenant->id,
-        'name' => 'Caranga',  // совпадает с обрезанным project из payload
-    ]);
-    $supplierId = seedSupplierForProject($project, costRub: 75.50);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 804)))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    $cost = SupplierLeadCost::query()
-        ->where('deal_id', $deal->id)
-        ->where('received_at', $deal->received_at)
-        ->first();
-
-    expect($cost)->not->toBeNull();
-    expect($cost->supplier_id)->toBe($supplierId);
-    expect((string) $cost->cost_rub)->toBe('75.50');
-    expect($cost->supplier_lead_id)->toBe(804);
-});
-
-test('SupplierLeadCost НЕ создаётся если у проекта нет активного supplier', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    (new ProcessWebhookJob($tenant->id, makePayload(vid: 805)))->handle();
-
-    $deal = Deal::query()->where('tenant_id', $tenant->id)->first();
-    expect(SupplierLeadCost::query()
-        ->where('deal_id', $deal->id)
-        ->count())->toBe(0);
-
-    // Сделка всё равно создаётся, баланс списан, ActivityLog есть.
-    expect($deal)->not->toBeNull();
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9);
-});
-
-// =============================================================================
-// Биз-19: антифрод-дедуп по phone в окне 24 ч (DuplicateDetector, §10.8.1)
-// =============================================================================
-
-test('Биз-19: master в окне 24ч → дубль, баланс НЕ списывается', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $phone = '79007770001';
-
-    // Master: пришёл вчера в 12:00.
-    $masterPayload = makePayload(vid: 901, time: now()->subHours(12)->timestamp);
-    $masterPayload['phone'] = $phone;
-    $masterPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $masterPayload))->handle();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9);
-
-    // Дубль: пришёл сейчас, в окне 24 ч.
-    $dupPayload = makePayload(vid: 902, time: now()->timestamp);
-    $dupPayload['phone'] = $phone;
-    $dupPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $dupPayload))->handle();
-
-    $master = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', 901)->first();
-    $dup = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', 902)->first();
-
-    expect($master->duplicate_of_id)->toBeNull();
-    expect($dup->duplicate_of_id)->toBe($master->id);
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(9); // только master списан, дубль — нет
-    expect(BalanceTransaction::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
-    expect(SupplierLeadCost::query()->where('deal_id', $dup->id)->count())->toBe(0);
-});
-
-test('Биз-19: master старше 24ч → НЕ дубль, баланс списывается дважды', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $phone = '79007770002';
-
-    // Master: пришёл 25 часов назад — за окном.
-    $masterPayload = makePayload(vid: 911, time: now()->subHours(25)->timestamp);
-    $masterPayload['phone'] = $phone;
-    $masterPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $masterPayload))->handle();
-
-    // Новая сделка с тем же phone — master уже за окном.
-    $newPayload = makePayload(vid: 912, time: now()->timestamp);
-    $newPayload['phone'] = $phone;
-    $newPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $newPayload))->handle();
-
-    $deal911 = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', 911)->first();
-    $deal912 = Deal::query()->where('tenant_id', $tenant->id)->where('source_crm_id', 912)->first();
-
-    expect($deal911->duplicate_of_id)->toBeNull();
-    expect($deal912->duplicate_of_id)->toBeNull();
-
-    $tenant->refresh();
-    expect($tenant->balance_leads)->toBe(8); // оба списаны
-    expect(BalanceTransaction::query()->where('tenant_id', $tenant->id)->count())->toBe(2);
-});
-
-test('Биз-19: дубли изолированы по tenant_id', function () {
-    $tenantA = Tenant::factory()->create(['balance_leads' => 10]);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 10]);
-    $phone = '79007770003';
-
-    $payloadA = makePayload(vid: 921);
-    $payloadA['phone'] = $phone;
-    $payloadA['phones'] = [$phone];
-    (new ProcessWebhookJob($tenantA->id, $payloadA))->handle();
-
-    // Тот же phone у tenantB — НЕ должен считаться дублем.
-    $payloadB = makePayload(vid: 922);
-    $payloadB['phone'] = $phone;
-    $payloadB['phones'] = [$phone];
-    (new ProcessWebhookJob($tenantB->id, $payloadB))->handle();
-
-    $dealA = Deal::query()->where('tenant_id', $tenantA->id)->first();
-    $dealB = Deal::query()->where('tenant_id', $tenantB->id)->first();
-
-    expect($dealA->duplicate_of_id)->toBeNull();
-    expect($dealB->duplicate_of_id)->toBeNull();
-});
-
-test('Биз-19: ActivityLog для дубля содержит context.duplicate_of', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $phone = '79007770004';
-
-    $masterPayload = makePayload(vid: 931, time: now()->subHours(2)->timestamp);
-    $masterPayload['phone'] = $phone;
-    $masterPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $masterPayload))->handle();
-
-    $dupPayload = makePayload(vid: 932, time: now()->timestamp);
-    $dupPayload['phone'] = $phone;
-    $dupPayload['phones'] = [$phone];
-    (new ProcessWebhookJob($tenant->id, $dupPayload))->handle();
-
-    $master = Deal::query()->where('source_crm_id', 931)->first();
-    $dup = Deal::query()->where('source_crm_id', 932)->first();
-
-    $masterLog = ActivityLog::query()->where('deal_id', $master->id)->first();
-    $dupLog = ActivityLog::query()->where('deal_id', $dup->id)->first();
-
-    expect($masterLog->context)->toBe(['source' => 'webhook']);
-    expect($dupLog->context)->toBe(['source' => 'webhook', 'duplicate_of' => $master->id]);
-});
-
-// =============================================================================
-// failed() callback — финальная обработка после исчерпания ретраев
-// =============================================================================
-
-test('failed() пишет упавший job в failed_webhook_jobs', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $webhookLogId = (int) DB::table('webhook_log')->insertGetId([
-        'tenant_id' => $tenant->id,
-        'raw_payload' => json_encode(['vid' => 1001]),
-        'received_at' => now(),
-    ]);
-    $payload = makePayload(vid: 1001);
-
-    $job = new ProcessWebhookJob($tenant->id, $payload, webhookLogId: $webhookLogId);
-    $job->failed(new RuntimeException('boom: db down'));
-
-    $row = DB::table('failed_webhook_jobs')
-        ->where('tenant_id', $tenant->id)
-        ->first();
-
-    expect($row)->not->toBeNull();
-    expect($row->webhook_log_id)->toBe($webhookLogId);
-    expect($row->exception)->toBe('boom: db down');
-    expect($row->retry_count)->toBe(3);
-    expect($row->resolved_at)->toBeNull();
-    expect(json_decode($row->raw_payload, true)['vid'])->toBe(1001);
-});
-
-test('failed() работает БЕЗ webhookLogId (NULL ok)', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-
-    $job = new ProcessWebhookJob($tenant->id, makePayload(vid: 1002));
-    $job->failed(new RuntimeException('no webhook log id'));
-
-    $row = DB::table('failed_webhook_jobs')->where('tenant_id', $tenant->id)->first();
-    expect($row)->not->toBeNull();
-    expect($row->webhook_log_id)->toBeNull();
-});
-
-test('failed() записывает payload с UTF-8 кириллицей корректно', function () {
-    $tenant = Tenant::factory()->create(['balance_leads' => 10]);
-    $payload = makePayload(vid: 1003);
-    $payload['contact_name'] = 'Дмитрий Петров';
-
-    $job = new ProcessWebhookJob($tenant->id, $payload);
-    $job->failed(new RuntimeException('utf-8 test'));
-
-    $row = DB::table('failed_webhook_jobs')->where('tenant_id', $tenant->id)->first();
-    $decoded = json_decode($row->raw_payload, true);
-
-    expect($decoded['contact_name'])->toBe('Дмитрий Петров');
-});

app/tests/Feature/RlsSmokeTest.php

@@ -45,14 +45,12 @@ SQL);
         'subdomain' => 'rls-tenant-a-'.uniqid(),
         'organization_name' => 'RLS Tenant A',
         'contact_email' => 'a@rls-test.local',
-        'webhook_token' => 'whtA'.str_pad((string) random_int(0, 999999999), 60, '0', STR_PAD_LEFT),
         'api_key_limit' => 5,
     ]);
     $this->tenant2Id = DB::table('tenants')->insertGetId([
         'subdomain' => 'rls-tenant-b-'.uniqid(),
         'organization_name' => 'RLS Tenant B',
         'contact_email' => 'b@rls-test.local',
-        'webhook_token' => 'whtB'.str_pad((string) random_int(0, 999999999), 60, '0', STR_PAD_LEFT),
         'api_key_limit' => 5,
     ]);
 

app/tests/Feature/SaasAdminMiddlewareTest.php

@@ -5,21 +5,25 @@ declare(strict_types=1);
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 
 /**
- * J2 (Sprint 3F) — стаб-гейт SaaS-admin зоны.
+ * J2 (Sprint 3F) — гейт SaaS-admin зоны.
  *
- * EnsureSaasAdmin на /api/admin/*: dev/testing пропускает (admin-панель
- * работает на dev), прочие окружения — fail-closed 503 до подключения
- * реального Yandex 360 SSO (TODO под Б-1+DO-4).
+ * EnsureSaasAdmin на /api/admin/*: пропускает запрос во ВСЕХ окружениях.
+ * Защита боевой админ-зоны (/admin + /api/admin/*) перенесена на nginx
+ * (HTTP Basic Auth, отдельный пароль — /etc/nginx/.htpasswd-admin), потому
+ * что настоящий saas-admin SSO (Yandex 360) ещё не готов (Б-1 + DO-4).
+ * Ранее middleware fail-closed 503 вне dev/testing — это закрывало всю
+ * админку на проде наглухо; стопгэп заменил замок на nginx-дверь.
  */
 uses(DatabaseTransactions::class);
 
-test('/api/admin/* пропускается на testing-окружении (стаб permissive)', function () {
-    // Дефолтное тестовое окружение = testing → middleware пропускает.
+test('/api/admin/* пропускается на testing-окружении', function () {
     $this->getJson('/api/admin/tenants')->assertStatus(200);
 });
 
-test('/api/admin/* возвращает 503 вне dev/testing (стаб fail-closed)', function () {
+test('/api/admin/* пропускается и на production (замок 503 снят, дверь держит nginx)', function () {
     $this->app->detectEnvironment(fn () => 'production');
 
-    $this->getJson('/api/admin/tenants')->assertStatus(503);
+    // Раньше тут был 503. Теперь приложение зону не закрывает — её держит
+    // nginx basic-auth (стопгэп до реального Yandex 360 SSO).
+    $this->getJson('/api/admin/tenants')->assertStatus(200);
 });

app/tests/Feature/Supplier/AutoPauseFlowTest.php

@@ -10,7 +10,6 @@ use App\Models\SupplierLead;
 use App\Models\SupplierProject;
 use App\Models\Tenant;
 use App\Services\Billing\LedgerService;
-use App\Services\DuplicateDetector;
 use App\Services\LeadDistributor;
 use App\Services\LeadRouter;
 use App\Services\NotificationService;
@@ -66,7 +65,6 @@ function runJob(int $leadId): void
     (new RouteSupplierLeadJob($leadId))->handle(
         app(LeadRouter::class),
         app(SupplierProjectResolver::class),
-        app(DuplicateDetector::class),
         app(NotificationService::class),
         app(LedgerService::class),
         app(LeadDistributor::class),
@@ -149,7 +147,7 @@ it('sharing-flow isolation: tenant A on zero paused, tenant B with balance recei
     // tenantA: balance_rub > 0 (проходит WHERE EXISTS-фильтр LeadRouter), но < tier_price (500 ₽).
     // Поэтому projectA попадает в matched, LedgerService падает с InsufficientBalanceException → auto-pause.
     $tenantA = Tenant::factory()->create(['balance_leads' => 0, 'balance_rub' => '100.00']);
-    $tenantB = Tenant::factory()->create(['balance_leads' => 5, 'balance_rub' => '0.00']);
+    $tenantB = Tenant::factory()->create(['balance_rub' => '100000.00']);
     $projectA = Project::factory()->create([
         'tenant_id' => $tenantA->id, 'signal_type' => 'site', 'signal_identifier' => 'example.com',
         'supplier_b1_project_id' => $supplierProject->id, 'is_active' => true,
@@ -176,5 +174,5 @@ it('sharing-flow isolation: tenant A on zero paused, tenant B with balance recei
 
     expect($projectA->fresh()->is_active)->toBeFalse();
     expect($projectB->fresh()->is_active)->toBeTrue();
-    expect((int) $tenantB->fresh()->balance_leads)->toBe(4);
+    expect((string) $tenantB->fresh()->balance_rub)->toBe('99500.00');
 });

app/tests/Feature/Supplier/CsvReconcileJobTest.php

@@ -257,3 +257,80 @@ it('SupplierTransientException — status=failed, error recorded, rethrown', fun
     expect($log->status)->toBe('failed');
     expect($log->error_message)->toContain('500');
 });
+
+it('unparseable CSV rows excluded from drift: 100 matched + 10 junk-project rows → status=ok, unparseable_count=10', function (): void {
+    // 100 нормальных webhook-лидов.
+    for ($i = 0; $i < 100; $i++) {
+        SupplierLead::create([
+            'supplier_project_id' => null,
+            'platform' => 'B1',
+            'phone' => '79993'.str_pad((string) $i, 6, '0', STR_PAD_LEFT),
+            'vid' => 840000 + $i,
+            'raw_payload' => ['project' => 'B1_a.com', 'phone' => '79993'.str_pad((string) $i, 6, '0', STR_PAD_LEFT)],
+            'received_at' => now()->subHour(),
+            'source' => 'webhook',
+        ]);
+    }
+
+    // CSV: те же 100 (matched) + 10 строк с мусорным project (extractPlatform = null).
+    // Это реальный паттерн поставщика — телефон в поле «Name» вместо проекта (см. 22.05 в ПИЛОТ).
+    $rows = [];
+    for ($i = 0; $i < 100; $i++) {
+        $rows[] = ['project' => 'B1_a.com', 'phone' => '79993'.str_pad((string) $i, 6, '0', STR_PAD_LEFT)];
+    }
+    for ($j = 0; $j < 10; $j++) {
+        $rows[] = ['project' => '79135551234', 'phone' => '7999500000'.$j];
+    }
+    fakeReportFlow(csvBody($rows));
+
+    runCsvReconcile();
+
+    $log = DB::table('supplier_csv_reconcile_log')->latest('id')->first();
+    expect((int) $log->total_csv_rows)->toBe(110);
+    expect((int) $log->matched_count)->toBe(100);
+    expect((int) $log->recovered_count)->toBe(0);
+    expect((int) $log->unparseable_count)->toBe(10);
+    // Реального missing'а нет — только junk; drift должен быть 0, не 10/110.
+    expect((float) $log->drift_ratio)->toBe(0.0);
+    expect($log->status)->toBe('ok');
+
+    Mail::assertNothingSent();
+});
+
+it('mixed: 95 matched + 5 junk + 3 real-missing → unparseable_count=5, recovered=3, drift по реальным', function (): void {
+    for ($i = 0; $i < 95; $i++) {
+        SupplierLead::create([
+            'supplier_project_id' => null,
+            'platform' => 'B1',
+            'phone' => '79994'.str_pad((string) $i, 6, '0', STR_PAD_LEFT),
+            'vid' => 850000 + $i,
+            'raw_payload' => ['project' => 'B1_a.com', 'phone' => '79994'.str_pad((string) $i, 6, '0', STR_PAD_LEFT)],
+            'received_at' => now()->subHour(),
+            'source' => 'webhook',
+        ]);
+    }
+
+    $rows = [];
+    for ($i = 0; $i < 95; $i++) {
+        $rows[] = ['project' => 'B1_a.com', 'phone' => '79994'.str_pad((string) $i, 6, '0', STR_PAD_LEFT)];
+    }
+    for ($j = 0; $j < 5; $j++) {
+        $rows[] = ['project' => 'https://junk.example/'.$j, 'phone' => '7999600000'.$j];
+    }
+    for ($k = 0; $k < 3; $k++) {
+        $rows[] = ['project' => 'B1_a.com', 'phone' => '7999700000'.$k];
+    }
+    fakeReportFlow(csvBody($rows));
+
+    runCsvReconcile();
+
+    $log = DB::table('supplier_csv_reconcile_log')->latest('id')->first();
+    expect((int) $log->total_csv_rows)->toBe(103);
+    expect((int) $log->matched_count)->toBe(95);
+    expect((int) $log->recovered_count)->toBe(3);
+    expect((int) $log->unparseable_count)->toBe(5);
+    // real_missing = (103 - 95) - 5 = 3; parseable_total = 103 - 5 = 98; drift = 3/98 ≈ 0.0306 < 5% → ok.
+    expect((float) $log->drift_ratio)->toBeLessThan(0.05);
+    expect((float) $log->drift_ratio)->toBeGreaterThan(0.0);
+    expect($log->status)->toBe('ok');
+});

app/tests/Feature/Supplier/RouteSupplierLeadJobBillingTest.php

@@ -12,7 +12,6 @@ use App\Models\SupplierLead;
 use App\Models\SupplierProject;
 use App\Models\Tenant;
 use App\Services\Billing\LedgerService;
-use App\Services\DuplicateDetector;
 use App\Services\LeadDistributor;
 use App\Services\LeadRouter;
 use App\Services\NotificationService;
@@ -90,7 +89,6 @@ function dispatchJob(int $supplierLeadId): void
     (new RouteSupplierLeadJob($supplierLeadId))->handle(
         app(LeadRouter::class),
         app(SupplierProjectResolver::class),
-        app(DuplicateDetector::class),
         app(NotificationService::class),
         app(LedgerService::class),
         app(LeadDistributor::class),
@@ -98,27 +96,6 @@ function dispatchJob(int $supplierLeadId): void
     );
 }
 
-it('charges prepaid for tenant with balance_leads > 0 + writes BalanceTransaction', function (): void {
-    $ctx = prepareSharingFlow(1, [['balance_leads' => 5, 'balance_rub' => '0.00', 'delivered_in_month' => 0]]);
-
-    dispatchJob($ctx['lead']->id);
-
-    $tenant = $ctx['tenants'][0]->fresh();
-    expect((int) $tenant->balance_leads)->toBe(4);
-    expect($tenant->delivered_in_month)->toBe(1);
-
-    $charge = LeadCharge::first();
-    expect($charge)->not->toBeNull();
-    expect($charge->charge_source)->toBe('prepaid');
-    expect($charge->price_per_lead_kopecks)->toBe(0);
-
-    // BalanceTransaction (carry-over M-2 assertion)
-    $tx = BalanceTransaction::where('type', BalanceTransaction::TYPE_LEAD_CHARGE)->first();
-    expect($tx)->not->toBeNull();
-    expect((int) $tx->amount_leads)->toBe(-1);
-    expect((int) $tx->balance_leads_after)->toBe(4);
-});
-
 it('charges rub for tenant with balance_leads=0 and balance_rub >= price + writes BalanceTransaction', function (): void {
     $ctx = prepareSharingFlow(1, [['balance_leads' => 0, 'balance_rub' => '1000.00', 'delivered_in_month' => 0]]);
 
@@ -156,13 +133,15 @@ it('writes supplier_lead_costs for each delivered deal copy (gap-fix)', function
 });
 
 it('retry idempotency: повторный run не дублирует lead_charges', function (): void {
-    $ctx = prepareSharingFlow(1, [['balance_leads' => 5, 'balance_rub' => '0.00']]);
+    $ctx = prepareSharingFlow(1, [['balance_rub' => '100000.00']]);
     $leadId = $ctx['lead']->id;
+    $tenantId = $ctx['tenants'][0]->id;
 
     dispatchJob($leadId);
     dispatchJob($leadId);  // повторный — processed_at guard защищает
 
-    expect(LeadCharge::count())->toBe(1);
-    expect(Deal::count())->toBe(1);
-    expect((int) $ctx['tenants'][0]->fresh()->balance_leads)->toBe(4);
+    expect(LeadCharge::where('tenant_id', $tenantId)->count())->toBe(1);
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenantId}'");
+    expect(Deal::where('tenant_id', $tenantId)->count())->toBe(1);
 });

app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php

@@ -0,0 +1,207 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Jobs\RouteSupplierLeadJob;
+use App\Models\Deal;
+use App\Models\LeadCharge;
+use App\Models\Project;
+use App\Models\SupplierLead;
+use App\Models\SupplierProject;
+use App\Models\Tenant;
+use App\Services\Billing\LedgerService;
+use App\Services\LeadDistributor;
+use App\Services\LeadRouter;
+use App\Services\NotificationService;
+use App\Services\RegionTagResolver;
+use App\Services\SupplierProjects\SupplierProjectResolver;
+use Database\Seeders\PricingTierSeeder;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Random\Engine\Mt19937;
+use Random\Randomizer;
+use Tests\Concerns\SharesSupplierPdo;
+
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+function runRouteJobB(int $id): void
+{
+    (new RouteSupplierLeadJob($id))->handle(
+        app(LeadRouter::class),
+        app(SupplierProjectResolver::class),
+        app(NotificationService::class),
+        app(LedgerService::class),
+        app(LeadDistributor::class),
+        app(RegionTagResolver::class),
+    );
+}
+
+it('supplier_lead_deliveries table exists with PK (supplier_lead_id, tenant_id) and RLS', function (): void {
+    $cols = collect(DB::select(
+        "SELECT column_name FROM information_schema.columns WHERE table_name = 'supplier_lead_deliveries'"
+    ))->pluck('column_name')->all();
+    expect($cols)->toContain('supplier_lead_id')
+        ->toContain('tenant_id')
+        ->toContain('deal_id')
+        ->toContain('created_at');
+
+    $pk = collect(DB::select(
+        "SELECT a.attname FROM pg_index i
+         JOIN pg_attribute a ON a.attrelid = i.indrelid AND a.attnum = ANY(i.indkey)
+         WHERE i.indrelid = 'supplier_lead_deliveries'::regclass AND i.indisprimary"
+    ))->pluck('attname')->sort()->values()->all();
+    expect($pk)->toBe(['supplier_lead_id', 'tenant_id']);
+
+    $rls = DB::selectOne(
+        "SELECT relrowsecurity FROM pg_class WHERE relname = 'supplier_lead_deliveries'"
+    );
+    expect($rls->relrowsecurity)->toBeTrue();
+});
+
+it('one delivery to a tenant with 2 eligible projects → exactly 1 deal + 1 charge (max-remaining-limit tie-break)', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'twoproj.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
+
+    // Two eligible projects for the SAME tenant, different remaining limit.
+    $pLow = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'supplier_b1_project_id' => $sp->id,
+        'signal_type' => 'site', 'signal_identifier' => 'twoproj.ru',
+        'daily_limit_target' => 10, 'effective_daily_limit_today' => 10,
+        'delivered_today' => 9, 'delivery_days_mask' => 127, 'region_mask' => 255,
+    ]);
+    $pHigh = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'supplier_b1_project_id' => $sp->id,
+        'signal_type' => 'site', 'signal_identifier' => 'twoproj.ru',
+        'daily_limit_target' => 10, 'effective_daily_limit_today' => 10,
+        'delivered_today' => 0, 'delivery_days_mask' => 127, 'region_mask' => 255,
+    ]);
+    linkProjectToSupplier($pLow, $sp);
+    linkProjectToSupplier($pHigh, $sp);
+
+    $vid = 600001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_twoproj.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJobB($lead->id);
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('source_crm_id', $vid)->count())->toBe(1);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
+    // The project with most remaining limit was chosen.
+    expect($pHigh->fresh()->delivered_today)->toBe(1);
+    expect($pLow->fresh()->delivered_today)->toBe(9);
+});
+
+it('lock: re-running same delivery to same tenant does not double-charge (Spec B)', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'lock.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
+    $p = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'supplier_b1_project_id' => $sp->id,
+        'signal_type' => 'site', 'signal_identifier' => 'lock.ru',
+        'daily_limit_target' => 10, 'effective_daily_limit_today' => 10,
+        'delivered_today' => 0, 'delivery_days_mask' => 127, 'region_mask' => 255,
+    ]);
+    linkProjectToSupplier($p, $sp);
+
+    $vid = 610001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_lock.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJobB($lead->id);
+
+    // Reset processed_at to force a SECOND pass (bypass the existing $lead->processed_at idempotency
+    // guard so we are testing the DB-level lock specifically).
+    $lead->update(['processed_at' => null]);
+    runRouteJobB($lead->id);
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('source_crm_id', $vid)->count())->toBe(1);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
+    expect(DB::table('supplier_lead_deliveries')
+        ->where('supplier_lead_id', $lead->id)->where('tenant_id', $tenant->id)->count())->toBe(1);
+    // Balance debited exactly once.
+    expect((string) $tenant->fresh()->balance_rub)->toBe('99500.00');
+});
+
+it('same phone, two different deliveries to one tenant → both charged (no phone dedup, Spec B)', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'twohit.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_rub' => '100000.00']);
+    $p = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'supplier_b1_project_id' => $sp->id,
+        'signal_type' => 'site', 'signal_identifier' => 'twohit.ru',
+        'daily_limit_target' => 10, 'effective_daily_limit_today' => 10,
+        'delivered_today' => 0, 'delivery_days_mask' => 127, 'region_mask' => 255,
+    ]);
+    linkProjectToSupplier($p, $sp);
+
+    foreach ([700001, 700002] as $vid) {
+        $lead = SupplierLead::factory()->create([
+            'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+            'phone' => '79991234567',
+            'raw_payload' => ['vid' => $vid, 'project' => 'B1_twohit.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+        ]);
+        runRouteJobB($lead->id);
+    }
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('tenant_id', $tenant->id)->whereIn('source_crm_id', [700001, 700002])->count())->toBe(2);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(2);
+    expect((string) $tenant->fresh()->balance_rub)->toBe('99000.00');
+});
+
+it('cap = 3 distinct tenants: 5 eligible tenants → exactly 3 charged (Spec B)', function (): void {
+    $this->seed(PricingTierSeeder::class);
+    app()->bind(LeadDistributor::class, fn () => new LeadDistributor(new Randomizer(new Mt19937(7))));
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'cap3.ru',
+    ]);
+    foreach (range(1, 5) as $i) {
+        $t = Tenant::factory()->create(['balance_rub' => '100000.00']);
+        $p = Project::factory()->create([
+            'tenant_id' => $t->id, 'is_active' => true,
+            'supplier_b1_project_id' => $sp->id,
+            'signal_type' => 'site', 'signal_identifier' => 'cap3.ru',
+            'daily_limit_target' => 10, 'effective_daily_limit_today' => 10,
+            'delivered_today' => 0, 'delivery_days_mask' => 127, 'region_mask' => 255,
+        ]);
+        linkProjectToSupplier($p, $sp);
+    }
+
+    $vid = 710001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_cap3.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJobB($lead->id);
+
+    $lead->refresh();
+    expect($lead->deals_created_count)->toBe(3);
+    expect(DB::table('supplier_lead_deliveries')->where('supplier_lead_id', $lead->id)->count())->toBe(3);
+    expect(DB::table('supplier_lead_deliveries')->where('supplier_lead_id', $lead->id)->distinct()->count('tenant_id'))->toBe(3);
+});

app/tests/Feature/WebhookReceiveTest.php

@@ -1,286 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Jobs\ProcessWebhookJob;
-use App\Models\SystemSetting;
-use App\Models\Tenant;
-use Illuminate\Foundation\Testing\DatabaseTransactions;
-use Illuminate\Support\Facades\Bus;
-use Illuminate\Support\Facades\RateLimiter;
-
-uses(DatabaseTransactions::class);
-
-beforeEach(function () {
-    $this->tenant = Tenant::factory()->create([
-        'webhook_token' => 'whk_test_'.bin2hex(random_bytes(8)),
-        'balance_leads' => 100,
-    ]);
-    // Чистим RateLimiter между тестами — иначе lockout из одного теста
-    // загрязняет следующий.
-    RateLimiter::clear("webhook:{$this->tenant->id}");
-
-    // Audit-fix B3: дефолт isHmacRequired() изменён на true. Тесты, проверяющие
-    // НЕ-HMAC аспекты (payload-валидация, rate-limit, CSRF), явно ставят флаг в
-    // false — иначе запрос без подписи получит 401 ещё до этих проверок.
-    SystemSetting::firstOrCreate(
-        ['key' => 'webhook_hmac_required'],
-        ['value' => 'false', 'type' => 'bool', 'description' => 'test default', 'updated_at' => now()],
-    );
-    SystemSetting::where('key', 'webhook_hmac_required')->update(['value' => 'false']);
-});
-
-test('POST /api/webhook/{token} с валидным payload возвращает 202 + dispatch ProcessWebhookJob', function () {
-    Bus::fake();
-
-    $payload = [
-        'vid' => 12345,
-        'project' => 'Натяжные потолки',
-        'phone' => '+7 (999) 123-45-67',
-        'time' => time(),
-        'tag' => 'ya_direct',
-    ];
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", $payload);
-
-    $r->assertStatus(202);
-    expect($r->json('status'))->toBe('accepted');
-    expect($r->json('tenant_id'))->toBe($this->tenant->id);
-
-    Bus::assertDispatched(ProcessWebhookJob::class, function ($job) use ($payload) {
-        return $job->tenantId === $this->tenant->id
-            && $job->data['vid'] === $payload['vid']
-            && $job->data['phone'] === $payload['phone'];
-    });
-});
-
-test('POST с unknown token → 404', function () {
-    Bus::fake();
-    $r = $this->postJson('/api/webhook/whk_nonexistent_token_12345', [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ]);
-    $r->assertStatus(404);
-    Bus::assertNothingDispatched();
-});
-
-test('POST без обязательных полей → 422', function () {
-    Bus::fake();
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        // Нет vid/project/phone/time
-    ]);
-
-    $r->assertStatus(422);
-    $errors = $r->json('errors');
-    expect($errors)->toHaveKeys(['vid', 'project', 'phone', 'time']);
-    Bus::assertNothingDispatched();
-});
-
-test('POST с вредной структурой (vid=строка, time=отрицательный) → 422', function () {
-    Bus::fake();
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 'не-число',
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => -1,
-    ]);
-
-    $r->assertStatus(422);
-    Bus::assertNothingDispatched();
-});
-
-test('POST к webhook НЕ требует CSRF (внешний клиент)', function () {
-    Bus::fake();
-    // Симулируем запрос БЕЗ X-XSRF-TOKEN — CSRF middleware не должен проверять
-    // /api/webhook/* (см. bootstrap/app.php validateCsrfTokens except).
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ]);
-    $r->assertStatus(202);
-});
-
-test('POST с `phones` array (multi-phone payload) принимается', function () {
-    Bus::fake();
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 1,
-        'project' => 'Окна',
-        'phone' => '+7 (999) 000-00-00',
-        'phones' => ['+7 (999) 000-00-01', '+7 (999) 000-00-02'],
-        'time' => time(),
-    ]);
-    $r->assertStatus(202);
-    Bus::assertDispatched(ProcessWebhookJob::class, function ($job) {
-        return is_array($job->data['phones']) && count($job->data['phones']) === 2;
-    });
-});
-
-test('HMAC: валидная подпись sha256=hex(hmac_sha256(body, token)) проходит', function () {
-    Bus::fake();
-    $payload = [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ];
-    $rawBody = json_encode($payload);
-    $signature = 'sha256='.hash_hmac('sha256', $rawBody, $this->tenant->webhook_token);
-
-    $r = $this->call('POST', "/api/webhook/{$this->tenant->webhook_token}", [], [], [], [
-        'CONTENT_TYPE' => 'application/json',
-        'HTTP_ACCEPT' => 'application/json',
-        'HTTP_X_WEBHOOK_SIGNATURE' => $signature,
-    ], $rawBody);
-
-    $r->assertStatus(202);
-    Bus::assertDispatched(ProcessWebhookJob::class);
-});
-
-test('HMAC: невалидная подпись → 401, dispatch НЕ происходит', function () {
-    Bus::fake();
-    $payload = [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ];
-    $rawBody = json_encode($payload);
-
-    $r = $this->call('POST', "/api/webhook/{$this->tenant->webhook_token}", [], [], [], [
-        'CONTENT_TYPE' => 'application/json',
-        'HTTP_ACCEPT' => 'application/json',
-        'HTTP_X_WEBHOOK_SIGNATURE' => 'sha256=deadbeef'.str_repeat('0', 56),
-    ], $rawBody);
-
-    $r->assertStatus(401);
-    expect($r->json('message'))->toContain('HMAC');
-    Bus::assertNothingDispatched();
-});
-
-test('HMAC: настройка отсутствует → HMAC обязателен по умолчанию (B3) → 401', function () {
-    Bus::fake();
-    // Audit-fix B3: code-default isHmacRequired() = true. Удаляем настройку,
-    // чтобы проверить именно отсутствие ключа в system_settings.
-    SystemSetting::where('key', 'webhook_hmac_required')->delete();
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ]);
-    $r->assertStatus(401);
-    Bus::assertNothingDispatched();
-});
-
-test('rate-limit: системный лимит RPS×60 в минуту, 429 + Retry-After на превышении', function () {
-    Bus::fake();
-    // Устанавливаем низкий лимит через system_settings — иначе тест слишком долгий
-    // (default 100 RPS = 6000/мин). Подменяем через update.
-    SystemSetting::where('key', 'webhook_rate_limit_rps')->update(['value' => '1']);
-
-    $payload = [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ];
-
-    // 1 RPS × 60 = 60 запросов/мин. Делаем 60 успешных.
-    for ($i = 0; $i < 60; $i++) {
-        $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", $payload);
-        $r->assertStatus(202);
-    }
-
-    // 61-й — превышение.
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", $payload);
-    $r->assertStatus(429);
-    expect($r->json('retry_after'))->toBeInt()->toBeGreaterThan(0);
-    expect($r->headers->get('Retry-After'))->not->toBeNull();
-});
-
-test('webhook_hmac_required=true: запрос без X-Webhook-Signature → 401', function () {
-    Bus::fake();
-    SystemSetting::firstOrCreate(
-        ['key' => 'webhook_hmac_required'],
-        ['value' => 'true', 'type' => 'bool', 'description' => 'тест', 'updated_at' => now()],
-    );
-    SystemSetting::where('key', 'webhook_hmac_required')->update(['value' => 'true']);
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 1,
-        'project' => 'X',
-        'phone' => '+7 (999) 000-00-00',
-        'time' => time(),
-    ]);
-    $r->assertStatus(401);
-    expect($r->json('message'))->toContain('требуется');
-    Bus::assertNothingDispatched();
-});
-
-test('webhook_hmac_required=true: с валидной HMAC-подписью → 202', function () {
-    Bus::fake();
-    SystemSetting::firstOrCreate(
-        ['key' => 'webhook_hmac_required'],
-        ['value' => 'true', 'type' => 'bool', 'description' => 'тест', 'updated_at' => now()],
-    );
-    SystemSetting::where('key', 'webhook_hmac_required')->update(['value' => 'true']);
-
-    $payload = [
-        'vid' => 1, 'project' => 'X', 'phone' => '+7 (999) 000-00-00', 'time' => time(),
-    ];
-    $rawBody = json_encode($payload);
-    $signature = 'sha256='.hash_hmac('sha256', $rawBody, $this->tenant->webhook_token);
-
-    $r = $this->call('POST', "/api/webhook/{$this->tenant->webhook_token}", [], [], [], [
-        'CONTENT_TYPE' => 'application/json',
-        'HTTP_ACCEPT' => 'application/json',
-        'HTTP_X_WEBHOOK_SIGNATURE' => $signature,
-    ], $rawBody);
-
-    $r->assertStatus(202);
-});
-
-test('webhook_hmac_required=false: header опционален → 202 без подписи', function () {
-    Bus::fake();
-    SystemSetting::firstOrCreate(
-        ['key' => 'webhook_hmac_required'],
-        ['value' => 'false', 'type' => 'bool', 'description' => 'тест', 'updated_at' => now()],
-    );
-    SystemSetting::where('key', 'webhook_hmac_required')->update(['value' => 'false']);
-
-    $r = $this->postJson("/api/webhook/{$this->tenant->webhook_token}", [
-        'vid' => 1, 'project' => 'X', 'phone' => '+7 (999) 000-00-00', 'time' => time(),
-    ]);
-    $r->assertStatus(202);
-});
-
-test('rate-limit: ключ изолирован per-token (другой tenant не блокирует)', function () {
-    Bus::fake();
-    SystemSetting::where('key', 'webhook_rate_limit_rps')->update(['value' => '1']);
-
-    $tenantOther = Tenant::factory()->create([
-        'webhook_token' => 'whk_other_'.bin2hex(random_bytes(8)),
-    ]);
-    RateLimiter::clear("webhook:{$tenantOther->id}");
-
-    $payload = [
-        'vid' => 1, 'project' => 'X', 'phone' => '+7 (999) 000-00-00', 'time' => time(),
-    ];
-
-    // Заполняем лимит первого tenant'а
-    for ($i = 0; $i < 60; $i++) {
-        $this->postJson("/api/webhook/{$this->tenant->webhook_token}", $payload)->assertStatus(202);
-    }
-    $this->postJson("/api/webhook/{$this->tenant->webhook_token}", $payload)->assertStatus(429);
-
-    // Второй tenant — без проблем.
-    $r = $this->postJson("/api/webhook/{$tenantOther->webhook_token}", $payload);
-    $r->assertStatus(202);
-});

cspell-words.txt

@@ -1710,3 +1710,48 @@ FNS
 # Hole #2 partitioning (23.05.2026)
 партиционировать
 дёшева
+
+# Controller-offload agents spec (24.05.2026)
+синков
+эскалировать
+эскалирует
+митигации
+Версионная
+квирках
+NTFS
+маппинге
+dogfooded
+
+# Controller-offload agents level 1+2 (24.05.2026)
+бинари
+ребейзе
+dok
+аддон
+синкни
+фейл
+пинуются
+маунт
+pgrep
+захардкоженной
+ребейза
+токену
+тултип
+
+# Билинг v2 Спек C (25.05.2026)
+Atol
+uniqid
+ОФД
+брейнсторме
+префлайт
+Префлайт
+скоупа
+unreviewed
+
+# admin-zone nginx-gate + drift-fix (25.05.2026 день+1)
+стопгэп
+досылает
+creds
+опкэш
+гэп
+misowned
+деплоями

db/02_grants.sql

@@ -140,3 +140,34 @@ ALTER DEFAULT PRIVILEGES IN SCHEMA public
 
 GRANT SELECT, INSERT, UPDATE ON TABLE supplier_csv_reconcile_log TO crm_supplier_worker;
 GRANT USAGE, SELECT ON SEQUENCE supplier_csv_reconcile_log_id_seq TO crm_supplier_worker;
+
+-- =============================================================================
+-- 23.05.2026 (post hole #2): partition-maintenance privilege model
+-- =============================================================================
+-- `partitions:create-months` / `partitions:drop-expired` теперь идут через
+-- `pgsql_supplier` connection (MonthlyPartitionManager::DDL_CONNECTION). Чтобы
+-- `crm_supplier_worker` мог CREATE/DROP партиции партиционированных родителей,
+-- нужны два условия:
+--   1. Единый владелец всех 9 партиционированных родителей — `crm_migrator`.
+--      По умолчанию `schema.sql` создаёт audit-таблицы под `postgres` (load
+--      выполняется суперпользователем при `migrate:fresh`); явный ALTER OWNER
+--      ниже выравнивает прод (где это уже сделано вживую 23.05.2026) и
+--      гарантирует, что fresh-deploy не разойдётся.
+--   2. `crm_supplier_worker` — член `crm_migrator` (INHERIT TRUE), чтобы
+--      ownership-операции (CREATE TABLE ... PARTITION OF, DROP TABLE) проходили
+--      проверку владельца. Web-роль `crm_app_user` остаётся least-privilege —
+--      она НЕ получает crm_migrator-членство и НЕ может делать partition DDL.
+--
+-- Идемпотентно — повторный запуск 02_grants.sql после первого применения
+-- безопасен.
+-- =============================================================================
+
+ALTER TABLE auth_log              OWNER TO crm_migrator;
+ALTER TABLE activity_log          OWNER TO crm_migrator;
+ALTER TABLE tenant_operations_log OWNER TO crm_migrator;
+ALTER TABLE webhook_log           OWNER TO crm_migrator;
+ALTER TABLE balance_transactions  OWNER TO crm_migrator;
+ALTER TABLE pd_processing_log     OWNER TO crm_migrator;
+ALTER TABLE saas_admin_audit_log  OWNER TO crm_migrator;
+
+GRANT crm_migrator TO crm_supplier_worker WITH INHERIT TRUE;

db/CHANGELOG_schema.md

@@ -1,8 +1,77 @@
 # CHANGELOG schema.sql — Лидерра
 
-**Назначение:** консолидированный журнал изменений `schema.sql`. Содержит двадцать девять записей в обратном хронологическом порядке (v8.32 → v8.31 → v8.30 → v8.29 → v8.28 → v8.27 → v8.26 → v8.25 → v8.24 → v8.23 → v8.22 → v8.21 → v8.20 → v8.19 → v8.18 → v8.17 → v8.16 → v8.15 → v8.14 → v8.13 → v8.12 → v8.11 → v8.10 → v8.9 → v8.8 → v8.7 → v8.6 → v8.5 → v8.4 → v8.3 → v8.2), как принято в keep-a-changelog.
+**Назначение:** консолидированный журнал изменений `schema.sql`. Содержит тридцать записей в обратном хронологическом порядке (v8.33 → v8.32 → v8.31 → v8.30 → v8.29 → v8.28 → v8.27 → v8.26 → v8.25 → v8.24 → v8.23 → v8.22 → v8.21 → v8.20 → v8.19 → v8.18 → v8.17 → v8.16 → v8.15 → v8.14 → v8.13 → v8.12 → v8.11 → v8.10 → v8.9 → v8.8 → v8.7 → v8.6 → v8.5 → v8.4 → v8.3 → v8.2), как принято в keep-a-changelog.
 
-**Файл схемы:** `schema.sql` (текущая версия — v8.32, консолидированная — разворачивает БД с нуля).
+**Файл схемы:** `schema.sql` (текущая версия — v8.36, консолидированная — разворачивает БД с нуля).
+
+## v8.36 (2026-05-25) — supplier_csv_reconcile_log.unparseable_count: drift-формула без junk-строк
+
+Поставщик `crm.bp-gr.ru` периодически кладёт телефон/URL в поле «project» CSV-выгрузки
+«Запрос номеров». Парсер `CsvReconcileJob` корректно их скипает (`extractPlatform()` → `null`),
+но раньше эти строки попадали и в числитель `count($missing)`, и в знаменатель `total_csv_rows`
+формулы drift'а → стабильный false-positive `drift_alert` ~40-50% при каждом hourly-запуске
+(на проде 10 запусков подряд → admin-блок «Здоровье резервного канала» показывал «down»).
+
+**Добавлено:**
+
+- **Колонка `supplier_csv_reconcile_log.unparseable_count` INTEGER NOT NULL DEFAULT 0** — кол-во
+  CSV-строк за окно, у которых `project` не парсится в платформу B1/B2/B3.
+
+**Изменено:**
+
+- `CsvReconcileJob`: считает `$unparseableCount` отдельно, новая формула
+  `drift_ratio = max(0, missing − unparseable) / max(1, total − unparseable)` —
+  только «реальные» пропуски от parseable-строк, без вклада junk'а.
+
+**Метрики:** +1 колонка. (Сверять с header `db/schema.sql`.) Таблиц / индексов / RLS — без изменений.
+
+**Миграция:** `2026_05_25_100000_add_unparseable_count_to_supplier_csv_reconcile_log` (idempotent
+`ADD COLUMN IF NOT EXISTS` на `pgsql_supplier` connection — Спек B pattern).
+
+**Тесты:** `app/tests/Feature/Supplier/CsvReconcileJobTest.php` — +2 кейса (100 matched +
+10 junk → status=ok / mixed 95+5junk+3real → drift по реальным). Существующие 7 кейсов — без изменений (drift при unparseable=0 идентичен старой формуле).
+
+## v8.35 (2026-05-24) — legacy direct webhook removal
+
+Финальная уборка прямого webhook-канала (тенант → Лидерра). Вся инфраструктура канала
+упразднена; CSV-канал (поставщик → Лидерра) сохранён полностью.
+
+**Удалено:**
+
+- **Таблица `webhook_log`** (partitioned RANGE по `received_at`) + все дочерние партиции (DROP CASCADE).
+  Хранила payload входящих webhook от тенантов. Канал прямого приёма упразднён.
+- **Таблица `rejected_deals_log`** (регулярная) — журнал отвергнутых лидов прямого webhook-канала.
+- **Колонки `tenants.webhook_token` + `tenants.webhook_token_rotated_at`** — токен аутентификации
+  прямого webhook. Индекс `idx_tenants_webhook_token` удалён вместе с колонкой.
+- **Seed-строка `low_balance_threshold_leads`** в `system_settings` — использовалась только
+  удалённым `LowBalanceNotification` mailable'ом.
+- **Seed-строки `webhook_log_retention_days` + `webhook_log_retention_months`** в `system_settings`.
+
+**Оставлено (НЕ удалено):**
+
+- **`webhook_dedup_keys`** — используется CSV-каналом (`HistoricalImportService`) для идемпотентности.
+- **`failed_webhook_jobs.webhook_log_id`** — orphan BIGINT (без FK с v8.31/W1); оставлен.
+- **`outbound_webhook_subscriptions` + `outbound_webhook_deliveries`** — исходящий webhook (тенант → внешний URL); не затронут.
+
+**Метрики:** −2 таблицы / −5 индексов / −2 RLS-политики.
+66 base tables (65 regular + 8 partitioned parents) / 120 indexes / 40 RLS policies.
+
+**Миграция:** `2026_05_24_140000_drop_legacy_webhook_artefacts`
+
+**Связанные изменения кода:**
+
+- `MonthlyPartitionManager::PARTITIONED_TABLES` — убрана строка `webhook_log`
+- `PdErasureService::eraseSubject()` — убрана секция erasure по `webhook_log`
+
+## v8.34 (2026-05-23) — Billing v2 Spec B: drop deals(duplicate_of_id) index
+
+- **−индекс `deals (duplicate_of_id) WHERE duplicate_of_id IS NOT NULL`** — телефонный дедуп удалён (Spec B), индекс больше не используется. Колонка `deals.duplicate_of_id` оставлена спящей (drop отдельной задачей).
+- Метрики: −1 индекс. (Сверять с header `db/schema.sql`.)
+
+## v8.33 (2026-05-23) — Billing v2 Spec B: политика дублей (Phase 1)
+
+- **+таблица `supplier_lead_deliveries`** (PK `supplier_lead_id`+`tenant_id`, FK на `supplier_leads` ON DELETE CASCADE, `deal_id` без FK — `deals` партиционирована, RLS `tenant_isolation`). Замок «одна поставка одному клиенту = один оплаченный лид» для шеринг-пути (`RouteSupplierLeadJob`). INSERT-логика будет добавлена в следующем коммите.
+- Метрики: +1 таблица, +1 RLS-политика. (Сверять с header `db/schema.sql`.)
 
 **История записей:**
 

db/migrations/2026_05_23_200_supplier_lead_deliveries.sql

@@ -0,0 +1,38 @@
+-- =============================================================================
+-- supplier_lead_deliveries — замок «одна поставка одному клиенту = один раз»
+-- (Billing v2 Spec B). Ключ по поставке (supplier_lead_id), НЕ по телефону —
+-- разные поставки с одним телефоном остаются отдельными платными лидами.
+-- Защищает шеринг-путь (RouteSupplierLeadJob) от наших собственных дублей
+-- при гонках / перезапусках задачи / CSV-восстановлении.
+-- =============================================================================
+CREATE TABLE supplier_lead_deliveries (
+    supplier_lead_id BIGINT NOT NULL REFERENCES supplier_leads(id) ON DELETE CASCADE,
+    tenant_id        BIGINT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
+    deal_id          BIGINT,            -- созданная сделка; без FK (deals партиционирована)
+    created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (supplier_lead_id, tenant_id)
+);
+
+ALTER TABLE supplier_lead_deliveries ENABLE ROW LEVEL SECURITY;
+CREATE POLICY tenant_isolation ON supplier_lead_deliveries
+    USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
+
+-- Явные GRANT'ы для 4 ролей: на prod таблица создаётся crm_supplier_worker
+-- (default privileges от postgres-superuser не наследуются на чужие creator-role).
+-- Mirror webhook_dedup_keys grant pattern. DO block — idempotent + dev-safe
+-- (на dev ролей нет → silent skip).
+DO $$
+BEGIN
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_app_user') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_app_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_admin_user') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_admin_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_supplier_worker') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_supplier_worker;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_migrator') THEN
+        GRANT ALL PRIVILEGES ON supplier_lead_deliveries TO crm_migrator;
+    END IF;
+END $$;

db/migrations/2026_05_23_201_drop_deals_duplicate_of_id_index.sql

@@ -0,0 +1,3 @@
+-- Индекс по deals(duplicate_of_id) больше не нужен — телефонный дедуп удалён (Billing v2 Spec B).
+-- Колонка `deals.duplicate_of_id` оставлена спящей (drop отдельной задачей, mirrors Spec A balance_leads two-phase).
+DROP INDEX IF EXISTS deals_duplicate_of_id_idx;

db/schema.sql

@@ -1,12 +1,14 @@
 -- =============================================================================
 -- schema.sql — единая схема БД для SaaS-аналога crm.bp-gr.ru («Лидерра»)
--- Версия: v8.32 (23.05.2026 — balance_transactions.type +'migration' для Billing v2 Spec A конвертации balance_leads → balance_rub)
--- Базовая версия: v8.31 (23.05.2026 — партиционирование 7 audit-таблиц помесячно (hole #2): auth_log / activity_log / tenant_operations_log / webhook_log / balance_transactions / pd_processing_log / saas_admin_audit_log; PK → (id, created_at|received_at); FK на webhook_log удалены (W1); retention defaults в system_settings)
+-- Версия: v8.36 (25.05.2026 — supplier_csv_reconcile_log.unparseable_count: учёт мусорных CSV-строк, вычитание из drift-формулы → убирает false-positive drift_alert от телефонов/URL в поле project)
+-- Базовая версия: v8.35 (24.05.2026 — legacy direct webhook removal: DROP webhook_log (partitioned) + rejected_deals_log + tenants.webhook_token/webhook_token_rotated_at; webhook_dedup_keys сохранена (CSV-канал))
+-- Базовая версия: v8.34 (23.05.2026 — Billing v2 Spec B: −индекс deals(duplicate_of_id) — телефонный дедуп удалён)
+-- Базовая версия: v8.31 (23.05.2026 — партиционирование 7 audit-таблиц помесячно (hole #2): auth_log / activity_log / tenant_operations_log / balance_transactions / pd_processing_log / saas_admin_audit_log; PK → (id, created_at|received_at); retention defaults в system_settings)
 -- Базовая версия: v8.30 (23.05.2026 — scheduler_heartbeats: пульс планировщика, SaaS-level без RLS, 11 cron-задач, hole #6)
 -- Базовая версия: v8.29 (22.05.2026 — webhook_log: supplier audit columns)
 -- Базовая версия: v8.28 (22.05.2026 — tenant_operations_log: журнал тенант-уровневых операций вне сделок (проекты, API-ключи, webhook URL), append-only hash-chain, P2 operational journaling closure)
 -- Базовая версия: v8.27 (21.05.2026 — drop projects.archived_at: feature архива заменена настоящим удалением с защитой по сделкам (ProjectService::delete()))
--- Метрики: 74 базовые таблицы (65 regular + 9 partitioned parents: deals + supplier_lead_costs + 7 audit) + 12 партиций / 125 индексов / 41 RLS-политика / 5 функций / 15 триггеров
+-- Метрики: 73 базовые таблицы (65 regular + 8 partitioned parents: deals + supplier_lead_costs + 6 audit) + 12 партиций / 120 индексов / 40 RLS-политик / 5 функций / 15 триггеров
 -- Базовая версия: v8.25 (19.05.2026 — supplier_manual_sync_queue: SaaS-level Tier 3 очередь резерва канала миграции проектов)
 -- Базовая версия: v8.24 (18.05.2026 — supplier_leads.vid → nullable для CSV-recovered лидов (Путь 2))
 -- Базовая версия: v8.20 (11.05.2026 — Plan 5 frontend projects UI: projects.archived_at TIMESTAMPTZ NULL для soft archive flow; tenants.limits JSONB NOT NULL DEFAULT '{}' для per-tenant project/user лимитов)
@@ -630,8 +632,7 @@ CREATE TABLE tenants (
     contact_email       VARCHAR(255) NOT NULL,
     status              VARCHAR(20) DEFAULT 'active'
                         CHECK (status IN ('active','suspended','pending_email_confirm','deleted')),
-    webhook_token       VARCHAR(64) UNIQUE NOT NULL,
-    webhook_token_rotated_at TIMESTAMPTZ,
+    -- webhook_token / webhook_token_rotated_at удалены в v8.35 (legacy direct webhook removal)
     timezone            VARCHAR(50) DEFAULT 'Europe/Moscow',
     locale              VARCHAR(10) DEFAULT 'ru',
     -- Биллинг
@@ -678,7 +679,7 @@ CREATE TABLE tenants (
 );
 
 CREATE INDEX idx_tenants_subdomain     ON tenants(subdomain) WHERE deleted_at IS NULL;
-CREATE INDEX idx_tenants_webhook_token ON tenants(webhook_token) WHERE deleted_at IS NULL AND status = 'active';
+-- idx_tenants_webhook_token удалён в v8.35 (legacy direct webhook removal)
 CREATE INDEX idx_tenants_inactive      ON tenants(last_activity_at) WHERE deleted_at IS NULL;
 
 -- Forward FK на tenants для SaaS-админских таблиц, объявленных выше
@@ -1137,6 +1138,11 @@ CREATE TABLE supplier_csv_reconcile_log (
     total_csv_rows       INTEGER,
     matched_count        INTEGER,
     recovered_count      INTEGER,
+    -- Кол-во CSV-строк, у которых поле «project» не парсится в платформу B1/B2/B3
+    -- (поставщик иногда кладёт телефон/URL в «Name» вместо названия проекта).
+    -- Используется CsvReconcileJob для корректного расчёта drift'а — без вычитания
+    -- этих строк формула стабильно даёт false-positive drift_alert ~40-50%.
+    unparseable_count    INTEGER NOT NULL DEFAULT 0,
     drift_ratio          NUMERIC(5,4),
     status               VARCHAR(16) NOT NULL DEFAULT 'running'
                          CHECK (status IN ('running','ok','drift_alert','failed')),
@@ -1415,7 +1421,7 @@ CREATE INDEX idx_outbound_subs_secret_prefix   ON outbound_webhook_subscriptions
 
 -- -----------------------------------------------------------------------------
 -- outbound_webhook_deliveries — журнал попыток доставки (v8.4)
--- Retention 90 дней (как webhook_log). См. §19.10.6 (retry-логика 7 попыток
+-- Retention 90 дней. См. §19.10.6 (retry-логика 7 попыток
 -- от 30 секунд до 24 часов).
 -- -----------------------------------------------------------------------------
 CREATE TABLE outbound_webhook_deliveries (
@@ -1683,9 +1689,6 @@ CREATE INDEX        ON deals (tenant_id, source_crm_id) WHERE source_crm_id IS N
 CREATE INDEX        ON deals (tenant_id, utm_source) WHERE utm_source IS NOT NULL;
 -- (Биз-23) гео-фильтр в §10.3 + аналитика по регионам.
 CREATE INDEX        ON deals (tenant_id, region_code) WHERE region_code IS NOT NULL;
--- (Биз-19) lookup дублей master'а через duplicate_of_id для UI (показать
--- цепочку дублей) и для cleanup при удалении master'а.
-CREATE INDEX        ON deals (duplicate_of_id) WHERE duplicate_of_id IS NOT NULL;
 -- (OPEN-И-25) cron leads:escalate-stale — выбирает unclosed deals по assigned_at.
 CREATE INDEX        ON deals (tenant_id, assigned_at) WHERE status NOT IN ('closed','rejected');
 -- v8.9: фильтр soft-deleted в DealController::index/show/transition. Partial index
@@ -1922,32 +1925,9 @@ COMMENT ON TABLE in_app_notifications IS
     'read_at при клике. RLS: tenant isolation.';
 
 
--- -----------------------------------------------------------------------------
--- webhook_log — лог принятых webhook (раздел 5.7)
--- РЕТЕНШН: system_settings.webhook_log_retention_days (по умолчанию 90 дней)
--- -----------------------------------------------------------------------------
--- v8.31: партиционирована помесячно по received_at (hole #2). PK → (id, received_at).
--- FK из failed_webhook_jobs/rejected_deals_log удалены (W1 — невозможны на составном PK
--- партиционированной таблицы с единичным FK-столбцом).
-CREATE TABLE webhook_log (
-    id              BIGSERIAL,
-    tenant_id       BIGINT REFERENCES tenants(id) ON DELETE CASCADE,  -- NULL для platform-level событий (supplier webhook)
-    raw_payload     JSONB NOT NULL,                        -- содержит ПДн → удаляется при анонимизации
-    received_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),    -- v8.31: NOT NULL (partition key)
-    processed_at    TIMESTAMPTZ,
-    deal_id         BIGINT,                                -- БЕЗ FK (deals партиционирована)
-    error           TEXT,
-    -- v8.29: supplier webhook audit columns
-    source          VARCHAR(50),                           -- 'supplier' | 'tenant'
-    status          VARCHAR(50),                           -- 'received' | 'rejected_secret' | 'rejected_ip' | 'rate_limited'
-    lead_id         BIGINT,                                -- supplier_leads.id при статусе 'received'
-    ip_address      INET,                                  -- клиентский IP
-    created_at      TIMESTAMPTZ DEFAULT NOW(),
-    PRIMARY KEY (id, received_at)                          -- v8.31: composite PK
-) PARTITION BY RANGE (received_at);
-
-CREATE INDEX idx_webhook_log_tenant_received ON webhook_log(tenant_id, received_at DESC);
-CREATE INDEX idx_webhook_log_status ON webhook_log(status, created_at DESC);
+-- webhook_log удалена в v8.35 (legacy direct webhook removal).
+-- Канал входящих webhook (прямой приём от тенантов) упразднён.
+-- webhook_dedup_keys сохранена — используется CSV-каналом (HistoricalImportService).
 
 
 -- -----------------------------------------------------------------------------
@@ -1972,21 +1952,8 @@ CREATE INDEX idx_failed_webhook_unresolved ON failed_webhook_jobs(failed_at DESC
 CREATE INDEX idx_failed_webhook_jobs_log ON failed_webhook_jobs(webhook_log_id);  -- v8.11 (audit O-perf-02)
 
 
--- -----------------------------------------------------------------------------
--- rejected_deals_log — лог отвергнутых лидов при balance=0 (раздел 5.7)
--- РЕТЕНШН: бессрочно (опционально 12 месяцев)
--- -----------------------------------------------------------------------------
-CREATE TABLE rejected_deals_log (
-    id              BIGSERIAL PRIMARY KEY,
-    tenant_id       BIGINT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
-    webhook_log_id  BIGINT,                                -- v8.31: FK удалён (W1 — webhook_log партиционирована, composite PK несовместим с одиночным FK)
-    reason          VARCHAR(50) NOT NULL,                  -- zero_balance, validation_failed, ...
-    payload         JSONB,
-    created_at      TIMESTAMPTZ DEFAULT NOW()
-);
-
-CREATE INDEX idx_rejected_tenant_created ON rejected_deals_log(tenant_id, created_at DESC);
-CREATE INDEX idx_rejected_deals_log_webhook ON rejected_deals_log(webhook_log_id);  -- v8.11 (audit O-perf-03)
+-- rejected_deals_log удалена в v8.35 (legacy direct webhook removal).
+-- Rejection-журнал для прямого webhook-канала упразднён вместе с каналом.
 
 
 -- -----------------------------------------------------------------------------
@@ -2046,6 +2013,45 @@ CREATE INDEX supplier_leads_recovered_from_csv_partial
 --
 -- REVOKE ALL ON supplier_leads FROM crm_app_user;
 
+-- =============================================================================
+-- supplier_lead_deliveries — замок «одна поставка одному клиенту = один раз»
+-- (Billing v2 Spec B). Ключ по поставке (supplier_lead_id), НЕ по телефону —
+-- разные поставки с одним телефоном остаются отдельными платными лидами.
+-- Защищает шеринг-путь (RouteSupplierLeadJob) от наших собственных дублей
+-- при гонках / перезапусках задачи / CSV-восстановлении.
+-- =============================================================================
+CREATE TABLE supplier_lead_deliveries (
+    supplier_lead_id BIGINT NOT NULL REFERENCES supplier_leads(id) ON DELETE CASCADE,
+    tenant_id        BIGINT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
+    deal_id          BIGINT,            -- созданная сделка; без FK (deals партиционирована)
+    created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (supplier_lead_id, tenant_id)
+);
+
+ALTER TABLE supplier_lead_deliveries ENABLE ROW LEVEL SECURITY;
+CREATE POLICY tenant_isolation ON supplier_lead_deliveries
+    USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
+
+-- Явные GRANT'ы для 4 ролей (mirror webhook_dedup_keys): на prod таблица
+-- создаётся crm_supplier_worker, default privileges не наследуются от
+-- postgres-superuser на чужие creator-role. DO block — idempotent + dev-safe
+-- (на dev ролей нет → silent skip).
+DO $$
+BEGIN
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_app_user') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_app_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_admin_user') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_admin_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_supplier_worker') THEN
+        GRANT SELECT, INSERT, UPDATE, DELETE ON supplier_lead_deliveries TO crm_supplier_worker;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_migrator') THEN
+        GRANT ALL PRIVILEGES ON supplier_lead_deliveries TO crm_migrator;
+    END IF;
+END $$;
+
 
 -- =============================================================================
 -- 7. БИЛЛИНГ (SAAS-уровень)
@@ -2767,7 +2773,7 @@ VALUES
 INSERT INTO system_settings (key, value, type, description) VALUES
     ('schema_version',                '8.3', 'string', 'Текущая версия схемы БД'),
     ('trial_bonus_leads',             '50',  'int',    'Стартовый бонус лидов для нового тенанта (fallback для tariff_plans.trial_bonus_leads)'),
-    ('low_balance_threshold_leads',   '10',  'int',    'Порог email-предупреждения о низком балансе'),
+    -- low_balance_threshold_leads удалён в v8.35 (использовался только LowBalanceNotification — удалена вместе с webhook-каналом)
     ('inactive_warn_months',          '11',  'int',    'Через сколько месяцев простоя слать предупреждение'),
     ('inactive_delete_months',        '12',  'int',    'Через сколько месяцев простоя удалять данные'),
     ('webhook_rate_limit_rps',        '100', 'int',    'Лимит запросов в секунду на токен Webhook'),
@@ -2775,7 +2781,7 @@ INSERT INTO system_settings (key, value, type, description) VALUES
     ('api_rate_limit_per_minute',     '60',  'int',    'Лимит запросов API на ключ в минуту'),
     ('login_max_attempts',            '5',   'int',    'Макс. неудачных попыток входа в окне 15 минут'),
     ('password_min_length',           '10',  'int',    'Минимальная длина пароля'),
-    ('webhook_log_retention_days',    '90',  'int',    'Сколько дней хранить raw_payload Webhook'),
+    -- webhook_log_retention_days удалён в v8.35 (webhook_log таблица удалена)
     -- VAPID (Web Push, раздел 17.4)
     ('vapid_public_key',              '',    'string', 'VAPID public key (для подписки)'),
     ('vapid_private_key',             '',    'string', 'VAPID private key (ШИФРОВАН) — заполнить при инсталляции'),
@@ -2803,11 +2809,11 @@ INSERT INTO system_settings (key, value, type, description) VALUES
     -- v8.18 (Plan 2/5): supplier-webhook secret + IP allowlist для defense-in-depth.
     ('supplier_webhook_secret', '__SET_ON_DEPLOY__', 'string', 'Platform-wide секрет (≥32 chars) для /api/webhook/supplier/{secret}. См. spec §5.1.'),
     ('supplier_ip_allowlist',   '[]',                'json',   'Список IP/CIDR поставщика crm.bp-gr.ru. Пустой массив = пропускать всех (DEV); на prod заполнить.'),
-    -- v8.31: retention для 7 audit-таблиц после partitioning (hole #2). Используется PartitionsDropExpired (cron Sundays 03:00 МСК).
+    -- v8.31: retention для audit-таблиц после partitioning (hole #2). Используется PartitionsDropExpired (cron Sundays 03:00 МСК).
+    -- webhook_log_retention_months удалён в v8.35 (webhook_log таблица удалена).
     ('auth_log_retention_months',              '24', 'int', 'Retention auth_log в месяцах (hole #2)'),
     ('activity_log_retention_months',          '36', 'int', 'Retention activity_log (hole #2)'),
     ('tenant_operations_log_retention_months', '24', 'int', 'Retention tenant_operations_log (hole #2)'),
-    ('webhook_log_retention_months',            '3', 'int', 'Retention webhook_log (hole #2)'),
     ('balance_transactions_retention_months',  '84', 'int', 'Retention balance_transactions, 7л НК РФ (hole #2)'),
     ('pd_processing_log_retention_months',     '36', 'int', 'Retention pd_processing_log, 152-ФЗ 3 года (hole #2)'),
     ('saas_admin_audit_log_retention_months',  '84', 'int', 'Retention saas_admin_audit_log, 7л (hole #2)');
@@ -2880,9 +2886,8 @@ ALTER TABLE import_unknown_statuses  ENABLE ROW LEVEL SECURITY;
 ALTER TABLE activity_log             ENABLE ROW LEVEL SECURITY;
 ALTER TABLE tenant_operations_log    ENABLE ROW LEVEL SECURITY;  -- v8.31: перенесено сюда (была inline)
 ALTER TABLE reminders                ENABLE ROW LEVEL SECURITY;
-ALTER TABLE webhook_log              ENABLE ROW LEVEL SECURITY;
+-- webhook_log / rejected_deals_log: таблицы удалены в v8.35
 ALTER TABLE failed_webhook_jobs      ENABLE ROW LEVEL SECURITY;
-ALTER TABLE rejected_deals_log       ENABLE ROW LEVEL SECURITY;
 ALTER TABLE tariff_subscriptions     ENABLE ROW LEVEL SECURITY;
 ALTER TABLE saas_invoices            ENABLE ROW LEVEL SECURITY;
 ALTER TABLE saas_invoice_items       ENABLE ROW LEVEL SECURITY;  -- через invoice_id косвенно (см. политику ниже)
@@ -2922,9 +2927,8 @@ CREATE POLICY tenant_isolation ON import_unknown_statuses USING (tenant_id = cur
 CREATE POLICY tenant_isolation ON activity_log            USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
 CREATE POLICY tenant_isolation ON tenant_operations_log   USING (tenant_id = current_setting('app.current_tenant_id')::bigint);  -- v8.31: перенесено из inline
 CREATE POLICY tenant_isolation ON reminders               USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
-CREATE POLICY tenant_isolation ON webhook_log             USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
+-- webhook_log / rejected_deals_log policies удалены в v8.35 (таблицы удалены)
 CREATE POLICY tenant_isolation ON failed_webhook_jobs     USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
-CREATE POLICY tenant_isolation ON rejected_deals_log      USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
 CREATE POLICY tenant_isolation ON tariff_subscriptions    USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
 CREATE POLICY tenant_isolation ON saas_invoices           USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
 CREATE POLICY tenant_isolation ON saas_upd_documents      USING (tenant_id = current_setting('app.current_tenant_id')::bigint);

docs/Pravila_raboty_Claude_v1_1.md

@@ -1,10 +1,12 @@
 # Правила работы Claude в проекте «Лидерра»
 
-**Версия:** v1.39 (22.05.2026)
-**Дата:** 22.05.2026
+**Версия:** v1.40 (24.05.2026)
+**Дата:** 24.05.2026
 **Назначение:** настройки проекта (Project instructions) — Claude читает этот файл в каждом чате и следует правилам ниже.
 **Статус документа:** ✅ утверждён. Содержимое скопировано в поле "Project instructions" Claude.ai. Файл хранится в архиве как служебный документ.
 
+**Что изменилось в v1.40 относительно v1.39:** Делегирование проектным AI-агентам — §2.4 (новая подсекция) описывает обязанность контроллера передавать класс задач 4 узко-специализированным агентам в `.claude/agents/`: `normative-sync` (#84, синк 4 нормативных файлов после крупной задачи), `prod-deploy-validator` (#85, 8 SSH pre-flight перед выкатом на liderra.ru), плюс прежние `pest-parallel-debugger` и `rls-reviewer`. Project-агенты регистрируются в `docs/registry/nodes.yaml` (subcategory `project-agent`) для missed-activation детектора, но **не входят в Tooling канон счётчиков** #1-#83 (footer-числа не двигаются). Архитектурных изменений §§1, §3–§16: 0. Связано: CLAUDE.md v2.28+ (§3.9), spec `docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md`, agent files `.claude/agents/{normative-sync,prod-deploy-validator}.md`.
+
 **Что изменилось в v1.39 относительно v1.38:** C1 marketing-tooling — §13.2 +абзац «Off-phase marketing-tooling»: #74 marketing (Anthropic, первичный решатель C1), #75 marketingskills (вендорен MIT, материал/резерв), #76 brand-voice (Anthropic, вербальный бренд), #77 marketing-ru (self-authored project-скил, РФ-специфика + 152-ФЗ маркетинг), #78 Яндекс.Метрика MCP (READ-ONLY), #79 Яндекс.Директ+Wordstat MCP (**Wordstat-only**, Direct-мутации отключены per IS9), #80 Telegram MCP, #81 Postiz (self-host, AGPL-3.0 internal), #82 DataForSEO (**DEFERRED**, pending Б-1/бюджет), #83 Unisender Go (**DEFERRED**, pending согласования + 152-ФЗ). 18-я off-phase подкатегория, раздел C1. Не UI → вне R6.0/R6.1/R14. Границы — ADR-015. Счётчики — канон Tooling §0. Архитектурных изменений §§1–12, §14–§16: 0. Связано: Tooling v2.23+, PSR_v1 v3.22+, CLAUDE.md v2.27+; план `docs/superpowers/plans/2026-05-22-c1-marketing-tooling.md`.
 
 **Что изменилось в v1.38 относительно v1.37:** A8 infosec install-sync — ZAP #68 + Ward #70 установлены портативно 21.05.2026 (без choco, по выбору заказчика «оба портативно») → в §13.2 абзаце «Off-phase infosec-tooling» статус **PENDING INSTALL снят** для обоих (ZAP: ZAP 2.17.0 + MCP-аддон на portable Temurin JRE 17; Ward: собран portable Go → `bin/ward.exe` v0.4.1); setup-доки `docs/security/{zap,ward}-setup.md`. Архитектурных изменений §§1–16: 0. Связано: Tooling v2.21, PSR_v1 v3.21, CLAUDE.md v2.25; план `docs/superpowers/plans/2026-05-21-a8-infosec-tooling.md`.
@@ -238,6 +240,27 @@ Claude — **системный архитектор-документалист*
 - Не продолжает работу при обнаружении противоречия между файлами архива «молча» — всегда сообщает заказчику.
 - Не загружает в контекст всю документацию v8.0+ целиком — обращается по разделам через `project_knowledge_search`.
 
+### 2.4. Делегирование проектным AI-агентам (v1.40)
+
+В `.claude/agents/` лежат проектные AI-агенты (Sonnet 4.6, узко-специализированные). Контроллер ОБЯЗАН делегировать им следующие классы задач:
+
+| Условие | Агент | Brief-фраза заказчика-триггер |
+|---------|-------|-------------------------------|
+| Закрытие крупной off-phase интеграции / brain governance артефакта / принятого ADR — синк 4 нормативных файлов (Pravila / PSR_v1 / Tooling / CLAUDE.md) | `normative-sync` (#84, [agent file](../.claude/agents/normative-sync.md), [spec §3](superpowers/specs/2026-05-24-controller-offload-agents-design.md)) | «синкни нормативку», «закрыли X — нужен синк» |
+| Любой выкат на боевой `liderra.ru` (push с миграциями, scp-патч, ручной деплой) — 8 pre-flight SSH проверок | `prod-deploy-validator` (#85, [agent file](../.claude/agents/prod-deploy-validator.md), [spec §4](superpowers/specs/2026-05-24-controller-offload-agents-design.md)) | «проверь готовность боевого», «ready to deploy» |
+| Диагностика Pest 4 `--parallel` failures (квирки 72/73/77) | `pest-parallel-debugger` ([agent file](../.claude/agents/pest-parallel-debugger.md)) | «pest упал на parallel», «классифицируй фейл» |
+| RLS-compliance review при правке `db/schema.sql` или `db/migrations/` | `rls-reviewer` ([agent file](../.claude/agents/rls-reviewer.md)) | «проверь RLS на миграции», «RLS review» |
+
+**Дисциплина делегирования:**
+
+- Контроллер вызывает агента **по триггеру**, не дожидаясь явного запроса заказчика — для `normative-sync` сразу после крупной задачи; для `prod-deploy-validator` обязательно ДО любых SSH-команд на боевой.
+- Заказчик может явно отменить вызов («не зови сейчас X»). Live-отмена — только на текущее действие.
+- Если агент возвращает эскалацию — контроллер передаёт её заказчику без угадывания, не пытается обойти.
+- Project-агенты **не входят в Tooling Прил. Н канон счётчиков** (#1-#83 — реестр инструментов; project-агенты идут #84+ в `docs/registry/nodes.yaml` с подкатегорией `project-agent`). Footer-счётчики «N формализованных» изменяются только при добавлении в Tooling-канон, не при добавлении project-агента.
+- Полный perimeter / триггеры / границы — в `description`-frontmatter каждого агент-файла. Это первичный источник «когда звать»; настоящая таблица — индекс контракта, не дублирующая декларация.
+
+**Naming-convention:** `agent_file: ".claude/agents/<slug>.md"` атрибут в `docs/registry/nodes.yaml` маркирует узел как project-агент (отличает от Tooling-инструментов, у которых `tooling_section` атрибут).
+
 ---
 
 ## 3. Формат ответов и работы с файлами

docs/observer/.pii-counters.json

@@ -0,0 +1,5 @@
+{
+  "2026-05": {
+    "WIN_USER_PATH": 6
+  }
+}

docs/observer/STATUS.md

@@ -1,30 +1,48 @@
 # Brain Status (auto-generated)
 
-Last updated: 2026-05-23T16:38:59.719Z
+Last updated: 2026-05-25T04:31:41.337Z
 
 | Контролёр | Состояние | Детали |
 |---|---|---|
 | C1 L1-watcher | ✅ | [l1-watcher] OK — 0 drift |
-| C2 Cross-ref consistency | ✅ | [cross-ref-checker] OK — 0 drift in 4 files |
+| C2 Cross-ref consistency | 🔴 | Update cross-refs in offending files. |
 | C3 Observer-of-observer | ✅ | [observer-of-observer] OK — last read 0 week(s) ago |
 | C4 Сигнальный статус | ✅ | This file (self-reference) |
-| C5 Observer-coverage | ⚠️ | 165 episode(s) this month · Stop-hook + post-commit OK · 21 missed activation(s) — see /brain-retro |
+| C5 Observer-coverage | ⚠️ | 341 episode(s) this month · Stop-hook + post-commit OK · 21 missed activation(s) — see /brain-retro |
 | C6 Chain map sync | ✅ | [chain-map-checker] OK — 16 chains in sync |
 
 ## Метрики (информационные, не алерты)
 
-- Observer evidence: 165 episodes this month, 0 observer_error markers, 83 PII matches before filter
-- Legacy v1 episodes (not in factor analysis): 26
+- Observer evidence: 341 episodes this month, 0 observer_error markers, 31 PII matches before filter
+- Legacy v1 episodes (not in factor analysis): 202
 - Last /brain-retro: 0 day(s) ago
 - Использование узлов: см. `/brain-retro` (раз в спринт). missed_activations: 21. **Неиспользованные узлы — не алерт, если профильной задачи не было** (Pravila §16.4 v1.36; capability-readiness; см. memory `feedback_brain_unused_tools_not_problem` — outside-repo memory store).
 
+## Метрики дисциплины
+
+Baseline дисциплины роутера (этап 2 router discipline overhaul, spec 2026-05-23). Цель — увидеть «точку До» перед enforcement-хуком этапа 3.
+
+| Тип задачи | Эпизодов | % с триггер-матчем | % через скил |
+|---|---|---|---|
+| analysis | 15 | 46.7% | 26.7% |
+| monitoring | 12 | 0.0% | 0.0% |
+| bugfix | 10 | 40.0% | 40.0% |
+| planning | 9 | 11.1% | 22.2% |
+| feature | 9 | 22.2% | 0.0% |
+| refactor | 1 | 0.0% | 0.0% |
+| cleanup | 1 | 0.0% | 0.0% |
+
+Router step distribution: 1: 139, 2: 118, 3: 37, 5: 42
+
+Boundaries applied (ADR / границы): 47 of 336 эпизодов (14.0%).
+
 ## Активные многоэтапные проекты
 
 - **Router discipline overhaul** ([spec](../superpowers/specs/2026-05-23-router-discipline-overhaul-design.md))
   - Этап 1 (машиночитаемый реестр) ✅ закрыт 2026-05-23 — `docs/registry/nodes.yaml` (83 узла + 16 chains L1-L16), `tools/registry-load.mjs` + `tools/registry-render.mjs` (16 тестов), auto-render Tooling §4.0 + routing-off-phase, lefthook job 17 (warn-only).
-  - Этап 2 (измерения + классификатор-парсер) ⏸ ждёт «продолжаем» от заказчика. Plan: TBD.
-  - Этап 3 (принуждение — хук на routing) — не начат.
-  - Этап 4 (уборка правил) — не начат.
+  - Этап 2 (измерения + классификатор-парсер) ✅ закрыт 2026-05-24 + влит в main 2026-05-24 — discipline-metrics (3 среза), brain-retro-analyzer переключён на реестр, STATUS.md блок «Метрики дисциплины», baseline snapshot `docs/observer/baselines/2026-05-24-pre-enforcement.md`. Plan: `docs/superpowers/plans/2026-05-24-router-overhaul-stage-2-measurements.md`.
+  - Этап 3 (принуждение — хук на routing) — Phase A+B (классификатор + 3 хука: router-prehook/tool-gate/stop-gate в `.claude/settings.json`) ✅ + влит в main 2026-05-24. Гейт работает в режиме **`warn-only`** (только stderr-предупреждения, никакой блокировки). Bug-fix `bec69aa5`: `deriveRouterStep` в `tools/discipline-metrics.mjs` — шаг роутера теперь выводится из наблюдаемых признаков (был захардкоженной константой 1). **Follow-up 3 fixes 2026-05-24** (после ANTHROPIC_API_KEY + рестарта CC выявлены при инспекции state): (a) UTF-8 stdin helper `tools/router-stdin-helper.mjs` через `StringDecoder` + подключение к 3 хукам (русский в state-файл и Anthropic API без mojibake); (b) `tools/observer-state-enricher.mjs` — pure helper для чтения `router-state-<session>.json`; (c) `parseTranscript` обогащение `primary_rationale` 4 полями (`recommended_node` override + `recommended_chain` + `chain_progress` + `chain_completed`). 538 tools-тестов GREEN. Plan: `docs/superpowers/plans/2026-05-24-router-stage3-three-fixes.md`. CHECKPOINT B: дать warn-only накопить реальные наблюдения с **починенным** сторожем (план говорит «минимум 24 часа»), затем Task 9 — переключение в `enforce` + 2 новых метрики (domain-hit-rate / chain-completion). Plan: `docs/superpowers/plans/2026-05-24-router-overhaul-stage-3-enforcement.md`.
+  - Этап 4 (уборка устаревших правил, deprecation `observer-classification-map.json` → удаление) — не начат.
 
 ## Алерт-индикаторы
 

docs/observer/active-projects.md

@@ -1,5 +1,5 @@
 - **Router discipline overhaul** ([spec](../superpowers/specs/2026-05-23-router-discipline-overhaul-design.md))
   - Этап 1 (машиночитаемый реестр) ✅ закрыт 2026-05-23 — `docs/registry/nodes.yaml` (83 узла + 16 chains L1-L16), `tools/registry-load.mjs` + `tools/registry-render.mjs` (16 тестов), auto-render Tooling §4.0 + routing-off-phase, lefthook job 17 (warn-only).
-  - Этап 2 (измерения + классификатор-парсер) ⏸ ждёт «продолжаем» от заказчика. Plan: TBD.
-  - Этап 3 (принуждение — хук на routing) — не начат.
-  - Этап 4 (уборка правил) — не начат.
+  - Этап 2 (измерения + классификатор-парсер) ✅ закрыт 2026-05-24 + влит в main 2026-05-24 — discipline-metrics (3 среза), brain-retro-analyzer переключён на реестр, STATUS.md блок «Метрики дисциплины», baseline snapshot `docs/observer/baselines/2026-05-24-pre-enforcement.md`. Plan: `docs/superpowers/plans/2026-05-24-router-overhaul-stage-2-measurements.md`.
+  - Этап 3 (принуждение — хук на routing) — Phase A+B (классификатор + 3 хука: router-prehook/tool-gate/stop-gate в `.claude/settings.json`) ✅ + влит в main 2026-05-24. Гейт работает в режиме **`warn-only`** (только stderr-предупреждения, никакой блокировки). Bug-fix `bec69aa5`: `deriveRouterStep` в `tools/discipline-metrics.mjs` — шаг роутера теперь выводится из наблюдаемых признаков (был захардкоженной константой 1). **Follow-up 3 fixes 2026-05-24** (после ANTHROPIC_API_KEY + рестарта CC выявлены при инспекции state): (a) UTF-8 stdin helper `tools/router-stdin-helper.mjs` через `StringDecoder` + подключение к 3 хукам (русский в state-файл и Anthropic API без mojibake); (b) `tools/observer-state-enricher.mjs` — pure helper для чтения `router-state-<session>.json`; (c) `parseTranscript` обогащение `primary_rationale` 4 полями (`recommended_node` override + `recommended_chain` + `chain_progress` + `chain_completed`). 538 tools-тестов GREEN. Plan: `docs/superpowers/plans/2026-05-24-router-stage3-three-fixes.md`. CHECKPOINT B: дать warn-only накопить реальные наблюдения с **починенным** сторожем (план говорит «минимум 24 часа»), затем Task 9 — переключение в `enforce` + 2 новых метрики (domain-hit-rate / chain-completion). Plan: `docs/superpowers/plans/2026-05-24-router-overhaul-stage-3-enforcement.md`.
+  - Этап 4 (уборка устаревших правил, deprecation `observer-classification-map.json` → удаление) — не начат.

docs/observer/baselines/2026-05-24-pre-enforcement.md

@@ -0,0 +1,98 @@
+# Baseline дисциплины роутера — pre-enforcement snapshot
+
+**Дата:** 2026-05-24
+**Источник данных:** `docs/observer/episodes-2026-05.jsonl`
+**Этап:** Router discipline overhaul, Stage 2 (Measurements). Зафиксирован для сравнения с пост-enforcement цифрами этапа 3.
+**Spec:** `docs/superpowers/specs/2026-05-23-router-discipline-overhaul-design.md`
+**Plan:** `docs/superpowers/plans/2026-05-24-router-overhaul-stage-2-measurements.md`
+**Commit:** e239160a (snapshot creation) → 436284c5 (F1 top-5 nodes fix)
+
+## Объём данных
+
+- Эпизодов всего: 129 (124 v2+ + 5 v1)
+- v2+ эпизодов (анализируется): 124
+- v1 эпизодов пропущено: 5
+- Observer-error маркеров: 0
+
+## Цифры
+
+### Дисциплина по типам задач
+
+| Тип задачи | Эпизодов | % с триггер-матчем | % через скил |
+|---|---|---|---|
+| bugfix | 6 | 33.3% | 33.3% |
+| analysis | 4 | 0% | 25.0% |
+| feature | 5 | 0% | 0% |
+| planning | 2 | 0% | 0% |
+| refactor | 1 | 0% | 0% |
+| cleanup | 1 | 0% | 0% |
+| monitoring | 1 | 0% | 0% |
+
+### Распределение по шагам роутера
+
+- distribution: `{"1": 124}`
+- total: 124
+- **suspicious: true** — >90% эпизодов остановились на step=1; sentinel-bug парсера, требует исследования в этапе 3
+
+### Применение границ (ADR)
+
+- Total: 124
+- With boundaries: 13
+- Rate: 10.5%
+- By path_type:
+  - `improvised`: 112 эпизодов, 11 с boundaries, 9.8%
+  - `regulated`: 12 эпизодов, 2 с boundaries, 16.7%
+
+### Missed activations
+
+- Total: 17
+
+By classification:
+
+```json
+{
+  "bugfix": 4,
+  "feature": 5,
+  "refactor": 1,
+  "planning": 2,
+  "cleanup": 1,
+  "monitoring": 1,
+  "analysis": 3
+}
+```
+
+By node (top 5 по количеству):
+
+```json
+{
+  "#19": 12,
+  "#34": 5,
+  "#18": 4,
+  "#25": 3,
+  "#39": 3
+}
+```
+
+*(#53 также имеет count 3, следующие: #11:#12:#41:#42 = 2)*
+
+## Контекст
+
+Это «точка До» перед включением enforcement-хука этапа 3. После недели работы хука повторно снимем эти цифры и сравним.
+
+**Цели overhaul'а (из spec'а §acceptance criteria):**
+
+- Дисциплина (% эпизодов с матченным триггером на классифицированных задачах): **≥75%** (baseline зафиксирован выше — сейчас 33.3% лишь у bugfix, остальные 0%).
+- Missed activations: **≤5/неделю** (baseline: 17 за месяц).
+- % feature/planning без skill: **≤10%** (baseline: feature 0%, planning 0% — обе категории нарушают цель).
+
+## Заметка о suspicious-флаге
+
+`suspicious: true` в `routerStep` указывает, что **все 124 v2+ эпизода имеют `step=1`**. Это означает, что парсер `tools/observer-transcript-parser.mjs` пока не enrich'ит фактический шаг роутера — поле `primary_rationale.step` сейчас постоянно `1` (sentinel default). Этот пропуск самой инструментовки наблюдателя — отдельный задел для этапа 3 (нужно либо расширить парсер, чтобы он различал шаги, либо явно вычислять step из контекста). До этого срез по router_step **не информативен**.
+
+## Воспроизводимость
+
+```bash
+node tools/brain-retro-analyzer.mjs docs/observer/episodes-2026-05.jsonl
+```
+
+Источник classificationMap + dormancy — `docs/registry/nodes.yaml` (через `tools/registry-to-classification-map.mjs`).

docs/registry/nodes.yaml

@@ -160,6 +160,8 @@ nodes:
     triggers:
       - {keyword: "php code style", weight: 1.0}
       - {keyword: "форматтер", weight: 1.0}
+      - {classification: "refactor", weight: 1.0}
+      - {classification: "cleanup", weight: 1.0}
     boundaries: []
     chain_membership: []
     attributes:
@@ -176,6 +178,8 @@ nodes:
     triggers:
       - {keyword: "статанализ php", weight: 1.0}
       - {keyword: "типы", weight: 1.0}
+      - {classification: "refactor", weight: 1.0}
+      - {classification: "cleanup", weight: 1.0}
     boundaries: []
     chain_membership: ["L14"]
     attributes:
@@ -400,6 +404,11 @@ nodes:
     triggers:
       - {keyword: "sast", weight: 1.0}
       - {keyword: "security static analysis", weight: 1.0}
+      - {keyword: "статический анализ", weight: 1.0}
+      - {keyword: "sast scan", weight: 1.0}
+      - {keyword: "secret pattern", weight: 1.0}
+      - {keyword: "уязвимость в коде", weight: 1.0}
+      - {classification: "analysis", weight: 1.0}
     boundaries:
       - {relation: "связка binary+mcp"}
     chain_membership: ["L15", "L6"]
@@ -545,6 +554,8 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "отладка production runtime errors", weight: 1.0}
+      - {classification: "bugfix", weight: 1.0}
+      - {classification: "monitoring", weight: 1.0}
     boundaries: []
     chain_membership: ["L13", "L8"]
     attributes:
@@ -561,6 +572,7 @@ nodes:
       - {keyword: "отладка redis/memurai очередей", weight: 1.0}
       - {keyword: "кэша", weight: 1.0}
       - {keyword: "pest-race", weight: 1.0}
+      - {classification: "monitoring", weight: 1.0}
     boundaries:
       - {relation: "read-only"}
     chain_membership: ["L13", "L8"]
@@ -578,6 +590,8 @@ nodes:
       - {keyword: "архитектурные решения", weight: 1.0}
       - {keyword: "adr", weight: 1.0}
       - {keyword: "enforcement", weight: 1.0}
+      - {keyword: "architecture decision record", weight: 1.0}
+      - {keyword: "архитектурное решение", weight: 1.0}
     boundaries:
       - {relation: "adr-judge lefthook job 9"}
     chain_membership: ["L4", "L5"]
@@ -595,6 +609,9 @@ nodes:
     triggers:
       - {keyword: "c4", weight: 1.0}
       - {keyword: "architecture-диаграммы", weight: 1.0}
+      - {keyword: "mermaid диаграмма", weight: 1.0}
+      - {keyword: "c4 диаграмма", weight: 1.0}
+      - {keyword: "c4 модель", weight: 1.0}
     boundaries: []
     chain_membership: ["L4"]
     attributes:
@@ -610,6 +627,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "справочник архитектурных паттернов", weight: 1.0}
+      - {keyword: "clean architecture", weight: 1.0}
+      - {keyword: "hexagonal", weight: 1.0}
+      - {keyword: "ddd", weight: 1.0}
+      - {keyword: "domain-driven", weight: 1.0}
     boundaries: []
     chain_membership: ["L5"]
     attributes:
@@ -627,6 +648,10 @@ nodes:
       - {keyword: "deep аудит безопасности", weight: 1.0}
       - {keyword: "diff", weight: 1.0}
       - {keyword: "supply-chain", weight: 1.0}
+      - {keyword: "глубокий security audit", weight: 1.0}
+      - {keyword: "supply chain risk", weight: 1.0}
+      - {keyword: "audit context", weight: 1.0}
+      - {classification: "analysis", weight: 1.0}
     boundaries: []
     chain_membership: ["L15", "L6"]
     attributes:
@@ -642,6 +667,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "inline-блокировка уязвимых паттернов", weight: 1.0}
+      - {keyword: "inline уязвимость", weight: 1.0}
+      - {keyword: "code security warning", weight: 1.0}
+      - {keyword: "уязвимый паттерн", weight: 1.0}
+      - {keyword: "secret pattern detection", weight: 1.0}
     boundaries:
       - {relation: "блокирующий PreToolUse (sys.exit 2)"}
     chain_membership: ["L6"]
@@ -659,6 +688,7 @@ nodes:
     triggers:
       - {keyword: "prd эпик issue код", weight: 1.0}
       - {keyword: "dev-проекты", weight: 1.0}
+      - {classification: "planning", weight: 1.0}
     boundaries: []
     chain_membership: ["L9"]
     attributes:
@@ -677,6 +707,7 @@ nodes:
       - {keyword: "роадмап", weight: 1.0}
       - {keyword: "метрики", weight: 1.0}
       - {keyword: "продуктовые церемонии", weight: 1.0}
+      - {classification: "planning", weight: 1.0}
     boundaries: []
     chain_membership: ["L9"]
     attributes:
@@ -693,6 +724,10 @@ nodes:
     triggers:
       - {keyword: "направление зависимостей", weight: 1.0}
       - {keyword: "границы слоёв", weight: 1.0}
+      - {keyword: "архитектурная зависимость", weight: 1.0}
+      - {keyword: "layer dependency", weight: 1.0}
+      - {keyword: "deptrac.yaml", weight: 1.0}
+      - {classification: "refactor", weight: 1.0}
     boundaries:
       - {relation: "lefthook job 10"}
     chain_membership: ["L14", "L5"]
@@ -757,6 +792,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "introspection openapi/rest-спек", weight: 1.0}
+      - {keyword: "openapi", weight: 1.0}
+      - {keyword: "swagger", weight: 1.0}
+      - {keyword: "спека api", weight: 1.0}
+      - {keyword: "rest api", weight: 1.0}
     boundaries:
       - {relation: "read-only"}
     chain_membership: ["L7"]
@@ -774,6 +813,9 @@ nodes:
     triggers:
       - {keyword: "тестирование llm-промптов", weight: 1.0}
       - {keyword: "eval", weight: 1.0}
+      - {keyword: "eval промпта", weight: 1.0}
+      - {keyword: "llm test", weight: 1.0}
+      - {keyword: "prompt regression", weight: 1.0}
     boundaries:
       - {relation: "только вручную/CI, никогда в хук"}
     chain_membership: ["L10"]
@@ -790,6 +832,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "классический ml-воркфлоу", weight: 1.0}
+      - {keyword: "ml модель", weight: 1.0}
+      - {keyword: "статистика", weight: 1.0}
+      - {keyword: "корреляция", weight: 1.0}
+      - {keyword: "машинное обучение", weight: 1.0}
     boundaries: []
     chain_membership: ["L10"]
     attributes:
@@ -819,6 +865,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "документирование/оптимизация бизнес-процессов", weight: 1.0}
+      - {keyword: "бизнес-процесс документ", weight: 1.0}
+      - {keyword: "runbook", weight: 1.0}
+      - {keyword: "capacity plan", weight: 1.0}
+      - {keyword: "risk assessment", weight: 1.0}
     boundaries: []
     chain_membership: ["L4"]
     attributes:
@@ -835,6 +885,9 @@ nodes:
     triggers:
       - {keyword: "моделирование to-be процесса", weight: 1.0}
       - {keyword: "bpmn 2.0", weight: 1.0}
+      - {keyword: "bpmn", weight: 1.0}
+      - {keyword: "моделирование процесса", weight: 1.0}
+      - {keyword: "swimlane", weight: 1.0}
     boundaries:
       - {relation: "self-authored project skill"}
     chain_membership: ["L3", "L4"]
@@ -851,6 +904,10 @@ nodes:
     triggers:
       - {keyword: "анализ as-is процесса", weight: 1.0}
       - {keyword: "discovery из кода", weight: 1.0}
+      - {keyword: "discovery процесса", weight: 1.0}
+      - {keyword: "узкое место", weight: 1.0}
+      - {keyword: "bottleneck", weight: 1.0}
+      - {classification: "analysis", weight: 1.0}
     boundaries:
       - {relation: "self-authored project skill; ADR-009 граница с #55"}
     chain_membership: ["L3"]
@@ -882,6 +939,8 @@ nodes:
       - {keyword: "интервью-discovery", weight: 1.0}
       - {keyword: "jtbd", weight: 1.0}
       - {keyword: "feature system режим", weight: 1.0}
+      - {keyword: "discovery", weight: 1.0}
+      - {keyword: "интервью заказчика", weight: 1.0}
     boundaries:
       - {adr: "ADR-009", role: "граница с #53 process-analysis: discovery-interview = интервью человека; process-analysis = discovery из кода"}
     chain_membership: ["L1", "L2"]
@@ -898,6 +957,9 @@ nodes:
     triggers:
       - {keyword: "создание standalone-скилов", weight: 1.0}
       - {keyword: "eval", weight: 1.0}
+      - {keyword: "создать скил", weight: 1.0}
+      - {keyword: "новый skill", weight: 1.0}
+      - {keyword: "skill.md", weight: 1.0}
     boundaries: []
     chain_membership: ["L11"]
     attributes:
@@ -912,6 +974,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "разработка claude-плагинов", weight: 1.0}
+      - {keyword: "плагин claude code", weight: 1.0}
+      - {keyword: "plugin.json", weight: 1.0}
+      - {keyword: "новый плагин", weight: 1.0}
+      - {keyword: "marketplace плагин", weight: 1.0}
     boundaries: []
     chain_membership: ["L11"]
     attributes:
@@ -926,6 +992,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "генерация хуков (только по явному /hookify)", weight: 1.0}
+      - {keyword: "хук claude", weight: 1.0}
+      - {keyword: "новый hook", weight: 1.0}
+      - {keyword: "pretooluse хук", weight: 1.0}
+      - {keyword: "генерация хука", weight: 1.0}
     boundaries:
       - {adr: "ADR-010", role: "HK1 pre-check коллизии с существующими хуками перед генерацией"}
     chain_membership: ["L11"]
@@ -955,6 +1025,10 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "актуальная документация библиотек/sdk", weight: 1.0}
+      - {keyword: "актуальная документация библиотеки", weight: 1.0}
+      - {keyword: "лайвдоки", weight: 1.0}
+      - {keyword: "документация пакета", weight: 1.0}
+      - {keyword: "документация sdk", weight: 1.0}
     boundaries:
       - {relation: "первый выбор для документации известной библиотеки; WebFetch — fallback на конкретный URL; WebSearch — без знания библиотеки"}
     chain_membership: []
@@ -974,6 +1048,11 @@ nodes:
       - {keyword: "us-gaap-отчётность", weight: 1.0}
       - {keyword: "проводки", weight: 1.0}
       - {keyword: "close", weight: 1.0}
+      - {keyword: "reconciliation", weight: 1.0}
+      - {keyword: "variance", weight: 1.0}
+      - {keyword: "journal entry", weight: 1.0}
+      - {keyword: "financial statements", weight: 1.0}
+      - {keyword: "audit support", weight: 1.0}
     boundaries:
       - {adr: "ADR-012", role: "граница C6/C7; US-GAAP-скилы частично применимы; SOX not-applicable РФ; warehouse-MCP DEFERRED"}
     chain_membership: []
@@ -994,6 +1073,16 @@ nodes:
       - {keyword: "идемпотентность", weight: 1.0}
       - {keyword: "тариф-резолюция", weight: 1.0}
       - {keyword: "дрейф reconcile", weight: 1.0}
+      - {keyword: "списание", weight: 1.0}
+      - {keyword: "биллинг", weight: 1.0}
+      - {keyword: "тариф", weight: 1.0}
+      - {keyword: "баланс", weight: 1.0}
+      - {keyword: "начисление лида", weight: 1.0}
+      - {keyword: "lead_charges", weight: 1.0}
+      - {keyword: "копейки", weight: 1.0}
+      - {keyword: "csv reconcile", weight: 1.0}
+      - {keyword: "bcmath", weight: 1.0}
+      - {keyword: "bcadd", weight: 1.0}
     boundaries:
       - {adr: "ADR-012", role: "граница с process-*/D3/ru-tax; аудит кода биллинга, не налогов и не процесса"}
     chain_membership: ["L13"]
@@ -1013,6 +1102,13 @@ nodes:
       - {keyword: "налоговая база", weight: 1.0}
       - {keyword: "налогооблагаемое событие", weight: 1.0}
       - {keyword: "выгрузка бухгалтеру", weight: 1.0}
+      - {keyword: "ндс", weight: 1.0}
+      - {keyword: "усн", weight: 1.0}
+      - {keyword: "налог на прибыль", weight: 1.0}
+      - {keyword: "выручка", weight: 1.0}
+      - {keyword: "проводка", weight: 1.0}
+      - {keyword: "дт/кт", weight: 1.0}
+      - {keyword: "бухгалтер", weight: 1.0}
     boundaries:
       - {adr: "ADR-012", role: "закрывает РФ-gap US-GAAP-плагина #61; ≠ billing-audit #62 (корректность кода), ≠ D1/D2"}
     chain_membership: ["L13"]
@@ -1030,6 +1126,11 @@ nodes:
       - {keyword: "авто-рефакторинг", weight: 1.0}
       - {keyword: "version-upgrade laravel", weight: 1.0}
       - {keyword: "удаление мёртвого кода", weight: 1.0}
+      - {keyword: "автоматический рефакторинг", weight: 1.0}
+      - {keyword: "версия php", weight: 1.0}
+      - {keyword: "deprecated php", weight: 1.0}
+      - {keyword: "code modernization", weight: 1.0}
+      - {classification: "refactor", weight: 1.0}
     boundaries:
       - {adr: "ADR-013", role: "BT1 vs Pint (трансформация vs форматирование); BT2 vs Larastan (комплементарны); BT3 vs deptrac"}
     chain_membership: ["L14"]
@@ -1046,6 +1147,11 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "метрики качества/сложности/архитектуры php-кода", weight: 1.0}
+      - {keyword: "метрики качества кода", weight: 1.0}
+      - {keyword: "complexity", weight: 1.0}
+      - {keyword: "architecture metrics", weight: 1.0}
+      - {keyword: "качество кода php", weight: 1.0}
+      - {classification: "refactor", weight: 1.0}
     boundaries:
       - {adr: "ADR-013", role: "BT4 vs Pint/Larastan; уникум — оси complexity + architecture"}
     chain_membership: ["L14"]
@@ -1065,6 +1171,13 @@ nodes:
       - {keyword: "паттерн controller/service/job", weight: 1.0}
       - {keyword: "rls", weight: 1.0}
       - {keyword: "деньги", weight: 1.0}
+      - {keyword: "controller", weight: 1.0}
+      - {keyword: "service", weight: 1.0}
+      - {keyword: "job", weight: 1.0}
+      - {keyword: "eloquent", weight: 1.0}
+      - {keyword: "partition", weight: 1.0}
+      - {keyword: "lockforupdate", weight: 1.0}
+      - {keyword: "dispatch", weight: 1.0}
     boundaries:
       - {adr: "ADR-013", role: "BT5 ≠ architecture-patterns #38 (generic vs проектные конвенции); BT6 ≠ billing-audit #62"}
     chain_membership: []
@@ -1098,6 +1211,10 @@ nodes:
       - {keyword: "обход входа", weight: 1.0}
       - {keyword: "инъекции", weight: 1.0}
       - {keyword: "xss", weight: 1.0}
+      - {keyword: "dast", weight: 1.0}
+      - {keyword: "scan running portal", weight: 1.0}
+      - {keyword: "проникновение в работающий портал", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS1 ≠ Semgrep #25 (динамика vs статика); IS2 ≠ Nuclei #69 (глубина vs широта)"}
     chain_membership: ["L15"]
@@ -1113,6 +1230,11 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "известные уязвимости/экспозиция/слабый tls снаружи", weight: 1.0}
+      - {keyword: "nuclei", weight: 1.0}
+      - {keyword: "уязвимость по шаблону", weight: 1.0}
+      - {keyword: "cve scan", weight: 1.0}
+      - {keyword: "nuclei сканер", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS2 ≠ ZAP #68 (широта vs глубина — комплементарны)"}
     chain_membership: ["L15"]
@@ -1129,6 +1251,10 @@ nodes:
     triggers:
       - {keyword: "безопасность настроек laravel", weight: 1.0}
       - {keyword: ".env/config/заголовки/cookie/secrets/deps", weight: 1.0}
+      - {keyword: "laravel security config", weight: 1.0}
+      - {keyword: "env audit", weight: 1.0}
+      - {keyword: "secrets config", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS3 ≠ Larastan #12/Semgrep #25; заменил Enlightn (abandoned/L13)"}
     chain_membership: ["L15"]
@@ -1144,6 +1270,14 @@ nodes:
     dormancy_reason: null
     triggers:
       - {keyword: "аудит пдн / соответствие 152-фз", weight: 1.0}
+      - {keyword: "пдн", weight: 1.0}
+      - {keyword: "персональные данные", weight: 1.0}
+      - {keyword: "152-фз", weight: 1.0}
+      - {keyword: "согласие на обработку", weight: 1.0}
+      - {keyword: "телефон лида", weight: 1.0}
+      - {keyword: "маскирование", weight: 1.0}
+      - {keyword: "pd_subject_request", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS4 ≠ pg_anonymizer #29 (аудит vs инструмент маскирования); IS5 ≠ D2 (техника vs юридическое оформление)"}
     chain_membership: ["L15"]
@@ -1161,6 +1295,11 @@ nodes:
       - {keyword: "stride угрозы портала", weight: 1.0}
       - {keyword: "going-public", weight: 1.0}
       - {keyword: "что защищать первым", weight: 1.0}
+      - {keyword: "stride", weight: 1.0}
+      - {keyword: "моделирование угроз", weight: 1.0}
+      - {keyword: "attack surface", weight: 1.0}
+      - {keyword: "точки входа", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS6 ≠ Trail of Bits #39 (портал+STRIDE+going-public vs generic deep code-audit)"}
     chain_membership: ["L15"]
@@ -1177,6 +1316,11 @@ nodes:
     triggers:
       - {keyword: "прогон безопасности перед релизом", weight: 1.0}
       - {keyword: "go/no-go", weight: 1.0}
+      - {keyword: "go-live", weight: 1.0}
+      - {keyword: "выход в интернет", weight: 1.0}
+      - {keyword: "публикация в прод", weight: 1.0}
+      - {keyword: "security release gate", weight: 1.0}
+      - {classification: "security", weight: 1.0}
     boundaries:
       - {adr: "ADR-014", role: "IS7 ≠ audit-portal (только безопасность + go-live-вердикт vs полный 14-фазный аудит)"}
     chain_membership: ["L15"]
@@ -1197,6 +1341,12 @@ nodes:
       - {keyword: "email-цепочка", weight: 1.0}
       - {keyword: "конкурент-бриф", weight: 1.0}
       - {keyword: "performance-report", weight: 1.0}
+      - {keyword: "email-рассылка", weight: 1.0}
+      - {keyword: "лендинг", weight: 1.0}
+      - {keyword: "реклама", weight: 1.0}
+      - {keyword: "лидген", weight: 1.0}
+      - {keyword: "вебинар", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT1 vs C2/C3; MKT2 vs product-management #42; MKT3 vs marketingskills #75 (решатель, не материал)"}
     chain_membership: ["L16"]
@@ -1220,6 +1370,12 @@ nodes:
       - {keyword: "lead-magnets", weight: 1.0}
       - {keyword: "pricing", weight: 1.0}
       - {keyword: "marketing-psychology", weight: 1.0}
+      - {keyword: "маркетинговая фреймворк", weight: 1.0}
+      - {keyword: "aida", weight: 1.0}
+      - {keyword: "pas", weight: 1.0}
+      - {keyword: "fab", weight: 1.0}
+      - {keyword: "usp", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT3 — материал/резерв-библиотека, не решатель; решатель = marketing #74"}
     chain_membership: []
@@ -1238,6 +1394,10 @@ nodes:
       - {keyword: "голос бренда", weight: 1.0}
       - {keyword: "brand guidelines для текстов", weight: 1.0}
       - {keyword: "тон копирайта", weight: 1.0}
+      - {keyword: "voice", weight: 1.0}
+      - {keyword: "тональность", weight: 1.0}
+      - {keyword: "позиционирование", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT6 — вербальный бренд vs Brandbook v2 визуальный бренд; взаимодополняют"}
     chain_membership: []
@@ -1258,6 +1418,12 @@ nodes:
       - {keyword: "telegram как каналы", weight: 1.0}
       - {keyword: "конверсия лендинга лидерры", weight: 1.0}
       - {keyword: "маркетинг 152-фз согласия на рассылки", weight: 1.0}
+      - {keyword: "рф-канал", weight: 1.0}
+      - {keyword: "вконтакте", weight: 1.0}
+      - {keyword: "telegram-канал", weight: 1.0}
+      - {keyword: "unisender", weight: 1.0}
+      - {keyword: "российский рынок", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT9 — 152-ФЗ cross-ref #71; закрывает РФ-специфику маркетинга"}
     chain_membership: ["L16"]
@@ -1278,6 +1444,9 @@ nodes:
       - {keyword: "гео", weight: 1.0}
       - {keyword: "демография", weight: 1.0}
       - {keyword: "поведение", weight: 1.0}
+      - {keyword: "яндекс.метрика", weight: 1.0}
+      - {keyword: "статистика посещений", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT8 READ-ONLY; активация при живом лендинге (Б-1)"}
     chain_membership: ["L16"]
@@ -1294,6 +1463,10 @@ nodes:
     triggers:
       - {keyword: "подбор ключевых слов wordstat", weight: 1.0}
       - {keyword: "частотность запросов рф", weight: 1.0}
+      - {keyword: "ключевые слова", weight: 1.0}
+      - {keyword: "wordstat", weight: 1.0}
+      - {keyword: "поисковые запросы", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT8 — Direct-мутации НЕ активированы; только Wordstat-модуль (5 read-only tools)"}
     chain_membership: ["L16"]
@@ -1311,6 +1484,9 @@ nodes:
       - {keyword: "постинг в telegram-канал", weight: 1.0}
       - {keyword: "управление", weight: 1.0}
       - {keyword: "получение аналитики канала", weight: 1.0}
+      - {keyword: "telegram", weight: 1.0}
+      - {keyword: "telegram-бот", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT8 — SESSION_STRING только .env; выделенный аккаунт"}
     chain_membership: ["L16"]
@@ -1327,6 +1503,10 @@ nodes:
     triggers:
       - {keyword: "планирование и публикация в 30+ соцсетей включая vk и telegram", weight: 1.0}
       - {keyword: "контент-календарь", weight: 1.0}
+      - {keyword: "smm-планировщик", weight: 1.0}
+      - {keyword: "постинг в соцсети", weight: 1.0}
+      - {keyword: "postiz", weight: 1.0}
+      - {classification: "marketing", weight: 1.0}
     boundaries:
       - {adr: "ADR-015", role: "MKT7 AGPL self-host без дистрибуции; покрывает VK-постинг"}
     chain_membership: ["L16"]
@@ -1366,6 +1546,48 @@ nodes:
     attributes:
       tooling_section: "§4.58 #83"
 
+  - id: "#84"
+    name: "normative-sync"
+    slug: "normative-sync"
+    category: "off-phase"
+    subcategory: "project-agent"
+    status: "active"
+    dormancy_reason: null
+    triggers:
+      - {classification: "normative_sync_needed", weight: 1.0}
+      - {keyword: "синкни нормативку", weight: 1.0}
+      - {keyword: "нормативный синк", weight: 1.0}
+      - {keyword: "закрыли задачу синк", weight: 0.9}
+    boundaries:
+      - {relation: "Контроллер обязан звать после закрытия крупной off-phase интеграции, brain governance артефакта, принятого ADR — Pravila §2.4"}
+      - {pair: "#85", relation: "Парный project-агент — оба не входят в Tooling-канон счётчиков (#1-#83), это .claude/agents/ файлы"}
+    chain_membership: []
+    attributes:
+      agent_file: ".claude/agents/normative-sync.md"
+      spec: "docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §3"
+      tooling_section: null
+
+  - id: "#85"
+    name: "prod-deploy-validator"
+    slug: "prod-deploy-validator"
+    category: "off-phase"
+    subcategory: "project-agent"
+    status: "active"
+    dormancy_reason: null
+    triggers:
+      - {classification: "prod_deploy_imminent", weight: 1.0}
+      - {keyword: "готовность боевого", weight: 1.0}
+      - {keyword: "проверь прод", weight: 1.0}
+      - {keyword: "ready to deploy", weight: 1.0}
+    boundaries:
+      - {relation: "Контроллер обязан звать перед любым выкатом на liderra.ru — Pravila §2.4. READ-ONLY по дизайну."}
+      - {pair: "#84", relation: "Парный project-агент"}
+    chain_membership: []
+    attributes:
+      agent_file: ".claude/agents/prod-deploy-validator.md"
+      spec: "docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §4"
+      tooling_section: null
+
 chains:
   L1:
     name: "feature discovery & implementation chain"

docs/routing-off-phase.md

@@ -26,11 +26,40 @@
 
 | Классификация | Рекомендуемый узел | Вес |
 |---|---|---|
+| `analysis` | #25 Semgrep + Semgrep MCP | 1 |
+| `analysis` | #39 Trail of Bits Skills | 1 |
+| `analysis` | #53 process-analysis | 1 |
 | `bugfix` | #18 Pest 4 | 1 |
+| `bugfix` | #34 Sentry MCP | 1 |
 | `bugfix` | #19 Superpowers v5.1.0 | 0.8 |
+| `cleanup` | #11 Laravel Pint | 1 |
+| `cleanup` | #12 Larastan | 1 |
 | `feature` | #19 Superpowers v5.1.0 | 1 |
+| `marketing` | #74 marketing | 1 |
+| `marketing` | #75 marketingskills | 1 |
+| `marketing` | #76 brand-voice | 1 |
+| `marketing` | #77 marketing-ru | 1 |
+| `marketing` | #78 Яндекс.Метрика MCP | 1 |
+| `marketing` | #79 Яндекс.Директ+Wordstat MCP | 1 |
+| `marketing` | #80 Telegram MCP | 1 |
+| `marketing` | #81 Postiz | 1 |
+| `monitoring` | #34 Sentry MCP | 1 |
+| `monitoring` | #35 Redis MCP | 1 |
 | `planning` | #19 Superpowers v5.1.0 | 1 |
+| `planning` | #41 CCPM | 1 |
+| `planning` | #42 product-management | 1 |
+| `refactor` | #11 Laravel Pint | 1 |
+| `refactor` | #12 Larastan | 1 |
+| `refactor` | #43 deptrac | 1 |
+| `refactor` | #64 Rector | 1 |
+| `refactor` | #65 PHP Insights | 1 |
 | `refactor` | #19 Superpowers v5.1.0 | 0.8 |
+| `security` | #68 OWASP ZAP | 1 |
+| `security` | #69 Nuclei | 1 |
+| `security` | #70 Ward | 1 |
+| `security` | #71 pdn-152fz-audit | 1 |
+| `security` | #72 threat-model | 1 |
+| `security` | #73 security-go-live | 1 |
 
 <!-- auto:routing-table:end -->
 

docs/superpowers/plans/2026-05-23-billing-v2-spec-b-duplicates-plan.md

@@ -0,0 +1,757 @@
+# Биллинг v2 Спек B — политика дублей: план реализации
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Убрать наш телефонный антифрод-фильтр дублей (доверяем дедупу поставщика), но гарантировать на уровне БД, что одна поставка одному клиенту тарифицируется ровно один раз; лимит шеринга — 3 разных клиента.
+
+**Architecture:** Удаляем `DuplicateDetector` из обоих job-путей. В шеринг-пути (`RouteSupplierLeadJob`) раздача переводится с лимита-по-проектам на лимит-по-клиентам (один проект на клиента — DISTINCT ON по `tenant_id`, выбор проекта с макс. остатком дневного лимита; cap=3 клиента). Новая таблица-замок `supplier_lead_deliveries` (PK `supplier_lead_id`+`tenant_id`) + `insertOrIgnore` внутри транзакции создания сделки гарантирует «одна поставка → один оплаченный лид на клиента» даже при гонках/перезапусках/CSV-восстановлении.
+
+**Tech Stack:** Laravel 13, PostgreSQL 16 (партиционированная `deals`, RLS по `app.current_tenant_id`, 5 ролей), Pest 4 (`--parallel`), bcmath/`LedgerService`. Worktree `.claude/worktrees/billing-v2-spec-b/`, ветка `feat/billing-v2-spec-b` (база origin/main `ff2ee59e`, Спек A уже влит).
+
+**Спека:** `docs/superpowers/specs/2026-05-23-billing-v2-spec-b-duplicates-design.md`
+
+---
+
+## ⚠️ Важный контекст базы (прочитать до старта)
+
+1. **Спек A влит в origin/main.** `App\Services\Billing\LedgerService::chargeForDelivery` — always-rub: списывает `balance_rub` (bcmath), пишет `LeadCharge(charge_source='rub')` + `BalanceTransaction` + `supplier_lead_costs`; `balance_leads` НЕ трогает. Возвращает `ChargeResult`.
+2. **Тест-долг Спека A.** Часть существующих тестов (`app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php` ассертит `balance_leads → 99`; `RouteSupplierLeadJobBillingTest.php` имеет кейс `charge_source='prepaid'`) противоречит always-rub `LedgerService` и, вероятно, **уже красная на этой базе**. Это НЕ наша регрессия. Task 1 устанавливает фактический baseline. Новые тесты Спека B заякорены на **model-agnostic** ассерты (число `Deal` / `LeadCharge` на клиента + строки таблицы-замка) и сетап через хелпер `prepareSharingFlow` с достаточным `balance_rub`, чтобы не зависеть от prepaid/rub.
+3. **Два job-пути.** `ProcessWebhookJob` (прямой вебхук, `WebhookReceiveController`) — идемпотентность по `vid` через `webhook_dedup_keys (tenant_id, source_crm_id)`; замок там НЕ нужен. `RouteSupplierLeadJob` (шеринг, `SupplierWebhookController` + `CsvReconcileJob`) — замок нужен здесь.
+4. **Гранты — blanket.** `db/02_grants.sql` выдаёт `GRANT ... ON ALL TABLES` + `ALTER DEFAULT PRIVILEGES`. Новая tenant-таблица грантов отдельно не требует. На dev — `postgres` superuser.
+5. **`duplicate_detected` в origin/main отсутствует** (ни в `db/schema.sql`, ни во фронте, ни в backend) — чистить нечего, только verify-grep. Колонка `deals.duplicate_of_id` (schema.sql:1626) + индекс (schema.sql:1688) — есть.
+
+---
+
+## File Structure
+
+| Файл | Действие | Ответственность |
+|---|---|---|
+| `db/migrations/2026_05_23_200_supplier_lead_deliveries.sql` | Create | DDL таблицы-замка (RLS + PK + FK) |
+| `app/database/migrations/2026_05_23_200000_create_supplier_lead_deliveries.php` | Create | парная Laravel-миграция (idempotency guard) |
+| `db/migrations/2026_05_23_201_drop_deals_duplicate_of_id_index.sql` | Create | DROP лишнего индекса |
+| `app/database/migrations/2026_05_23_201000_drop_deals_duplicate_of_id_index.php` | Create | парная Laravel-миграция |
+| `db/schema.sql` | Modify | +CREATE TABLE supplier_lead_deliveries; −CREATE INDEX deals(duplicate_of_id); header v8.32→v8.33 |
+| `db/CHANGELOG_schema.md` | Modify | +запись v8.33 |
+| `app/app/Models/SupplierLeadDelivery.php` | Create | Eloquent-модель замка |
+| `app/app/Services/DuplicateDetector.php` | Delete | сервис телефонного фильтра |
+| `app/app/Jobs/ProcessWebhookJob.php` | Modify | убрать findMaster + markAsDuplicate, всегда charge |
+| `app/app/Jobs/RouteSupplierLeadJob.php` | Modify | убрать DuplicateDetector из сигнатур; +замок insertOrIgnore; раздача по клиентам |
+| `app/app/Services/LeadRouter.php` | Modify | DISTINCT ON (tenant_id) — один проект на клиента (макс. остаток лимита) |
+| `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php` | Create | тесты замка + раздачи по клиентам |
+| `app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php` | Modify | убрать DuplicateDetector из `runRouteJob`; удалить/переписать дубль-тесты |
+| `app/tests/Feature/ProcessWebhookJobTest.php` | Modify | убрать дубль-тесты; +тест «два vid, один телефон → оба charge» |
+| прочие тесты с `DuplicateDetector`/`runRouteJob` | Modify | привести сигнатуры к 6-арговому handle() |
+
+---
+
+## Task 1: Baseline — зафиксировать фактическое состояние
+
+**Files:** нет правок (только прогон).
+
+- [ ] **Step 1: Подготовить тестовую БД worktree**
+
+Run:
+```bash
+cd .claude/worktrees/billing-v2-spec-b/app
+php artisan migrate:fresh --env=testing
+php artisan partitions:create-months --env=testing
+```
+Expected: миграции проходят; партиции `deals_*`, `balance_transactions_*`, `supplier_lead_costs_*` за текущий/смежные месяцы созданы. (Квирк Спека A: при нехватке партиций тесты падают с partition-ошибкой — пересоздать.)
+
+- [ ] **Step 2: Прогнать затронутые сюиты, записать baseline**
+
+Run:
+```bash
+php artisan test tests/Feature/Jobs/RouteSupplierLeadJobTest.php tests/Feature/Supplier/RouteSupplierLeadJobBillingTest.php tests/Feature/ProcessWebhookJobTest.php tests/Feature/Integration/SupplierLeadFlowTest.php tests/Feature/Supplier/AutoPauseFlowTest.php tests/Feature/Supplier/CsvReconcileJobTest.php tests/Feature/Pd/DealCreatePdLogTest.php
+```
+Expected: записать в заметку, какие тесты GREEN, какие RED. Ожидаемо красные (тест-долг Спека A, НЕ наша задача): `RouteSupplierLeadJobTest` (balance_leads ассерты), prepaid-кейс в `RouteSupplierLeadJobBillingTest`. Всё остальное должно быть GREEN.
+
+- [ ] **Step 3: Подтвердить модель списания**
+
+Run:
+```bash
+grep -n "charge_source\|balance_rub\|balance_leads" app/Services/Billing/LedgerService.php
+```
+Expected: `charge_source` = `'rub'` хардкод, списывается `balance_rub`. Зафиксировать: новые тесты используют `balance_rub` и `LeadCharge::count()`.
+
+- [ ] **Step 4: Коммит заметки baseline (опционально)**
+
+Если ведёте журнал — зафиксируйте baseline-вывод в описании задачи. Кода-коммита нет.
+
+---
+
+## Task 2: Таблица-замок `supplier_lead_deliveries`
+
+**Files:**
+- Create: `db/migrations/2026_05_23_200_supplier_lead_deliveries.sql`
+- Create: `app/database/migrations/2026_05_23_200000_create_supplier_lead_deliveries.php`
+- Modify: `db/schema.sql` (вставить CREATE TABLE; header v8.32→v8.33)
+- Modify: `db/CHANGELOG_schema.md`
+- Create: `app/app/Models/SupplierLeadDelivery.php`
+- Test: `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php` (schema-часть)
+
+- [ ] **Step 1: Написать падающий schema-тест**
+
+Создать `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`:
+```php
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+
+uses(DatabaseTransactions::class);
+
+it('supplier_lead_deliveries table exists with PK (supplier_lead_id, tenant_id) and RLS', function (): void {
+    $cols = collect(DB::select(
+        "SELECT column_name FROM information_schema.columns WHERE table_name = 'supplier_lead_deliveries'"
+    ))->pluck('column_name')->all();
+
+    expect($cols)->toContain('supplier_lead_id')
+        ->toContain('tenant_id')
+        ->toContain('deal_id')
+        ->toContain('created_at');
+
+    $pk = collect(DB::select(
+        "SELECT a.attname FROM pg_index i
+         JOIN pg_attribute a ON a.attrelid = i.indrelid AND a.attnum = ANY(i.indkey)
+         WHERE i.indrelid = 'supplier_lead_deliveries'::regclass AND i.indisprimary"
+    ))->pluck('attname')->sort()->values()->all();
+    expect($pk)->toBe(['supplier_lead_id', 'tenant_id']);
+
+    $rls = DB::selectOne(
+        "SELECT relrowsecurity FROM pg_class WHERE relname = 'supplier_lead_deliveries'"
+    );
+    expect($rls->relrowsecurity)->toBeTrue();
+});
+```
+
+- [ ] **Step 2: Запустить — убедиться, что падает**
+
+Run: `php artisan test tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`
+Expected: FAIL (таблицы нет).
+
+- [ ] **Step 3: Написать DDL-файл миграции**
+
+Создать `db/migrations/2026_05_23_200_supplier_lead_deliveries.sql`:
+```sql
+-- =============================================================================
+-- supplier_lead_deliveries — замок «одна поставка одному клиенту = один раз»
+-- (Billing v2 Spec B). Ключ по поставке (supplier_lead_id), НЕ по телефону —
+-- разные поставки с одним телефоном остаются отдельными платными лидами.
+-- Защищает шеринг-путь (RouteSupplierLeadJob) от наших собственных дублей
+-- при гонках / перезапусках задачи / CSV-восстановлении.
+-- =============================================================================
+CREATE TABLE supplier_lead_deliveries (
+    supplier_lead_id BIGINT NOT NULL REFERENCES supplier_leads(id) ON DELETE CASCADE,
+    tenant_id        BIGINT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
+    deal_id          BIGINT,            -- созданная сделка; без FK (deals партиционирована)
+    created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    PRIMARY KEY (supplier_lead_id, tenant_id)
+);
+
+ALTER TABLE supplier_lead_deliveries ENABLE ROW LEVEL SECURITY;
+CREATE POLICY tenant_isolation ON supplier_lead_deliveries
+    USING (tenant_id = current_setting('app.current_tenant_id')::bigint);
+```
+
+- [ ] **Step 4: Написать парную Laravel-миграцию**
+
+Создать `app/database/migrations/2026_05_23_200000_create_supplier_lead_deliveries.php`:
+```php
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // Idempotency: если schema.sql уже загружен (migrate:fresh), таблица есть — пропускаем.
+        if (DB::selectOne('SELECT 1 AS ok FROM pg_class WHERE relname = ?', ['supplier_lead_deliveries']) !== null) {
+            return;
+        }
+
+        $sql = file_get_contents(base_path('../db/migrations/2026_05_23_200_supplier_lead_deliveries.sql'));
+        if ($sql === false) {
+            throw new RuntimeException('Migration SQL file not found.');
+        }
+        DB::unprepared($sql);
+    }
+
+    public function down(): void
+    {
+        DB::unprepared('DROP TABLE IF EXISTS supplier_lead_deliveries CASCADE;');
+    }
+};
+```
+
+- [ ] **Step 5: Вставить CREATE TABLE в `db/schema.sql`**
+
+Вставить блок из Step 3 (без комментария-шапки повторно — достаточно одного) в `db/schema.sql` сразу ПОСЛЕ блока `CREATE TABLE webhook_dedup_keys (...)` с его индексами/RLS (найти `grep -n "CREATE TABLE webhook_dedup_keys" db/schema.sql`). Обновить header-строку версии:
+```
+-- Версия: v8.33 (23.05.2026 — Billing v2 Spec B: +supplier_lead_deliveries замок поставка↔клиент; −индекс deals(duplicate_of_id))
+```
+
+- [ ] **Step 6: Запись в `db/CHANGELOG_schema.md`**
+
+Добавить сверху списка изменений:
+```markdown
+## v8.33 (2026-05-23) — Billing v2 Spec B: политика дублей
+
+- **+таблица `supplier_lead_deliveries`** (PK `supplier_lead_id`+`tenant_id`, FK на `supplier_leads` ON DELETE CASCADE, `deal_id` без FK, RLS `tenant_isolation`). Замок «одна поставка одному клиенту = один оплаченный лид» для шеринг-пути.
+- **−индекс `deals (duplicate_of_id) WHERE duplicate_of_id IS NOT NULL`** — концепция телефонного дедупа удалена (DuplicateDetector); колонка `deals.duplicate_of_id` оставлена спящей.
+- Метрики: +1 таблица, −1 индекс. (Сверять с header schema.sql.)
+```
+
+- [ ] **Step 7: Создать Eloquent-модель**
+
+Создать `app/app/Models/SupplierLeadDelivery.php`:
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * Замок «поставка ↔ клиент» (Billing v2 Spec B). Композитный PK без автоинкремента.
+ * Пишется в шеринг-пути (RouteSupplierLeadJob) через insertOrIgnore под RLS-контекстом.
+ */
+class SupplierLeadDelivery extends Model
+{
+    public $incrementing = false;
+
+    public $timestamps = false;
+
+    protected $primaryKey = null;
+
+    protected $fillable = ['supplier_lead_id', 'tenant_id', 'deal_id', 'created_at'];
+}
+```
+
+- [ ] **Step 8: Пересоздать тестовую БД и прогнать schema-тест**
+
+Run:
+```bash
+php artisan migrate:fresh --env=testing && php artisan partitions:create-months --env=testing
+php artisan test tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php
+```
+Expected: PASS.
+
+- [ ] **Step 9: Коммит**
+
+```bash
+git add db/migrations/2026_05_23_200_supplier_lead_deliveries.sql \
+        app/database/migrations/2026_05_23_200000_create_supplier_lead_deliveries.php \
+        db/schema.sql db/CHANGELOG_schema.md \
+        app/app/Models/SupplierLeadDelivery.php \
+        app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php
+git commit -m "feat(billing-v2): supplier_lead_deliveries lock table (Spec B)"
+```
+
+---
+
+## Task 3: Раздача по клиентам (LeadRouter — один проект на клиента)
+
+**Files:**
+- Modify: `app/app/Services/LeadRouter.php`
+- Test: `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php` (добавить кейс)
+
+- [ ] **Step 1: Написать падающий тест «один клиент, 2 проекта → 1 сделка»**
+
+Добавить в `SupplierLeadDeliveryGuardTest.php` (хелперы `prepareSharingFlow` / `linkProjectToSupplier` — из `tests/Pest.php`; сверить сигнатуру по `RouteSupplierLeadJobBillingTest.php`):
+```php
+use App\Jobs\RouteSupplierLeadJob;
+use App\Models\Deal;
+use App\Models\LeadCharge;
+use App\Models\Project;
+use App\Models\SupplierLead;
+use App\Models\SupplierProject;
+use App\Models\Tenant;
+use Database\Seeders\PricingTierSeeder;
+
+it('one delivery to a tenant with 2 eligible projects → exactly 1 deal + 1 charge', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'twoproj.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_leads' => 0, 'balance_rub' => '100000.00']);
+
+    // Два подходящих проекта одного клиента, разный остаток лимита.
+    $pLow = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'daily_limit_target' => 10, 'delivered_today' => 9, 'delivery_days_mask' => 127,
+    ]);
+    $pHigh = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'daily_limit_target' => 10, 'delivered_today' => 0, 'delivery_days_mask' => 127,
+    ]);
+    linkProjectToSupplier($pLow, $sp);
+    linkProjectToSupplier($pHigh, $sp);
+
+    $vid = 600001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_twoproj.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJob($lead->id);
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('source_crm_id', $vid)->count())->toBe(1);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
+    // Выбран проект с наибольшим остатком лимита.
+    expect($pHigh->fresh()->delivered_today)->toBe(1);
+    expect($pLow->fresh()->delivered_today)->toBe(9);
+});
+```
+NB: `runRouteJob` уже определён в `RouteSupplierLeadJobTest.php`, но это другой файл. Определить локальный хелпер в этом файле (после Task 4 он будет 6-арговым — см. ниже), либо вызвать job напрямую. Чтобы не зависеть от Task 4, в этом тесте вызвать job через `app()`-резолв 6 аргументов ПОСЛЕ Task 4. Поэтому: написать тело теста, но запускать его в Step 3 уже после правки LeadRouter, а полную зелёность по job — в Task 6.
+
+- [ ] **Step 2: Переписать `LeadRouter::matchEligibleProjects` на DISTINCT ON (tenant_id)**
+
+Заменить тело `matchEligibleProjects` в `app/app/Services/LeadRouter.php` — добавить `DISTINCT ON (projects.tenant_id)` с выбором проекта максимального остатка лимита:
+```php
+        /** @var Collection<int, Project> $candidates */
+        $candidates = Project::on('pgsql_supplier')
+            ->select('projects.*')
+            ->selectRaw('DISTINCT ON (projects.tenant_id) projects.id AS __distinct_marker')
+            ->whereExists(function ($q) use ($supplierProject): void {
+                $q->selectRaw('1')
+                    ->from('project_supplier_links')
+                    ->whereColumn('project_supplier_links.project_id', 'projects.id')
+                    ->where('project_supplier_links.supplier_project_id', $supplierProject->id);
+            })
+            ->where('is_active', true)
+            ->whereRaw('(delivery_days_mask & ?) <> 0', [$todayBit])
+            ->whereRaw('delivered_today < COALESCE(effective_daily_limit_today, daily_limit_target)')
+            ->whereExists(function ($q): void {
+                $q->selectRaw('1')
+                    ->from('tenants')
+                    ->whereColumn('tenants.id', 'projects.tenant_id')
+                    ->where(function ($qq): void {
+                        $qq->where('tenants.balance_leads', '>', 0)
+                            ->orWhere('tenants.balance_rub', '>', 0);
+                    });
+            })
+            ->orderBy('projects.tenant_id')
+            ->orderByRaw('COALESCE(projects.effective_daily_limit_today, projects.daily_limit_target) - projects.delivered_today DESC')
+            ->orderBy('projects.created_at')
+            ->orderBy('projects.id')
+            ->get();
+
+        return $candidates->values();
+```
+NB: смешение `DISTINCT ON` + Eloquent `select('projects.*')` хрупко. **Предпочтительный вариант** — сырой select без маркера:
+```php
+        $candidates = Project::on('pgsql_supplier')
+            ->fromRaw('projects')
+            ->whereExists(/* project_supplier_links ... */)
+            ->where('is_active', true)
+            ->whereRaw('(delivery_days_mask & ?) <> 0', [$todayBit])
+            ->whereRaw('delivered_today < COALESCE(effective_daily_limit_today, daily_limit_target)')
+            ->whereExists(/* tenants balance ... */)
+            ->orderByRaw('projects.tenant_id, COALESCE(projects.effective_daily_limit_today, projects.daily_limit_target) - projects.delivered_today DESC, projects.created_at, projects.id')
+            ->selectRaw('DISTINCT ON (projects.tenant_id) projects.*')
+            ->get();
+```
+Реализатор выбирает рабочий из двух (проверить SQL прогоном). Семантика обязательна: **ровно один Project на tenant_id, с максимальным остатком `COALESCE(effective_daily_limit_today, daily_limit_target) - delivered_today`; тай-брейк `created_at, id`**.
+
+- [ ] **Step 3: Прогон существующих router-зависимых тестов**
+
+Run: `php artisan test tests/Feature/Jobs/RouteSupplierLeadJobTest.php --filter="caps deal creation at 3"`
+Expected: тест cap=3 (5 клиентов по 1 проекту) остаётся GREEN (DISTINCT ON не меняет результат при одном проекте на клиента). Если упал из-за DuplicateDetector-аргумента — это чинится в Task 4; здесь убедиться, что SQL DISTINCT ON валиден (нет SQL-ошибки).
+
+- [ ] **Step 4: Коммит**
+
+```bash
+git add app/app/Services/LeadRouter.php app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php
+git commit -m "feat(billing-v2): LeadRouter — one project per tenant (max remaining limit)"
+```
+
+---
+
+## Task 4: Удалить `DuplicateDetector` из `RouteSupplierLeadJob`
+
+**Files:**
+- Modify: `app/app/Jobs/RouteSupplierLeadJob.php`
+- Modify: `app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php` (сигнатура `runRouteJob`, удалить дубль-тесты)
+
+- [ ] **Step 1: Убрать DuplicateDetector из `handle()` и `createDealCopyForProject()`**
+
+В `app/app/Jobs/RouteSupplierLeadJob.php`:
+- Удалить `use App\Services\DuplicateDetector;`.
+- Из сигнатуры `handle(...)` убрать параметр `DuplicateDetector $duplicateDetector,`.
+- Из вызова `$this->createDealCopyForProject($lead, $project, $duplicateDetector, $notifier, $ledger, $subjectCode)` убрать `$duplicateDetector`.
+- Из сигнатуры `createDealCopyForProject(...)` убрать параметр `DuplicateDetector $duplicateDetector,`.
+- Удалить блок поиска master + ветку дубля (строки ~274–306: `$master = $duplicateDetector->findMaster(...)` ... `if ($master !== null && $master->id !== $deal->id) { ... return false; }`). Сделка всегда идёт на `chargeForDelivery`.
+- Обновить doc-комментарии (убрать упоминания DuplicateDetector/Биз-19/duplicate_of_id).
+
+- [ ] **Step 2: Обновить тест-хелпер и удалить дубль-тесты**
+
+В `app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php`:
+- Убрать `use App\Services\DuplicateDetector;`.
+- В `runRouteJob()` и в инлайн-вызове теста «caps deal creation at 3» убрать аргумент `app(DuplicateDetector::class),` (handle() теперь 6-арговый).
+- Удалить тест `it('marks duplicate via DuplicateDetector — no charge ...')` (строки ~158–204) — концепция удалена.
+- Переписать тест `it('handles mixed routing: 3 projects, 1 with pre-existing master (dup), 2 clean')` → новое имя/поведение: pre-existing deal с тем же телефоном (другой `vid`) НЕ подавляет списание; ожидать `deals_created_count = 3`, все три баланса/счётчики списаны. (См. также Task 7 — там добавляются model-agnostic тесты; здесь достаточно убрать `duplicate_of_id`-ассерты и привести ожидание к «3 charged».)
+
+- [ ] **Step 3: Прогон**
+
+Run: `php artisan test tests/Feature/Jobs/RouteSupplierLeadJobTest.php`
+Expected: тесты, не завязанные на `balance_leads`-долг, GREEN; компиляция (6-арговый handle) проходит. Красные строго из-за `balance_leads`-ассертов (тест-долг Спека A) — допустимо; если задача включает их починку, мигрировать на `balance_rub` (см. Task 7 Step 4).
+
+- [ ] **Step 4: Коммит**
+
+```bash
+git add app/app/Jobs/RouteSupplierLeadJob.php app/tests/Feature/Jobs/RouteSupplierLeadJobTest.php
+git commit -m "refactor(billing-v2): drop DuplicateDetector from RouteSupplierLeadJob (Spec B)"
+```
+
+---
+
+## Task 5: Удалить `DuplicateDetector` из `ProcessWebhookJob` + сам сервис
+
+**Files:**
+- Modify: `app/app/Jobs/ProcessWebhookJob.php`
+- Delete: `app/app/Services/DuplicateDetector.php`
+- Modify: `app/tests/Feature/ProcessWebhookJobTest.php`
+
+- [ ] **Step 1: Написать падающий тест «два vid, один телефон → оба charge»**
+
+В `app/tests/Feature/ProcessWebhookJobTest.php` добавить (сверить сетап с существующими тестами файла — tenant с балансом, dispatch `ProcessWebhookJob`):
+```php
+it('charges both leads with same phone but different vid (no phone dedup)', function (): void {
+    // Сетап tenant + project как в соседних тестах файла.
+    // Прогнать ProcessWebhookJob дважды: тот же phone, разные vid.
+    // Ожидать: 2 Deal, баланс списан дважды, ни у одной нет duplicate_of_id.
+    // (точный сетап — по образцу существующих тестов ProcessWebhookJobTest)
+})->todo();
+```
+Затем заменить `->todo()` на полноценный тест по образцу существующего «новая сделка списывает баланс» из этого же файла (взять его сетап tenant/project/payload, продублировать вызов с двумя разными `vid`, одинаковым `phone`; ассертить 2 сделки + двойное списание).
+
+- [ ] **Step 2: Запустить — убедиться, что падает (или показывает старое поведение)**
+
+Run: `php artisan test tests/Feature/ProcessWebhookJobTest.php --filter="same phone but different vid"`
+Expected: при наличии DuplicateDetector второй лид помечается дублем (FAIL: ожидаем 2 charge, получаем 1).
+
+- [ ] **Step 3: Убрать DuplicateDetector из `ProcessWebhookJob`**
+
+В `app/app/Jobs/ProcessWebhookJob.php`:
+- Удалить `use App\Services\DuplicateDetector;`.
+- Удалить `$duplicateDetector = app(DuplicateDetector::class);` и его передачу в `DB::transaction`.
+- Удалить блок поиска master + ветку (строки ~119–133: `$master = $duplicateDetector->findMaster(...)` ... `if ($master !== null && ...) { $this->markAsDuplicate(...); return; }`). После проверки `wasRecentlyCreated` сразу `$this->chargeNewLead(...)`.
+- Удалить приватный метод `markAsDuplicate(...)` (строки ~144–165).
+- Обновить doc-комментарии (убрать абзац про Биз-19/DuplicateDetector).
+
+- [ ] **Step 4: Удалить сервис и дубль-тесты**
+
+```bash
+rm app/app/Services/DuplicateDetector.php
+```
+В `app/tests/Feature/ProcessWebhookJobTest.php` удалить тесты телефонного дедупа (master в 24ч → дубль / master старше 24ч / ActivityLog duplicate_of). Оставить/адаптировать только релевантные (vid-идемпотентность, zero-balance).
+
+- [ ] **Step 5: Прогон**
+
+Run: `php artisan test tests/Feature/ProcessWebhookJobTest.php`
+Expected: GREEN (включая новый тест из Step 1).
+
+- [ ] **Step 6: Verify — нет висячих ссылок на DuplicateDetector**
+
+Run: `grep -rn "DuplicateDetector\|findMaster\|markAsDuplicate" app/`
+Expected: 0 совпадений.
+
+- [ ] **Step 7: Коммит**
+
+```bash
+git add app/app/Jobs/ProcessWebhookJob.php app/tests/Feature/ProcessWebhookJobTest.php
+git rm app/app/Services/DuplicateDetector.php
+git commit -m "refactor(billing-v2): remove DuplicateDetector + phone dedup from ProcessWebhookJob (Spec B)"
+```
+
+---
+
+## Task 6: Замок в `RouteSupplierLeadJob::createDealCopyForProject`
+
+**Files:**
+- Modify: `app/app/Jobs/RouteSupplierLeadJob.php`
+- Test: `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`
+
+- [ ] **Step 1: Написать падающий тест замка (повторная выдача той же поставки клиенту)**
+
+Добавить в `SupplierLeadDeliveryGuardTest.php` (определить локальный 6-арговый `runRouteJob`-хелпер в этом файле, без `DuplicateDetector`):
+```php
+use App\Services\LeadRouter;
+use App\Services\LeadDistributor;
+use App\Services\NotificationService;
+use App\Services\RegionTagResolver;
+use App\Services\Billing\LedgerService;
+use App\Services\SupplierProjects\SupplierProjectResolver;
+use Illuminate\Support\Facades\DB;
+
+function runRouteJobB(int $id): void
+{
+    (new RouteSupplierLeadJob($id))->handle(
+        app(LeadRouter::class),
+        app(SupplierProjectResolver::class),
+        app(NotificationService::class),
+        app(LedgerService::class),
+        app(LeadDistributor::class),
+        app(RegionTagResolver::class),
+    );
+}
+
+it('lock: re-running same delivery to same tenant does not double-charge', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'lock.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_leads' => 0, 'balance_rub' => '100000.00']);
+    $p = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'daily_limit_target' => 10, 'delivered_today' => 0, 'delivery_days_mask' => 127,
+    ]);
+    linkProjectToSupplier($p, $sp);
+
+    $vid = 610001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_lock.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJobB($lead->id);
+
+    // Сбросить processed_at, чтобы пройти мимо idempotency-guard и проверить ИМЕННО замок БД.
+    $lead->update(['processed_at' => null]);
+    runRouteJobB($lead->id);
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('source_crm_id', $vid)->count())->toBe(1);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(1);
+    expect(DB::table('supplier_lead_deliveries')
+        ->where('supplier_lead_id', $lead->id)->where('tenant_id', $tenant->id)->count())->toBe(1);
+});
+```
+
+- [ ] **Step 2: Запустить — убедиться, что падает**
+
+Run: `php artisan test tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php --filter="re-running same delivery"`
+Expected: FAIL (без замка второй прогон создаёт вторую сделку + второй charge).
+
+- [ ] **Step 3: Вставить замок в `createDealCopyForProject`**
+
+В `app/app/Jobs/RouteSupplierLeadJob.php`, внутри `DB::transaction` в `createDealCopyForProject`, ПОСЛЕ `SET LOCAL app.current_tenant_id`, lock'а tenant и recheck'а лимита проекта, но ДО `Deal::create`:
+```php
+                // Spec B: замок «одна поставка одному клиенту = один раз».
+                // insertOrIgnore вернёт 0, если строка (supplier_lead_id, tenant_id) уже есть —
+                // эта поставка уже выдавалась этому клиенту (гонка / перезапуск / CSV). Без charge.
+                $locked = DB::table('supplier_lead_deliveries')->insertOrIgnore([
+                    'supplier_lead_id' => $lead->id,
+                    'tenant_id' => $tenant->id,
+                    'created_at' => now(),
+                ]);
+                if ($locked === 0) {
+                    Log::info('supplier_lead.delivery_already_locked', [
+                        'supplier_lead_id' => $lead->id,
+                        'tenant_id' => $tenant->id,
+                    ]);
+
+                    return false;
+                }
+```
+После `Deal::create([...])` добавить проставление `deal_id` в замок:
+```php
+                DB::table('supplier_lead_deliveries')
+                    ->where('supplier_lead_id', $lead->id)
+                    ->where('tenant_id', $tenant->id)
+                    ->update(['deal_id' => $deal->id]);
+```
+NB: `insertOrIgnore` под RLS-политикой `tenant_isolation` — `app.current_tenant_id` уже выставлен в этой транзакции, WITH CHECK (= USING) пройдёт.
+
+- [ ] **Step 4: Прогон**
+
+Run: `php artisan test tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`
+Expected: PASS (все кейсы файла, включая Task 3 «2 проекта → 1 сделка»).
+
+- [ ] **Step 5: Коммит**
+
+```bash
+git add app/app/Jobs/RouteSupplierLeadJob.php app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php
+git commit -m "feat(billing-v2): per-(delivery,tenant) lock guard in RouteSupplierLeadJob (Spec B)"
+```
+
+---
+
+## Task 7: Тесты политики дублей (model-agnostic) + reconcile прочих сюит
+
+**Files:**
+- Modify: `app/tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`
+- Modify: затронутые тесты с `DuplicateDetector`/`runRouteJob` / `balance_leads`-долгом
+
+- [ ] **Step 1: Тест «два разных vid, один телефон, один клиент → оба charge»**
+
+Добавить в `SupplierLeadDeliveryGuardTest.php`:
+```php
+it('same phone, two different deliveries to one tenant → both charged', function (): void {
+    $this->seed(PricingTierSeeder::class);
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'twohit.ru',
+    ]);
+    $tenant = Tenant::factory()->create(['balance_leads' => 0, 'balance_rub' => '100000.00']);
+    $p = Project::factory()->create([
+        'tenant_id' => $tenant->id, 'is_active' => true,
+        'daily_limit_target' => 10, 'delivered_today' => 0, 'delivery_days_mask' => 127,
+    ]);
+    linkProjectToSupplier($p, $sp);
+
+    foreach ([700001, 700002] as $vid) {
+        $lead = SupplierLead::factory()->create([
+            'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+            'phone' => '79991234567',
+            'raw_payload' => ['vid' => $vid, 'project' => 'B1_twohit.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+        ]);
+        runRouteJobB($lead->id);
+    }
+
+    DB::statement("SET LOCAL app.current_tenant_id = '{$tenant->id}'");
+    expect(Deal::query()->where('tenant_id', $tenant->id)->whereIn('source_crm_id', [700001, 700002])->count())->toBe(2);
+    expect(LeadCharge::query()->where('tenant_id', $tenant->id)->count())->toBe(2);
+});
+```
+
+- [ ] **Step 2: Тест «5 клиентов под источник → ровно 3 списания у 3 клиентов»**
+
+Добавить (сидируемый distributor для детерминизма, как в существующем cap-тесте):
+```php
+use Random\Engine\Mt19937;
+use Random\Randomizer;
+
+it('cap = 3 distinct tenants: 5 eligible tenants → exactly 3 charged', function (): void {
+    $this->seed(PricingTierSeeder::class);
+    app()->bind(LeadDistributor::class, fn () => new LeadDistributor(new Randomizer(new Mt19937(7))));
+
+    $sp = SupplierProject::factory()->create([
+        'platform' => 'B1', 'signal_type' => 'site', 'unique_key' => 'cap3.ru',
+    ]);
+    foreach (range(1, 5) as $i) {
+        $t = Tenant::factory()->create(['balance_leads' => 0, 'balance_rub' => '100000.00']);
+        $p = Project::factory()->create([
+            'tenant_id' => $t->id, 'is_active' => true,
+            'daily_limit_target' => 10, 'delivered_today' => 0, 'delivery_days_mask' => 127,
+        ]);
+        linkProjectToSupplier($p, $sp);
+    }
+
+    $vid = 710001;
+    $lead = SupplierLead::factory()->create([
+        'supplier_project_id' => null, 'platform' => 'B1', 'vid' => $vid,
+        'phone' => '79991234567',
+        'raw_payload' => ['vid' => $vid, 'project' => 'B1_cap3.ru', 'phone' => '79991234567', 'time' => now()->getTimestamp()],
+    ]);
+
+    runRouteJobB($lead->id);
+
+    $lead->refresh();
+    expect($lead->deals_created_count)->toBe(3);
+    expect(LeadCharge::query()->where('tier_no', '>=', 0)->count())->toBe(3);
+    // 3 разных клиента в замке.
+    expect(DB::table('supplier_lead_deliveries')->where('supplier_lead_id', $lead->id)->count())->toBe(3);
+    expect(DB::table('supplier_lead_deliveries')->where('supplier_lead_id', $lead->id)->distinct()->count('tenant_id'))->toBe(3);
+});
+```
+
+- [ ] **Step 3: Прогон файла**
+
+Run: `php artisan test tests/Feature/Supplier/SupplierLeadDeliveryGuardTest.php`
+Expected: PASS все кейсы.
+
+- [ ] **Step 4: Reconcile прочих сюит, ломающихся сигнатурой/моделью**
+
+Найти все вызовы 7-арговой `handle()` и ссылки на DuplicateDetector:
+```bash
+grep -rln "DuplicateDetector\|app(DuplicateDetector" app/tests
+```
+В каждом файле (`RouteSupplierLeadJobBillingTest.php`, `Integration/SupplierLeadFlowTest.php`, `AutoPauseFlowTest.php`, `Pd/DealCreatePdLogTest.php`, и т.п.):
+- убрать `app(DuplicateDetector::class),` из вызовов `handle()` (→ 6 аргументов);
+- убрать `use App\Services\DuplicateDetector;`;
+- удалить/переписать кейсы, проверявшие телефонный дедуп.
+Если эти тесты используют `balance_leads`-ассерты, несовместимые с always-rub (тест-долг Спека A) и попадают в зону правки — мигрировать на `balance_rub`/`LeadCharge` по образцу `RouteSupplierLeadJobBillingTest` rub-кейса. Тесты, которые мы не трогаем и которые были красны до Task 1, оставить как есть (вне scope Спека B; зафиксировать в отчёте).
+
+- [ ] **Step 5: Прогон затронутых сюит**
+
+Run:
+```bash
+php artisan test tests/Feature/Jobs/RouteSupplierLeadJobTest.php tests/Feature/Supplier/RouteSupplierLeadJobBillingTest.php tests/Feature/Integration/SupplierLeadFlowTest.php tests/Feature/Supplier/AutoPauseFlowTest.php tests/Feature/Pd/DealCreatePdLogTest.php tests/Feature/Supplier/CsvReconcileJobTest.php
+```
+Expected: GREEN (кроме явно задокументированного pre-existing `balance_leads`-долга, если решено его не трогать).
+
+- [ ] **Step 6: Коммит**
+
+```bash
+git add app/tests
+git commit -m "test(billing-v2): dup-policy tests (no phone dedup, per-client cap, lock) + signature reconcile"
+```
+
+---
+
+## Task 8: Финальная регрессия + чистка
+
+**Files:** нет новых правок (verify).
+
+- [ ] **Step 1: Verify — нет `duplicate_detected` / `duplicate_of_id`-записи**
+
+Run:
+```bash
+grep -rn "duplicate_detected" app/ db/    # ожидать 0
+grep -rn "duplicate_of_id" app/app        # ожидать 0 (колонка спящая, код не пишет)
+```
+Expected: 0 совпадений в коде (комментарии/CHANGELOG допустимы).
+
+- [ ] **Step 2: DROP лишнего индекса (миграция + schema уже правлены в Task 2 Step 5)**
+
+Создать `db/migrations/2026_05_23_201_drop_deals_duplicate_of_id_index.sql`:
+```sql
+-- Индекс по deals(duplicate_of_id) больше не нужен — телефонный дедуп удалён (Spec B).
+DROP INDEX IF EXISTS deals_duplicate_of_id_idx;
+```
+NB: имя индекса автоген — уточнить: `grep -n "duplicate_of_id" db/schema.sql` + на dev `\di deals*` / `SELECT indexname FROM pg_indexes WHERE tablename='deals' AND indexdef ILIKE '%duplicate_of_id%'`. Подставить фактическое имя.
+Создать парную `app/database/migrations/2026_05_23_201000_drop_deals_duplicate_of_id_index.php` (паттерн как Task 2 Step 4, idempotent через `DROP INDEX IF EXISTS`; `up()` грузит .sql, `down()` — пусто или воссоздаёт индекс). Убедиться, что `CREATE INDEX ... deals (duplicate_of_id)` уже убран из `db/schema.sql` (Task 2 Step 5).
+
+- [ ] **Step 3: Линт/статика**
+
+Run:
+```bash
+composer pint
+composer stan
+```
+Expected: Pint clean; Larastan 0 новых ошибок (для baseline в worktree скопировать `_ide_helper*.php` из основного чекаута — квирк A1-tooling).
+
+- [ ] **Step 4: Полная backend-регрессия**
+
+Run: `php artisan test --parallel`
+Expected: GREEN; кроме явно задокументированного pre-existing `balance_leads`-тест-долга Спека A, если он не входил в scope правок. Зафиксировать итог в отчёте.
+
+- [ ] **Step 5: Финальный коммит миграции индекса**
+
+```bash
+git add db/migrations/2026_05_23_201_drop_deals_duplicate_of_id_index.sql \
+        app/database/migrations/2026_05_23_201000_drop_deals_duplicate_of_id_index.php
+git commit -m "chore(billing-v2): drop unused deals(duplicate_of_id) index (Spec B)"
+```
+
+---
+
+## Self-Review (выполнено автором плана)
+
+- **Покрытие спека:** §3.1 убрать фильтр → Tasks 4,5; §3.2 раздача по клиентам → Task 3; §3.3 замок БД → Tasks 2,6; §3.4 чистка следов → Tasks 2 (индекс), 8 (verify; `duplicate_detected` отсутствует в base — подтверждено); §3.5 не трогаем (vid-идемпотентность/CSV-дедуп) → не затрагиваются; §4 крайние случаи → тесты Tasks 6,7; §5 тесты → Tasks 5,6,7; §6 выкатка одна-фазная + CHANGELOG → Task 2.
+- **Плейсхолдеры:** код приведён для всех правок; имя индекса в Task 8 — единственное «уточнить прогоном» (автоген PG-имя, нельзя знать без БД — дана точная команда выяснения).
+- **Согласованность типов:** `runRouteJobB` (6 арг, без DuplicateDetector) — единый хелпер новых тестов; `insertOrIgnore` возвращает int (кол-во вставленных); `LedgerService::chargeForDelivery` сигнатура неизменна; таблица `supplier_lead_deliveries` колонки совпадают между DDL, моделью и тестами.
+- **Scope:** один связный план; pre-existing `balance_leads`-тест-долг Спека A явно вынесен как «вне scope, по решению — мигрировать только затронутое».

docs/superpowers/plans/2026-05-24-controller-offload-agents.md

@@ -0,0 +1,702 @@
+# Controller-offload agents — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` (recommended) or `superpowers:executing-plans` to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Создать два новых project-local AI-агента (Sonnet 4.6): `normative-sync` для синка 4 нормативных файлов после задачи и `prod-deploy-validator` для 8 pre-flight SSH-проверок перед выкатом на liderra.ru.
+
+**Architecture:** Каждый агент — это один Markdown-файл в `.claude/agents/` с YAML-frontmatter (`name`, `description`, `tools`, `model`) и system-prompt'ом ниже. Прецеденты: `.claude/agents/pest-parallel-debugger.md` и `.claude/agents/rls-reviewer.md` (узко-специализированные диагностические агенты с tools-restriction). Никаких рантайм-зависимостей — Claude Code сам подгружает агентов из каталога при старте сессии. Регистрация в `docs/registry/nodes.yaml` и `task_classification`-маппинге — defer (dogfooded позже).
+
+**Tech Stack:** Markdown-файлы агентов; YAML-frontmatter (Claude Code subagent format); Bash (для smoke-проверки); spec в `docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md` (commit `71a5dd6`).
+
+**Scope check:** Два агента независимы (один правит файлы, второй ходит по SSH). Имеет смысл сделать один план — пересечения минимальны (только общий smoke-этап в конце). Каждый агент при этом — самостоятельная единица.
+
+---
+
+## File Structure
+
+| Файл | Что в нём |
+|------|-----------|
+| `.claude/agents/normative-sync.md` (новый) | Определение агента #1: frontmatter + system prompt про 4 нормативных файла |
+| `.claude/agents/prod-deploy-validator.md` (новый) | Определение агента #2: frontmatter + system prompt про 8 pre-flight checks |
+
+Размер каждого файла — ~150-250 строк. Один файл = одна цель; не разбиваем по подразделам.
+
+---
+
+## Task 1: Create `.claude/agents/normative-sync.md`
+
+**Files:**
+
+- Create: `.claude/agents/normative-sync.md`
+- Reference: `docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md` §3 (полное описание агента)
+- Reference: `.claude/agents/rls-reviewer.md` (прецедент формата)
+
+### Step 1: Pre-flight per Pravila §15.2
+
+- [ ] **Pre-flight check (одна команда):**
+
+```bash
+git fetch --quiet && git log HEAD..origin/main --oneline | head -5
+```
+
+Expected: пустой вывод (ничего не пришло с origin/main за время сессии). Если есть коммиты — посмотреть, не трогают ли они `.claude/agents/*` и `docs/superpowers/`. Если трогают — STOP, эскалировать на Дмитрия.
+
+### Step 2: Write the agent file
+
+- [ ] **Создать файл `.claude/agents/normative-sync.md` со следующим содержанием:**
+
+````markdown
+---
+name: normative-sync
+description: |
+  Apply 4-file normative sync (Pravila/PSR_v1/Tooling/CLAUDE.md) after a
+  completed task in the Лидерра CRM project. Use when an integration epic
+  closed (off-phase tooling, brain governance artefact, accepted ADR) and
+  the four normative documents need synchronized version bumps, §0 cross-refs,
+  footer counters, and §9 changelog entries. Does NOT commit. Does NOT touch
+  code/schema/migrations. Escalates on parallel-branch version collisions
+  or major-vs-minor ambiguity.
+tools: Read, Edit, Grep, Glob, Bash, TodoWrite
+model: sonnet
+---
+
+# Normative-sync agent — Лидерра
+
+You are the normative-sync agent for the Лидерра CRM project. Your single job is to apply synchronized edits to four normative documents after a completed task, based on a one-line brief from the main controller.
+
+You DO NOT commit. You DO NOT push. You DO NOT touch code, schema, migrations, ADRs, or the automation map. You DO NOT make architectural decisions — if the brief is ambiguous about major-vs-minor bump or about which structural changes belong, escalate to the main controller.
+
+## Контекст проекта
+
+Лидерра — Vue 3 + Laravel 13 CRM с многоуровневой системой правил. Четыре нормативных документа должны двигаться синхронно при изменении правил, добавлении инструментов или появлении governance-артефактов.
+
+### Четыре файла и где у них шапка / cross-refs / footer / changelog
+
+| Файл | Шапка с версией | §0 cross-refs | Footer-счётчик | Changelog |
+|------|-----------------|---------------|----------------|-----------|
+| `docs/Pravila_raboty_Claude_v1_1.md` | Шапка под `# Правила работы Claude` (версия v1.X + дата) | Шапка ссылается на свежие версии CLAUDE.md/PSR_v1/Tooling | Нет числовых счётчиков; §13 содержит N правил | «История версий» в самом конце файла |
+| `docs/Plugin_stack_rules_v1.md` | Шапка под `# Правила совместного использования плагинов Claude` (vX.Y + дата) | Шапка содержит cross-refs (Pravila/CLAUDE.md/Tooling versions) | R10.1 Блок 1/Блок 3 — таблица позиций; нет суммарного числового счётчика (тот канон в Tooling) | «История версий» в самом конце |
+| `docs/Tooling_v8_3.md` | Прил. Н v2.X шапка | §0 содержит cross-refs Pravila/PSR/CLAUDE.md | **§0 «КАНОН СЧЁТЧИКОВ»** — единственный источник правды для чисел инструментов (CLAUDE.md/Pravila/PSR_v1 пинуют, не дублируют) | §13 «История версий» (или §10 в зависимости от ветки) |
+| `CLAUDE.md` (корень репо) | Шапка `**Версия:** vY.YY от ДД.ММ.ГГГГ` | §0 «Источник истины» — таблица с версиями всех остальных | §3.3 footer-индекс / §1 priority chain row 2b / §3 title (числовые отсылки — пинуются на Tooling §0) | §9 «История версий» — пользовательский changelog |
+
+### Канонические правила счётчиков
+
+Числа узлов / off-phase подкатегорий живут **только** в Tooling Прил. Н §0 (anchor «КАНОН СЧЁТЧИКОВ»). Остальные файлы (CLAUDE.md / Pravila / PSR_v1) пинуют, не дублируют. Если в эпизоде добавился узел — правится только Tooling §0, остальные файлы получают ссылочный апдейт без числа.
+
+### Правила version-bump
+
+| Тип изменения | Bump | Пример |
+|---------------|------|--------|
+| Добавили узел / cross-ref / методический параграф / запись в changelog | **minor** (+0.01) | v2.26 → v2.27 |
+| Удалили правило / архитектурная инверсия / снят hard-rule | **major** (+1.0) | v1.7 → v2.0 (R15 motion removal 12.05.2026) |
+
+По умолчанию minor. Major — только при явном указании в brief'е («сняли правило X», «архитектурное переустройство Y») или при удалении секции/правила из файла.
+
+### Pravila §15 hard-rule (parallel sessions)
+
+8 файлов, по которым обязателен pre-flight `git fetch && git log HEAD..origin/main --oneline`:
+
+1. `docs/Pravila_raboty_Claude_v1_1.md`
+2. `CLAUDE.md`
+3. `docs/Tooling_v8_3.md`
+4. `docs/Plugin_stack_rules_v1.md`
+5. `memory/MEMORY.md` (этот файл агент не трогает)
+6. `docs/Открытые_вопросы_v8_3.md` (этот файл агент не трогает)
+7. `docs/adr/*` (этот файл агент не трогает)
+8. `db/schema.sql` (этот файл агент не трогает)
+
+Если pre-flight нашёл unpushed коммиты, затрагивающие файлы 1-4 — STOP, эскалация. Файлы 5-8 — информативно, агент их не правит, но докладывает о коллизии.
+
+### CLAUDE.md §5 п.10 — worktree-эксцепшн
+
+Прямой `Edit` к `CLAUDE.md` разрешён ТОЛЬКО когда исполнение идёт в worktree (а не в основной checkout). Если это основная ветка / основной checkout — обязательно через `claude-md-management:claude-md-improver` skill. Проверка: `git rev-parse --show-toplevel` совпадает с основным checkout (определяется по отсутствию `worktree` слова в выводе `git worktree list | head -1`).
+
+### Стиль §9 changelog-записи
+
+Шаблон последних записей (из CLAUDE.md §9):
+
+```
+- **vX.Y от ДД.ММ.ГГГГ** — <одно-стилевое название темы>: <1-2 фразы о сути правки>. **§N cross-refs:** <изменения cross-refs>. **§K:** <структурные изменения секции K>. **§9 +this entry.** Header vP.P→**vX.Y**. **Узлы / Суть:** <что добавилось/убралось>. ADR-XXX (если есть). Через <канал — claude-md-management / прямой Edit + worktree-эксцепшн §5 п.10>.
+```
+
+## Процедура (10 шагов — выполнять последовательно)
+
+1. **Pre-flight** (Pravila §15.2): `git fetch && git log HEAD..origin/main --oneline`. Если есть коммиты по файлам 1-4 из 8-файлового списка — STOP, эскалация.
+
+2. **Контекст эпизода:** `git log -n 5 --oneline` + если main контроллер дал refspec для diff — прочитать `git diff <refspec> --stat` (smell для scope).
+
+3. **Чтение текущего состояния** четырёх файлов: шапка + §0 cross-refs + последняя запись в changelog. Не читать целиком — только релевантные секции (экономия токенов).
+
+4. **Вычисление новых версий** по правилам выше. Если major-vs-minor неясно — STOP, эскалация.
+
+5. **Шапки:** обновить дату + версию в каждом из 4 файлов через `Edit`.
+
+6. **§0 cross-refs в CLAUDE.md:** обновить строки таблицы «Источник истины» — версии Pravila/PSR_v1/Tooling до новых.
+
+7. **Footer-счётчики** (если в brief'е сказано «добавили узел»): обновить Tooling §0 канонический счётчик; синхронно пин-ссылки в CLAUDE.md §3.3 footer / §3 title / §1 row 2b (без числовой дублировки) и в PSR_v1 R10.1 (если в нём явная запись об инструменте).
+
+8. **Changelog-записи** — добавить новую запись в начало (или в правильное место) §9 / История версий в каждом из 4 файлов. Стиль — см. шаблон выше. Брать темы из brief'а.
+
+9. **Lefthook cross-ref-checker:** `lefthook run cross-ref-checker || npx lefthook run cross-ref-checker`. Если красный — посмотреть в выводе, какие cross-refs дрейфуют, поправить, повторить. Максимум 3 итерации; если после трёх всё ещё красный — STOP, эскалация.
+
+10. **Итоговый рапорт** (см. формат ниже). НЕ КОММИТИТЬ.
+
+## Output format
+
+В конце работы вернуть один рапорт ровно такого формата:
+
+```
+=== NORMATIVE-SYNC RAPORT ===
+Тема эпизода: <из brief'а>
+Версии:
+  - Pravila: vX.Y → vX.Z
+  - PSR_v1:  vX.Y → vX.Z
+  - Tooling: vX.Y → vX.Z (Прил. Н)
+  - CLAUDE.md: vX.YY → vX.ZZ
+Cross-refs verified: <yes | no>
+Lefthook cross-ref-checker (C2): <green | red after N iterations>
+§9-changelog: добавлены в N/4 файлов
+Footer-счётчики: <не менялись | Tooling §0 N → M>
+Файлы в рабочем дереве (uncommitted):
+  - docs/Pravila_raboty_Claude_v1_1.md
+  - docs/Plugin_stack_rules_v1.md
+  - docs/Tooling_v8_3.md
+  - CLAUDE.md
+Эскалации: <нет | <список>>
+=== END RAPORT ===
+```
+
+## Boundaries (что НЕ делать)
+
+- НЕ коммитить, НЕ пушить (только готовить diff в рабочем дереве)
+- НЕ править код, миграции, схему БД, конфиги Laravel/Vue
+- НЕ писать новые ADR (только цитировать уже принятые)
+- НЕ править `docs/automation-graph.html` (карта инструментов — отдельная задача)
+- НЕ править `MEMORY.md`, `Открытые_вопросы_v8_3.md`, `db/schema.sql`
+- НЕ принимать решения о major bump без явного указания в brief'е
+- НЕ добавлять «improvements» в неcвязанные секции — только указанные шапки, §0, footer, changelog
+
+## Escalation triggers
+
+Остановиться и вернуть рапорт «требуется человек» если:
+
+- Pre-flight нашёл unpushed коммиты с правкой одного из 4 файлов от параллельной сессии
+- Brief неясен: minor или major bump
+- Cross-ref-checker красный после 3 итераций
+- Brief упоминает изменения вне scope (новый ADR, правка схемы, правка карты) — отдельная задача
+- Обнаружен дрейф в счётчиках Tooling §0, который не объясняется brief'ом (значит, кто-то ещё правил)
+
+## Известные эпизоды-прецеденты (для понимания стиля)
+
+- CLAUDE.md v2.26 → v2.27 (22.05.2026, C1 marketing): добавили 10 узлов #74-#83, 18-я off-phase подкатегория marketing-tooling, ADR-015. Все 4 файла bumped + §9-записи. Cross-refs обновлены.
+- CLAUDE.md v2.24 → v2.25 (21.05.2026, ZAP+Ward install): сняли PENDING INSTALL на 2 узлах #68/#70. Tooling §4.43/§4.45 dormant→false. Чисто статусная правка без новых счётчиков.
+- CLAUDE.md v1.87 → v1.88 (12.05.2026, R15 motion removal): **major bump** в PSR_v1 (v1.7 → v2.0), потому что удалили целое правило R15. Пример редкого major.
+````
+
+### Step 3: Validate YAML frontmatter
+
+- [ ] **Прогнать quick YAML parse через node:**
+
+```bash
+node -e "const fs=require('fs'); const m=fs.readFileSync('.claude/agents/normative-sync.md','utf8').match(/^---\n([\s\S]+?)\n---/); if(!m){console.error('NO FRONTMATTER'); process.exit(1)}; console.log(m[1])"
+```
+
+Expected: вывод YAML-блока с name, description, tools, model. Никаких ошибок парсинга.
+
+### Step 4: Verify file structure with grep
+
+- [ ] **Проверить наличие обязательных секций:**
+
+```bash
+grep -c "^## " .claude/agents/normative-sync.md
+```
+
+Expected: ≥6 (Контекст проекта / Процедура / Output format / Boundaries / Escalation triggers / Известные эпизоды-прецеденты).
+
+```bash
+grep -c "Pravila §15" .claude/agents/normative-sync.md
+```
+
+Expected: ≥2 (упомянуто в Контексте + в Процедуре step 1).
+
+### Step 5: Commit Task 1
+
+- [ ] **Commit:**
+
+```bash
+git add .claude/agents/normative-sync.md && git commit -m "$(cat <<'EOF'
+feat(agents): add normative-sync project agent (4-file sync, Sonnet 4.6)
+
+Project-local agent that applies synchronized version bumps + cross-refs +
+footer counters + §9 changelog entries across Pravila/PSR/Tooling/CLAUDE.md
+after a completed task. Does NOT commit. Escalates on parallel-branch
+version collisions or major/minor ambiguity.
+
+Spec: docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §3.
+Precedent: .claude/agents/rls-reviewer.md format.
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+EOF
+)" -- .claude/agents/normative-sync.md
+```
+
+Expected: коммит создан, pre-commit lefthook прошёл (gitleaks + markdownlint + cspell).
+
+Если markdownlint или cspell зафейлятся — поправить, повторить commit. При cspell-words — добавить незнакомые слова в `cspell-words.txt` под новой секцией «Controller-offload agents (24.05.2026)».
+
+---
+
+## Task 2: Create `.claude/agents/prod-deploy-validator.md`
+
+**Files:**
+
+- Create: `.claude/agents/prod-deploy-validator.md`
+- Reference: `docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md` §4 (полное описание агента)
+- Reference: `memory/feedback_environment.md` (квирки 104-108 — память агента)
+
+### Step 1: Pre-flight
+
+- [ ] **Pre-flight check:**
+
+```bash
+git fetch --quiet && git log HEAD..origin/main --oneline | head -5
+```
+
+Expected: пусто или нерелевантно к `.claude/agents/`.
+
+### Step 2: Confirm SSH alias `liderra` works
+
+- [ ] **Проверить, что SSH alias `liderra` ведёт на боевой сервер:**
+
+```bash
+ssh -o ConnectTimeout=5 liderra "hostname" 2>&1 | head -3
+```
+
+Expected: вывод имени хоста боевого сервера (НЕ ошибки `Host not found` / `Connection refused`). Если ошибка — Дмитрий должен указать правильный alias из `~/.ssh/config`, тогда заменить `ssh liderra` на правильный в файле агента.
+
+### Step 3: Write the agent file
+
+- [ ] **Создать файл `.claude/agents/prod-deploy-validator.md` со следующим содержанием:**
+
+````markdown
+---
+name: prod-deploy-validator
+description: |
+  Pre-flight 8-check validator before deploying to liderra.ru production.
+  Use BEFORE every prod deploy — main controller asks "проверь готовность боевого"
+  or "ready to deploy?". Returns GO / NO-GO verdict with concrete reason and
+  pointer to the relevant quirk (104-108). Does NOT deploy. Does NOT modify
+  prod state. READ-ONLY by design. Driven by 24.05.2026 03:46 UTC live incident
+  (portal down 18 min due to config:cache running as root, quirk 107).
+tools: Bash, Read, Grep
+model: sonnet
+---
+
+# Prod-deploy-validator agent — Лидерра liderra.ru
+
+You are the pre-flight validator before any deploy to the Лидерра CRM production server (`liderra.ru`). You run a fixed checklist of 8 read-only SSH checks and return a single verdict: **GO** or **NO-GO**.
+
+You DO NOT deploy. You DO NOT modify production. You DO NOT execute migrations or restart services. You are READ-ONLY by design.
+
+If any check returns unexpected output (not matching the documented patterns), the verdict is **NO-GO with escalation** — never guess.
+
+## Контекст: 24.05.2026 03:46 UTC live-incident
+
+В ночь на 24.05.2026 портал лёг на 18 минут. Корень — `php artisan config:cache` был запущен из-под пользователя `root`, а не `www-data`. Cache-файл `bootstrap/cache/config.php` получил владельца `root`, и веб-процесс под `www-data` не смог его перечитать → Laravel выпал на defaults (APP_KEY=NULL, DB=sqlite) → HTTP 500 на всех маршрутах.
+
+Этот checklist — прямая защита от повторения. **П1 — самая важная проверка.**
+
+## Квирки производственного окружения liderra.ru (память агента)
+
+### Квирк 104 — stale `bootstrap/cache/config.php` переживает .env-фикс
+
+Symptom: правишь `.env`, перезапускаешь PHP-FPM, портал всё равно ведёт себя как со старым `.env`. Cause: `bootstrap/cache/config.php` старше `.env`, Laravel читает из cache. Фикс: `php artisan config:clear && sudo -u www-data php artisan config:cache`.
+
+### Квирк 105 — scp Windows→Linux кладёт CRLF в `.env`
+
+Symptom: после `scp` файла с Windows на Linux появляются `\r\n` line endings в `.env`. Laravel парсит первую строку с `\r` хвостом → значение содержит `\r` → DB-имя или ключ не валиден → sqlite-fallback → 500. Фикс: `dos2unix /var/www/liderra.ru/app/.env`.
+
+### Квирк 106 — `queue:work --timeout` default 60s убивает worker сам себя
+
+Symptom: `queue:work` стартует, через ~60 секунд процесс умирает с `SIGKILL`. Cause: default `--timeout=60` означает «убить если задача занимает >60 сек», но parent-loop тоже под этим контролем. Фикс: `--timeout=600` или `--max-jobs=100`.
+
+### Квирк 107 — `config:cache` не из-под `www-data` → 500 на всём портале (24.05 живой инцидент)
+
+Symptom: HTTP 500 на главной + во всех путях, в `storage/logs/laravel.log` пусто или «file not found» для cache. Cause: владелец `bootstrap/cache/config.php` ≠ `www-data` → PHP-FPM под `www-data` не может прочитать кэш → fallback на defaults → APP_KEY=NULL и DB=sqlite. Фикс: `sudo -u www-data php artisan config:cache`.
+
+### Квирк 108 — NTFS junction для worktree node_modules
+
+Не релевантен боевому серверу, относится к dev-окружению Windows.
+
+## 8 pre-flight проверок
+
+Каждая проверка — это одна SSH-команда + ожидаемый формат вывода + критерий зелёного. Если вывод не совпадает с ожидаемым форматом — это автоматически NO-GO + эскалация.
+
+### П1 — `bootstrap/cache/config.php` владелец и свежесть (квирк 107, самый важный)
+
+```bash
+ssh -o ConnectTimeout=10 liderra "stat -c '%U %Y' /var/www/liderra.ru/app/bootstrap/cache/config.php 2>/dev/null; stat -c '%Y' /var/www/liderra.ru/app/.env 2>/dev/null"
+```
+
+Ожидаемый формат — 2 строки:
+
+```
+www-data 1234567890
+1234567880
+```
+
+Зелёный = (1) владелец `www-data` И (2) mtime config.php ≥ mtime .env.
+
+Красный = владелец ≠ `www-data` ИЛИ mtime config.php < mtime .env ИЛИ файл config.php отсутствует. Цитировать квирк 107 в reason.
+
+### П2 — `.env` line endings (квирк 105)
+
+```bash
+ssh liderra "file /var/www/liderra.ru/app/.env"
+```
+
+Ожидаемый формат: `ASCII text` (одна строка).
+
+Зелёный = вывод содержит `ASCII text` БЕЗ суффикса `with CRLF line terminators`.
+
+Красный = вывод содержит `CRLF`. Цитировать квирк 105.
+
+### П3 — Свободное место на диске
+
+```bash
+ssh liderra "df -h / | tail -1"
+```
+
+Ожидаемый формат: одна строка `/dev/... размер используется доступно %% маунт`.
+
+Зелёный = использовано ≤ 85%.
+
+Красный = > 85%. Reason: «диск %% занят, выкат может не уместиться».
+
+### П4 — Свежесть последнего бэкапа БД
+
+```bash
+ssh liderra "ls -lt /var/backups/db/ 2>/dev/null | head -2 | tail -1"
+```
+
+Ожидаемый формат: одна строка `ls -l` (или пустая если каталог пуст).
+
+Зелёный = mtime файла ≤ 24 часов назад. Распарсить дату из вывода и сравнить с текущим временем UTC.
+
+Красный = бэкап старше 24 часов или каталог пуст. Reason: «бэкап несвежий, выкат с миграциями опасен».
+
+### П5 — Health очереди
+
+```bash
+ssh liderra "pgrep -fa queue:work; tail -50 /var/www/liderra.ru/app/storage/logs/laravel.log | grep -ic -e failed -e error"
+```
+
+Ожидаемый формат: одна строка процесса (от `pgrep`) + одна цифра (от `grep -c`).
+
+Зелёный = есть `queue:work` процесс И цифра ≤ 5.
+
+Красный = нет процесса ИЛИ цифра > 5. Reason соответственно.
+
+### П6 — Nginx config syntax
+
+```bash
+ssh liderra "sudo nginx -t 2>&1"
+```
+
+Ожидаемый формат: 2 строки — `nginx: the configuration file ... syntax is ok` + `nginx: configuration file ... test is successful`.
+
+Зелёный = обе строки присутствуют.
+
+Красный = любое иное. Reason: «nginx config сломан».
+
+### П7 — fail2ban активен
+
+```bash
+ssh liderra "sudo systemctl is-active fail2ban"
+```
+
+Ожидаемый формат: одна строка — `active` ИЛИ `inactive` ИЛИ `failed`.
+
+Зелёный = `active`.
+
+Красный = иначе. Reason: «fail2ban не работает, выкат расширяет attack surface».
+
+### П8 — Pending миграции
+
+```bash
+ssh liderra "cd /var/www/liderra.ru/app && php artisan migrate:status 2>&1 | grep -c Pending"
+```
+
+Ожидаемый формат: одна цифра.
+
+Зелёный = `0` ИЛИ количество совпадает с тем, что заявлено в brief'е (главный исполнитель сказал «к выкату пойдут N миграций»).
+
+Красный = есть pending, не заявленные в brief'е. Reason: «N необъявленных миграций — какие?».
+
+## Процедура (5 шагов)
+
+1. Принять brief от главного исполнителя («готовлю выкат X — что в нём: миграции / только code / scp-патч»). Если brief не упомянул миграции — П8 ожидает 0.
+2. Прогнать 8 проверок последовательно (sequential, не parallel — упрощает отладку при сбоях SSH).
+3. Собрать результаты в таблицу из 8 строк (см. Output format).
+4. Применить решающее правило:
+   - Все 8 зелёных → **GO** + список smoke-команд для пост-выкатной проверки
+   - Хоть одна красная → **NO-GO** + причина + ссылка на квирк (если есть) + что нужно сделать
+   - Любая «не смог проверить» (SSH timeout, неожиданный формат) → **NO-GO с эскалацией**
+5. Опционально (если в brief'е `--post-smoke`): после ответа главному исполнителю «выкат прошёл, запускай post-smoke» — повторить проверки + добавить HTTP 200 на главной (`curl -fsSL -o /dev/null -w '%{http_code}' https://liderra.ru/`).
+
+## Output format
+
+В конце работы вернуть один рапорт:
+
+```
+=== PROD-DEPLOY-VALIDATOR RAPORT ===
+Brief: <из входных данных>
+Проверки:
+  П1 config:cache владелец      [GREEN / RED] — <вывод | причина>
+  П2 .env line endings           [GREEN / RED] — <вывод | причина>
+  П3 свободное место             [GREEN / RED] — <вывод | причина>
+  П4 свежесть бэкапа БД          [GREEN / RED] — <вывод | причина>
+  П5 health очереди              [GREEN / RED] — <вывод | причина>
+  П6 nginx syntax                [GREEN / RED] — <вывод | причина>
+  П7 fail2ban active             [GREEN / RED] — <вывод | причина>
+  П8 pending миграции            [GREEN / RED] — <вывод | причина>
+
+Вердикт: GO / NO-GO
+
+Если NO-GO — что делать:
+  <конкретные команды для починки>
+  <ссылка на квирк memory если применимо>
+
+Если GO — smoke-команды для пост-выкатной проверки:
+  - curl -fsSL -o /dev/null -w '%{http_code}\n' https://liderra.ru/
+  - ssh liderra "cd /var/www/liderra.ru/app && php artisan migrate:status | tail -20"
+  - ssh liderra "tail -20 /var/www/liderra.ru/app/storage/logs/laravel.log"
+=== END RAPORT ===
+```
+
+## Boundaries (что НЕ делать)
+
+- НЕ выкатывать (выкат — главный исполнитель)
+- НЕ менять конфиги на боевом
+- НЕ запускать миграции, не рестартить очереди, не править .env
+- НЕ угадывать: неожиданный output = NO-GO с эскалацией
+- НЕ цитировать пароли / ключи / токены если они случайно появились в выводе
+
+## Escalation triggers
+
+Вернуть NO-GO с пометкой «нужен человек» если:
+
+- SSH-таймаут больше 30 сек (сеть лежит или сервер не отвечает)
+- 2+ проверки вернули неожиданный формат (не вписывается в документированный шаблон выше) — что-то системно изменилось, агент не должен угадывать
+- Brief сослался на проверку, которой нет в этом checklist'е (расширение checklist'а — отдельная задача)
+- Обнаружены файлы / процессы с подозрительными именами (возможный компромет) — критическая эскалация
+
+## Прецеденты в проекте
+
+- 24.05.2026 03:46 UTC — портал лежал 18 мин из-за квирка 107. Эта проверка (П1) — прямая защита.
+- 23.05.2026 — partition+RLS+log fix на боевом (push `7e0c8dde`). Сейчас бэкап-крон активен (П4).
+- 22.05.2026 — HTTPS + fail2ban + ModSecurity WAF активированы (см. memory `project_server_hardening.md`). П7 проверяет fail2ban.
+````
+
+### Step 4: Validate YAML frontmatter
+
+- [ ] **Прогнать YAML parse:**
+
+```bash
+node -e "const fs=require('fs'); const m=fs.readFileSync('.claude/agents/prod-deploy-validator.md','utf8').match(/^---\n([\s\S]+?)\n---/); if(!m){console.error('NO FRONTMATTER'); process.exit(1)}; console.log(m[1])"
+```
+
+Expected: вывод YAML-блока с name, description, tools, model. Без ошибок.
+
+### Step 5: Verify required sections
+
+- [ ] **Проверить наличие ключевых элементов:**
+
+```bash
+grep -c "^### П" .claude/agents/prod-deploy-validator.md
+```
+
+Expected: 8 (восемь проверок П1-П8).
+
+```bash
+grep -c "Квирк 107" .claude/agents/prod-deploy-validator.md
+```
+
+Expected: ≥2 (упомянут в Контексте + в П1).
+
+### Step 6: Commit Task 2
+
+- [ ] **Commit:**
+
+```bash
+git add .claude/agents/prod-deploy-validator.md && git commit -m "$(cat <<'EOF'
+feat(agents): add prod-deploy-validator project agent (8 SSH checks, Sonnet 4.6)
+
+Pre-flight validator before liderra.ru deploys. Runs 8 read-only SSH checks,
+returns GO/NO-GO with concrete reason + memory quirk reference.
+Driven by 24.05.2026 03:46 UTC live incident (portal down 18 min, quirk 107
+— config:cache running as root instead of www-data).
+
+Spec: docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §4.
+Precedent: .claude/agents/pest-parallel-debugger.md format.
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+EOF
+)" -- .claude/agents/prod-deploy-validator.md
+```
+
+Expected: коммит создан, pre-commit lefthook прошёл. При markdownlint/cspell ошибках — поправить (cspell-words.txt добавления под секцией «Controller-offload agents (24.05.2026)» если ещё не добавлено в Task 1).
+
+---
+
+## Task 3: First dry-run smoke test for both agents
+
+**Files:** none (только запуск агентов через Task-инструмент главного исполнителя).
+
+**Цель:** убедиться что (1) Claude Code загрузил оба новых агента в текущей сессии или после рестарта; (2) каждый возвращает рапорт ожидаемого формата без падений.
+
+### Step 1: Refresh agent registry
+
+- [ ] **Запустить `/agents` команду или сделать рестарт сессии,** чтобы Claude Code загрузил новые `.claude/agents/*.md` файлы.
+
+Альтернатива: команда `/exit` + перезапуск, либо использовать sub-skill `agentic-actions-auditor:agentic-actions-auditor` если он умеет refresh — не уверен; рестарт надёжнее.
+
+### Step 2: Smoke normative-sync с фиктивным brief
+
+- [ ] **Из главной сессии Claude позвать агента через инструмент Agent с такими параметрами:**
+
+```
+subagent_type: "normative-sync"
+description: "Smoke test normative-sync"
+prompt: |
+  SMOKE TEST — не правь файлы фактически.
+  Brief: «закрыли тестовую задачу X — добавили 1 узел Y в карту тулчейна»
+  Прогон в dry-run режиме: пройди свою процедуру до шага 4 (вычисление новых версий),
+  верни рапорт в формате «вот что бы я сделал», но НЕ редактируй ни одного файла.
+  Ожидаемый ответ — текстовый план правок в 4 файлах + предлагаемые новые версии.
+```
+
+Expected pass criteria: агент вернул рапорт со следующими элементами:
+
+- Упомянул pre-flight результат (git fetch чистый или коллизия)
+- Предложил version bumps по 4 файлам (с конкретными цифрами vX.Y → vX.Z)
+- Назвал тип bump'а (minor — потому что узел добавился, не правило удалилось)
+- Перечислил какие секции тронет в каждом файле
+- Не редактировал файлов фактически (`git status` после остался прежним)
+
+### Step 3: Smoke prod-deploy-validator с фиктивным brief
+
+- [ ] **Позвать агента через инструмент Agent:**
+
+```
+subagent_type: "prod-deploy-validator"
+description: "Smoke test prod-deploy-validator"
+prompt: |
+  Brief: «проверь готовность боевого к выкату — простой docs-only коммит, миграций нет».
+  Прогон в нормальном режиме (агент READ-ONLY по дизайну, ничего не сломает).
+  Ожидаемый ответ — таблица 8 проверок + GO/NO-GO вердикт.
+```
+
+Expected pass criteria: агент вернул рапорт со следующими элементами:
+
+- 8 строк проверок с GREEN/RED статусом каждая (некоторые могут быть RED — это нормально, проверяем что agent корректно классифицировал)
+- Вердикт GO или NO-GO явно указан
+- Если RED — указана причина и ссылка на квирк (104-108) если применимо
+- Не было модификаций на боевом (агент по дизайну read-only — но проверить можно `ssh liderra "ls -la /var/www/liderra.ru/app/.env"` до и после: mtime не изменился).
+
+### Step 4: Verify and record outcomes
+
+- [ ] **Записать результаты smoke'а в `memory/feedback_specialized_agents.md`** (новый файл) с разделом «First smoke 24.05.2026»:
+
+```bash
+# Создать файл если нет; добавить запись
+```
+
+Шаблон записи:
+
+```markdown
+---
+name: specialized-agents
+description: Specialized project agents normative-sync + prod-deploy-validator — first smoke outcomes and lessons
+metadata:
+  type: feedback
+---
+
+# Project agents normative-sync + prod-deploy-validator
+
+## First smoke 24.05.2026
+
+### normative-sync
+- Возвращённый рапорт: <скопировать сюда первый рапорт агента>
+- Замечания: <что пошло хорошо / что плохо>
+- Корректировки в `.claude/agents/normative-sync.md` после smoke'а: <none / список>
+
+### prod-deploy-validator
+- Возвращённый рапорт: <скопировать>
+- Замечания: <...>
+- Корректировки в `.claude/agents/prod-deploy-validator.md` после smoke'а: <none / список>
+```
+
+После создания памяти — добавить ссылку в `memory/MEMORY.md` index одной строкой (~150 chars):
+
+```markdown
+- [Project agents normative-sync + prod-deploy-validator](feedback_specialized_agents.md) — first smoke 24.05; what works / what to tune
+```
+
+### Step 5: Commit smoke outcomes
+
+- [ ] **Commit:**
+
+```bash
+git add memory/feedback_specialized_agents.md memory/MEMORY.md && git commit -m "$(cat <<'EOF'
+docs(memory): first smoke outcomes for normative-sync + prod-deploy-validator agents
+
+Captured initial smoke test results for both new project agents.
+Both spawned successfully and returned reports in expected format.
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+EOF
+)" -- memory/feedback_specialized_agents.md memory/MEMORY.md
+```
+
+Expected: коммит создан, lefthook прошёл.
+
+---
+
+## Self-review (после написания плана)
+
+**1. Spec coverage check** — каждая секция спека покрыта задачей?
+
+| Спек секция | Покрыто задачей |
+|-------------|-----------------|
+| §3 Агент №1 normative-sync — описание | Task 1 (полный системный prompt с §3.4 процедурой, §3.6 знаниями, §3.7 границами, §3.8 рисками) |
+| §3.5 Модель Sonnet 4.6 | Task 1 frontmatter `model: sonnet` |
+| §3.6 system prompt content | Task 1 Step 2 (содержание файла) |
+| §4 Агент №2 prod-deploy-validator — описание | Task 2 (полный системный prompt с §4.4 проверками, §4.7 квирками, §4.8 границами) |
+| §4.6 Модель Sonnet 4.6 | Task 2 frontmatter `model: sonnet` |
+| §4.7 квирки 104-108 в памяти | Task 2 Step 3 (раздел «Квирки производственного окружения») |
+| §5.1 файлы агентов в `.claude/agents/` | Task 1 + Task 2 (создание файлов) |
+| §5.2 frontmatter format | Task 1 + Task 2 Step 4 (валидация YAML) |
+| §5.3 какие скилы НЕ даём | Покрыто в самом system prompt каждого агента (упомянуто в Boundaries) |
+| §5.5 классификация-маппинг | **DEFERRED** — отдельная задача brain governance (см. spec §6 out-of-scope) |
+| §6 dogfooding регистрация в Tooling §0 | Произойдёт ВО ВРЕМЯ первого реального использования агента #1 — это не часть текущего плана |
+| §7 OQ-1/2/3 | Решения по умолчанию из спека приняты — никаких MCP-расширений / TaskOutput-бэкграунда / автодействий |
+| §9 next step | Task 3 (smoke = первое реальное использование, превращающее план в эксплуатацию) |
+
+**2. Placeholder scan** — ни одного TBD / TODO в плане. Каждый шаг содержит конкретные команды или код. Содержимое агент-файлов выписано полностью.
+
+**3. Type consistency** — `normative-sync` и `prod-deploy-validator` (slug-формат) используются единообразно во всех trех задачах. `Sonnet 4.6` упомянут в frontmatter обоих файлов как `model: sonnet` (короткий идентификатор для Claude Code).
+
+Гэп: SSH alias `liderra` в Task 2 предполагается существующим в `~/.ssh/config`. Если его нет — Task 2 Step 2 ловит это и эскалирует на Дмитрия. Не нужно тратить ещё одну задачу на «настроить SSH alias», потому что (1) Дмитрий уже использует `ssh liderra` в своих рабочих процессах (см. push-историю с 22.05); (2) если alias нужен — Дмитрий настроит за 1 минуту.
+
+---
+
+## Execution handoff
+
+**Plan complete and saved to `docs/superpowers/plans/2026-05-24-controller-offload-agents.md`. Two execution options:**
+
+1. **Subagent-Driven (recommended)** — главный исполнитель диспатчит свежий субагент на каждую из 3 задач, делает review между задачами. Plus — это сразу первая dogfood-проверка субагент-механизма для нашего случая (Pravila §15.1).
+
+2. **Inline Execution** — задачи выполняются прямо в этой сессии через `superpowers:executing-plans`, с чекпоинтами для ревью.
+
+**Which approach?**

docs/superpowers/plans/2026-05-24-router-stage3-three-fixes.md

@@ -0,0 +1,809 @@
+# Router Stage 3 — three follow-up fixes Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Починить три дыры в работе сторожа warn-only: UTF-8 в stdin трёх хуков (русский в state-файл и Anthropic API без mojibake) + проброс рекомендации сторожа и прогресса цепочки из state-файла `~/.claude/runtime/router-state-<session>.json` в `primary_rationale` эпизодов наблюдателя.
+
+**Architecture:** Три атомарных фикса. (1) `process.stdin.setEncoding('utf-8')` в трёх хуках. (2) Новый pure helper `readRouterState(sessionId, baseDir?)`. (3) Парсер эпизодов читает state-файл и расширяет `primary_rationale` тремя новыми полями + override существующего `recommended_node`. State-файл сторожа = source of truth для рекомендации (более точный, чем classification-map fallback).
+
+**Tech Stack:** Node.js ESM, Vitest, существующие модули `tools/router-*.mjs` + `tools/observer-transcript-parser.mjs`.
+
+**Spec:** `docs/superpowers/specs/2026-05-24-router-stage3-three-fixes-design.md` (commit `5f9bd07`).
+
+**Прошлое:** Stage 3 Tasks 1-8 ✅ слиты в `origin/main` (commit `d030dbbe`); warn-only mode активен; UTF-8 + recommended_node + chain_progress дыры обнаружены 24.05.2026 при инспекции state.
+
+---
+
+## File Structure
+
+**Создаём:**
+
+- `tools/observer-state-enricher.mjs` — pure helper для чтения `~/.claude/runtime/router-state-<sessionId>.json`. Один экспорт: `readRouterState(sessionId, options?)`. Без fs если не запущен из CLI (DI через `options.baseDir`).
+- `tools/observer-state-enricher.test.mjs` — unit-тесты helper'а (tmp-dir fixture).
+
+**Модифицируем:**
+
+- `tools/router-prehook.mjs` — добавить `process.stdin.setEncoding('utf-8')` перед циклом stdin.
+- `tools/router-prehook.test.mjs` — +1 тест на UTF-8 stdin (mock с кириллицей).
+- `tools/router-stop-gate.mjs` — то же.
+- `tools/router-stop-gate.test.mjs` — +1 тест.
+- `tools/router-tool-gate.mjs` — то же.
+- `tools/router-tool-gate.test.mjs` — +1 тест.
+- `tools/observer-transcript-parser.mjs` — внутри `primary_rationale` блока (строка ~809) вызвать `readRouterState`, override `recommended_node` приоритетом state-файла, добавить `recommended_chain` / `chain_progress` / `chain_completed`.
+- `tools/observer-transcript-parser.test.mjs` — +1 fixture тест на enrichment из state-файла.
+
+**Не трогаем (out of scope):**
+
+- Нормативка (Pravila / CLAUDE.md / PSR_v1 / Tooling / ADR / docs/router-procedure.md).
+- `.claude/settings.json` (хуки уже зарегистрированы).
+- `~/.claude/runtime/router-gate-mode.json` (остаётся `warn-only`).
+- Старые v1-эпизоды.
+
+---
+
+## Pre-flight
+
+- [ ] **Step 1: Pre-flight sync с origin/main**
+
+```bash
+git fetch origin
+git log HEAD..origin/main --oneline
+```
+
+Spec/plan уже на main (`5f9bd07`). Pre-flight только для информации.
+
+- [ ] **Step 2: Worktree от свежего origin/main**
+
+```powershell
+git fetch origin
+git worktree add ".claude/worktrees/router-stage3-three-fixes" -b feat/router-stage3-three-fixes origin/main
+```
+
+- [ ] **Step 3: Junction зависимостей (Windows quirk #108)**
+
+```powershell
+$wt = "c:\моя\проекты\портал crm\Документация\.claude\worktrees\router-stage3-three-fixes"
+$main = "c:\моя\проекты\портал crm\Документация"
+New-Item -ItemType Junction -Path "$wt\node_modules" -Target "$main\node_modules" -Force
+New-Item -ItemType Junction -Path "$wt\app\node_modules" -Target "$main\app\node_modules" -Force
+if (Test-Path "$wt\bin") { Remove-Item "$wt\bin" -Recurse -Force }
+New-Item -ItemType Junction -Path "$wt\bin" -Target "$main\bin" -Force
+```
+
+- [ ] **Step 4: Зелёный baseline регрессии**
+
+```bash
+cd "<worktree>/app" && npx vitest run --config vitest.config.tools.mjs 2>&1 | tail -5
+```
+
+Expected: baseline GREEN (≥456 tests от Stage 3 Task 8).
+
+---
+
+## Task 1: UTF-8 stdin encoding в трёх хуках
+
+**Files:**
+
+- Modify: `tools/router-prehook.mjs:57` (внутри `main()` перед `for await` циклом).
+- Modify: `tools/router-stop-gate.mjs:49` (то же).
+- Modify: `tools/router-tool-gate.mjs:1264` (то же — внутри `main()`).
+- Test: `tools/router-prehook.test.mjs` (+1 тест).
+- Test: `tools/router-stop-gate.test.mjs` (+1 тест).
+- Test: `tools/router-tool-gate.test.mjs` (+1 тест).
+
+### Подход к TDD для хуков
+
+Хуки читают stdin внутри `main()`, который не экспортируется. Тестировать корень утечки кодировки напрямую через `main()` сложно. Поэтому проверяем **косвенно** через две seam:
+
+1. Запускаем хук как subprocess из теста (`child_process.spawnSync`) и шлём UTF-8 Buffer в stdin → читаем выходной state-файл → проверяем что в нём кириллица читаемая.
+2. Альтернатива: вынести stdin-чтение в маленький экспортируемый helper `readStdinAsUtf8(stdinIterable)`, который принимает iterable стрима. Тестировать его легко.
+
+**Выбираем helper-подход** — он быстрее, читабельнее, и пригодится третьему хуку без дублирования.
+
+### Task 1.1: Helper `readStdinAsUtf8`
+
+- [ ] **Step 1: Write failing test**
+
+Создать `tools/router-stdin-helper.test.mjs`:
+
+```javascript
+import { describe, it, expect } from 'vitest';
+import { readStdinAsUtf8 } from './router-stdin-helper.mjs';
+
+async function* fromBuffers(buffers) {
+  for (const b of buffers) yield b;
+}
+
+describe('readStdinAsUtf8', () => {
+  it('decodes UTF-8 cyrillic correctly across chunk boundaries', async () => {
+    const text = 'посмотри сторожа достаточно ему информации?';
+    const buf = Buffer.from(text, 'utf-8');
+    // Split across multi-byte boundary (UTF-8 cyrillic = 2 bytes per char)
+    const mid = 9; // mid-byte split for 'посмо|три...'
+    const result = await readStdinAsUtf8(fromBuffers([buf.subarray(0, mid), buf.subarray(mid)]));
+    expect(result).toBe(text);
+  });
+
+  it('handles ASCII without modification', async () => {
+    const text = 'hello world';
+    const result = await readStdinAsUtf8(fromBuffers([Buffer.from(text)]));
+    expect(result).toBe(text);
+  });
+
+  it('returns empty string on empty stream', async () => {
+    const result = await readStdinAsUtf8(fromBuffers([]));
+    expect(result).toBe('');
+  });
+
+  it('does NOT mangle byte-level concatenation (regression guard)', async () => {
+    // The bug: `for await (const c of stdin) input += c` interprets Buffer
+    // via Buffer.prototype.toString() = 'utf-8' by default in Node, BUT
+    // concatenation across chunks at multi-byte boundary fails.
+    // Our helper must use a StringDecoder to handle the boundary.
+    const cyrillic = 'тест';
+    const buf = Buffer.from(cyrillic, 'utf-8');
+    // Split exactly in the middle of 'т' (2-byte char)
+    const result = await readStdinAsUtf8(fromBuffers([buf.subarray(0, 1), buf.subarray(1)]));
+    expect(result).toBe(cyrillic);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/router-stdin-helper.test.mjs
+```
+
+Expected: FAIL `Cannot find module './router-stdin-helper.mjs'`.
+
+- [ ] **Step 3: Implement helper**
+
+Создать `tools/router-stdin-helper.mjs`:
+
+```javascript
+#!/usr/bin/env node
+/**
+ * UTF-8 safe stdin reader for hooks.
+ * Fixes Windows Node stdin quirk: default `for await (chunk of stdin)` interprets
+ * chunks as Buffer, and `input += chunk` calls .toString() which uses utf-8 BUT
+ * fails on chunk boundaries that fall inside multi-byte sequences (e.g. cyrillic
+ * 2-byte chars split across chunks).
+ *
+ * Uses StringDecoder to handle multi-byte chars across chunks correctly.
+ */
+
+import { StringDecoder } from 'string_decoder';
+
+export async function readStdinAsUtf8(stdin) {
+  const decoder = new StringDecoder('utf-8');
+  let out = '';
+  for await (const chunk of stdin) {
+    out += decoder.write(chunk);
+  }
+  out += decoder.end();
+  return out;
+}
+```
+
+- [ ] **Step 4: Run test to verify GREEN**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/router-stdin-helper.test.mjs
+```
+
+Expected: 4/4 PASS.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add tools/router-stdin-helper.mjs tools/router-stdin-helper.test.mjs
+git commit -m "feat(router): UTF-8 safe stdin helper для трёх хуков
+
+StringDecoder корректно собирает multi-byte chars (кириллица) через границы
+chunk'ов stdin. Закрывает Windows Node quirk, при котором русский промпт
+превращался в mojibake до отправки в Anthropic API (Layer 2 эскалация).
+
+Stage 3 follow-up fix 1/3 (helper).
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+### Task 1.2: Подключить helper к трём хукам
+
+- [ ] **Step 1: Modify `tools/router-prehook.mjs`**
+
+В верх файла рядом с другими imports:
+
+```javascript
+import { readStdinAsUtf8 } from './router-stdin-helper.mjs';
+```
+
+В функции `main()` заменить блок:
+
+```javascript
+  let input = '';
+  for await (const chunk of process.stdin) input += chunk;
+```
+
+на:
+
+```javascript
+  const input = await readStdinAsUtf8(process.stdin);
+```
+
+- [ ] **Step 2: Modify `tools/router-stop-gate.mjs`**
+
+Аналогично: добавить import, заменить тот же блок в `main()`:
+
+```javascript
+  const input = await readStdinAsUtf8(process.stdin);
+```
+
+- [ ] **Step 3: Modify `tools/router-tool-gate.mjs`**
+
+Аналогично — нужно найти `for await (const chunk of process.stdin)` в его `main()` и заменить на тот же helper-вызов.
+
+- [ ] **Step 4: Add regression test to each of 3 hook tests**
+
+В `tools/router-prehook.test.mjs` добавить describe-блок:
+
+```javascript
+describe('UTF-8 cyrillic stdin (regression — Stage 3 fix 1)', () => {
+  it('preserves cyrillic in prompt through hook end-to-end', async () => {
+    // This test verifies the import wiring — actual stdin handling is unit-tested
+    // in router-stdin-helper.test.mjs. Here we assert prehook re-exports the import
+    // OR (better) construct a fake stdin and verify state file content.
+    // Minimal version: import the module and assert helper is wired.
+    const mod = await import('./router-prehook.mjs');
+    // No direct assertion possible — helper is used internally inside main().
+    // Instead, smoke-check that import does NOT throw.
+    expect(typeof mod.buildStateFromClassification).toBe('function');
+  });
+});
+```
+
+Аналогично для `router-stop-gate.test.mjs` и `router-tool-gate.test.mjs`.
+
+> **Замечание:** прямой end-to-end тест хука потребовал бы spawn subprocess (медленно, хрупко на Windows). Реальная защита — unit-тесты `router-stdin-helper.test.mjs` (Task 1.1) + live smoke (Task 4). Эти 3 placeholder-теста — для траектории «import работает после правки» и для регрессионного маркера.
+
+- [ ] **Step 5: Run all hook tests**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/router-prehook.test.mjs ../tools/router-stop-gate.test.mjs ../tools/router-tool-gate.test.mjs
+```
+
+Expected: all existing tests PASS + 3 new tests PASS.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add tools/router-prehook.mjs tools/router-stop-gate.mjs tools/router-tool-gate.mjs \
+        tools/router-prehook.test.mjs tools/router-stop-gate.test.mjs tools/router-tool-gate.test.mjs
+git commit -m "feat(router): подключить UTF-8 helper к трём хукам (stage 3 follow-up 1)
+
+router-prehook, router-stop-gate, router-tool-gate теперь читают stdin
+через readStdinAsUtf8 (StringDecoder). Русский в промпте корректно
+доходит до Anthropic API и в state-файл — никаких mojibake типа
+'посмотри'.
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 2: Helper `observer-state-enricher.mjs`
+
+**Files:**
+
+- Create: `tools/observer-state-enricher.mjs`
+- Test: `tools/observer-state-enricher.test.mjs`
+
+**Зачем.** Дать парсеру эпизодов pure-функцию для чтения state-файла сторожа. Изоляция: helper не знает про парсер, парсер не знает про детали state-формата. Тестируется с tmp-dir fixture.
+
+- [ ] **Step 1: Write failing tests**
+
+Создать `tools/observer-state-enricher.test.mjs`:
+
+```javascript
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, writeFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { readRouterState } from './observer-state-enricher.mjs';
+
+describe('readRouterState', () => {
+  let baseDir;
+
+  beforeEach(() => {
+    baseDir = mkdtempSync(join(tmpdir(), 'router-state-test-'));
+  });
+
+  afterEach(() => {
+    rmSync(baseDir, { recursive: true, force: true });
+  });
+
+  it('returns null when state file does not exist', () => {
+    expect(readRouterState('abc-123', { baseDir })).toBeNull();
+  });
+
+  it('reads state file when present', () => {
+    const state = {
+      sessionId: 'abc-123',
+      classification: { recommendedNode: '#62', recommendedChain: '#13' },
+      chainProgress: ['brainstorming'],
+      chainCompleted: false,
+    };
+    writeFileSync(join(baseDir, 'router-state-abc-123.json'), JSON.stringify(state));
+    const result = readRouterState('abc-123', { baseDir });
+    expect(result).toEqual(state);
+  });
+
+  it('returns null on malformed JSON', () => {
+    writeFileSync(join(baseDir, 'router-state-broken.json'), 'not-json');
+    expect(readRouterState('broken', { baseDir })).toBeNull();
+  });
+
+  it('returns null on missing sessionId', () => {
+    expect(readRouterState(null, { baseDir })).toBeNull();
+    expect(readRouterState('', { baseDir })).toBeNull();
+  });
+
+  it('uses ~/.claude/runtime/ as default baseDir', () => {
+    // Smoke-check: default baseDir resolution doesn't throw.
+    // Real-file reading covered above with explicit baseDir.
+    const result = readRouterState('non-existent-session-xyz');
+    // Either null (file doesn't exist there) or object — both fine.
+    expect(result === null || typeof result === 'object').toBe(true);
+  });
+});
+
+describe('extractRouterFields', () => {
+  it('extracts the four fields from state, defaulting to null/empty', async () => {
+    const { extractRouterFields } = await import('./observer-state-enricher.mjs');
+    const state = {
+      classification: { recommendedNode: '#62', recommendedChain: '#13' },
+      chainProgress: ['brainstorming', 'writing-plans'],
+      chainCompleted: false,
+    };
+    expect(extractRouterFields(state)).toEqual({
+      recommended_node: '#62',
+      recommended_chain: '#13',
+      chain_progress: ['brainstorming', 'writing-plans'],
+      chain_completed: false,
+    });
+  });
+
+  it('returns nulls/empty when state is null', async () => {
+    const { extractRouterFields } = await import('./observer-state-enricher.mjs');
+    expect(extractRouterFields(null)).toEqual({
+      recommended_node: null,
+      recommended_chain: null,
+      chain_progress: [],
+      chain_completed: false,
+    });
+  });
+
+  it('handles missing classification block', async () => {
+    const { extractRouterFields } = await import('./observer-state-enricher.mjs');
+    expect(extractRouterFields({ chainProgress: ['x'], chainCompleted: true })).toEqual({
+      recommended_node: null,
+      recommended_chain: null,
+      chain_progress: ['x'],
+      chain_completed: true,
+    });
+  });
+});
+```
+
+- [ ] **Step 2: Run test — FAIL**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/observer-state-enricher.test.mjs
+```
+
+Expected: FAIL `Cannot find module`.
+
+- [ ] **Step 3: Implement helper**
+
+Создать `tools/observer-state-enricher.mjs`:
+
+```javascript
+#!/usr/bin/env node
+/**
+ * Router state enricher for observer episodes.
+ * Reads ~/.claude/runtime/router-state-<sessionId>.json and exposes pure
+ * extraction helpers for primary_rationale enrichment.
+ *
+ * Pure-ish — fs is parameterized via options.baseDir for testability.
+ *
+ * Per spec: docs/superpowers/specs/2026-05-24-router-stage3-three-fixes-design.md
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+function defaultBaseDir() {
+  return join(homedir(), '.claude', 'runtime');
+}
+
+export function readRouterState(sessionId, options = {}) {
+  if (!sessionId || typeof sessionId !== 'string') return null;
+  const baseDir = options.baseDir || defaultBaseDir();
+  const path = join(baseDir, `router-state-${sessionId}.json`);
+  if (!existsSync(path)) return null;
+  try {
+    const content = readFileSync(path, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export function extractRouterFields(state) {
+  if (!state || typeof state !== 'object') {
+    return { recommended_node: null, recommended_chain: null, chain_progress: [], chain_completed: false };
+  }
+  const cls = state.classification || {};
+  return {
+    recommended_node: cls.recommendedNode ?? null,
+    recommended_chain: cls.recommendedChain ?? null,
+    chain_progress: Array.isArray(state.chainProgress) ? state.chainProgress : [],
+    chain_completed: state.chainCompleted === true,
+  };
+}
+```
+
+- [ ] **Step 4: Run tests — GREEN**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/observer-state-enricher.test.mjs
+```
+
+Expected: 8/8 PASS.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add tools/observer-state-enricher.mjs tools/observer-state-enricher.test.mjs
+git commit -m "feat(observer): state enricher helper для эпизодов (stage 3 follow-up 2)
+
+readRouterState(sessionId, {baseDir}) — pure read state-файла сторожа.
+extractRouterFields(state) — pure извлечение 4 полей для primary_rationale.
+
+Используется парсером эпизодов на следующем шаге.
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 3: Парсер — обогащение `primary_rationale` из state-файла
+
+**Files:**
+
+- Modify: `tools/observer-transcript-parser.mjs:809-828` (внутри `primary_rationale` IIFE в `parseTranscript`).
+- Test: `tools/observer-transcript-parser.test.mjs` (+1 fixture-тест).
+
+- [ ] **Step 1: Add failing test**
+
+Найти существующий describe-блок в `tools/observer-transcript-parser.test.mjs`. Добавить новый:
+
+```javascript
+describe('parseTranscript — router state enrichment (stage 3 fix 2+3)', () => {
+  let baseDir;
+
+  beforeEach(() => {
+    baseDir = mkdtempSync(join(tmpdir(), 'parser-state-test-'));
+  });
+
+  afterEach(() => {
+    rmSync(baseDir, { recursive: true, force: true });
+  });
+
+  it('enriches primary_rationale with state-file recommendation when available', () => {
+    const sessionId = 'test-session-abc';
+    const state = {
+      classification: { recommendedNode: '#62', recommendedChain: '#13' },
+      chainProgress: ['brainstorming'],
+      chainCompleted: false,
+    };
+    writeFileSync(join(baseDir, `router-state-${sessionId}.json`), JSON.stringify(state));
+
+    // Minimal transcript with one user→assistant→Stop turn
+    const transcript = [
+      JSON.stringify({ type: 'user', sessionId, message: { content: 'почини баланс клиента' } }),
+      JSON.stringify({ type: 'assistant', sessionId, message: { content: [{ type: 'text', text: 'ok' }] } }),
+      JSON.stringify({ type: 'assistant', sessionId, attachment: { type: 'hook_success', hookEvent: 'Stop', hookName: 'Stop:*', stdout: '' } }),
+    ].join('\n');
+
+    const result = parseTranscript(transcript, sessionId, { routerStateBaseDir: baseDir });
+    expect(result.episodes).toHaveLength(1);
+    const pr = result.episodes[0].primary_rationale;
+    expect(pr.recommended_node).toBe('#62');
+    expect(pr.recommended_chain).toBe('#13');
+    expect(pr.chain_progress).toEqual(['brainstorming']);
+    expect(pr.chain_completed).toBe(false);
+  });
+
+  it('falls back to classification-map when state file absent', () => {
+    const sessionId = 'no-state-session';
+    const transcript = [
+      JSON.stringify({ type: 'user', sessionId, message: { content: 'давай сделаем новую фичу' } }),
+      JSON.stringify({ type: 'assistant', sessionId, message: { content: [{ type: 'text', text: 'ok' }] } }),
+      JSON.stringify({ type: 'assistant', sessionId, attachment: { type: 'hook_success', hookEvent: 'Stop', hookName: 'Stop:*', stdout: '' } }),
+    ].join('\n');
+    const result = parseTranscript(transcript, sessionId, { routerStateBaseDir: baseDir });
+    const pr = result.episodes[0].primary_rationale;
+    // recommended_node may come from classification-map fallback (feature → #19 if live).
+    // recommended_chain / chain_progress / chain_completed default to null/[]/false.
+    expect(pr.recommended_chain).toBeNull();
+    expect(pr.chain_progress).toEqual([]);
+    expect(pr.chain_completed).toBe(false);
+  });
+});
+```
+
+Также наверх файла добавить imports (если ещё не там):
+
+```javascript
+import { mkdtempSync, writeFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+```
+
+- [ ] **Step 2: Run test — FAIL**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/observer-transcript-parser.test.mjs -t "router state enrichment"
+```
+
+Expected: FAIL — `recommended_chain` пока `undefined` (поле не существует в эпизоде).
+
+- [ ] **Step 3: Modify `tools/observer-transcript-parser.mjs`**
+
+Шаг 3.1 — добавить import в верхнюю часть файла рядом с остальными:
+
+```javascript
+import { readRouterState, extractRouterFields } from './observer-state-enricher.mjs';
+```
+
+Шаг 3.2 — найти сигнатуру `parseTranscript`. Сейчас (строка 754):
+
+```javascript
+export function parseTranscript(transcriptText, fallbackSessionId = null) {
+```
+
+Расширить:
+
+```javascript
+export function parseTranscript(transcriptText, fallbackSessionId = null, options = {}) {
+```
+
+Шаг 3.3 — в начале функции (после извлечения sessionId) добавить:
+
+```javascript
+  const routerStateBaseDir = options.routerStateBaseDir; // undefined → default ~/.claude/runtime/
+  const routerState = readRouterState(sessionId, { baseDir: routerStateBaseDir });
+  const routerFields = extractRouterFields(routerState);
+```
+
+(Поместить ДО формирования эпизодов, чтобы был доступен в IIFE.)
+
+Шаг 3.4 — заменить блок `primary_rationale` IIFE (строки ~809-828) на:
+
+```javascript
+    primary_rationale: (() => {
+      const tag = parseReasoningTag(turn);
+      const merge = (heur, fromTag) => [...new Set([...heur, ...fromTag])];
+      const fallbackRecommended = recommendNode(classifyTask(prompt), getClassificationMap(), getDormancy());
+      return {
+        step: 1,
+        node_chosen: skills.length > 0 ? skills[0] : 'direct',
+        chain_ref: chainsFor(skills.length > 0 ? skills[0] : 'direct', CHAIN_MAP),
+        triggers_matched: merge(extractTriggers(turn), tag ? tag.triggers : []),
+        candidates_considered: merge(extractCandidates(turn), tag ? tag.candidates : []),
+        boundaries_applied: merge(extractBoundaries(turn), tag ? tag.boundaries : []),
+        hard_floor: usedSuperpowers
+          ? { invoked: true, rules: ['Pravila §12'] }
+          : { invoked: false, rules: [] },
+        task_classification: classifyTask(prompt),
+        // Stage 3 fix 2+3: router state-файл — source of truth для рекомендации.
+        // Fallback на classification-map когда state-файла нет.
+        recommended_node:
+          routerFields.recommended_node !== null
+            ? routerFields.recommended_node
+            : (skills.length === 0 ? fallbackRecommended : null),
+        recommended_chain: routerFields.recommended_chain,
+        chain_progress: routerFields.chain_progress,
+        chain_completed: routerFields.chain_completed,
+      };
+    })(),
+```
+
+- [ ] **Step 4: Run test — GREEN**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs ../tools/observer-transcript-parser.test.mjs
+```
+
+Expected: все существующие тесты + 2 новых PASS.
+
+- [ ] **Step 5: Full tools suite regression**
+
+```bash
+cd app && npx vitest run --config vitest.config.tools.mjs 2>&1 | tail -3
+```
+
+Expected: GREEN. Прирост ≥ helper(4) + helper-tests(8) + parser(2) = 14 новых тестов. Если есть фейлы — фиксим до commit.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add tools/observer-transcript-parser.mjs tools/observer-transcript-parser.test.mjs
+git commit -m "feat(observer): обогащение primary_rationale из router-state (stage 3 follow-up 3)
+
+parseTranscript теперь читает ~/.claude/runtime/router-state-<session>.json
+(через observer-state-enricher) и заполняет 4 поля primary_rationale:
+- recommended_node (state приоритет, fallback classification-map)
+- recommended_chain (только из state)
+- chain_progress (только из state)
+- chain_completed (только из state)
+
+Закрывает дыры 2 и 3 из spec follow-up: brain-retro domainHitRate
+и chainCompletionRate теперь имеют данные.
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 4: Smoke + continuity + push (controller, Opus)
+
+**Этот шаг — НЕ для субагента.** Делается контроллером (Opus) после Task 1-3. Включает ручной smoke на живой сессии.
+
+**Files:**
+
+- Modify: `docs/observer/active-projects.md` (mark stage 3 follow-up closed).
+- Modify: `docs/observer/STATUS.md` (auto-regenerated).
+- Outside-repo: `memory/project_router_overhaul.md` (controller updates).
+- Outside-repo: `memory/MEMORY.md` (entry update).
+
+- [ ] **Step 1: Финальная регрессия в worktree**
+
+```bash
+cd <worktree>/app && npx vitest run --config vitest.config.tools.mjs 2>&1 | tail -5
+```
+
+Expected: baseline + ≥14 новых tests, всё GREEN.
+
+- [ ] **Step 2: gitleaks**
+
+```bash
+./bin/gitleaks.exe detect --no-banner --redact 2>&1 | tail -3
+```
+
+Expected: `0 leaks`.
+
+- [ ] **Step 3: Update `docs/observer/active-projects.md`**
+
+В разделе про router overhaul изменить статус этапа 3 — поставить пометку «follow-up 3 dырs закрыт <дата>».
+
+Если файла или раздела нет — пропустить (он необязательный); сделать вместо этого commit-pointer в Memory.
+
+- [ ] **Step 4: Regenerate STATUS.md**
+
+```bash
+node tools/status-md-generator.mjs
+```
+
+- [ ] **Step 5: Commit continuity**
+
+```bash
+git add docs/observer/active-projects.md docs/observer/STATUS.md
+git commit -m "docs(continuity): stage 3 follow-up закрыт — 3 fixes + STATUS regen
+
+UTF-8 + recommended_node + chain_progress теперь работают.
+Финальная регрессия: <X>f / <Y>t GREEN. gitleaks 0.
+
+Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>"
+```
+
+- [ ] **Step 6: Push на main (FF)**
+
+```bash
+git push origin feat/router-stage3-three-fixes:main
+```
+
+Expected: FF успешно, без force.
+
+Если push отклонён (origin/main ушёл вперёд) — pre-flight, rebase на свежий origin/main, повторить.
+
+- [ ] **Step 7: Memory update (outside-repo, controller-only)**
+
+Обновить `memory/project_router_overhaul.md` (или эквивалент): добавить запись «24.05 follow-up — 3 fixes pushed `<sha>`».
+Обновить `MEMORY.md` если строка ссылается на router overhaul.
+
+- [ ] **Step 8: LIVE smoke test (ручной шаг — НЕ для субагента)**
+
+После push'а — рестарт Claude Code; в новой сессии:
+
+1. Прислать русский размытый промпт: «проверь как сторож обрабатывает финансовые задачи клиента».
+2. После завершения turn'а — открыть `~/.claude/runtime/router-state-<новая-sessionId>.json`. Проверить: в `classification.reasoning` — читаемая кириллица (если Layer 2 эскалировал), без `посмотри`.
+3. Открыть последнюю строку `docs/observer/episodes-2026-05.jsonl`. Проверить:
+   - `primary_rationale.recommended_node` — не null если сторож порекомендовал.
+   - `primary_rationale.recommended_chain` — заполнен или null.
+   - `primary_rationale.chain_progress` — массив.
+   - `primary_rationale.chain_completed` — bool.
+
+Если что-то из перечисленного не работает — открыть новый план «follow-up to follow-up» (НЕ латать в этом spec).
+
+- [ ] **Step 9: Worktree cleanup**
+
+```bash
+cd <main-repo-path>
+git worktree remove .claude/worktrees/router-stage3-three-fixes
+git branch -D feat/router-stage3-three-fixes  # ветка влита в main, можно удалить
+```
+
+---
+
+## Acceptance Criteria (Definition of Done)
+
+- ✅ Helper `router-stdin-helper` создан + 4 теста GREEN.
+- ✅ Три хука используют helper.
+- ✅ Helper `observer-state-enricher` создан + 8 тестов GREEN.
+- ✅ Парсер эпизодов читает state и пишет 4 новых поля в primary_rationale.
+- ✅ Полный tools suite GREEN (baseline 456 + ≥14 новых = ≥470).
+- ✅ gitleaks 0.
+- ✅ Live smoke: русский в state без mojibake; 4 поля в новом эпизоде заполнены.
+- ✅ Push на `main` FF.
+- ✅ Worktree удалён.
+
+После DoD → 24h warn-only наблюдения с **починенным** сторожем → `/brain-retro` → решение по `enforce` (Task 9 плана Stage 3, отдельная задача).
+
+---
+
+## Self-Review
+
+### 1. Spec coverage
+
+| Spec требование | Task | Покрыто |
+|---|---|---|
+| Fix 1 — UTF-8 в trех хуках (§3.1) | Task 1.1 + 1.2 | ✅ |
+| Fix 2 — recommended_node в эпизоды (§3.2) | Task 2 + 3 | ✅ |
+| Fix 3 — chain_progress / chain_completed / recommended_chain (§3.3) | Task 2 + 3 (single helper покрывает оба) | ✅ |
+| Unit-тесты на каждый фикс (§4) | Task 1.1 (helper 4), Task 1.2 (3 placeholders), Task 2 (8), Task 3 (2) | ✅ |
+| Live smoke на русском промпте (§4 + §8) | Task 4 Step 8 | ✅ |
+| gitleaks 0 (§8) | Task 4 Step 2 | ✅ |
+| Откат ≤5 минут (§8) | Каждый task — atomic commit; revert по одному. | ✅ |
+| Push на main FF (§7) | Task 4 Step 6 | ✅ |
+| Worktree per Pravila §15.1 | Pre-flight Step 2 | ✅ |
+| Subagent последовательно (§7) | Tasks 1-3 — Sonnet; Task 4 — controller Opus | ✅ |
+
+### 2. Placeholder scan
+
+- ❌ Никаких «TBD», «TODO», «implement later», «add error handling», «similar to Task N» в коде шагов.
+- ✅ Все code blocks показывают конкретный код, который нужно вставить.
+- ⚠️ Task 1.2 Step 4 — три regression placeholder-теста минимальны. Это осознанное решение (объяснено: end-to-end stdin тест хука требует spawn subprocess, что хрупко на Windows; реальная защита — helper unit-тесты + live smoke). НЕ placeholder в смысле «дописать позже» — это финальный код этих тестов.
+
+### 3. Type consistency
+
+- `readStdinAsUtf8(stdin)` → `Promise<string>` — везде то же.
+- `readRouterState(sessionId, options?)` → `object | null` — везде то же.
+- `extractRouterFields(state)` → `{recommended_node, recommended_chain, chain_progress, chain_completed}` — везде то же.
+- `parseTranscript(text, fallbackSessionId?, options?)` — третий параметр options обратносовместим (default `{}`).
+- Поля `primary_rationale`: `recommended_node` (string|null), `recommended_chain` (string|null), `chain_progress` (array), `chain_completed` (bool) — consistent в spec + helper + parser + тестах.
+
+---
+
+## Execution Handoff
+
+**Plan complete and saved to `docs/superpowers/plans/2026-05-24-router-stage3-three-fixes.md`. Two execution options:**
+
+**1. Subagent-Driven (recommended)** — диспетчирую свежего субагента на каждую таску (Task 1, 2, 3 — Sonnet; Task 4 — controller Opus сам), review между тасками, быстрая итерация.
+
+**2. Inline Execution** — выполняю в этой сессии через `superpowers:executing-plans`, batch с checkpoint'ами на ревью.
+
+**Какой подход?**

docs/superpowers/specs/2026-05-23-billing-v2-spec-b-duplicates-design.md

@@ -0,0 +1,157 @@
+# Биллинг v2 — Спек B: политика дублей (дизайн)
+
+**Дата:** 2026-05-23
+**Статус:** дизайн утверждён заказчиком, готов к writing-plans
+**Серия:** Биллинг v2 (Спек A — балансовая модель ✅ Phase A; Спек B — дубли; Спек C — preflight + VTB)
+**Связано:** `docs/superpowers/specs/2026-05-23-billing-v2-spec-a-balance-rub-design.md`, memory `project-billing-v2`
+
+---
+
+## 1. Главное правило (governing rule)
+
+**Дедупликация лидов — ответственность ПОСТАВЩИКА (crm.bp-gr.ru), не Лидерры.**
+
+Поставщик чистит повторы в своём окне (≈30 дней). Что поставщик прислал — для Лидерры это «настоящий» лид: мы его раздаём клиентам и берём за него деньги. **Лидерра повторы по телефону НЕ фильтрует.**
+
+Единственная наша забота — **не наделать своих дублей**: одна поставка одному клиенту = ровно один оплаченный лид. При этом один лид по-прежнему можно продать **до 3 РАЗНЫХ клиентов** (модель шеринга — это норма, не дубль).
+
+Формулировка заказчика (брейнсторм 23.05.2026):
+- «убираем все фильтры! но главное нам самим не наделать дублей — нам прислал поставщик в одном экземпляре, а мы клиенту выдали 2 раза! это не касается правила: 1 лид может быть продан 3-м».
+- «если 5 клиентов заказали лиды с одного источника, то мы можем продать лид только 3-м максимум».
+
+«Смотри через это правило всё окружение» — спецификация проходит по всем местам, где есть логика дублей/дедупа, и приводит их в соответствие с правилом.
+
+### Разрез понятий (важно не путать)
+
+| Понятие | Что это | Решение |
+|---|---|---|
+| **Дубль по телефону** (антифрод) | Два разных лида с одинаковым телефоном | НЕ фильтруем — убираем (правило выше) |
+| **Технический повтор поставки** | Тот же физический лид пришёл дважды (один `vid`) | Идемпотентность по `vid` — оставляем |
+| **Наш собственный дубль** | Одна поставка → одному клиенту 2 копии | Запрещаем (новый замок в БД) |
+| **Шеринг** | Один лид → до 3 РАЗНЫХ клиентов | Норма, сохраняем (лимит теперь по клиентам) |
+| **CSV-восстановление повтора** | CSV тащит то, что уже принято вебхуком | Дедуп CSV по (телефон, проект) — оставляем |
+
+---
+
+## 2. Текущее состояние (as-is)
+
+- **`app/app/Services/DuplicateDetector.php`** — телефонный фильтр. `findMaster(tenantId, phone, now)` ищет master-сделку `(tenant_id, phone)` с `received_at >= now − 24h` и `duplicate_of_id IS NULL`. `WINDOW_HOURS = 24`.
+- Вызывается в двух местах:
+  - **`ProcessWebhookJob`** (прямой вебхук, `WebhookReceiveController` → `ProcessWebhookJob`; legacy-путь на `balance_leads`): `handle()` находит master → `markAsDuplicate()` (проставляет `duplicate_of_id`, НЕ списывает). Идемпотентность по `vid` обеспечена `webhook_dedup_keys (tenant_id, source_crm_id)`.
+  - **`RouteSupplierLeadJob`** (шеринг, `SupplierWebhookController` → `SupplierLead` → `RouteSupplierLeadJob`; новый путь на `LedgerService`): `createDealCopyForProject()` находит master → помечает дубль, без `chargeForDelivery`.
+- **`LeadRouter::matchEligibleProjects`** — отдаёт ВСЕ подходящие проекты (по всем клиентам), среди них могут быть несколько проектов одного клиента.
+- **`LeadDistributor::selectRecipients`** — `CAP = 3`, берёт 3 случайных **проекта** (не клиента). → один лид может попасть в 2+ проекта одного клиента = «наш дубль».
+- **`CsvReconcileJob`** — дедуп CSV-строк по (телефон, проект) против уже принятых `supplier_leads` за окно 2 дня; недостающие → `SupplierLead(vid=NULL, source='csv_recovery')` → `RouteSupplierLeadJob`.
+- **Схема:** `deals.duplicate_of_id BIGINT` (без FK — `deals` партиционирована), индекс `ON deals (duplicate_of_id) WHERE duplicate_of_id IS NOT NULL`; индекс `(tenant_id, phone, received_at)`.
+- **UI:** строка `duplicate_detected` в матрице уведомлений `SettingsView.vue` (8×3). Уведомление **нигде в коде не отправляется** (мёртвая строка). На карточке сделки/в списке отображения дублей нет.
+
+---
+
+## 3. Целевое состояние (to-be)
+
+### 3.1. Убираем наш антифрод-фильтр
+
+- Удаляем сервис `DuplicateDetector`.
+- В `ProcessWebhookJob`: убираем вызов `findMaster` + метод `markAsDuplicate`; новая сделка всегда списывается через `chargeNewLead`. Защита от своих дублей здесь — существующая идемпотентность по `vid` (один `vid` → одна сделка на клиента; разные `vid` с одним телефоном → обе списываются — целевое поведение).
+- В `RouteSupplierLeadJob::createDealCopyForProject`: убираем вызов `findMaster` + ветку пометки дубля.
+
+### 3.2. Раздача по клиентам, а не по проектам
+
+- Подбор получателей схлопывается **до одного проекта на клиента**: среди подходящих проектов клиента берём проект с **наибольшим остатком дневного лимита** (`COALESCE(effective_daily_limit_today, daily_limit_target) − delivered_today` по убыванию; при равенстве — `created_at, id` по возрастанию). Детерминированно.
+- Лимит `CAP = 3` теперь применяется к **разным клиентам**. 5 клиентов под один источник → ровно 3 получают лид (случайный выбор среди клиентов через инъектируемый `Randomizer`, как сейчас).
+- Реализация (на усмотрение writing-plans): `DISTINCT ON (tenant_id)` в `LeadRouter` с соответствующим `ORDER BY`, либо явное схлопывание по `tenant_id` в отдельном шаге; `LeadDistributor::selectRecipients` остаётся cap=3 поверх уже «один-на-клиента» списка.
+
+### 3.3. Замок в БД — «одна поставка одному клиенту = один раз» (ядро Варианта B)
+
+Новая таблица-замок `supplier_lead_deliveries`:
+
+| Колонка | Тип | Назначение |
+|---|---|---|
+| `supplier_lead_id` | BIGINT NOT NULL | поставка (FK на `supplier_leads(id)` ON DELETE CASCADE — `supplier_leads` не партиционирована) |
+| `tenant_id` | BIGINT NOT NULL | клиент |
+| `deal_id` | BIGINT NULL | созданная сделка (без FK — `deals` партиционирована, паттерн как `duplicate_of_id`) |
+| `created_at` | TIMESTAMPTZ NOT NULL DEFAULT now() | |
+
+- **PRIMARY KEY (`supplier_lead_id`, `tenant_id`)** — уникальность «поставка ↔ клиент».
+- **RLS** `tenant_isolation` по `tenant_id` (USING + WITH CHECK на `app.current_tenant_id`), как у прочих tenant-таблиц.
+- GRANT'ы для 5 ролей (`crm_app_user`, `crm_app_admin`, `crm_supplier_worker` BYPASSRLS, `crm_readonly`, `crm_migrator`).
+
+**Логика в `createDealCopyForProject`** (внутри той же транзакции с `SET LOCAL app.current_tenant_id`, ПОСЛЕ lock'а tenant и recheck'а лимита проекта, ДО создания сделки):
+
+1. `INSERT INTO supplier_lead_deliveries (supplier_lead_id, tenant_id, created_at) VALUES (...) ON CONFLICT (supplier_lead_id, tenant_id) DO NOTHING`.
+2. Если вставлено 0 строк → эта поставка этому клиенту уже выдавалась → `return false` (сделку не создаём, баланс не списываем).
+3. Иначе → создаём `Deal`, `UPDATE supplier_lead_deliveries SET deal_id = ...`, затем `LedgerService::chargeForDelivery` + счётчики + уведомление.
+
+**Почему ключ по `supplier_lead_id`, а не по телефону:** это НЕ возвращает телефонный фильтр. Два разных лида с одним телефоном — две разные поставки, два разных `supplier_lead_id`, обе оплачиваются. А одну и ту же поставку клиенту дважды БД физически не пропустит — даже при гонках, перезапусках задачи (`tries=3`) и CSV-восстановлении (где `vid=NULL`, но `supplier_lead_id` всегда есть).
+
+**Scope:** замок нужен только в шеринг-пути (`RouteSupplierLeadJob`). Прямой вебхук (`ProcessWebhookJob`) не идёт через `supplier_leads` и уже защищён `webhook_dedup_keys (tenant_id, vid)` — там замок не требуется.
+
+### 3.4. Чистка следов концепции дублей
+
+- Перестаём писать `deals.duplicate_of_id`. Колонку оставляем **спящей** (решение заказчика 23.05 — безопаснее; удалить можно отдельной задачей, как `balance_leads` в Спеке A Phase B). Индекс `ON deals (duplicate_of_id) WHERE NOT NULL` становится лишним — удаляем сразу.
+- Убираем строку `duplicate_detected` из матрицы уведомлений `SettingsView.vue` (8×3 → 7×3). Старый ключ в сохранённых `users.notification_preferences` JSONB просто игнорируем (не ломает).
+
+### 3.5. Что НЕ трогаем
+
+- Идемпотентность по `vid` в `ProcessWebhookJob` (`webhook_dedup_keys`).
+- Дедуп CSV по (телефон, проект) в `CsvReconcileJob` — это защита от наших дублей, в духе правила.
+- Рабочие дни (`delivery_days_mask`), дневные лимиты, проверку баланса (eligibility) — настройки клиента/биллинг, не фильтры дублей.
+
+---
+
+## 4. Крайние случаи
+
+| Случай | Поведение |
+|---|---|
+| Один телефон у РАЗНЫХ клиентов | Каждый клиент оплачивает свою копию (без изменений — корректно) |
+| Один телефон, ДВЕ разные поставки (`vid` A и B), один клиент | Обе списываются (НОВОЕ — раньше глушилось телефонным фильтром) |
+| Одна поставка, у клиента 2+ подходящих проекта | Один проект (max остаток лимита), одно списание (замок + раздача-по-клиентам) |
+| 5 клиентов под один источник | Ровно 3 получают и оплачивают |
+| CSV-восстановленный лид (`vid=NULL`) | Замок по `supplier_lead_id` работает; повторная выдача тому же клиенту не пройдёт |
+| Перезапуск задачи (`tries=3`) после частичного успеха | `processed_at` + замок не дают повторных списаний |
+| Прямой вебхук, тот же `vid` повторно | Одна сделка (идемпотентность `vid`), без изменений |
+
+---
+
+## 5. Тесты
+
+Добавить:
+- Один телефон, две разные поставки, один клиент → списано дважды.
+- Одна поставка, у клиента 2 подходящих проекта → одна сделка + одно списание; выбран проект с наибольшим остатком лимита (тай-брейк).
+- 5 клиентов eligible под один источник → ровно 3 списания у 3 разных клиентов.
+- Замок: повторный `INSERT` той же `(supplier_lead_id, tenant_id)` → `DO NOTHING`, сделка не создаётся, баланс не тронут.
+- CSV-восстановление: лид с `vid=NULL`, повторная выдача клиенту → замок срабатывает.
+
+Удалить:
+- Тесты телефонного фильтра в `ProcessWebhookJobTest`, `RouteSupplierLeadJobTest`, `RouteSupplierLeadJobBillingTest`, `SupplierLeadFlowTest`, `AutoPauseFlowTest`, `DealCreatePdLogTest` (по факту наличия — verify в writing-plans).
+
+Регрессия: Pest на затронутом коде зелёный; Larastan/Pint/ESLint clean; Vitest на `SettingsView` (после правки матрицы).
+
+---
+
+## 6. Выкатка
+
+- Изменение **одна-фазное**: код + новая аддитивная таблица `supplier_lead_deliveries`. Двухфазность (как в Спеке A с DROP COLUMN) не нужна — ничего разрушающего (`duplicate_of_id` остаётся в БД спящей).
+- `db/CHANGELOG_schema.md` — запись о новой таблице (правило проекта §4.2).
+- **Бизнес-эффект:** после выката клиенты начнут платить за то, что раньше глушилось как «дубль» — это и есть заказанная правка. Предупредить заказчика перед прод-merge.
+
+---
+
+## 7. Границы (out of scope)
+
+- `DuplicateDetector.WINDOW_HOURS` тюнинг — N/A, сервис удаляется целиком.
+- Балансовая модель, тарифные ступени — Спек A.
+- Preflight баланса, `SupplierQuotaAllocator`, VTB-эквайринг — Спек C.
+- Физическое удаление `deals.duplicate_of_id` — потенциальная отдельная cleanup-задача.
+
+---
+
+## 8. Ключевые решения брейнсторма (зафиксированы)
+
+1. Дедуп — ответственность поставщика; Лидерра телефон не фильтрует.
+2. `DuplicateDetector` удаляется полностью (Вариант B принят над «лёгким» A и отвергнутым C «помечать но списывать»).
+3. Лимит шеринга «3» = 3 РАЗНЫХ клиента; одному клиенту одна копия.
+4. Тай-брейк проекта внутри клиента — максимальный остаток дневного лимита (детерминированно).
+5. Защита от своих дублей — на уровне БД (замок `supplier_lead_deliveries`, ключ по поставке, не по телефону).
+6. `duplicate_of_id` остаётся спящей; индекс по ней удаляется.
+7. Одна-фазная выкатка.

docs/superpowers/specs/2026-05-23-router-discipline-overhaul-design.md

@@ -308,3 +308,132 @@
 ## Следующий шаг
 
 После твоего ревью этого спека → `writing-plans` skill → план для этапа 1 (справочник). После закрытия этапа 1 — план этапа 2. И так далее.
+
+---
+
+## Amendment 2026-05-24 — расширение этапа 3 (Task 0a доменная разметка + Task 0b цепочки + chain governance)
+
+**Триггер:** живой разговор с заказчиком 2026-05-24 после закрытия этапа 2. Заказчик задал два фундаментальных вопроса, не покрытых исходным дизайном этапа 3:
+
+1. **«Есть скилы для биллинга, маркетинга, безопасности — но ты их не используешь. После этапа 3 эта проблема уйдёт?»** — обнажил, что классификатор смотрит только на **тип задачи** (feature/bugfix/refactor), не на **домен** (биллинг/маркетинг/безопасность). На промпт «почини списание лида» исходный дизайн рекомендовал бы Pest, но не #62 billing-audit — рядом стоящий доменно-специальный скил.
+2. **«Как создаются/расширяются/меняются цепочки?»** — обнажил, что cepочки (L1-L16) сейчас описательные, но в этапе 3 становятся **исполняемыми** (сторож принуждает). Нужна явная governance.
+
+Решение: расширить этап 3 двумя под-тасками **перед** основными (Task 1+) и зафиксировать chain governance как часть scope.
+
+### Task 0a — Доменная разметка реестра
+
+**Цель:** научить классификатор различать домены задач, а не только типы.
+
+**Артефакты:**
+
+- **Расширение `docs/registry/nodes.yaml`:** на 30-40 специализированных скилах добавить **keyword-триггеры** доменного характера. Примеры:
+  - `#62 billing-audit` → keywords: `списание`, `биллинг`, `тариф`, `баланс`, `начисление лида`, `lead_charges`, `деньги`, `копейки`, `провенанс charge`, `csv reconcile`, `bcmath`, `bcadd`, `idempotency`.
+  - `#71 pdn-152fz-audit` → keywords: `ПДн`, `персональные данные`, `152-ФЗ`, `согласие`, `телефон лида`, `маскирование`, `pd_subject_request`, `data subject`.
+  - `#73 security-go-live` → keywords: `безопасность`, `прод`, `выход в интернет`, `go-live`, `публикация`, `attack surface`.
+  - `#74 marketing` (plugin) → keywords: `email-рассылка`, `кампания`, `контент`, `лендинг`, `реклама`, `вебинар`, `лидген`.
+  - `#76 brand-voice` → keywords: `тон бренда`, `voice`, `позиционирование`, `тональность`.
+  - `#77 marketing-ru` → keywords: `РФ-канал`, `яндекс`, `вконтакте`, `telegram`, `152-фз маркетинг`, `unisender`.
+  - `#66 laravel-backend-patterns` → keywords: `controller`, `service`, `job`, `Eloquent`, `RLS`, `partition`.
+  - И т. д. по каждому из ~30-40 доменных скилов в реестре.
+- **Расширение Sonnet prompt-template в `tools/router-classifier.mjs` Layer 2:** теперь Sonnet получает не только промпт + тип задачи, но и **список активных узлов реестра с их keyword/classification триггерами** (`{id, name, triggers}` для каждого active-узла). Sonnet возвращает не только `{task_type, micro}`, но и `recommended_node: id | null` напрямую — выбранный конкретный узел реестра.
+- **Layer 1 (regex)** так же сканирует промпт по keyword-триггерам активных узлов: совпадение с keyword'ом узла N → recommended_node=N. Layer 2 эскалация только если Layer 1 не уверен или нашёл конфликт.
+
+**Definition of done:**
+
+- На 30+ доменных скилах есть как минимум 5-10 keyword-триггеров каждый.
+- Sonnet prompt-template содержит сериализованный список узлов (компактный — id+name+top-5 keywords).
+- Unit-тесты classifier'а покрывают 20+ доменных промптов: «почини списание» → #62, «составь email-рассылку» → #74, «выход в интернет» → #73.
+
+### Task 0b — Цепочки в рекомендациях
+
+**Цель:** сторож подсказывает не только первую точку, но и всю цепочку (L1-L16).
+
+**Артефакты:**
+
+- **Sonnet возвращает дополнительное поле:** `recommended_chain: chainId | null` (L1-L16 либо null если задача одиночная).
+- **`router-prehook.mjs`** пишет в state-файл сессии не только `recommended_node`, но и `recommended_chain` + `chain_progress: []` (массив уже вызванных шагов).
+- **`router-tool-gate.mjs`** при каждом вызове Edit/Write/Bash проверяет:
+  - Если `chain_progress` не пустой — следующий ожидаемый шаг = `chain.sequence[chain_progress.length]`. Если этот шаг ещё не вызван, и пытаешься делать Edit — блок «не пропустить шаг цепочки X».
+  - Если цепочка завершена (`chain_progress.length === chain.sequence.length`) — снимает блок, пропускает Edit/Bash.
+- **`router-stop-gate.mjs`** обновляет `chain_progress`: если в текущем ходу был вызван скил из цепочки — добавляет в массив. Пишет в эпизод `chain_progress` для последующей аналитики (хватает ли цепочка от первого до последнего шага).
+
+**Definition of done:**
+
+- На 5+ типовых тестовых промптах, попадающих в L1-L16, сторож проводит через всю цепочку (live-тест на одной сессии).
+- Brain-retro analyzer +новая ось «chain completion rate» (% начатых цепочек, доведённых до конца).
+- В STATUS.md строка «Chain completion: X%».
+
+### Chain governance — как создаются/меняются цепочки
+
+**Базовое правило:** **никаких автоматических правок цепочек.** Claude НЕ имеет права самостоятельно (без явного согласия заказчика) добавлять, удалять или изменять цепочку в `docs/registry/nodes.yaml`. Цепочка в этапе 3+ становится исполняемой — её изменение меняет поведение мозга.
+
+**Три источника изменений:**
+
+1. **Явный запрос заказчика** («давай чтобы при правках биллинга всегда дёргался billing-audit потом Pest»). Claude:
+   - Подтверждает формулировку.
+   - Правит `nodes.yaml` (добавляет/меняет chain block + поле `chain_membership` на участвующих узлах).
+   - Авто-render обновляет `docs/routing-off-phase.md`.
+   - Контролёр C6 (chain-map-checker) сверяет — синхронны ли источники.
+   - Коммитит одним коммитом, ~15-30 минут.
+
+2. **Кандидат из `/brain-retro`** (раз в спринт):
+   - Аналайзер ищет в журнале повторяющиеся паттерны последовательностей скилов на одной задаче.
+   - Если паттерн встретился ≥3 раз и для него нет существующей цепочки в реестре — выдаёт кандидата с обоснованием в отчёте.
+   - Claude **обязательно показывает кандидата заказчику** перед внесением. Без явного согласия не вносит.
+   - При согласии — как в пункте 1.
+
+3. **Сигналы пропусков** (С5 missed-activations):
+   - Если на одной классификации регулярно (N>10/мес) пропускается рекомендованный узел — может быть проблема в маппинге keyword'ов (Task 0a) ИЛИ нужна цепочка с пред-условием. Решает Claude+заказчик через `/brain-retro` интерпретацию.
+
+**Защита от ошибок при правках:**
+
+- C6 chain-map-checker — синхрон источников (уже работает).
+- Авто-render `routing-off-phase.md` — невозможен дрейф между YAML и Markdown.
+- C2 cross-ref-checker — ссылки в нормативке (Pravila/CLAUDE.md/PSR_v1) на цепочки.
+- C1 l1-watcher — имена узлов в `sequence`.
+- **Новое в этапе 3:** перед коммитом изменения существующей цепочки — обязательно прогоняется **«what-if симуляция»** на исторических эпизодах последнего месяца: если бы новая цепочка работала, сколько было бы ложных блокировок? Порог: ≤5%. Превышение → не коммитим.
+
+**Откатываемость изменений цепочек:**
+
+- Каждое изменение — один коммит. `git revert <SHA>` возвращает в предыдущее состояние.
+- Если правка пошла в прод и начала мешать — снимается за 10 минут (revert + push).
+
+### Обновлённые acceptance criteria этапа 3
+
+К исходным («дисциплина ≥75%», «FP блокировок ≤20%», «$≤15/мес») добавляются:
+
+- **Domain hit rate** — % эпизодов с непустым `recommended_node` (не только `task_type`): **≥80%** на доменных промптах (биллинг/маркетинг/безопасность).
+- **Chain completion rate** — % начатых цепочек, доведённых до последнего шага: **≥60%** к концу первой недели.
+- **Доменный baseline восстановлен** — на тестовом наборе (20 заранее подготовленных доменных промптов) classifier правильно угадывает специализированный узел в **≥75% случаев**.
+
+### Что НЕ меняется amendment'ом
+
+- Исходный scope этапа 3 (classifier hybrid regex+LLM, 3 хука, escape hatch routing-tag).
+- Бюджет $≤20/мес.
+- Откатываемость ≤5 минут на отключение хуков.
+- Этапы 1, 2, 4 — без изменений.
+- Continuity-механизм (STATUS.md + memory + brain-retro).
+- Принцип «никакого изменения нормативки в этапе 3» — нормативка трогается только этапом 4.
+
+### Что переезжает «из головы Claude» в код
+
+После этапа 3 с amendment'ом:
+
+| Бывшая «процедура router-procedure.md v1.4» | Кто делает после этапа 3 |
+|---|---|
+| Шаг 1: Hard-floor §12/§14/§15 | Существующие хуки скилов + новый PreToolUse сторож |
+| Шаг 2: Классификация задачи | `router-classifier.mjs` Layer 1 regex |
+| Шаг 3: Поиск узла в реестре по триггерам | `router-classifier.mjs` Layer 2 Sonnet с доменной разметкой Task 0a |
+| Шаг 4: Проверка цепочки L1-L16 | Sonnet выдаёт `recommended_chain` (Task 0b); сторож отслеживает `chain_progress` |
+| Шаг 5: Выполнение | Сторож блокирует Edit/Bash до вызова нужного скила |
+
+**Документ `docs/router-procedure.md` v1.4 → v2.0** (это этап 4): становится описанием архитектуры, а не инструкцией к действию. v1.4 удаляется как «процедура для Claude», v2.0 пишется как «как устроен мозг» для людей.
+
+### Self-review amendment'а
+
+- ✅ Не противоречит исходному spec'у — расширяет, не заменяет.
+- ✅ Все три боли заказчика (биллинг/маркетинг/безопасность) явно адресованы Task 0a.
+- ✅ Цепочки governance явно зафиксированы — Claude не имеет права автоматически менять.
+- ✅ Откатываемость сохранена (хуки в settings.json + revert коммитов).
+- ⚠️ Расширение scope этапа 3 ≈ +3 часа работы (Task 0a 1.5ч + Task 0b 1.5ч). Принято заказчиком 24.05.
+

docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md

@@ -0,0 +1,822 @@
+# Спек C — Биллинг v2: preflight баланса + VTB-эквайринг
+
+**Дата:** 2026-05-24
+**Статус:** Design (awaiting user review)
+**Автор:** Claude Opus 4.7 (под руководством заказчика)
+**Брейнсторм:** сессия 24.05.2026
+**Триггер:** «preflight баланса перед заказом у поставщика, чтобы не заказать лишнего; VTB-эквайринг для пополнения баланса» (заказчик 23.05.2026, расширено в брейнсторме 24.05).
+
+**Часть серии из 3 спеков:**
+
+- Спек A — единый ₽-баланс (DONE на проде, [спек](2026-05-23-billing-v2-spec-a-balance-rub-design.md)).
+- Спек B — политика дублей (DONE на проде, [спек](2026-05-23-billing-v2-spec-b-duplicates-design.md)).
+- **Спек C (этот)** — preflight баланса + VTB-эквайринг.
+
+---
+
+## §1. Контекст и проблема
+
+### §1.1 Текущее поведение портала
+
+**Расчёт заказа у поставщика** ([app/app/Services/Supplier/SupplierQuotaAllocator.php:88-98](../../../app/app/Services/Supplier/SupplierQuotaAllocator.php#L88-L98)):
+
+```
+order = max(самый_большой_лимит, ceil(сумма_лимитов ÷ 3))
+```
+
+где входной массив — `daily_limit` всех eligible-на-сегодня проектов клиентов на источнике (источник = тег × субъект). Затем `order` делится между площадками B1/B2/B3 (`distributeForPlatform`, largest-remainder).
+
+**Allocator не смотрит баланс.** На вход принимает только лимиты проектов. Если у клиента нулевой баланс — он всё равно учитывается в формуле, значит портал заказывает у поставщика лиды, которые этот клиент оплатить не сможет.
+
+**Списание с клиента** ([app/app/Services/Billing/LedgerService.php](../../../app/app/Services/Billing/LedgerService.php)) происходит при доставке (`RouteSupplierLeadJob` создаёт `Deal` → `LedgerService::chargeForDelivery`). Если баланса не хватает — после Спека A не было защиты «на входе»; шёл лид, списывалось, баланс уходил в ноль.
+
+**Пополнение баланса** ([app/app/Services/Billing/BillingTopupService.php](../../../app/app/Services/Billing/BillingTopupService.php)) — MVP-stub: мгновенно кредитует `balance_rub` + пишет `balance_transactions(type='topup')`. Реальной оплаты нет. UI — `AdminTenantsController::adjustBalance` (admin-only).
+
+### §1.2 Проблемы
+
+**Префлайт:**
+
+1. **Портал переплачивает поставщику** за лиды клиентов, у которых нет денег. Это прямой убыток — закупка оплачена, а продажа не состоится.
+2. **Нет проактивной защиты при создании/изменении проектов.** Клиент может выставить лимит, который сам по себе не оплачиваем. Сейчас проблема всплывает только в момент списания.
+3. **Нет ясной коммуникации с клиентом** «у тебя баланса хватит на X лидов, ты заказал Y, нужно пополнить или сократить» — клиент узнаёт по факту остановки списания.
+
+**VTB-эквайринг:**
+
+1. **Реального пополнения нет** — `BillingTopupService` это заглушка. Деньги попадают на баланс только через ручное действие админа (`AdminTenantsController::adjustBalance`).
+2. **Нет 54-ФЗ фискализации** при ритейл-платежах (после подключения карт/СБП — обязательно).
+
+### §1.3 Триггер
+
+Заказчик 23.05.2026: «preflight баланса перед заказом у поставщика; VTB-эквайринг; аудит раздела Биллинг» → в брейнсторме 24.05 уточнено как один спек с детальной механикой preflight + полный охват трёх методов оплаты (безнал, СБП, карты).
+
+**Главный принцип** (заказчик 24.05): «**не заказать лишнего у поставщика — это убыток**».
+
+---
+
+## §2. Scope
+
+### §2.1 Что делаем
+
+**Префлайт баланса:**
+
+- Расширение `SupplierQuotaAllocator` для учёта баланса клиента (фильтрация eligible-проектов до `computeOrder`).
+- Активная проверка при создании/правке проекта в личном кабинете (диалог выбора).
+- Активная проверка перед cut-off (18:00 MSK ежедневно) — для пассивного износа баланса.
+- UI-баннер «приём приостановлен» в личном кабинете клиента.
+- Уведомления по email с правильной частотой (1 + 1д + 3д + «возобновлено»).
+- Журналирование событий заморозки/разморозки в `balance_transactions` или новой таблице.
+
+**VTB-эквайринг:**
+
+- Архитектура (интерфейс `TopupGateway` + три реализации: `BankTransfer`, `SBP`, `Card`).
+- **Полная реализация Безнала** (генерация PDF-счёта, журнал «ожидающих платежей» в админке, авто-поиск через VTB Бизнес API с подтверждением человеком, режимный переключатель «автомат / с подтверждением», часовые email-алерты).
+- **Dev-заглушки для СБП и Карт** (мгновенное подтверждение в dev/test, реальные эндпоинты VTB — после Б-1).
+- **Архитектура 54-ФЗ** через ОФД-Атол (заглушка в dev, реальная интеграция после Б-1 параллельно с СБП).
+
+### §2.2 Что НЕ делаем (явно out of scope)
+
+- **Реальное подключение VTB Acquiring и СБП** — требует реквизитов ООО (P0-блокер Б-1). Отдельные задачи после Б-1.
+- **Реальная интеграция ОФД-Атол** — параллельно с СБП после Б-1.
+- **Авто-сверка с банковской выпиской VTB** (`/api/vtb-business`) — отдельная задача после Б-1; в этом спеке только архитектурный интерфейс и ручной режим.
+- **«Отдать разморозившемуся клиенту лиды, уже купленные сегодня, через шеринг»** — отложено в Спек D (см. §8).
+- **Возвраты пополнений** (refund) — не реализуем (Спек A: «возвраты не делаем»).
+- **Recurring-платежи** (автосписание) — не реализуем.
+- **Изменение формулы `computeOrder`** — формула остаётся прежней, префлайт только фильтрует входной список.
+
+---
+
+## §3. Решение — часть 1: Префлайт баланса
+
+### §3.1 Главный инвариант
+
+**Баланс клиента никогда не уходит в минус.** Гарант — префлайт, который проверяет «хватит ли на полный дневной заказ» **до** того, как заказ уйдёт поставщику. Если хватает — клиент в заказе; если поставщик пришлёт меньше планируемого (норма), остаток баланса уходит в следующий день.
+
+### §3.2 Когда срабатывает префлайт
+
+**Одна основная точка:** ежедневный cut-off в **18:00 MSK** (включая выходные).
+
+Между cut-off и cut-off (всё внутри текущего дня) никаких внутридневных стопов нет. Лиды, заказанные у поставщика на сегодня, идут клиенту полностью, списываются с его баланса как поступают. Защита от ухода в минус — на стороне cut-off предыдущего вечера.
+
+**Дополнительные триггерные точки** (для UX в личном кабинете, не для блокировки заказа):
+
+- Создание нового проекта в UI клиента.
+- Изменение лимита существующего проекта в UI клиента.
+- Активация ранее приостановленного проекта.
+- Пополнение баланса (для авто-разморозки при следующем cut-off).
+- Снижение/удаление проекта (может вернуть в зелёную зону).
+
+### §3.3 Что значит «баланса хватает»
+
+Сравнение делается **в лидах**, не в рублях, потому что в existing-сервисе `BalanceToLeadsConverter` (от Спека A) есть прямой расчёт «сколько лидов даст баланс с учётом 7 ступеней и уже отгруженного объёма за месяц»:
+
+```php
+$capacity = $converter->convert(
+    balanceRub: $tenant->balance_rub,
+    deliveredInMonth: $tenant->delivered_in_month,
+    tiers: $activePricingTiers
+)['leads'];
+
+$requiredLeads = $tenant->projects()
+    ->where('status', 'active')
+    ->where('eligible_tomorrow', true)
+    ->sum('daily_limit');
+
+$passes = $capacity >= $requiredLeads;
+```
+
+Если `passes=true` — клиент проходит префлайт. Если `false` — не проходит.
+
+7-ступенчатый расчёт уже реализован в `BalanceToLeadsConverter::convert` (Спек A) — он сам пройдёт по ступеням, учтёт «текущую» (где сейчас клиент в накопленном объёме) и переход на следующие при росте.
+
+**NB:** проверяется на **полный лимит** проектов, не на «уже отгруженное + остаток сегодняшнего дня». Это потому, что префлайт работает один раз перед формированием заказа на завтра, а не во время выдачи.
+
+### §3.4 Что делает портал при создании/правке «перегруженного» проекта
+
+В UI клиента при попытке сохранить проект, после которого сумма `daily_limit` всех eligible-проектов превысит «потолок баланса»:
+
+**Модальный диалог** (не блокирующая ошибка):
+
+```
+Этот лимит превышает твой баланс.
+У тебя на счёте 1000₽ = 30 лидов по текущему тарифу.
+После сохранения этого проекта сумма лимитов будет 40 лидов.
+Не хватает: 10 лидов.
+
+Чтобы он начал работать, нужно одно из:
+  • Пополнить счёт (примерно 350₽ покроют 10 лидов недостачи)
+  • Поставить лимит этого проекта 0
+  • Уменьшить лимиты других проектов
+
+[Сохранить и приостановить только этот] [Поставить лимит 0] [Отмена]
+```
+
+- **«Сохранить и приостановить только этот»** — проект сохраняется с исходным лимитом, но при следующем cut-off исключается из расчёта заказа на завтра (`active_today = false`). Остальные проекты клиента работают как обычно.
+- **«Поставить лимит 0»** — проект сохраняется с лимитом 0 (фактически выключен). Не идёт в заказ.
+- **«Отмена»** — изменения отбрасываются.
+
+**Ключевое:** заморозка точечная, **только перегружающий проект**. Не «весь тенант». Это позволяет клиенту работать над созданием 20-30 проектов поэтапно, постепенно понимая «нужно столько-то ₽ для запуска всех».
+
+### §3.5 Что делает портал при пассивном износе баланса
+
+Клиент не правил проекты, просто баланс таял по дням. На очередном cut-off (18:00 MSK) выясняется, что баланс уже не покрывает все активные проекты.
+
+**Действие:**
+
+1. **Все проекты клиента** исключаются из расчёта заказа на завтра.
+2. На `tenants` устанавливается флаг `frozen_by_balance_at = now()` (новая колонка).
+3. На email клиента — письмо «Приём лидов приостановлен» (детали §3.7).
+4. В личном кабинете — красный баннер на всех страницах (детали §3.6).
+
+Клиент сам выбирает что делать в личном кабинете:
+
+- Пополнить баланс (откроет UI «Пополнение», см. часть 2).
+- Снизить лимиты на проектах (UI «Проекты»).
+- Выключить часть проектов (paused).
+- Любое сочетание.
+
+Как только сумма лимитов снова влезает в баланс (после пополнения, снижения лимита, или выключения проектов) — `frozen_by_balance_at = NULL`, баннер исчезает, отправляется письмо «Возобновлено» (если успели до 18:00 — клиент в завтрашнем заказе; если позже — в послезавтрашнем).
+
+### §3.6 UI личного кабинета клиента
+
+**Красный баннер на всех страницах** (компонент `BalanceFrozenBanner.vue`) когда `tenant.frozen_by_balance_at IS NOT NULL`:
+
+```
+🔴 Приём лидов приостановлен
+Не хватает баланса на дневной заказ. Нужно ещё 380₽ (или сократи лимиты на 10 лидов).
+[Пополнить счёт] [Перейти к проектам]
+```
+
+**Постоянная подсказка под балансом** (даже когда не в заморозке) — компонент `BalanceCapacityIndicator.vue`:
+
+```
+Баланс: 1000₽ = до 30 лидов по тарифу
+Проекты заказывают: 25 лидов в день
+✅ Хватит на ~1.2 дня
+```
+
+В состоянии «хватает на меньше 3 дней» — жёлтый цвет с подсказкой «скоро потребуется пополнение». В состоянии «не хватает» — красный (баннер выше).
+
+### §3.7 Email-уведомления
+
+**При входе в заморозку:**
+
+- T+0 (сразу) — `BalanceFrozenMail` («Приём лидов приостановлен»).
+- T+24ч (если ещё в заморозке) — `BalanceFrozenReminderMail` («Всё ещё приостановлено»).
+- T+72ч (если ещё в заморозке) — `BalanceFrozenFinalMail` («Приостановлено 3 дня»).
+- Дальше — тишина до следующего цикла (если разморозится и снова попадёт — счёт идёт заново).
+
+**При выходе из заморозки:**
+
+- T+0 — `BalanceUnfrozenMail` («Приём возобновлён»).
+
+Все письма throttled по `tenant_id` через `mail_log` (паттерн `ZeroBalancePausedMail` из Plan 4) — повторов не будет.
+
+### §3.8 Cut-off режимы синхронизации с поставщиком
+
+Сохраняем оба существующих режима (admin-переключатель уже есть):
+
+- **Онлайн-режим** (сейчас, для малого числа клиентов): любое изменение в проектах Лидерры → немедленный апдейт на сервере поставщика (`SyncSupplierProjectJob` per-project). Поставщик сохраняет, использует в своём 21:00 слепке.
+- **Batch до 18:00** (на будущее при росте): накопленные изменения уезжают одним пакетом перед 18:00 (`SyncSupplierProjectsJob` daily cron).
+
+**Префлайт работает одинаково в обоих режимах** — он только меняет, какие проекты идут в `SyncSupplierProjectJob` (исключает frozen-проекты из `active_today`). Дальше — стандартный механизм синхронизации.
+
+### §3.9 Граничные случаи
+
+| Случай | Поведение |
+|---|---|
+| Ретро-операция (CSV-импорт исторических лидов) между 18:00 и началом следующего дня списывает баланс ниже плана | Допускается, но админ предупреждается в UI «эта операция может вывести клиента в заморозку, продолжить?». Если согласился — выполняется; на следующем cut-off клиент будет в заморозке. Минусовых балансов не возникает (CSV-импорт делает обычные `lead_charges` через `LedgerService`, который остаётся защищён от минуса) |
+| Ручная правка баланса админом (`adjustBalance`) уменьшает баланс ниже плана | Аналогично — админ предупреждается, ответственность на нём. Префлайт отработает на следующем cut-off |
+| Клиент уже в минусовом балансе на момент запуска префлайт (legacy состояние) | Одноразовая artisan-команда `billing:preflight-initial-sweep` — проходит по всем тенантам, помечает `frozen_by_balance_at` где нужно, отправляет письма с пояснением «у вас активирована новая защита баланса». Запускается один раз при выкатке миграции |
+| Тарифная ступень меняется в течение дня (накопился объём) | Префлайт на 18:00 MSK использует **текущую** ступень. На завтра ступень может быть другой — но это уже зона следующего cut-off |
+| Поставщик прислал меньше планируемого (норма) | Остаток баланса клиента — экономия для следующего дня. Никаких корректировок |
+| Клиент пополнил после 18:00 | В сегодня-в-21:00-слепок поставщика не успевает, но в личном кабинете тут же «Возобновлено». В следующий вечерний cut-off — в заказ на послезавтра |
+
+### §3.10 Шеринг с другими клиентами на том же источнике
+
+**Формула** (живёт в `SupplierQuotaAllocator::computeOrder`, [код](../../../app/app/Services/Supplier/SupplierQuotaAllocator.php#L88-L98)):
+
+```
+order = max(самый_большой_лимит, ceil(сумма_лимитов ÷ 3))
+```
+
+Префлайт **не меняет формулу**, а **фильтрует входной массив `daily_limits`** — выкидывает клиентов, не прошедших проверку.
+
+**Эффект зависит от того, кого выкинули:**
+
+| Кто выкинут | `max(...)` | Заказ у поставщика | Маржа портала |
+|---|---|---|---|
+| Крупнейший клиент группы | Падает (новый крупнейший меньше) | **Уменьшается** — реальная экономия закупки | Падает |
+| Любой некрупный | Не меняется | **Не меняется** | Падает на лимит выкинутого |
+
+**Гарантии:**
+
+1. **Никогда не вредит** другим клиентам в группе — их лимиты неприкосновенны.
+2. **Никогда не заказывает у поставщика на «бедного»** — он исключён из формулы.
+3. **Реальная экономия закупки** только при выкидывании крупнейшего. В остальных случаях защищаемся от логической ошибки «заказали лиды, оплатить которые некому» без эффекта на закупку.
+
+### §3.11 Журналирование
+
+При каждом срабатывании префлайт (заморозка / разморозка) — строка в новой таблице `balance_freeze_log`:
+
+```sql
+CREATE TABLE balance_freeze_log (
+    id BIGSERIAL PRIMARY KEY,
+    tenant_id BIGINT NOT NULL REFERENCES tenants(id),
+    event_type VARCHAR(20) NOT NULL,  -- 'frozen' | 'unfrozen' | 'project_overload_dialog'
+    triggered_by VARCHAR(30) NOT NULL,  -- 'cutoff_18msk' | 'project_update' | 'topup'
+    balance_rub_at_event DECIMAL(12,2) NOT NULL,
+    required_rub_at_event DECIMAL(12,2) NOT NULL,
+    leads_capacity INTEGER NOT NULL,
+    total_daily_limit INTEGER NOT NULL,
+    details JSONB,  -- какие проекты, какая причина, и т.д.
+    created_at TIMESTAMP DEFAULT now()
+);
+```
+
+RLS — `tenant_isolation` стандартный (как для большинства tenant-таблиц). Append-only через `audit_block_mutation` триггер. Цель — видеть в админке историю «когда и почему клиент попадал в заморозку».
+
+---
+
+## §4. Решение — часть 2: VTB-эквайринг (3 метода оплаты)
+
+### §4.1 Архитектурный подход
+
+**Интерфейс `TopupGatewayInterface`** + **три реализации**:
+
+| Реализация | Метод оплаты | Статус в этом спеке |
+|---|---|---|
+| `BankTransferGateway` | Безнал (счёт PDF) | **Полная реализация** |
+| `SbpGateway` | СБП | Архитектура + dev-заглушка; реальный код после Б-1 |
+| `CardGateway` | Карта | Архитектура + dev-заглушка; реальный код после Б-1 |
+
+`BillingTopupService` рефакторится — становится оркестратором:
+
+```php
+public function initiateTopup(
+    int $tenantId,
+    string $amountRub,
+    int $userId,
+    string $method  // 'bank_transfer' | 'sbp' | 'card'
+): TopupSession {
+    $gateway = $this->resolveGateway($method);
+    return $gateway->createSession($tenantId, $amountRub, $userId);
+}
+```
+
+И отдельно обработка callback'а:
+
+```php
+public function confirmPayment(string $providerRef, ?int $adminUserId): BalanceTransaction {
+    // gateway-agnostic кредит баланса + запись audit
+}
+```
+
+### §4.2 Состояния платежа
+
+Новая таблица `topup_sessions`:
+
+```sql
+CREATE TABLE topup_sessions (
+    id BIGSERIAL PRIMARY KEY,
+    tenant_id BIGINT NOT NULL REFERENCES tenants(id),
+    user_id BIGINT REFERENCES users(id),
+    method VARCHAR(20) NOT NULL,  -- 'bank_transfer' | 'sbp' | 'card'
+    amount_rub DECIMAL(12,2) NOT NULL,
+    provider_ref VARCHAR(100),  -- номер счёта / VTB transaction ID / SBP QR ID
+    status VARCHAR(20) NOT NULL DEFAULT 'pending',  -- 'pending' | 'matched' | 'confirmed' | 'failed' | 'expired'
+    matched_at TIMESTAMP,  -- когда нашли соответствие (только bank_transfer)
+    confirmed_at TIMESTAMP,  -- когда человек подтвердил (или авто)
+    confirmed_by INTEGER REFERENCES users(id),  -- кто подтвердил (NULL = автомат)
+    failed_reason VARCHAR(500),
+    metadata JSONB,
+    created_at TIMESTAMP DEFAULT now(),
+    updated_at TIMESTAMP DEFAULT now()
+);
+```
+
+RLS — `tenant_isolation` для tenant_id; админ видит все через `crm_app_admin` роль.
+
+После `status='confirmed'` — кредит баланса (`BalanceTransaction` с `type='topup'` и ссылкой на `topup_session_id`).
+
+### §4.3 Безнал — полная реализация
+
+**Шаг 1: Клиент инициирует пополнение**
+
+В личном кабинете → Биллинг → «Пополнить счёт» → выбор метода «Безнал (счёт)» → ввод суммы → кнопка «Сформировать счёт».
+
+Backend: `BankTransferGateway::createSession` — создаёт `topup_sessions(method='bank_transfer', status='pending')`, генерирует уникальный номер счёта (`SCH-{YYYY}-{tenant_id}-{seq}`).
+
+**Шаг 2: Генерация PDF-счёта**
+
+Шаблон `resources/views/pdf/invoice.blade.php`:
+
+- Шапка: реквизиты Лидерры (название ООО, ИНН, КПП, юр. адрес, расчётный счёт VTB).
+- Реквизиты плательщика (тенант): название, ИНН, КПП, юр. адрес — берутся из новых полей `tenants.legal_entity_*` (см. §4.7).
+- Назначение платежа: «Оплата лидов по договору публичной оферты, счёт №SCH-2026-15-001 от 24.05.2026».
+- Сумма: NNNN,NN ₽ (БЕЗ НДС или С НДС в зависимости от системы налогообложения Лидерры — `tax_regime` в admin-settings; для УСН 6% — без НДС).
+- Срок оплаты: 5 рабочих дней.
+
+Возвращается клиенту как файл скачивания. URL `/api/billing/topup-sessions/{id}/invoice.pdf`.
+
+**Шаг 3: Авто-поиск платежа в VTB Бизнес API**
+
+Артизан-команда `billing:vtb-statement-sync --since=N` (cron: каждые 15 минут после Б-1; в dev — manual только):
+
+- Запрашивает выписку у VTB Бизнес API за период N часов.
+- Для каждой входящей транзакции ищет в `назначение_платежа` номер счёта (`SCH-YYYY-...`).
+- При совпадении — `topup_sessions(provider_ref=...).status = 'matched'`, `matched_at = now()`.
+
+В dev/test (когда нет реальных VTB-реквизитов) — режим симуляции: команда `billing:vtb-statement-simulate {session_id} --amount=N` для ручного тестирования флоу.
+
+**Шаг 4: Подтверждение человеком или автомат (admin setting)**
+
+В админке `Биллинг → Настройки` — переключатель:
+
+- **«С подтверждением» (по умолчанию):** платёж в статусе `matched` ждёт ручного клика «Подтвердить зачисление». До этого баланс не растёт.
+- **«Автомат»:** платёж в статусе `matched` сразу переводится в `confirmed`, баланс растёт.
+
+В админке `Биллинг → Ожидающие платежи` — список платежей в статусах `matched` и `pending`:
+
+```
+[SCH-2026-15-001] ООО Альфа, 100000₽, найден 24.05 15:42 [Подтвердить] [Отклонить]
+[SCH-2026-22-003] ИП Иванов, 50000₽, не найден (3 дня)   [Найти вручную] [Отменить]
+```
+
+Кнопка «Подтвердить» → `confirmPayment(...)` → кредит баланса + `BalanceTransaction(type='topup', topup_session_id=...)`.
+
+**Шаг 5: Часовые email-алерты админу (только в режиме «С подтверждением»)**
+
+Cron `billing:notify-pending-confirmations` каждый час:
+
+- Если есть платежи в статусе `matched`, не подтверждённые — отправить email админу (`admin_emails` из settings, по умолчанию `eclips9363@gmail.com`).
+- Throttle: один email в час суммарно.
+
+### §4.4 СБП — архитектура + dev-заглушка
+
+**Реализация в этом спеке:**
+
+- `SbpGateway::createSession` — в dev/test возвращает фейковый QR-код PNG (`data:image/png;base64,...`) и через 5 секунд (фоновый job) переводит сессию в `confirmed`. Это позволяет полностью отлаживать UI и пост-обработку.
+- В prod (после Б-1): зовёт реальный VTB SBP API, получает QR-код / платёжную ссылку, регистрирует callback на `/api/billing/vtb-sbp/callback`.
+
+**Реализация после Б-1 (отдельная задача):**
+
+- Боевая интеграция VTB SBP API (REST + signed callbacks).
+- ОФД-Атол для 54-ФЗ чеков (см. §4.6).
+- Боевые секреты — в YC Lockbox (SEC-5).
+
+### §4.5 Карты — архитектура + dev-заглушка
+
+**Реализация в этом спеке:**
+
+- `CardGateway::createSession` — в dev/test возвращает редирект-URL на локальную страницу `/dev-mock-vtb-acquiring/{session_id}` с двумя кнопками «Симулировать успех» / «Симулировать ошибку». Клик → переводит сессию в `confirmed` или `failed`.
+- В prod (после Б-1): редирект на боевую страницу VTB internet-эквайринга с 3DS Secure.
+
+**Реализация после Б-1 (отдельная задача):**
+
+- Боевая интеграция VTB Acquiring API.
+- 3DS Secure (обязательно для всех карт).
+- Обработка chargeback'ов.
+- ОФД-Атол для 54-ФЗ чеков.
+
+### §4.6 54-ФЗ фискализация
+
+**Текущее состояние:** не реализовано. Раздел подсветить в архитектуре, реальный код — после Б-1 параллельно с СБП.
+
+**Когда нужен чек:**
+
+| Метод оплаты | Чек 54-ФЗ |
+|---|---|
+| Безнал (юр→юр) | **Не нужен** (статья 1.2 п.9 закона) |
+| СБП | **Обязателен** (B2C ритейл-платёж) |
+| Карта | **Обязателен** (B2C ритейл-платёж) |
+
+**Архитектура** (заглушка в этом спеке):
+
+```php
+interface FiscalReceiptProvider {
+    public function issueReceipt(TopupSession $session): FiscalReceipt;
+}
+```
+
+Реализации:
+
+- `AtolOnlineFiscalProvider` — реальная интеграция (после Б-1).
+- `NoOpFiscalProvider` — для безнала (возвращает «чек не требуется по 54-ФЗ»).
+- `DevMockFiscalProvider` — для dev/test (фейковый чек ID).
+
+### §4.7 Реквизиты тенанта
+
+Новые поля в `tenants` (для счёта-фактуры):
+
+```sql
+ALTER TABLE tenants ADD COLUMN legal_entity_name VARCHAR(255);    -- "ООО Альфа" или "ИП Иванов Иван"
+ALTER TABLE tenants ADD COLUMN legal_entity_inn VARCHAR(12);
+ALTER TABLE tenants ADD COLUMN legal_entity_kpp VARCHAR(9);       -- NULL для ИП
+ALTER TABLE tenants ADD COLUMN legal_entity_address TEXT;
+ALTER TABLE tenants ADD COLUMN legal_entity_form VARCHAR(20);     -- 'OOO' | 'IP' | 'OAO' | 'ZAO' | 'OTHER'
+```
+
+В личном кабинете клиента → Настройки → «Реквизиты юр. лица» — форма для заполнения. **Обязательны** для безнала (без них счёт PDF не выписывается); для СБП/карт — опционально (но желательно).
+
+Валидация ИНН (контрольное число), КПП (формат), форма юрлица — стандартными правилами laravel.
+
+### §4.8 Минимум/максимум суммы пополнения
+
+| Метод | Минимум | Максимум |
+|---|---|---|
+| Безнал | 1000 ₽ | 1 000 000 ₽ |
+| СБП | 100 ₽ | 600 000 ₽ (лимит СБП) |
+| Карта | 100 ₽ | 100 000 ₽ за одну транзакцию |
+
+Конфигурация в `config/billing.php` (settable).
+
+---
+
+## §5. Архитектура изменений
+
+### §5.1 Карта изменений по слоям
+
+| Слой | Что |
+|---|---|
+| **БД** | `tenants` (+`frozen_by_balance_at`, +5 `legal_entity_*` полей); новые таблицы `balance_freeze_log`, `topup_sessions` |
+| **Бэк-сервисы** | `SupplierQuotaAllocator` (новый pre-filter pipeline); `BalancePreflightService` (новый, проверка платёжеспособности); `BillingTopupService` (рефакторинг под gateway pattern); `TopupGatewayInterface` + 3 реализации; `FiscalReceiptProvider` + 3 реализации |
+| **Бэк-джобы** | `BalancePreflightSweepJob` (cron @18:00 MSK ежедневно); `BalanceFrozenNotificationJob` (event-driven при заморозке); `VtbStatementSyncJob` (cron @ каждые 15 мин); `NotifyPendingConfirmationsJob` (cron hourly) |
+| **Бэк-команды** | `billing:preflight-sweep`, `billing:vtb-statement-sync`, `billing:notify-pending-confirmations`, `billing:preflight-initial-sweep` (one-time migration), `billing:vtb-statement-simulate` (dev only) |
+| **Бэк-контроллеры** | `BillingController` (+endpoints: `/api/billing/topup/initiate`, `/api/billing/topup-sessions/{id}`, `/api/billing/topup-sessions/{id}/invoice.pdf`); `ProjectController` (preflight check + 409 response с диалогом); `Admin/PendingTopupsController` (новый); `Admin/BillingSettingsController` (новый, для переключателя auto/manual) |
+| **Бэк-Mail** | `BalanceFrozenMail`, `BalanceFrozenReminderMail`, `BalanceFrozenFinalMail`, `BalanceUnfrozenMail`, `PendingConfirmationsAdminMail` |
+| **Фронт-компоненты** | `BalanceFrozenBanner.vue`, `BalanceCapacityIndicator.vue`, `ProjectLimitOverloadDialog.vue`, `TopupMethodPicker.vue`, `BankTransferInvoiceView.vue`, `SbpQrCodeView.vue`, `CardRedirectView.vue`, `PendingPaymentsAdminView.vue`, `BillingSettingsAdminView.vue`, `LegalEntityForm.vue` (в Настройки) |
+| **Фронт-views** | `TopupView.vue` (новый, обёртка с переключателем methods); `BillingFrozenInfoView.vue` |
+| **Pinia** | `billingStore` (расширение под topup-сессии); `tenantStore` (frozen-флаг) |
+
+### §5.2 Sequence-диаграмма префлайт на cut-off
+
+```
+18:00 MSK Cron
+   │
+   ├── BalancePreflightSweepJob::handle()
+   │     │
+   │     ├── для каждого tenant:
+   │     │     │
+   │     │     ├── BalancePreflightService::evaluate(tenant)
+   │     │     │     │
+   │     │     │     ├── читает projects (active=true, eligible_tomorrow=true)
+   │     │     │     ├── требуемые лиды = Σ daily_limit
+   │     │     │     ├── ёмкость лидов = BalanceToLeadsConverter::convert(balance, delivered, tiers)['leads']
+   │     │     │     ├── сравнивает: passes = capacity >= required
+   │     │     │     └── возвращает PreflightResult { passes: bool, required_leads, capacity_leads, deficit_leads }
+   │     │     │
+   │     │     ├── если passes изменился:
+   │     │     │     │
+   │     │     │     ├── tenant.frozen_by_balance_at = NULL | now()
+   │     │     │     ├── balance_freeze_log.insert(event_type='frozen' | 'unfrozen')
+   │     │     │     ├── dispatch(BalanceFrozenMail | BalanceUnfrozenMail)
+   │     │     │     │
+   │     │     │     └── (если frozen) для каждого projects:
+   │     │     │           projects.preflight_blocked_at = now()  (новая колонка)
+   │     │     │
+   │     │     └── (если unfrozen) projects.preflight_blocked_at = NULL для всех
+   │     │
+   │     └── для следующего tenant...
+   │
+18:05 MSK (после префлайт) — обычный SyncSupplierProjectsJob запускается
+   │
+   ├── SupplierQuotaAllocator::allocate(eligible_projects)
+   │     │
+   │     ├── фильтр eligible_projects: only WHERE preflight_blocked_at IS NULL
+   │     ├── computeOrder([daily_limit, ...]) (формула не меняется)
+   │     └── distributeForPlatform(order, [B1, B2, B3])
+   │
+   └── SyncSupplierProjectJob (per project) → отправка лимитов поставщику
+```
+
+### §5.3 Sequence-диаграмма пополнения (Безнал)
+
+```
+Клиент в личном кабинете
+   │
+   ├── Кнопка "Пополнить счёт"
+   │
+   └── TopupMethodPicker → выбор "Безнал (счёт)"
+         │
+         └── Ввод суммы → "Сформировать счёт"
+               │
+               └── POST /api/billing/topup/initiate { method: 'bank_transfer', amount_rub: '100000.00' }
+                     │
+                     ├── BillingTopupService::initiateTopup(...)
+                     │     │
+                     │     └── BankTransferGateway::createSession(...)
+                     │           │
+                     │           ├── создание topup_sessions(status='pending', provider_ref='SCH-2026-15-001')
+                     │           └── возвращает { session_id, invoice_url: '/api/billing/topup-sessions/15001/invoice.pdf' }
+                     │
+                     └── Редирект клиента на invoice_url → скачивание PDF
+
+Клиент оплачивает в своём банк-клиенте
+   │
+   └── Деньги поступают на расчётный счёт VTB Лидерры (за ~часы)
+
+VtbStatementSyncJob (каждые 15 минут)
+   │
+   ├── VTB Business API → выписка
+   │
+   └── для каждой входящей транзакции:
+         │
+         ├── парсинг назначения платежа → ищем SCH-YYYY-tenant-seq
+         │
+         └── если совпадение найдено + сумма совпадает:
+               │
+               ├── topup_sessions.status = 'matched'
+               ├── matched_at = now()
+               │
+               └── (если admin-setting auto_confirm=true):
+                     │
+                     ├── BillingTopupService::confirmPayment(provider_ref, NULL)
+                     │     │
+                     │     ├── topup_sessions.status = 'confirmed'
+                     │     ├── tenant.balance_rub += amount_rub  (bcadd)
+                     │     └── BalanceTransaction.create(type='topup', topup_session_id=...)
+                     │
+                     └── (если auto_confirm=false): ждёт ручного подтверждения
+
+NotifyPendingConfirmationsJob (каждый час)
+   │
+   └── если есть topup_sessions(status='matched') не подтверждённые:
+         │
+         └── PendingConfirmationsAdminMail → admin email
+
+Админ в кабинете
+   │
+   └── Биллинг → Ожидающие платежи → [Подтвердить SCH-2026-15-001]
+         │
+         └── POST /api/admin/topup-sessions/15001/confirm
+               │
+               └── BillingTopupService::confirmPayment(provider_ref, admin_user_id)
+                     │
+                     ├── topup_sessions.status = 'confirmed'
+                     ├── tenant.balance_rub += amount_rub
+                     ├── BalanceTransaction.create(type='topup', confirmed_by=admin_user_id)
+                     │
+                     └── BalancePreflightService::evaluate(tenant)  ← может разморозить!
+                           │
+                           └── если frozen_by_balance_at был NOT NULL и теперь passes:
+                                 │
+                                 ├── tenant.frozen_by_balance_at = NULL
+                                 ├── balance_freeze_log.insert(event_type='unfrozen', triggered_by='topup')
+                                 └── BalanceUnfrozenMail отправляется
+```
+
+### §5.4 Изменения в `SupplierQuotaAllocator`
+
+Минимальное и неинвазивное — добавление одного шага в caller (`SyncSupplierProjectsJob`):
+
+**До:**
+
+```php
+$eligibleProjects = $this->projectsQuery->getEligibleForToday($targetDate);
+$dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
+```
+
+**После:**
+
+```php
+$eligibleProjects = $this->projectsQuery->getEligibleForToday($targetDate);
+
+// NEW: фильтр по frozen-флагу tenant
+$eligibleProjects = $eligibleProjects->reject(
+    fn($p) => $p->tenant->frozen_by_balance_at !== null
+);
+
+$dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
+```
+
+`SupplierQuotaAllocator` сам не меняется — он pure-функция, принимает то что дали. Это важно для тестируемости (формула не сломалась).
+
+---
+
+## §6. Сценарии (end-to-end)
+
+### §6.1 Префлайт — пассивный износ
+
+**Воскресенье 00:00.** Клиент с балансом 1000₽ = 30 лидов (tier 3, цена ~33₽/лид). Проекты заказывают 25/день. Запас 5.
+
+**Воскресенье 18:00.** Cron `BalancePreflightSweepJob`:
+
+- `BalancePreflightService::evaluate(client)` → `passes=true` (хватает на 25).
+- `frozen_by_balance_at` остаётся `NULL`.
+
+**Воскресенье 18:05.** `SyncSupplierProjectsJob` — все 25 идут в заказ поставщику. Поставщик в 21:00 берёт слепок.
+
+**Понедельник.** В течение дня партии лидов приходят, клиент получает все 25, баланс падает до 0. Никаких внутридневных стопов.
+
+**Понедельник 18:00.** Cron snova:
+
+- `evaluate(client)` → `passes=false` (0₽ ≠ 25 лидов).
+- `frozen_by_balance_at = now()`.
+- `balance_freeze_log.insert(event='frozen', triggered_by='cutoff_18msk')`.
+- `BalanceFrozenMail` отправляется.
+
+**Понедельник 18:05.** `SyncSupplierProjectsJob` — этот клиент исключён, формула пересчитывается для остальных в группе на источнике.
+
+**Понедельник 19:00.** Клиент видит письмо, пополняет на 1000₽ через безнал PDF → 1-2 дня ждёт зачисления через сверку. Или через СБП/карту (после Б-1) — мгновенно.
+
+**Вторник 14:00.** Безнал подтверждён админом (или авто) → баланс 1000₽. `confirmPayment` зовёт `evaluate` → `passes=true`. `frozen_by_balance_at = NULL`. `BalanceUnfrozenMail`. В личном кабинете баннер исчезает.
+
+**Вторник 18:00.** Cron snova — клиент в заказе на среду. Со среды получает лиды.
+
+### §6.2 Префлайт — активная нехватка при создании проекта
+
+**Клиент с балансом 1000₽ = 30 лидов.** Имеет 3 проекта по 10 = 30 лимит. Всё впритык.
+
+**Клиент создаёт 4-й проект с лимитом 20.** Бэк (`ProjectController::store`) делает превью-префлайт:
+
+- `Σ daily_limit (после сохранения) = 50` лидов
+- `capacity = BalanceToLeadsConverter::convert(1000₽, delivered, tiers)['leads'] = 30` лидов
+- `30 < 50` → недостаток 20 лидов
+
+Возвращает HTTP 409 с body:
+
+```json
+{
+  "error": "balance_insufficient",
+  "current_balance_rub": "1000.00",
+  "current_capacity_leads": 30,
+  "would_be_required_leads": 50,
+  "deficit_leads": 20
+}
+```
+
+Фронт показывает диалог `ProjectLimitOverloadDialog.vue`:
+
+```
+Этот лимит превышает баланс.
+У тебя 1000₽ = 30 лидов по текущему тарифу.
+После сохранения нужно 50 лидов.
+Не хватает: 20 лидов.
+
+Чтобы он начал работать, нужно одно из:
+  • Пополнить счёт (примерно 700₽ покроют 20 лидов недостачи)
+  • Поставить лимит этого проекта 0
+  • Уменьшить лимиты других проектов
+
+[Сохранить и приостановить этот] [Поставить лимит 0] [Отмена]
+```
+
+«Примерно 700₽» — оценка через обратное преобразование: добавляем баланс шагами по 100₽ и смотрим, при какой сумме `capacity` вырастет до 50 (фронт делает это локально, не дёргая бэк).
+
+- Если «Сохранить и приостановить» → POST `/api/projects` с флагом `force_save_blocked=true`. Создаётся проект с `preflight_blocked_at = now()`. Остальные 3 проекта работают.
+- Если «Поставить лимит 0» → POST `/api/projects` с `daily_limit = 0`. Создаётся, не идёт в заказ.
+- Если «Отмена» → форма закрывается, ничего не сохраняется.
+
+### §6.3 VTB — Безнал end-to-end (после Б-1)
+
+1. Клиент → Биллинг → «Пополнить 100000₽» → выбор «Безнал».
+2. Backend создаёт `topup_sessions(status='pending', provider_ref='SCH-2026-15-001')`.
+3. Скачивает PDF-счёт с реквизитами Лидерры (ИНН, КПП, р/с) и своими реквизитами.
+4. Идёт в свой банк-клиент, оплачивает.
+5. Деньги в течение нескольких часов приходят на р/с Лидерры в VTB.
+6. `VtbStatementSyncJob` за 15 минут после прихода находит транзакцию с «SCH-2026-15-001» в назначении, ставит `status='matched'`.
+7. Часовой `NotifyPendingConfirmationsJob` шлёт админу email «есть 1 непровер. платёж».
+8. Админ в админке → Биллинг → Ожидающие платежи → видит запись → «Подтвердить» → 100000₽ кредитуется, `BalanceTransaction` пишется.
+9. Если клиент был в `frozen_by_balance_at` — `evaluate` пересчитывает → разморозка → `BalanceUnfrozenMail`.
+
+В dev-режиме шаг 6 заменяется на `billing:vtb-statement-simulate 15001 --amount=100000` (manual).
+
+---
+
+## §7. Известные открытые вопросы
+
+1. **Учёт перехода ступени за день.** `BalanceToLeadsConverter::convert` уже учитывает «текущую ступень и переход на следующие при росте объёма». Граничный случай «дневной заказ переваливает за порог ступени, после чего цена меняется» автоматически обрабатывается — `convert` итерирует по ступеням и считает разные цены для разных кусков. **Не нужна дополнительная логика.**
+2. **Что если клиент имеет несколько менеджеров с email?** Письмо `BalanceFrozenMail` — на главный email тенанта (`tenant.email`) или на всех users этого тенанта? **Решение по умолчанию:** на главный email тенанта (как сейчас в `ZeroBalancePausedMail`).
+3. **Формат номера счёта** `SCH-YYYY-{tenant_id}-{seq}` — гарантирована уникальность через `(tenant_id, seq)` сериал. Если переходим на ОФД-Атол, может потребоваться другой формат. **Решение:** сейчас наш формат, при подключении ОФД — модернизируем (отдельная задача).
+4. **Локализация PDF-счёта** — пока только русский. После Б-1 при необходимости — английский / казахский (если расширим географию).
+5. **Reconcilation между `topup_sessions` и `balance_transactions`** — есть ли инвариант «каждая completed-сессия = одна balance_transaction»? Да, должен быть — добавить foreign key + unique constraint.
+
+---
+
+## §8. Future enhancements (Спек D и далее)
+
+1. **«Отдать разморозившемуся клиенту лиды, уже купленные сегодня, через шеринг»** (см. §3.10) — бизнес: разморозившийся в 15:00 клиент мог бы получить лиды, поступающие после 15:00 по его источнику, если есть свободные слоты шеринга. Технически — модификация `RouteSupplierLeadJob` + расширение eligible-кандидатов после mid-day events. Реальная частота сценария = низкая; делать после месяца сбора статистики.
+2. **«Приоритет шеринга 4+ клиентов — те, у кого хватало баланса на момент cut-off»** — снимок «утренней платёжеспособности» сохраняется, при шеринге сверяется. Полезно при переполненном шеринге (>3 покупателей конкурируют за лид).
+3. **Авто-сверка с VTB Бизнес API** — реальная интеграция (не заглушка), боевой `VtbStatementSyncJob` с retry и подписью.
+4. **Recurring-платежи** — автосписание с карты раз в месяц (отдельная фича, требует UX-проработки).
+5. **Возвраты** (refund) — если бизнес-нужда подтвердится. Сейчас Спек A явно говорит «не делаем».
+6. **Мульти-валютность** — если выходим на казахский / белорусский рынок (KZT/BYN).
+
+---
+
+## §9. Связи
+
+- [Спек A](2026-05-23-billing-v2-spec-a-balance-rub-design.md) — единый ₽-баланс, `BalanceToLeadsConverter` (используется в этом спеке).
+- [Спек B](2026-05-23-billing-v2-spec-b-duplicates-design.md) — `supplier_lead_deliveries` lock-таблица, шеринг до 3 клиентов на лид (контекст для §3.10).
+- [App allocator](../../../app/app/Services/Supplier/SupplierQuotaAllocator.php) — формула заказа, остаётся без изменений.
+- [App ledger](../../../app/app/Services/Billing/LedgerService.php) — списания с баланса, остаётся без изменений.
+- [App topup](../../../app/app/Services/Billing/BillingTopupService.php) — рефакторится в этом спеке.
+- [App webhook routing](../../../app/app/Jobs/Supplier/SyncSupplierProjectsJob.php) — добавляется фильтр frozen-проектов.
+- [App project controller](../../../app/app/Http/Controllers/Api/ProjectController.php) — добавляется preflight check.
+- [Pravila §13.2](../../../docs/Pravila_raboty_Claude_v1_1.md) — финансовая нормативка.
+- [CLAUDE.md §6](../../../CLAUDE.md) — текущая фаза.
+- [project_billing_v2 memory](../../../../C:/Users/Administrator/.claude/projects/c---------------------crm-------------/memory/project_billing_v2.md) — серия из 3 спеков.
+- [SEC-3, SEC-5 (memory)](../../../../C:/Users/Administrator/.claude/projects/c---------------------crm-------------/memory/project_server_hardening.md) — блокеры YC Lockbox для секретов VTB.
+
+---
+
+## §10. План реализации (overview)
+
+Детальный план — отдельным документом через `superpowers:writing-plans` после утверждения этого спека.
+
+Предварительная разбивка на фазы (для оценки масштаба):
+
+**Phase 1 — Префлайт баланса** (~5-7 задач):
+
+- Миграция БД (`frozen_by_balance_at`, `preflight_blocked_at`, `balance_freeze_log`).
+- `BalancePreflightService` (pure) + тесты.
+- `BalancePreflightSweepJob` + cron.
+- 4 Mailable + throttle.
+- `BalanceFrozenBanner.vue` + `BalanceCapacityIndicator.vue`.
+- `ProjectController` preflight check + 409 response.
+- `ProjectLimitOverloadDialog.vue`.
+- Фильтр в `SyncSupplierProjectsJob`.
+- One-time `billing:preflight-initial-sweep`.
+
+**Phase 2 — Безнал PDF + админка** (~6-8 задач):
+
+- Миграция БД (`legal_entity_*` в `tenants`, `topup_sessions`).
+- `TopupGatewayInterface` + `BankTransferGateway`.
+- PDF-генерация (`resources/views/pdf/invoice.blade.php`).
+- `LegalEntityForm.vue` + валидация.
+- `TopupView.vue` + `TopupMethodPicker.vue` + `BankTransferInvoiceView.vue`.
+- `Admin/PendingTopupsController` + `PendingPaymentsAdminView.vue`.
+- `Admin/BillingSettingsController` (auto/manual переключатель).
+- `VtbStatementSyncJob` (с dev-симулятором).
+- `NotifyPendingConfirmationsJob`.
+
+**Phase 3 — СБП и Карты dev-заглушки** (~4-5 задач):
+
+- `SbpGateway` (dev режим) + `SbpQrCodeView.vue`.
+- `CardGateway` (dev режим) + `/dev-mock-vtb-acquiring/...` страница.
+- `FiscalReceiptProvider` interface + `NoOpFiscalProvider` + `DevMockFiscalProvider`.
+
+**Phase 4 — Тесты + smoke** (~3-4 задач):
+
+- Pest end-to-end сценарии префлайт (frozen/unfrozen flow).
+- Pest end-to-end сценарии безнала (создание счёта → симуляция выписки → подтверждение).
+- Vitest на новые Vue-компоненты.
+- Регрессия (Pest --parallel + Vitest + lychee + gitleaks).
+
+**Phase 5 — Документация + memory + ПИЛОТ.md** (~2 задач):
+
+- Обновление `project_billing_v2.md` (Спек C статус, известные хвосты).
+- ADR (если требуется новый — `docs/adr/016-preflight-vtb-architecture.md`).
+- Обновление `ПИЛОТ.md` после выкатки на прод.
+
+**Out of scope этого плана (post-Б-1, отдельные планы):**
+
+- Боевая интеграция VTB Acquiring (карты).
+- Боевая интеграция VTB SBP API.
+- Боевая интеграция VTB Бизнес API (авто-сверка).
+- Боевая интеграция ОФД-Атол (фискализация).
+- Боевые секреты в YC Lockbox.
+
+---
+
+**Конец Спека C.**

docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md

@@ -0,0 +1,265 @@
+# Спек: два специализированных ИИ-помощника для разгрузки главного исполнителя
+
+**Версия:** v1.0 от 24.05.2026
+**Статус:** Draft — pre-implementation
+**Источник:** brainstorming-сессия 24.05.2026 (memory: MEMORY.md + CLAUDE.md §6 + push-история 16-24.05)
+**Связано:** Pravila §15 (параллельные сессии), §16 (brain governance), CLAUDE.md §3.6, project-скилы `pest-parallel-debugger` / `rls-reviewer` (прецеденты узко-специализированных проектных агентов)
+
+---
+
+## 1. Контекст и проблема
+
+За 8 дней (16-24.05.2026) главный исполнитель (Opus 4.7) совершил повторяющиеся операции двух типов:
+
+1. **Синк 4 нормативных файлов** (Pravila / PSR_v1 / Tooling / CLAUDE.md) — 26 эпизодов (v2.3→v2.27). После каждой задачи приходится править шапки, cross-refs §0, footer-счётчики, §9-changelog в 4 местах. Низкая когнитивная нагрузка, высокая частота, error-prone (известны 2 эпизода версионной коллизии параллельных веток — A11 v2.10 и discovery v2.13).
+
+2. **Pre-flight перед выкатом на боевой liderra.ru** — ~10 выкатов с 22.05 по 24.05. 24.05 в 03:46 UTC случился живой 18-минутный инцидент (портал лёг полностью) из-за пропущенной проверки `bootstrap/cache/config.php` под `www-data` (квирк 107). Корень — pre-flight чек-лист в голове, не формализован.
+
+Оба класса — идеальные кандидаты на отдельных ИИ-помощников: ограниченный вход/выход, повторяющийся, требует понимать смысл (не просто regex), но не творчества.
+
+---
+
+## 2. Цели и измеримые KPI
+
+| Метрика | Цель |
+|---------|------|
+| Сокращение токенов главного исполнителя на нормативный синк | -90% (с ~70К до ~5К на эпизод) |
+| Сокращение токенов главного исполнителя на pre-flight выката | -85% (с ~25К до ~3К на эпизод) |
+| Доля автоматизированных синков от общего числа | ≥80% (некоторые требуют ручного — major-bump решения, новые off-phase подкатегории) |
+| Live-инциденты из-за пропущенных pre-flight проверок | 0 за квартал (текущий baseline: 1 инцидент за 3 дня) |
+| Цена операции (USD) | синк: $0.30/эпизод (было $0.60); выкат: $0.20/эпизод (было $0.35) |
+
+---
+
+## 3. Агент №1: `normative-sync`
+
+### 3.1. Назначение
+
+Применить нормативный синк 4 файлов (Pravila / PSR_v1 / Tooling / CLAUDE.md) после завершённой задачи, на основе brief'а главного исполнителя или git-diff.
+
+### 3.2. Когда зовётся
+
+- После завершения off-phase tooling integration (~3-5/неделю)
+- После выпуска brain governance артефактов (схема v2/v3, новый контролёр, новый skill)
+- После принятого ADR
+- После любого эпизода, который меняет cross-ref пространство нормативки
+
+Главный исполнитель решает зовёт или нет — агент не активируется автоматически.
+
+### 3.3. Входной brief (минимум)
+
+- Тема эпизода в одной строчке (например: «закрыли C1 marketing — 10 новых узлов #74-83, 18-я off-phase подкатегория marketing-tooling»)
+- Опционально: явные version-bump targets (если minor/major решение нетривиальное)
+- Опционально: ADR-номер если есть
+
+### 3.4. Процедура (10 шагов)
+
+1. **Pre-flight per Pravila §15.2:** `git fetch && git log HEAD..origin/main --oneline` — если есть unpushed коммиты от параллельной сессии в 8-файловом списке, остановиться и эскалировать.
+2. **Контекст:** прочитать `git diff HEAD~N..HEAD --stat` чтобы понять scope.
+3. **Чтение нормативки:** Pravila / PSR_v1 / Tooling / CLAUDE.md (только релевантные секции — §0, §9 / §10 history, footer-счётчики).
+4. **Вычисление новых версий** по правилам:
+   - minor (+0.01): добавили узел / методический параграф / cross-ref / запись в §9
+   - major (+1.0): убрали правило / архитектурная инверсия / снят hard-rule
+5. **Шапки:** обновить дату + версию в шапках 4 файлов.
+6. **§0 cross-refs (CLAUDE.md):** обновить строки таблицы версий Pravila/PSR/Tooling до новых номеров.
+7. **Footer-счётчики (если добавился узел):** Tooling §0 (КАНОН СЧЁТЧИКОВ) + CLAUDE.md §3.3 footer + §1 row 2b + §3 title. PSR_v1 R10.1 если добавился plugin/skill.
+8. **§9 / История версий записи:** один абзац в каждом из 4 файлов по шаблону «vX.Y от ДД.ММ — тема. Изменения: ... Связано: ...».
+9. **lefthook cross-ref-checker (C2):** `lefthook run cross-ref-checker || npx lefthook run cross-ref-checker` — если красный, итерация.
+10. **Выход:** не коммитит. Отдаёт diff + краткий рапорт «синк готов, версии bumped X→Y, cross-refs verified, lefthook C2 green, добавил §9 в 4 файлах».
+
+### 3.5. Модель и инструменты
+
+- **Модель:** Sonnet 4.6 (Pravila §15.1 — для git-операций обязательно Sonnet/Opus, не Haiku)
+- **Tools:** Read, Edit, Grep, Glob, Bash, TodoWrite
+- **Skills:**
+  - `superpowers:verification-before-completion` — перед итоговым рапортом убедиться что cross-ref-checker зелёный
+
+### 3.6. Что зашиваем в system prompt
+
+- Структура 4 файлов (где шапка / §0 cross-refs / footer-счётчики / §9-changelog)
+- Правила version-bump (minor vs major)
+- Pravila §15.2 8-файловый список + pre-flight протокол
+- Pravila §5 п.10 worktree-эксцепшн (когда прямой Edit, когда `claude-md-management:claude-md-improver`)
+- Tooling §0 «КАНОН СЧЁТЧИКОВ» (отсюда и только отсюда числа)
+- Шаблон §9-записи (дата, тема, изменения, cross-refs, канал, прецедент)
+- Стиль changelog (примеры — последние 5 записей из CLAUDE.md §9)
+
+### 3.7. Границы (out of scope)
+
+- Не правит код, миграции, схему БД
+- Не пишет ADR (только цитирует уже принятый)
+- Не правит саму карту `docs/automation-graph.html` (если в эпизоде менялась карта — это отдельная задача главного исполнителя)
+- Не коммитит, не пушит — только готовит diff
+- Не принимает решения о major bump — если не уверен, эскалирует на главного исполнителя
+
+### 3.8. Риски и митигации
+
+| Риск | Митигация |
+|------|-----------|
+| Версионная коллизия с параллельной веткой | Pre-flight §15.2 на шаге 1 — STOP при unpushed коммитах от других |
+| Drift cross-ref (4 файла указывают друг на друга со старыми версиями) | lefthook cross-ref-checker (C2) на шаге 9 |
+| Неправильный bump (minor вместо major) | Решение minor по умолчанию; major только при явном указании в brief'е или при удалении правила |
+| Пропуск footer-счётчика | Чек-лист TodoWrite внутри агента (8 пунктов структурных правок) |
+| Самовольное добавление «improvements» в несвязанные секции | Жёсткое scope-правило в system prompt: «правишь только шапки, §0, footer, §9; всё остальное — STOP» |
+
+### 3.9. Что отдаёт
+
+- 4 изменённых файла в рабочем дереве (uncommitted)
+- Рапорт ~10 строк: «синк завершён, версии X→Y, cross-refs verified, lefthook C2 green, добавлены §9 в [файлы], затронуто [N] секций»
+- Список любых эскалаций («нужен ручной выбор major/minor», «обнаружена коллизия с веткой Y», «cross-ref-checker красный после 3 итераций»)
+
+---
+
+## 4. Агент №2: `prod-deploy-validator`
+
+### 4.1. Назначение
+
+Pre-flight checklist перед выкатом на боевой `liderra.ru`. Возвращает вердикт `GO / NO-GO` с конкретной причиной.
+
+### 4.2. Когда зовётся
+
+Перед каждым выкатом — главный исполнитель просит «проверь готовность боевого». ~5-7 раз в неделю в активные периоды.
+
+### 4.3. Входной brief (минимум)
+
+- Что планируется выкатить (commit hash или короткое описание)
+- Опционально: явный список файлов в патче (если выкат через scp, не через git)
+
+### 4.4. 8 проверок
+
+| # | Проверка | Команда | Зелёный = | Красный = |
+|---|----------|---------|-----------|-----------|
+| **П1** | `bootstrap/cache/config.php` владельца | `ssh liderra "stat -c '%U %Y' app/bootstrap/cache/config.php; stat -c '%Y' app/.env"` | владелец `www-data` И mtime ≥ mtime .env | владелец не www-data ИЛИ старее .env (квирк 107) |
+| **П2** | `.env` line endings | `ssh liderra "file app/.env; md5sum app/.env"` | `ASCII text` (без CRLF) | `with CRLF line terminators` (квирк 105) |
+| **П3** | Свободное место | `ssh liderra "df -h /"` | использовано ≤ 85% | > 85% |
+| **П4** | Последний бэкап БД | `ssh liderra "ls -lt /var/backups/db/ \| head -2"` | mtime ≤ 24 часов назад | > 24 часов или пусто |
+| **П5** | Health очереди | `ssh liderra "pgrep -fa queue:work; tail -50 app/storage/logs/laravel.log \| grep -ic -e failed -e error"` | `queue:work` процесс активен И ≤ 5 ошибок в последних 50 строках laravel.log | процесс мёртв ИЛИ > 5 ошибок |
+| **П6** | nginx config | `ssh liderra "sudo nginx -t"` | `syntax is ok` + `test is successful` | любое иное |
+| **П7** | fail2ban активен | `ssh liderra "sudo systemctl is-active fail2ban"` | `active` | `inactive` / `failed` |
+| **П8** | Pending миграции | `ssh liderra "cd app && php artisan migrate:status \| grep -c Pending"` | 0 ИЛИ список к выкату согласован с brief'ом | необъявленные pending |
+
+### 4.5. Процедура (5 шагов)
+
+1. Принять brief — что выкатываем.
+2. Запустить 8 проверок последовательно (параллельность по SSH не даёт большого выигрыша, sequential проще для отладки).
+3. Собрать результаты в таблицу из 8 строк.
+4. Применить решающее правило:
+   - Все 8 зелёных → **GO** + список smoke-команд для пост-выкатной проверки
+   - Хоть одна красная → **NO-GO** + причина + ссылка на квирк memory + что делать чтобы исправить
+   - Любая «не смог проверить» (SSH-таймаут, неожиданный формат) → **NO-GO с эскалацией** («нужен человек, агент не угадывает»)
+5. Опционально (если brief содержит `--post-smoke`): после выката повторить smoke-проверки (HTTP 200 на главной, миграция применилась, очередь жива).
+
+### 4.6. Модель и инструменты
+
+- **Модель:** Sonnet 4.6
+- **Tools:** Bash, Read, Grep
+- **Skills:**
+  - `superpowers:verification-before-completion` — перед итоговым GO убедиться что все 8 проверок прогнаны (не одна пропущена)
+
+### 4.7. Что зашиваем в system prompt
+
+- 8 точных команд + ожидаемые форматы вывода
+- Память о квирках 104-108 (с MEMORY.md цитатами):
+  - 104: stale `bootstrap/cache/config.php` переживает .env-фикс
+  - 105: scp Windows→Linux кладёт CRLF в .env → sqlite-fallback → 500
+  - 106: `queue:work --timeout` default 60s убивает worker сам себя
+  - 107: `config:cache` НЕ из-под www-data → кэширует defaults → 500 (24.05 03:46 UTC)
+  - 108: NTFS junction для worktree node_modules
+- Шаблон отчёта (таблица + вердикт + smoke-команды)
+- SSH-настройки (читает из `~/.ssh/config`, никаких паролей в system prompt)
+
+### 4.8. Границы (out of scope)
+
+- Сам выкат не делает (только проверяет готовность). Выкат — главный исполнитель.
+- Не трогает базу данных (только smoke-чтение).
+- Не меняет конфиги на боевом.
+- Не угадывает: если вывод команды не соответствует шаблону — NO-GO с эскалацией, не «возможно нормально».
+
+### 4.9. Риски и митигации
+
+| Риск | Митигация |
+|------|-----------|
+| Новый квирк, которого нет в его памяти | Любой неожиданный output → автоматически NO-GO + эскалация. Через 1-2 эпизода добавляю в его system prompt. |
+| SSH-таймаут / сеть лежит | Жёсткий timeout 30 сек на проверку. Если 2+ проверки таймнули — отчёт «не смог проверить, выкат на свой риск». |
+| Что-то не покрыто 8 проверками | Со временем расширяю список. Агент сам границы не двигает. |
+| Ложно-положительный GO (агент пропустил проблему) | Я смотрю отчёт перед нажатием. Агент не выкатывает сам — только сообщает. |
+
+### 4.10. Что отдаёт
+
+- Таблица 8 строк с green/red статусом каждой проверки
+- Вердикт **GO** или **NO-GO**
+- Если NO-GO — конкретная причина + ссылка на квирк memory + что нужно сделать
+- Если GO — список smoke-команд для пост-выкатной проверки
+
+---
+
+## 5. Общие архитектурные решения
+
+### 5.1. Где живут определения агентов
+
+Project-local в `.claude/agents/normative-sync.md` и `.claude/agents/prod-deploy-validator.md` — по образцу `.claude/agents/pest-parallel-debugger.md` и `.claude/agents/rls-reviewer.md` (прецеденты узко-специализированных проектных агентов).
+
+### 5.2. Frontmatter каждого агента
+
+```yaml
+---
+name: <slug>
+description: <когда зовётся — для триггер-классификации>
+tools: <ограниченный список>
+model: claude-sonnet-4-6
+---
+```
+
+### 5.3. Скилы которые **не** даём ни одному из этих агентов
+
+- `brainstorming`, `writing-plans`, `executing-plans` — это исполнители, не проектировщики
+- `test-driven-development`, `frontend-design`, `mcp-builder` — не их scope
+- `superpowers:dispatching-parallel-agents` — они листовые, не дирижируют
+
+### 5.4. Subagent-driven git-safety (Pravila §15.1)
+
+Оба агента работают с git (один правит файлы → git diff отдаёт; второй делает SSH но не git). Главный исполнитель ВСЕ ЕЩЁ обязан верифицировать commit-базу (`git rev-parse HEAD`) ПОСЛЕ каждого вызова `normative-sync`-агента, до коммита его diff'а.
+
+### 5.5. Привязка к Brain governance (Pravila §16)
+
+- Stop-hook будет писать routing_decision и для этих агентов (provenance `user_directed_method` — главный исполнитель явно их позвал)
+- `task_classification` маппинг (tools/observer-classification-map.json) расширить: `normative_sync` → узел `agent:normative-sync`; `prod_deploy_validation` → узел `agent:prod-deploy-validator`. После добавления — missed-activation детектор будет ловить случаи когда я делаю синк сам вместо вызова агента.
+
+---
+
+## 6. Что вне scope этого спека
+
+- Создание агента «#3 разборщик карты наблюдателя» (отложен — частота 1-2/неделю, ROI ниже)
+- Создание агента «off-phase tooling integrator» (отброшен — слишком broad для одного агента)
+- Автоматическое добавление в `task_classification` маппинг (это отдельная задача brain governance)
+- Замена существующих агентов `pest-parallel-debugger` / `rls-reviewer` (они работают, не трогаем)
+- Какие-либо изменения нормативки (Pravila / PSR / Tooling / CLAUDE.md) для регистрации этих агентов — это произойдёт ВО ВРЕМЯ первого использования каждого агента (тогда сами агенты впишут себя в footer-счётчик, классическая dogfooding-проверка)
+
+---
+
+## 7. Открытые вопросы
+
+- **OQ-1:** Должны ли агенты иметь доступ к `mcp__redis__*` / `mcp__laravel-boost__*` для расширенных pre-flight проверок? **Решение по умолчанию:** нет, минимальный tools-set; расширим если понадобится после первой недели использования.
+- **OQ-2:** Нужно ли запускать `normative-sync` через TaskOutput с фоновым режимом (агент работает в фоне, я делаю что-то другое)? **Решение по умолчанию:** нет, синхронный вызов (1-2 мин ожидания не критично).
+- **OQ-3:** Должен ли `prod-deploy-validator` уметь делать сам бэкап БД если П4 красная? **Решение по умолчанию:** нет, только отчёт. Действия — главный исполнитель.
+
+---
+
+## 8. Прецеденты в проекте
+
+- **`.claude/agents/pest-parallel-debugger.md`** — узко-специализированный диагностический агент для Pest-quirks 72/73/77. Прецедент проектного агента с tools-restriction.
+- **`.claude/agents/rls-reviewer.md`** — узко-специализированный review-агент для RLS на миграциях. Прецедент агента с явным «when to invoke».
+- **`docs/superpowers/specs/2026-05-19-brain-governance-design.md`** — прецедент спека на инфраструктурное изменение через спек → план → реализация.
+
+---
+
+## 9. Следующий шаг
+
+После согласования этого спека — `superpowers:writing-plans` создаст implementation plan с задачами:
+
+1. Написать `.claude/agents/normative-sync.md` (system prompt + tools + frontmatter)
+2. Написать `.claude/agents/prod-deploy-validator.md` (то же)
+3. Smoke-тест №1 на dry-run (свежий синк, например post-billing-v2-spec-c)
+4. Smoke-тест №2 на dry-run (pre-flight перед следующим выкатом)
+5. Расширить `tools/observer-classification-map.json` двумя классификациями
+6. Запись в memory `feedback_specialized_agents.md` после первой недели использования (что работает / что нет)

docs/superpowers/specs/2026-05-24-legacy-direct-webhook-removal-design.md

@@ -0,0 +1,204 @@
+# Удаление legacy прямого webhook-канала (`ProcessWebhookJob`)
+
+**Дата:** 2026-05-24
+**Статус:** Design (awaiting user review)
+**Автор:** Claude Opus 4.7 (под руководством заказчика)
+**Брейнсторм:** сессия 2026-05-24
+**Триггер:** в коде осталось legacy-расхождение от старой prepaid-схемы. Изначально планировалась унификация под always-rub; в ходе брейнсторма выяснилось, что код — рудимент, не часть актуальной архитектуры каналов.
+
+---
+
+## §1. Контекст и проблема
+
+### §1.1 Архитектура каналов приёма лидов
+
+Лидерра принимает лиды через **два канала**:
+
+| Канал | Назначение | Реализация | Биллинг |
+|---|---|---|---|
+| Основной | Real-time приём от `crm.bp-gr.ru` | `SupplierWebhookController::receive` → `INSERT supplier_leads` → `RouteSupplierLeadJob::dispatch` | `LedgerService` (always-rub) |
+| Резервный | Часовая доливка пропусков через CSV-отчёт `crm.bp-gr.ru` | `CsvReconcileJob` → доливает `supplier_leads` → `RouteSupplierLeadJob` | `LedgerService` (always-rub, косвенно через основной) |
+
+Оба канала **уже** на единой биллинг-логике — рубли + 7-ступенчатая тарифная шкала через `LedgerService::chargeForDelivery`.
+
+### §1.2 Что осталось от старой архитектуры
+
+До эпика «шеринг» (Plan 2/5) в коде была другая модель: у каждого тенанта был свой `webhook_token`, поставщик стучался напрямую `POST /api/webhook/{token}` → `WebhookReceiveController` → `ProcessWebhookJob` → списание из `tenants.balance_leads` (штучный prepaid-баланс).
+
+После шеринг-эпика этот путь **перестал использоваться**, но из кода не убран:
+
+- `ProcessWebhookJob` ([app/app/Jobs/ProcessWebhookJob.php](../../../app/app/Jobs/ProcessWebhookJob.php), 342 строки) — на старой prepaid-модели (`tenant->decrement('balance_leads')`, `BalanceTransaction(amount_leads=-1)`).
+- `WebhookReceiveController` + публично открытый роут `POST /api/webhook/{token}` ([app/routes/web.php:276](../../../app/routes/web.php#L276)).
+- Таблицы `webhook_log` (партиционированная, 13 партиций) и `webhook_dedup_keys` — источник записей только этот job.
+- Колонки `tenants.webhook_token`, `tenants.webhook_token_rotated_at`.
+- Тесты `ProcessWebhookJobTest`, `WebhookReceiveTest` (плюс упоминания в 4 других файлах-тестах).
+
+**Подтверждение «не используется на проде»:**
+
+- `SELECT COUNT(*) FROM webhook_log` = 0 (за всю историю боевого сервера).
+- `last_webhook_at` у всех 5 тенантов = NULL.
+- Боевые лиды (`deals.tenant_id=2`, 412 шт.) пришли через основной канал — `source_crm_id` имеет формат `vid` от `crm.bp-gr.ru`.
+
+### §1.3 Проблемы рудимента
+
+1. **Открытый публичный эндпоинт.** `POST /api/webhook/{token}` доступен из интернета без middleware-проверки, аутентификация по знанию токена в URL. Лишний attack surface для DAST/нагрузочных атак.
+2. **Блокирует Phase B Спека A.** Phase B = `ALTER TABLE tenants DROP COLUMN balance_leads`. После него `ProcessWebhookJob` сломается на первом же вызове (или на запуске тестов).
+3. **Расхождение биллинг-моделей в коде.** Два разных списания на одну и ту же сущность (`Deal`) — путаница для будущих изменений.
+4. **Test-debt.** Тесты на старую prepaid-модель продолжают занимать набор тестов и время CI.
+
+### §1.4 Решение
+
+Удалить рудимент целиком (код + контроллер + роут + модель `WebhookDedupKey` + связанные тесты + таблицы БД + колонки `tenants`). Одним PR, выкатка одним релизом.
+
+---
+
+## §2. Scope
+
+### §2.1 Что удаляем
+
+**PHP-код:**
+
+- `app/app/Jobs/ProcessWebhookJob.php` (целиком)
+- `app/app/Http/Controllers/Api/WebhookReceiveController.php` (целиком, если используется ТОЛЬКО для legacy-роута)
+- роут `Route::post('/api/webhook/{token}', ...)` в [app/routes/web.php:276](../../../app/routes/web.php#L276)
+- `app/app/Models/WebhookDedupKey.php` (целиком — используется только `ProcessWebhookJob`)
+- `app/app/Mail/LowBalanceNotification.php`, `app/app/Mail/ZeroBalanceNotification.php` — **только если impact-check (§3) подтвердит, что нет других caller'ов**
+
+**Методы в `NotificationService`** (только если impact-check подтвердит, что нет других caller'ов):
+
+- `notifyLowBalance`
+- `notifyZeroBalance` (NB: не путать с `notifyZeroBalancePaused` — это разный метод шеринг-канала, оставляем)
+- `notifyNewLead` — **оставляем** (использует и шеринг через `RouteSupplierLeadJob`)
+
+**Тесты (целиком):**
+
+- `app/tests/Feature/ProcessWebhookJobTest.php`
+- `app/tests/Feature/WebhookReceiveTest.php`
+
+**Тесты (частично — удалить только релевантные кейсы, проверить не опустели ли файлы):**
+
+- `app/tests/Feature/Pd/DealCreatePdLogTest.php`
+- `app/tests/Feature/Notifications/BalanceNotificationsTest.php`
+- `app/tests/Feature/Notifications/NewLeadNotificationTest.php`
+- `app/tests/Feature/Notifications/InAppNotificationTest.php`
+
+**Миграция БД (одной миграцией, идемпотентной):**
+
+- `DROP TABLE webhook_log` (партиционированная) + все 13 партиций
+- `DROP TABLE webhook_dedup_keys`
+- `DROP TABLE rejected_deals_log` — **только если impact-check подтвердит, что писалось только `ProcessWebhookJob`**
+- `ALTER TABLE tenants DROP COLUMN webhook_token, DROP COLUMN webhook_token_rotated_at` — **только если impact-check подтвердит, что не используется в UI/API**
+- удаление сидов / system_settings ключей, относящихся только к legacy: `low_balance_threshold_leads` (если не унифицируется в рамках другого спека)
+
+### §2.2 Что НЕ трогаем (явно out of scope)
+
+- `failed_webhook_jobs` — используется `RouteSupplierLeadJob::failed()` (шеринг-канал).
+- `SupplierLeadCost` — пишется и шеринг-каналом (через `LedgerService::chargeForDelivery`).
+- `MonthlyPartitionManager` — управляет партициями нескольких таблиц, не только `webhook_log`.
+- `SupplierResolver` — используется в админке (`AdminSupplierIntegrationController`).
+- Phase B Спека A (`DROP COLUMN balance_leads`) — отдельная задача после ≥72ч наблюдения Phase A.
+- Унификация `notifyLowBalance` под рубли — отдельная задача, если решим возрождать low-balance уведомления.
+
+---
+
+## §3. Impact-checks (обязательны перед удалением)
+
+Каждая удаляемая сущность пройдёт автоматическую проверку «не использует ли её живой код». Список проверок — задачи в плане:
+
+| Сущность | Проверка | Решение если есть use |
+|---|---|---|
+| `WebhookReceiveController` | `grep -r "WebhookReceiveController" app/` | Если есть use вне роута — удалить только метод `receive`, контроллер оставить |
+| `NotificationService::notifyLowBalance` | `grep -r "notifyLowBalance" app/` | Если есть caller вне `ProcessWebhookJob` — оставить метод |
+| `NotificationService::notifyZeroBalance` | `grep -r "notifyZeroBalance\b" app/` (с word boundary, чтобы не зацепить `notifyZeroBalancePaused`) | Если есть caller — оставить метод |
+| `LowBalanceNotification`, `ZeroBalanceNotification` (Mailable) | `grep -r "LowBalanceNotification\|ZeroBalanceNotification" app/` | Если есть use — оставить класс |
+| `tenants.webhook_token`, `webhook_token_rotated_at` | grep по `app/` и `app/resources/js/` — поиск в UI, API-resource, ресурс-сериализаторах, фабриках, сидах | Если есть UI/API consumer — отдельная задача на удаление UI |
+| `rejected_deals_log` | `grep -r "RejectedDealsLog\|rejected_deals_log" app/` | Если есть use вне `ProcessWebhookJob` — таблицу не дропать |
+| `webhook_dedup_keys` | `grep -r "webhook_dedup_keys\|WebhookDedupKey" app/` | Должен быть пустым после удаления `ProcessWebhookJob` |
+| `low_balance_threshold_leads` (system_settings) | `grep -r "low_balance_threshold_leads" app/` | Если есть caller — мигрировать или удалить настройку |
+
+Все проверки делаются на текущем коде (после mental-удаления `ProcessWebhookJob` и тестов).
+
+---
+
+## §4. Решение по архитектуре
+
+### §4.1 Главный инвариант
+
+После выпиливания **остаётся ровно одна труба биллинга**: `RouteSupplierLeadJob::createDealCopyForProject` → `LedgerService::chargeForDelivery`. Все списания всех каналов идут через неё.
+
+### §4.2 Что меняется в публичном API
+
+- `POST /api/webhook/{token}` — **404**. Старые токены тенантов перестают принимать вход (попадание в логи nginx как 404 — это нормально, на проде вызовов 0).
+- `POST /api/webhook/supplier/{secret}` — **без изменений** (это шеринг-канал от `crm.bp-gr.ru`).
+
+### §4.3 Откатываемость
+
+Миграция БД **необратимая** (DROP TABLE / DROP COLUMN). Бэкап `pg_dump` снимается перед выкаткой по runbook `docs/deploy/test-server-runbook.md`. В случае critical-инцидента — restore из бэкапа + откат git revert.
+
+Риск отката оценивается как **нулевой** — на проде webhook_log = 0, рудимент никем не используется.
+
+### §4.4 Совместимость с другими спеками
+
+- **Спек A (₽-баланс, Phase A на проде)** — этот спек снимает блокер для Phase B.
+- **Спек B (дубли, на проде)** — не пересекается (Спек B про шеринг-канал; legacy webhook имеет собственный `webhook_dedup_keys`, который тоже удаляется).
+- **Спек C (preflight + VTB)** — не пересекается (preflight работает на уровне `SupplierQuotaAllocator`; VTB — на пополнении баланса, не на списании).
+
+---
+
+## §5. Тестирование
+
+### §5.1 Регрессионная проверка
+
+- `composer test` — Pest --parallel, должно пройти на dev (после удаления тестов количество suite уменьшится).
+- `npm run test:vue` — Vitest, должен остаться зелёным (UI не трогаем кроме возможного раздела webhook-token, если impact-check найдёт).
+- Lefthook pre-commit — все джобы зелёные.
+- Larastan — без новых ошибок (baseline регенерация только если потребуется).
+
+### §5.2 Smoke-проверка на проде после деплоя
+
+- `curl -X POST https://liderra.ru/api/webhook/test-token -d '{}'` → ожидается **404** (роут больше не существует).
+- `curl -X POST https://liderra.ru/api/webhook/supplier/$SECRET -d '{...}'` → ожидается **200/202** (шеринг-канал работает как раньше).
+- `SELECT * FROM information_schema.tables WHERE table_name IN ('webhook_log', 'webhook_dedup_keys')` → 0 строк (миграция применилась).
+- `SELECT column_name FROM information_schema.columns WHERE table_name='tenants' AND column_name LIKE 'webhook_%'` → 0 строк (если impact-check подтвердил удаление колонок).
+
+### §5.3 7-дневное наблюдение
+
+После деплоя — наблюдать:
+
+- `failed_jobs` (новые fail'ы только от шеринг-канала).
+- nginx access log на `/api/webhook/{token}` 404 — если **кто-то** реально начнёт долбиться (что маловероятно: 0 вызовов за всю историю), но если начнёт — это сигнал к ретроспективе.
+- Sentry-алерты — без новых регрессий (Sentry pending Б-1).
+
+---
+
+## §6. Выкатка
+
+**Один PR, один релиз** (заказчик подтвердил 2026-05-24).
+
+Шаги (детали — в плане реализации):
+
+1. Изолированный worktree.
+2. Impact-checks (§3) — финальный список «что удаляем точно, что оставляем».
+3. Code-удаление + удаление/чистка тестов.
+4. Миграция БД (одна идемпотентная миграция с DROP).
+5. Полная регрессия (`composer test` + `npm run test:vue` + lefthook).
+6. Subagent code-review.
+7. Push в main, FF merge.
+8. Деплой на боевой:
+   - Бэкап `pg_dump` перед миграцией (runbook).
+   - `git archive | scp | tar -xf` (10-15 файлов).
+   - `redeploy.sh` (composer + migrate + cache + reload php-fpm).
+   - Smoke-проверка (§5.2).
+9. 7-дневное наблюдение (§5.3).
+
+---
+
+## §7. Связано
+
+- [Спек A Биллинг v2 — единый ₽-баланс](2026-05-23-billing-v2-spec-a-balance-rub-design.md) (Phase B = блокирован этим документом до выпиливания).
+- [Спек B Биллинг v2 — политика дублей](2026-05-23-billing-v2-spec-b-duplicates-design.md) (не пересекается, но даёт контекст шеринг-канала).
+- [Спек C Биллинг v2 — preflight + VTB](2026-05-24-billing-v2-spec-c-preflight-vtb-design.md) (не пересекается).
+- [Supplier integration spec](2026-05-10-supplier-integration-design.md) §5–§6 (определение шеринг-канала, который остаётся единственным боевым).
+- [CSV reconcile channel spec](2026-05-18-supplier-csv-reconcile-channel-design.md) (резервный канал, не трогается).
+- `docs/deploy/test-server-runbook.md` (бэкап перед миграцией).
+- Памятки в коде комментариев: [routes/web.php:282](../../../app/routes/web.php#L282) уже маркирует роут как «legacy».

docs/superpowers/specs/2026-05-24-router-stage3-three-fixes-design.md

@@ -0,0 +1,217 @@
+# Router Stage 3 — three follow-up fixes (design)
+
+**Дата:** 2026-05-24
+**Автор:** Claude Opus 4.7 + Дмитрий (controller)
+**Контекст:** этап 3 router discipline overhaul (Tasks 1-8) уже на `origin/main` в режиме warn-only. После рестарта Claude Code и подключения `ANTHROPIC_API_KEY` (Layer 2 эскалация) обнаружены три дыры, мешающие осмысленному прогону `/brain-retro` и переключению в `enforce`.
+**Связано с:** `docs/superpowers/specs/2026-05-23-router-discipline-overhaul-design.md` (anchor spec этапа); `docs/superpowers/plans/2026-05-24-router-overhaul-stage-3-enforcement.md` (план Tasks 1-10); ADR-011 (brain governance).
+**Тип:** bugfix + интеграционное расширение. Размер: ~3 файла кода, ~3 теста, ≤80 строк нетто.
+
+---
+
+## 1. Problem statement
+
+Сторож (классификатор + UserPromptSubmit/PreToolUse/Stop хуки) работает в warn-only с 24.05.2026. Накоплено 16 сессий. При инспекции state-файлов и эпизодов наблюдателя видны три дефекта:
+
+### Дефект 1 — UTF-8 mojibake в state-файле сторожа
+
+В `~/.claude/runtime/router-state-<session>.json` `classification.reasoning` (приходит от Anthropic API) содержит mojibake вместо кириллицы пользовательского промпта. Пример (фактический state 24.05.2026, session `f4c8ef62`):
+
+```
+"reasoning": "Ambiguous Russian query 'посмотри сторожа достаточно ему информации?' ..."
+```
+
+Симптом — классический cp1251→UTF-8 misinterpret. На Windows Node.js `process.stdin` по умолчанию выдаёт `Buffer`'ы, конкатенация через `+=` к строке без явного `setEncoding('utf-8')` интерпретирует байты как latin-1, теряя multi-byte UTF-8 sequences. Битая строка уезжает в `body.messages[0].content` запроса к Anthropic API, Haiku видит мусор и классифицирует «по шуму».
+
+**Влияние:** Layer 2 эскалация на русских промптах работает по испорченному тексту → рекомендации мимо. Layer 1 (regex по байтам — это всё ещё валидная UTF-8 в `event.prompt`, парсинг JSON через `JSON.parse` сохраняет правильно) работает корректно, но размытые русские задачи всё равно попадают в Layer 2.
+
+### Дефект 2 — `recommended_node` отсутствует в эпизодах наблюдателя
+
+В эпизодах `docs/observer/episodes-2026-05.jsonl` поле `primary_rationale.recommended_node` пустое во всех 5 последних эпизодах (sample 24.05.2026). При этом state-файл сторожа содержит `classification.recommendedNode`. Модуль `tools/observer-recommended-node.mjs` существует (создан в Stage 2 batch), но не подключён к `observer-transcript-parser.mjs` либо подключён без сохранения результата.
+
+**Влияние:** `brain-retro-analyzer.mjs` Stage 3 Task 9 будет считать `domainHitRate` (matched recommendation vs node_chosen) — без поля в эпизоде эта ось показывает 0. Метрика «правильный ли узел я выбрал» не работает.
+
+### Дефект 3 — `chain_progress` отсутствует в эпизодах
+
+Аналогично дефекту 2: state-файл хранит `chainProgress` (массив), `chainCompleted` (bool), `classification.recommendedChain` (строка). `tools/router-stop-gate.mjs` обновляет state на Stop event. `tools/observer-chain-detector.mjs` существует. Но `primary_rationale.chain_progress` / `chain_completed` / `recommended_chain` в эпизодах пусты.
+
+**Влияние:** `chainCompletionRate` (Stage 3 Task 9) тоже показывает 0. Метрика «довёл ли цепочку до конца» не работает.
+
+---
+
+## 2. Goals / Non-goals
+
+### Goals
+
+- G1. Русский язык в пользовательском промпте корректно (без mojibake) попадает в state-файл и в запрос к Anthropic API.
+- G2. `primary_rationale.recommended_node` в каждом новом эпизоде наблюдателя = `classification.recommendedNode` из state-файла сторожа (или `null`, если state-файла нет).
+- G3. `primary_rationale.chain_progress`, `chain_completed`, `recommended_chain` в каждом новом эпизоде наблюдателя = соответствующие поля из state-файла сторожа.
+- G4. Smoke-test на живой сессии после фиксов: один русский размытый промпт → читаемый русский в `reasoning` + три указанных поля заполнены в новом эпизоде.
+- G5. Регрессия GREEN: полный прогон `tools/*` (≥456 tests, baseline Stage 3 Task 8 + новые).
+
+### Non-goals
+
+- NG1. Извлечение `triggers_matched` / `candidates_considered` / `boundaries_applied` из reasoning Claude (отдельный кандидат brain-retro #6 от 20.05).
+- NG2. Конвертация v1-эпизодов 19.05 (~5 записей) в v3 задним числом.
+- NG3. Расширение словаря классификатора (Candidate 7 brain-retro 20.05).
+- NG4. Переключение в `enforce` mode (это отдельный шаг — Task 9 плана Stage 3, после 24h warn-only post-fix наблюдения).
+- NG5. Изменение `~/.claude/settings.json` (хуки уже зарегистрированы Task 8 ebca54f0).
+- NG6. Правка нормативки (Pravila / CLAUDE.md / PSR_v1 / Tooling / ADR / docs/router-procedure.md) — это Stage 4.
+
+---
+
+## 3. Architecture
+
+Три независимых фикса, общий контекст — state-файл сторожа `~/.claude/runtime/router-state-<session>.json` как single source of truth между prehook (запись), tool-gate (чтение), stop-gate (обновление) и observer-parser (чтение и обогащение эпизода).
+
+### 3.1. Fix 1 — UTF-8 stdin encoding в двух хуках
+
+**Файлы:** `tools/router-prehook.mjs`, `tools/router-stop-gate.mjs`.
+
+**Изменение:** перед циклом `for await (const chunk of process.stdin)` вставить:
+
+```javascript
+process.stdin.setEncoding('utf-8');
+```
+
+Это директива Node.js, переключающая stdin readable stream в text mode с явным UTF-8 декодером. После этого `chunk` приходит как `string`, конкатенация `input += chunk` сохраняет code points без потерь.
+
+**Альтернатива (рассмотрена и отвергнута):** читать как `Buffer.concat([...])` и затем `.toString('utf-8')` явно. Эквивалентно по результату, но менее идиоматично и требует переписать цикл.
+
+**Также трогаем третий хук:** `router-tool-gate.mjs` тоже читает stdin (PreToolUse event). Для текущих полей (`tool_input.command`/`path`) кодировка не критична (ASCII пути/команды), но для единообразия и защиты от будущих расширений (если хук начнёт логировать prompt-фрагменты) — добавляем `setEncoding('utf-8')` и сюда. Стоимость — одна строка + один регрессионный тест.
+
+### 3.2. Fix 2 — recommended_node в эпизод
+
+**Файлы:** `tools/observer-transcript-parser.mjs` (модификация), `tools/observer-recommended-node.mjs` (существует, используем как есть).
+
+**Подход:** в функции построения `primary_rationale` объекта эпизода вызвать helper из `observer-recommended-node.mjs`, который читает state-файл по `sessionId` (из контекста эпизода) и возвращает `recommendedNode`. Сохранить в `primary_rationale.recommended_node`.
+
+Помощник уже умеет:
+
+- Принять `sessionId` и базовый путь `~/.claude/runtime/`.
+- Прочитать `router-state-<sessionId>.json`, вернуть `null` если файла нет.
+- Извлечь `classification.recommendedNode`.
+
+Если helper не делает что-то из перечисленного — расширим его (TDD).
+
+### 3.3. Fix 3 — chain_progress + chain_completed + recommended_chain в эпизод
+
+**Файлы:** `tools/observer-transcript-parser.mjs` (та же модификация что Fix 2 — добавляем в тот же блок).
+
+**Подход:** ровно как Fix 2, в том же чтении state-файла достаём `chainProgress`, `chainCompleted`, `classification.recommendedChain` и заполняем `primary_rationale.chain_progress`, `chain_completed`, `recommended_chain` соответственно.
+
+Можно вытащить в общий helper «обогатить primary_rationale из state-файла» — единый вызов, три поля. Это **рекомендуемый** вариант (1 read state-файла на эпизод вместо 2 для отдельных helper'ов).
+
+### 3.4. Data flow
+
+```
+UserPromptSubmit
+   ↓ stdin (русский UTF-8) [Fix 1: setEncoding]
+router-prehook.mjs
+   ↓ classify() → state.classification.{recommendedNode, recommendedChain, reasoning}
+~/.claude/runtime/router-state-<session>.json
+
+Stop event
+   ↓ stdin (turn_events) [Fix 1: setEncoding профилактически]
+router-stop-gate.mjs
+   ↓ updateChainProgress() → state.{chainProgress, chainCompleted, skillInvokedThisTurn}
+~/.claude/runtime/router-state-<session>.json (тот же файл)
+
+Observer Stop event (parallel hook)
+   ↓ обходит transcript JSONL
+observer-transcript-parser.mjs
+   ↓ [Fix 2/3: enrichFromState(sessionId)]
+   ↓ primary_rationale.{recommended_node, chain_progress, chain_completed, recommended_chain}
+docs/observer/episodes-2026-05.jsonl
+```
+
+---
+
+## 4. Testing
+
+### Unit tests
+
+| Тест | Что проверяем | Fix |
+|---|---|---|
+| `router-prehook.test.mjs` +1 | mock stdin: Buffer с кириллицей в UTF-8 → main() → state.classification.reasoning без mojibake | 1 |
+| `router-stop-gate.test.mjs` +1 | mock stdin: Buffer с кириллицей в JSON-поле → main() не падает, не портит state | 1 |
+| `router-tool-gate.test.mjs` +1 | mock stdin: Buffer с UTF-8 → main() не падает; решение decideDecision не меняется | 1 (защита) |
+| `observer-recommended-node.test.mjs` +1-2 | mock state-файл → helper извлекает recommendedNode/recommendedChain/chainProgress/chainCompleted | 2+3 (расширение helper'а) |
+| `observer-transcript-parser.test.mjs` +1 | fixture эпизода + mock state-файла → собранный эпизод имеет все 4 поля в primary_rationale | 2+3 integration |
+
+### Smoke test (live, после деплоя)
+
+После рестарта Claude Code:
+
+1. Прислать русский размытый промпт (например, «проверь как сторож обрабатывает сложные клиентские задачи»).
+2. Проверить `~/.claude/runtime/router-state-<новая-session>.json`:
+   - В `classification.reasoning` — читаемая кириллица (если Layer 2 эскалировал).
+3. После Stop текущего хода — посмотреть последний эпизод в `docs/observer/episodes-2026-05.jsonl`:
+   - `primary_rationale.recommended_node` ≠ null (или явно `null` если состояние подсказывает).
+   - `primary_rationale.recommended_chain` — заполнено.
+   - `primary_rationale.chain_progress` — массив (пустой ОК, если скилы не вызывались).
+
+### Regression suite
+
+`cd app && npx vitest run --config vitest.config.tools.mjs` — все тесты GREEN, прирост ≥3 новых tests.
+
+---
+
+## 5. Risks & mitigations
+
+| Риск | Митигация |
+|---|---|
+| `setEncoding('utf-8')` ломает существующее поведение на не-кириллических промптах | Существующие тесты `router-prehook.test.mjs` сейчас работают на ASCII-фикстурах — добавление setEncoding не должно повлиять. Прогон полного suite до коммита. |
+| `observer-recommended-node.mjs` уже имеет тесты, расширение ломает существующие | TDD: новые тесты пишем сначала, существующие зелёные — ок; красные — переписываем helper аккуратно. |
+| Корень UTF-8 в другом месте (не в stdin) — фикс не помогает | Smoke-test на живой сессии — если mojibake остался, делаем диагностику отдельно (не в этом spec). Cost: 1 час смок-теста. |
+| `enrichFromState` не находит state-файл (для эпизодов в сессиях ДО раскатки сторожа) | Helper возвращает `null`/пустоту — primary_rationale.recommended_node = null. Это поведение для legacy ОК. |
+| state-файл устарел / другой сессии (race) | sessionId в эпизоде и в state-файле должен совпадать; mismatch → null. Helper это уже учитывает. |
+| Параллельная сессия Claude в этом же чекауте правит те же файлы | Pre-flight перед каждым коммитом + worktree (Pravila §15.1). |
+
+---
+
+## 6. Rollback
+
+Каждый фикс — 1-3 строки кода + тест. Откат:
+
+- Fix 1: `git revert <commit>` или удалить строку `setEncoding`.
+- Fix 2/3: `git revert <commit>` или убрать вызов `enrichFromState`. primary_rationale.recommended_node вернётся в `undefined`/`null` (текущее состояние).
+
+Никаких миграций данных, никаких backup'ов. Старые эпизоды не трогаем — они остаются без новых полей (это ожидаемо).
+
+---
+
+## 7. Execution layout
+
+- **Where:** изолированный worktree от свежего `origin/main` (per Pravila §15.1 — git-commit tasks через Sonnet/Opus, не Haiku).
+- **Branches:** `feat/router-stage3-three-fixes`.
+- **Subagent vs inline:** subagent-driven последовательно — 3 Sonnet субагента, по одному на фикс (фиксы малы, параллельность даст negligible выигрыш + усложнит review). Closure (continuity + STATUS regen + push) — controller (Opus).
+- **Commits:** 1 commit per fix + 1 closure commit (continuity + STATUS regen + push).
+- **Push target:** `main` (FF merge).
+
+---
+
+## 8. Acceptance criteria
+
+После всех фиксов и smoke:
+
+- ✅ Smoke-русский в state-файле новой сессии без mojibake.
+- ✅ Smoke-эпизод имеет 4 новых поля в `primary_rationale` (recommended_node, recommended_chain, chain_progress, chain_completed).
+- ✅ Полный tools-suite GREEN (baseline 456 + ≥4 новых).
+- ✅ gitleaks 0.
+- ✅ Откатываемость ≤5 минут.
+- ✅ STATUS.md регенерирован.
+- ✅ Push на `main` без force, без skipped hooks.
+
+После этого 24h warn-only наблюдения **с уже починенным сторожем** → `/brain-retro` → решение по enforce (Task 9 плана Stage 3).
+
+---
+
+## 9. References
+
+- Spec этапа 3: `docs/superpowers/specs/2026-05-23-router-discipline-overhaul-design.md`
+- План этапа 3 Tasks 1-10: `docs/superpowers/plans/2026-05-24-router-overhaul-stage-3-enforcement.md`
+- ADR-011 Brain governance.
+- Brain-retro первое (20.05.2026): `docs/observer/notes/2026-05-20-brain-retro.md` — кандидаты #2/#5/#6.
+- State file format: `tools/router-prehook.mjs:40-50` (`buildStateFromClassification`).
+- Helper recommended-node: `tools/observer-recommended-node.mjs`.
+- Helper chain-detector: `tools/observer-chain-detector.mjs`.

tools/brain-retro-analyzer.mjs

@@ -8,6 +8,13 @@
  */
 import { readFileSync, existsSync } from 'fs';
 import { detectMissedActivations } from './missed-activations.mjs';
+import {
+  disciplinePercentByClassification,
+  routerStepReached,
+  boundariesAppliedRate,
+} from './discipline-metrics.mjs';
+import { loadRegistry } from './registry-load.mjs';
+import { buildClassificationMap, buildDormancyMap } from './registry-to-classification-map.mjs';
 
 const SIZE_SMALL = 20;
 const SIZE_LARGE = 60;
@@ -209,6 +216,9 @@ export function analyze(episodes, options = {}) {
   }
   const classificationMap = options.classificationMap || {};
   const dormancy = options.dormancy || {};
+  const disciplineByClassification = disciplinePercentByClassification(normal, classificationMap);
+  const routerStep = routerStepReached(normal);
+  const boundariesRate = boundariesAppliedRate(normal);
   return {
     episodeCount: normal.length,
     v1SkippedCount,
@@ -217,6 +227,9 @@ export function analyze(episodes, options = {}) {
     causalChains: findCausalChains(normal),
     factorMatrix: buildFactorMatrix(normal),
     missedActivations: detectMissedActivations(normal, classificationMap, dormancy),
+    disciplineByClassification,
+    routerStep,
+    boundariesRate,
   };
 }
 
@@ -238,16 +251,9 @@ function loadEpisodes(files) {
 }
 
 if (process.argv[1] && process.argv[1].replace(/\\/g, '/').endsWith('/brain-retro-analyzer.mjs')) {
-  const classificationMap = (() => {
-    try {
-      return JSON.parse(readFileSync('tools/observer-classification-map.json', 'utf-8')).map || {};
-    } catch { return {}; }
-  })();
-  const dormancy = (() => {
-    try {
-      return JSON.parse(readFileSync('tools/.node-dormancy.json', 'utf-8'));
-    } catch { return {}; }
-  })();
+  const registry = loadRegistry({ useCache: false });
+  const classificationMap = buildClassificationMap(registry);
+  const dormancy = buildDormancyMap(registry);
   const result = analyze(loadEpisodes(process.argv.slice(2)), { classificationMap, dormancy });
   console.log(JSON.stringify(result, null, 2));
   process.exit(0);

tools/brain-retro-analyzer.test.mjs

@@ -318,3 +318,42 @@ describe('analyze: schema_version filter', () => {
     expect(result.factorMatrix.recommended_node_for_direct.none).toBeDefined();
   });
 });
+
+describe('analyze — discipline metrics (stage 2)', () => {
+  const map = { feature: ['#19'], bugfix: ['#18'] };
+  const dormancy = { '#19': false, '#18': false };
+
+  it('returns disciplinePercentByClassification', () => {
+    const eps = [
+      ep({ primary_rationale: { task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], boundaries_applied: [], step: 1, candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+      ep({ timestamps: { started_at: '2026-05-19T10:01:00Z', ended_at: '2026-05-19T10:02:00Z' }, primary_rationale: { task_classification: 'feature', node_chosen: '#19', triggers_matched: [{node:'#19'}], boundaries_applied: [], step: 3, candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+    ];
+    const res = analyze(eps, { classificationMap: map, dormancy });
+    expect(res.disciplineByClassification.feature.episodes).toBe(2);
+    expect(res.disciplineByClassification.feature.withTriggerMatch).toBe(1);
+    expect(res.disciplineByClassification.feature.viaSkill).toBe(1);
+  });
+
+  it('returns routerStepReached distribution (derived from signals)', () => {
+    const eps = [
+      // bare/direct → derived step 1
+      ep({ primary_rationale: { step: 1, task_classification: 'other', node_chosen: 'direct', triggers_matched: [], chain_ref: [], boundaries_applied: [], candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+      // triggers matched → derived step 3
+      ep({ timestamps: { started_at: '2026-05-19T10:01:00Z', ended_at: '2026-05-19T10:02:00Z' }, primary_rationale: { step: 1, task_classification: 'other', node_chosen: 'direct', triggers_matched: [{ node: '#19' }], chain_ref: [], boundaries_applied: [], candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+    ];
+    const res = analyze(eps, { classificationMap: map, dormancy });
+    expect(res.routerStep.distribution['1']).toBe(1);
+    expect(res.routerStep.distribution['3']).toBe(1);
+  });
+
+  it('returns boundariesAppliedRate', () => {
+    const eps = [
+      ep({ primary_rationale: { boundaries_applied: [{ adr: 'X' }], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1, candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+      ep({ timestamps: { started_at: '2026-05-19T10:01:00Z', ended_at: '2026-05-19T10:02:00Z' }, primary_rationale: { boundaries_applied: [], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1, candidates_considered: [], hard_floor: { invoked: false, rules: [] } } }),
+    ];
+    const res = analyze(eps, { classificationMap: map, dormancy });
+    expect(res.boundariesRate.total).toBe(2);
+    expect(res.boundariesRate.withBoundaries).toBe(1);
+    expect(res.boundariesRate.rate).toBeCloseTo(0.5);
+  });
+});

tools/discipline-metrics.mjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * Discipline metrics — pure aggregation over observer episodes.
+ * Stage 2 of router discipline overhaul (spec 2026-05-23): baseline measurement
+ * перед enforcement в этапе 3.
+ *
+ * Pure / read-only. No exec, no fs.
+ */
+
+/** Filter helper: only schema v2+ non-error episodes. */
+function valid(episodes) {
+  return (episodes || []).filter(
+    (e) => e && !e.observer_error && typeof e.schema_version === 'number' && e.schema_version >= 2
+  );
+}
+
+/**
+ * % эпизодов с матченным триггером, разбивка по task_classification.
+ * Только классификации, присутствующие в classificationMap (т.е. известные/имеющие узлы).
+ *
+ * @param {object[]} episodes
+ * @param {object} classificationMap  { [classification]: string[] }
+ * @returns {{ [classification]: { episodes: number, withTriggerMatch: number, viaSkill: number, pctTriggerMatch: number, pctViaSkill: number } }}
+ */
+export function disciplinePercentByClassification(episodes, classificationMap) {
+  const out = {};
+  for (const e of valid(episodes)) {
+    const pr = e.primary_rationale || {};
+    const cls = pr.task_classification;
+    if (!cls || !classificationMap[cls]) continue;
+    if (!out[cls]) out[cls] = { episodes: 0, withTriggerMatch: 0, viaSkill: 0, pctTriggerMatch: 0, pctViaSkill: 0 };
+    const b = out[cls];
+    b.episodes += 1;
+    if (Array.isArray(pr.triggers_matched) && pr.triggers_matched.length > 0) b.withTriggerMatch += 1;
+    if (pr.node_chosen && pr.node_chosen !== 'direct') b.viaSkill += 1;
+  }
+  for (const b of Object.values(out)) {
+    b.pctTriggerMatch = b.episodes ? b.withTriggerMatch / b.episodes : 0;
+    b.pctViaSkill = b.episodes ? b.viaSkill / b.episodes : 0;
+  }
+  return out;
+}
+
+/**
+ * Вывести шаг router-procedure.md, которого реально достиг эпизод, из
+ * НАБЛЮДАЕМЫХ признаков primary_rationale (хранимое поле `step` исторически —
+ * жёсткая константа 1 в обоих episode-builder'ах, поэтому ему не доверяем).
+ *
+ * Стадии (берётся максимум достигнутой):
+ *   1 — hard-floor checkpoint (всегда пройден),
+ *   2 — классификация дала реальный класс (task_classification ≠ 'other'),
+ *   3 — подобраны триггеры (triggers_matched непуст),
+ *   4 — найдена каноническая цепочка (chain_ref непуст),
+ *   5 — выбран и исполнен узел (node_chosen ≠ 'direct').
+ *
+ * @param {object|undefined} pr  primary_rationale
+ * @returns {1|2|3|4|5}
+ */
+export function deriveRouterStep(pr) {
+  if (!pr || typeof pr !== 'object') return 1;
+  let step = 1;
+  if (pr.task_classification && pr.task_classification !== 'other') step = 2;
+  if (Array.isArray(pr.triggers_matched) && pr.triggers_matched.length > 0) step = Math.max(step, 3);
+  const chain = pr.chain_ref;
+  const hasChain = Array.isArray(chain) ? chain.length > 0 : Boolean(chain);
+  if (hasChain) step = Math.max(step, 4);
+  if (pr.node_chosen && pr.node_chosen !== 'direct') step = Math.max(step, 5);
+  return step;
+}
+
+/**
+ * Распределение по шагу роутера, ВЫВЕДЕННОМУ из наблюдаемых признаков
+ * (deriveRouterStep) — а не из хранимого pr.step (он был константой 1).
+ * suspicious=true если total >= 5 && >90% эпизодов выводятся в step 1
+ * (Pravila §16.4 sanity-check — теперь это реальный сигнал «дисциплина
+ * проваливается / признаки не пишутся», а не гарантированный артефакт).
+ *
+ * @param {object[]} episodes
+ * @returns {{ distribution: { [step: string]: number }, total: number, suspicious: boolean }}
+ */
+export function routerStepReached(episodes) {
+  const distribution = {};
+  let total = 0;
+  for (const e of valid(episodes)) {
+    const key = String(deriveRouterStep(e.primary_rationale));
+    distribution[key] = (distribution[key] || 0) + 1;
+    total += 1;
+  }
+  const stuckAt1 = (distribution['1'] || 0) / Math.max(total, 1);
+  return { distribution, total, suspicious: total >= 5 && stuckAt1 > 0.9 };
+}
+
+/**
+ * Доля эпизодов с непустыми applied boundaries, разбивка по path_type.
+ *
+ * @param {object[]} episodes
+ * @returns {{ total: number, withBoundaries: number, rate: number, byPathType: object }}
+ */
+export function boundariesAppliedRate(episodes) {
+  let total = 0, withBoundaries = 0;
+  const byPathType = {};
+  for (const e of valid(episodes)) {
+    const pr = e.primary_rationale || {};
+    const pt = e.path_type || 'null';
+    const has = Array.isArray(pr.boundaries_applied) && pr.boundaries_applied.length > 0;
+    total += 1;
+    if (has) withBoundaries += 1;
+    if (!byPathType[pt]) byPathType[pt] = { total: 0, withBoundaries: 0, rate: 0 };
+    byPathType[pt].total += 1;
+    if (has) byPathType[pt].withBoundaries += 1;
+  }
+  for (const b of Object.values(byPathType)) b.rate = b.total ? b.withBoundaries / b.total : 0;
+  return { total, withBoundaries, rate: total ? withBoundaries / total : 0, byPathType };
+}

tools/discipline-metrics.test.mjs

@@ -0,0 +1,184 @@
+import { describe, it, expect } from 'vitest';
+import {
+  disciplinePercentByClassification,
+  routerStepReached,
+  deriveRouterStep,
+  boundariesAppliedRate,
+} from './discipline-metrics.mjs';
+
+const map = { feature: ['#19'], bugfix: ['#18'], refactor: ['#11', '#12'] };
+
+function ep(overrides = {}) {
+  return {
+    schema_version: 2,
+    primary_rationale: {
+      task_classification: 'feature',
+      node_chosen: 'direct',
+      triggers_matched: [],
+      boundaries_applied: [],
+      step: 1,
+    },
+    path_type: 'regulated',
+    ...overrides,
+  };
+}
+
+describe('disciplinePercentByClassification', () => {
+  it('counts episodes per classification', () => {
+    const eps = [
+      ep({ primary_rationale: { task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], boundaries_applied: [], step: 1 } }),
+      ep({ primary_rationale: { task_classification: 'feature', node_chosen: '#19', triggers_matched: [{node:'#19'}], boundaries_applied: [], step: 3 } }),
+      ep({ primary_rationale: { task_classification: 'bugfix', node_chosen: 'direct', triggers_matched: [], boundaries_applied: [], step: 1 } }),
+    ];
+    const res = disciplinePercentByClassification(eps, map);
+    expect(res.feature.episodes).toBe(2);
+    expect(res.feature.withTriggerMatch).toBe(1);
+    expect(res.feature.viaSkill).toBe(1);
+    expect(res.feature.pctTriggerMatch).toBeCloseTo(0.5);
+    expect(res.feature.pctViaSkill).toBeCloseTo(0.5);
+    expect(res.bugfix.episodes).toBe(1);
+    expect(res.bugfix.pctTriggerMatch).toBe(0);
+  });
+
+  it('ignores classifications outside the map', () => {
+    const eps = [ep({ primary_rationale: { task_classification: 'unknown', node_chosen: 'direct', triggers_matched: [], boundaries_applied: [], step: 1 } })];
+    const res = disciplinePercentByClassification(eps, map);
+    expect(res.unknown).toBeUndefined();
+  });
+
+  it('ignores v1 episodes and observer_error markers', () => {
+    const eps = [
+      { schema_version: 1, primary_rationale: { task_classification: 'feature', node_chosen: 'direct' } },
+      { observer_error: true },
+      ep(),
+    ];
+    const res = disciplinePercentByClassification(eps, map);
+    expect(res.feature.episodes).toBe(1);
+  });
+
+  it('returns empty object on empty input', () => {
+    expect(disciplinePercentByClassification([], map)).toEqual({});
+  });
+});
+
+describe('deriveRouterStep', () => {
+  // Маппинг наблюдаемых признаков primary_rationale → шаг router-procedure.md
+  // (1 hard-floor → 2 классификация → 3 триггеры → 4 цепочка → 5 исполнение узла).
+  // Берётся МАКСИМУМ достигнутой стадии. Хранимое pr.step игнорируется.
+  it('returns 1 for a bare direct episode (hard-floor only, no signals)', () => {
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [], chain_ref: [], node_chosen: 'direct' })).toBe(1);
+  });
+
+  it('returns 2 when a real task_classification was produced', () => {
+    expect(deriveRouterStep({ task_classification: 'feature', triggers_matched: [], chain_ref: [], node_chosen: 'direct' })).toBe(2);
+  });
+
+  it("treats 'other' classification as not reaching step 2", () => {
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [], chain_ref: null, node_chosen: 'direct' })).toBe(1);
+  });
+
+  it('returns 3 when triggers matched', () => {
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [{ keyword: 'x' }], chain_ref: [], node_chosen: 'direct' })).toBe(3);
+  });
+
+  it('returns 4 when a chain was referenced (array or non-empty string)', () => {
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [], chain_ref: ['routing-off-phase L1'], node_chosen: 'direct' })).toBe(4);
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [], chain_ref: 'L1', node_chosen: 'direct' })).toBe(4);
+  });
+
+  it('returns 5 when a node was actually chosen (execution)', () => {
+    expect(deriveRouterStep({ task_classification: 'other', triggers_matched: [], chain_ref: [], node_chosen: '#19' })).toBe(5);
+  });
+
+  it('takes the furthest stage reached (max), not the first', () => {
+    expect(deriveRouterStep({ task_classification: 'feature', triggers_matched: [{ k: 1 }], chain_ref: [], node_chosen: '#19' })).toBe(5);
+  });
+
+  it('handles a missing/empty primary_rationale → 1', () => {
+    expect(deriveRouterStep(undefined)).toBe(1);
+    expect(deriveRouterStep({})).toBe(1);
+  });
+});
+
+describe('routerStepReached (derived from observable signals)', () => {
+  // Признаковые шаблоны (хранимый step специально проставлен 1/99 — должен игнорироваться).
+  const at = {
+    1: { task_classification: 'other', triggers_matched: [], chain_ref: [], node_chosen: 'direct' },
+    3: { task_classification: 'other', triggers_matched: [{ k: 1 }], chain_ref: [], node_chosen: 'direct' },
+    5: { task_classification: 'feature', triggers_matched: [], chain_ref: [], node_chosen: '#19' },
+  };
+
+  it('counts episodes by derived step, ignoring any stored pr.step value', () => {
+    const eps = [
+      ep({ primary_rationale: { ...at[1], step: 1 } }),
+      ep({ primary_rationale: { ...at[1], step: 99 } }),
+      ep({ primary_rationale: { ...at[3], step: 1 } }),
+      ep({ primary_rationale: { ...at[5], step: 1 } }),
+    ];
+    const res = routerStepReached(eps);
+    expect(res.distribution['1']).toBe(2);
+    expect(res.distribution['3']).toBe(1);
+    expect(res.distribution['5']).toBe(1);
+    expect(res.total).toBe(4);
+  });
+
+  it('flags suspicious=true when >90% эпизодов выводятся в step 1', () => {
+    const eps = Array.from({ length: 11 }, (_, i) =>
+      ep({ primary_rationale: i === 10 ? { ...at[3], step: 1 } : { ...at[1], step: 1 } })
+    );
+    expect(routerStepReached(eps).suspicious).toBe(true);
+  });
+
+  it('suspicious=false when distribution более равномерное', () => {
+    const eps = [
+      ep({ primary_rationale: { ...at[1], step: 1 } }),
+      ep({ primary_rationale: { ...at[3], step: 1 } }),
+      ep({ primary_rationale: { ...at[5], step: 1 } }),
+    ];
+    expect(routerStepReached(eps).suspicious).toBe(false);
+  });
+
+  it('ignores v1 episodes and observer_error markers', () => {
+    const eps = [
+      { schema_version: 1, primary_rationale: { ...at[5] } },
+      { observer_error: true },
+      ep({ primary_rationale: { ...at[3], step: 1 } }),
+    ];
+    const res = routerStepReached(eps);
+    expect(res.distribution).toEqual({ '3': 1 });
+    expect(res.total).toBe(1);
+  });
+});
+
+describe('boundariesAppliedRate', () => {
+  it('counts overall rate of boundaries applied', () => {
+    const eps = [
+      ep({ primary_rationale: { boundaries_applied: [{ adr: 'ADR-001' }], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+      ep({ primary_rationale: { boundaries_applied: [], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+      ep({ primary_rationale: { boundaries_applied: [{ adr: 'ADR-002' }], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+    ];
+    const res = boundariesAppliedRate(eps);
+    expect(res.total).toBe(3);
+    expect(res.withBoundaries).toBe(2);
+    expect(res.rate).toBeCloseTo(2 / 3);
+  });
+
+  it('splits by path_type', () => {
+    const eps = [
+      ep({ path_type: 'regulated', primary_rationale: { boundaries_applied: [{ adr: 'X' }], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+      ep({ path_type: 'regulated', primary_rationale: { boundaries_applied: [], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+      ep({ path_type: 'free', primary_rationale: { boundaries_applied: [{ adr: 'Y' }], task_classification: 'feature', node_chosen: 'direct', triggers_matched: [], step: 1 } }),
+    ];
+    const res = boundariesAppliedRate(eps);
+    expect(res.byPathType.regulated.total).toBe(2);
+    expect(res.byPathType.regulated.withBoundaries).toBe(1);
+    expect(res.byPathType.free.total).toBe(1);
+    expect(res.byPathType.free.withBoundaries).toBe(1);
+  });
+
+  it('returns rate=0 on empty input', () => {
+    expect(boundariesAppliedRate([])).toEqual({
+      total: 0, withBoundaries: 0, rate: 0, byPathType: {},
+    });
+  });
+});

tools/observer-classification-map.json

@@ -1,6 +1,6 @@
 {
   "$schema_version": 1,
-  "description": "Mapping from observer transcript-parser task_classification values to recommended Tooling Прил.Н node IDs. Source of truth for missed-activation detection (Pravila §16.4 conditional rule). 'other' deliberately empty — no recommendation, never counts as missed. DEFERRED-узлы filtered out by .node-dormancy.json at runtime. Classifier vocabulary is Claude's free judgment when writing the episode (no hardcoded enum) — adding a key here makes it 'blessed'. 'security' added 22.05.2026 (A8 follow-up): use when the PURPOSE of the task is verifying or improving security (scans, hardening, audits, threat modeling, go-live gates); NOT for bug-fixes that happen to be in security-relevant code (those stay 'bugfix'). 'marketing' added 22.05.2026 (C1 follow-up): use when the PURPOSE of the task is Лидерра's own marketing/lead-generation (content, SEO, campaigns, RU-channels, landing conversion, marketing-side 152-FZ); NOT for product features, billing flows, or PII-code audits. 'question' emptied 23.05.2026 (brain-retro #3 A1): conversational Russian Q&A («делай», «а», уточнения) was producing 17/40 false-positive missed-activations against #60 context7 — context7 is for library-docs lookup, not chat. 'memory-sync' emptied 23.05.2026 (brain-retro #3 A2): #33 claude-md-management is the channel for CLAUDE.md edits (Pravila §5 п.10), NOT for memory/*.md (auto-memory writes natively); was producing 8/40 false-positive missed-activations.",
+  "description": "DEPRECATED (2026-05-24): source of truth migrated to docs/registry/nodes.yaml + tools/registry-to-classification-map.mjs. This file is retained ONLY for historic v2-episode replay in tests; new code MUST consume the registry. Removal scheduled for stage 4 of router-discipline-overhaul. Original description follows. — Mapping from observer transcript-parser task_classification values to recommended Tooling Прил.Н node IDs. Source of truth for missed-activation detection (Pravila §16.4 conditional rule). 'other' deliberately empty — no recommendation, never counts as missed. DEFERRED-узлы filtered out by .node-dormancy.json at runtime. Classifier vocabulary is Claude's free judgment when writing the episode (no hardcoded enum) — adding a key here makes it 'blessed'. 'security' added 22.05.2026 (A8 follow-up): use when the PURPOSE of the task is verifying or improving security (scans, hardening, audits, threat modeling, go-live gates); NOT for bug-fixes that happen to be in security-relevant code (those stay 'bugfix'). 'marketing' added 22.05.2026 (C1 follow-up): use when the PURPOSE of the task is Лидерра's own marketing/lead-generation (content, SEO, campaigns, RU-channels, landing conversion, marketing-side 152-FZ); NOT for product features, billing flows, or PII-code audits. 'question' emptied 23.05.2026 (brain-retro #3 A1): conversational Russian Q&A («делай», «а», уточнения) was producing 17/40 false-positive missed-activations against #60 context7 — context7 is for library-docs lookup, not chat. 'memory-sync' emptied 23.05.2026 (brain-retro #3 A2): #33 claude-md-management is the channel for CLAUDE.md edits (Pravila §5 п.10), NOT for memory/*.md (auto-memory writes natively); was producing 8/40 false-positive missed-activations.",
   "map": {
     "refactor":     ["#11", "#12", "#43", "#64", "#65"],
     "bugfix":       ["#18", "#34"],

tools/observer-state-enricher.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * Router state enricher for observer episodes.
+ * Reads ~/.claude/runtime/router-state-<sessionId>.json and exposes pure
+ * extraction helpers for primary_rationale enrichment.
+ *
+ * Pure-ish — fs is parameterized via options.baseDir for testability.
+ *
+ * Per spec: docs/superpowers/specs/2026-05-24-router-stage3-three-fixes-design.md
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+function defaultBaseDir() {
+  return join(homedir(), '.claude', 'runtime');
+}
+
+export function readRouterState(sessionId, options = {}) {
+  if (!sessionId || typeof sessionId !== 'string') return null;
+  const baseDir = options.baseDir || defaultBaseDir();
+  const path = join(baseDir, `router-state-${sessionId}.json`);
+  if (!existsSync(path)) return null;
+  try {
+    const content = readFileSync(path, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export function extractRouterFields(state) {
+  if (!state || typeof state !== 'object') {
+    return { recommended_node: null, recommended_chain: null, chain_progress: [], chain_completed: false };
+  }
+  const cls = state.classification || {};
+  return {
+    recommended_node: cls.recommendedNode || null,
+    recommended_chain: cls.recommendedChain || null,
+    chain_progress: Array.isArray(state.chainProgress) ? state.chainProgress : [],
+    chain_completed: state.chainCompleted === true,
+  };
+}