@rt-tools/agent-kit 0.6.0 → 0.8.0

package/assets/hooks/reuse-first-guard.sh

@@ -132,8 +132,90 @@ has_re() {
     printf '%s' "$1" | RT_RE="$2" perl -0777 -ne 'exit(/$ENV{RT_RE}/s ? 0 : 1)' 2>/dev/null
 }
 
+# Что дерево объявило своим: наборы признаков и файл собственных. Настройка проверок — та же,
+# что читает сплошная проверка; каталог наборов называет профиль дерева, потому что раскладка
+# проверок у каждого дерева своя.
+rt_checks_json="${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/checks.json"
+rt_bundles=''
+rt_own_signals=''
+if [ -f "$rt_checks_json" ]; then
+    rt_bundles="$(jq -r '.reuse.bundles[]? // empty' "$rt_checks_json" 2>/dev/null | tr '\n' ' ')"
+    own="$(jq -r '.reuse.signals // empty' "$rt_checks_json" 2>/dev/null)"
+    [ -n "$own" ] && rt_own_signals="${CLAUDE_PROJECT_DIR:-.}/$own"
+fi
+rt_signals_dir="${CLAUDE_PROJECT_DIR:-.}/${RT_REUSE_SIGNALS_DIR:-tools/signals}"
+
+# Признаки объявленных наборов: те же файлы читает сплошная проверка. Ключ признака совпал с
+# ключом дерева — побеждает дерево: оно видит своё готовое, а пакет его не видел.
+signals_json() {
+    [ -n "$rt_signals_dir" ] || return 0
+    [ -d "$rt_signals_dir" ] || return 0
+    # Шапка раскладки снимается до разбора: в JSON комментария нет, и с ней разбор падает.
+    for name in $rt_bundles; do
+        file="$rt_signals_dir/$name.json"
+        [ -f "$file" ] && grep -v '^# rt-kit ' "$file" | jq -c '.signals[]?' 2>/dev/null
+    done
+    [ -n "$rt_own_signals" ] && [ -f "$rt_own_signals" ] && grep -v '^# rt-kit ' "$rt_own_signals" | jq -c '.signals[]?' 2>/dev/null
+}
+
+# Поля читаются по одному, а не разбором строки: таб в `IFS` — пробельный разделитель, и пустое
+# поле в середине схлопывается, из-за чего совет уезжает в образец отмены и гасит признак молча.
+field() { printf '%s' "$1" | jq -r "$2 // empty" 2>/dev/null; }
+
 found=''
-while IFS="$(printf '\t')" read -r scope pattern cancel replacement; do
+signals_seen=0
+while IFS= read -r signal; do
+    [ -z "$signal" ] && continue
+    signals_seen=1
+    ext="$(field "$signal" '.ext')"
+    case "$ext" in
+        '') ;;
+        *) case "$path" in *"$ext") ;; *) continue ;; esac ;;
+    esac
+    only_named="$(field "$signal" '.onlyNamed')"
+    if [ -n "$only_named" ]; then
+        printf '%s' "${path##*/}" | grep -qE "$only_named" || continue
+    fi
+
+    case "$(field "$signal" '.scope')" in
+        whole) text="$whole" ;;
+        *) text="$added" ;;
+    esac
+
+    pattern="$(field "$signal" '.find')"
+    [ -z "$pattern" ] && continue
+    strip="$(field "$signal" '.strip')"
+    [ -n "$strip" ] && text="$(printf '%s' "$text" | RT_RE="$strip" perl -0777 -pe 's/$ENV{RT_RE}//gs' 2>/dev/null)"
+
+    has_re "$text" "$pattern" || continue
+
+    cancel="$(field "$signal" '.cancel')"
+    [ -n "$cancel" ] && has_re "$text" "$cancel" && continue
+
+    skip_signal=''
+    while IFS= read -r one; do
+        [ -z "$one" ] && continue
+        has_re "$text" "$one" || skip_signal=1
+    done <<ALL
+$(printf '%s' "$signal" | jq -r '.all[]? // empty' 2>/dev/null)
+ALL
+    [ -n "$skip_signal" ] && continue
+
+    found="${found}
+  - $(field "$signal" '.instead')"
+done <<EOF
+$(signals_json | jq -s -c 'reduce .[] as $one ({}; .[$one.key] = $one) | .[]' 2>/dev/null)
+EOF
+
+# Функция профиля остаётся вторым источником: деревья её уже написали. Поля читаются построчно,
+# по тем же четырём колонкам, что объявлены выше.
+while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    signals_seen=1
+    scope="$(printf '%s' "$line" | cut -f1)"
+    pattern="$(printf '%s' "$line" | cut -f2)"
+    cancel="$(printf '%s' "$line" | cut -f3)"
+    replacement="$(printf '%s' "$line" | cut -f4)"
     [ -z "$pattern" ] && continue
     case "$scope" in
         whole) text="$whole" ;;
@@ -147,6 +229,13 @@ done <<EOF
 $(rt_reinvented_in "$path" 2>/dev/null)
 EOF
 
+# Гард без единого признака неотличим от гарда, которому нечего отбивать. Правку он пропускает —
+# останавливать работу за ненастроенное дерево не за что, — но говорит, чем это настраивается.
+if [ "$signals_seen" = 0 ]; then
+    printf '%s\n' 'reuse-first-guard: признаков нет — объявите наборы ключом `reuse.bundles` в настройке проверок' >&2
+    exit 0
+fi
+
 [ -z "$found" ] && exit 0
 
 reason="BLOCKED: это уже написано. Файл: ${path##*/}

package/assets/patterns/git-workflow-commit.azure.md

@@ -201,6 +201,11 @@ az repos pr show --id 205 \
 
 Владельцу называют то, что прочитали, а не то, что заказывали.
 
+Перечитывают его и по времени, а не только после вызовов, которые молча ничего не сделали:
+состояние PR читается перед тем, как что-либо о нём сказать. Между «прогон зелёный» и следующей
+фразой владелец успевает влить PR, и всё сказанное о нём после этого — про вчерашний день. Так
+владельцу и было предложено влить то, что он влил часом раньше.
+
 Открытый PR означает, что элемент ждёт разбора, — состояние переставляется тем же движением:
 
 ```bash
@@ -236,6 +241,14 @@ npm run task:move -- 86 in-review
 сделано>`, тем же номером, что стоит у элемента и в имени ветки.
 12. **Очередь работ сходится** — `npm run check:board`.
 13. **Состояние PR прочитано, а не выведено из кодов возврата.**
+14. **Набор взят из файла конвейера, а не собран по памяти.** Гейт пуша заведомо уже: он стоит
+    между командой и пушем, и всё, что дольше секунд, из него вынесено. Что гоняет конвейер,
+    написано в его файле — этот список и повторяется локально; зелёный гейт полнотой набора не
+    является.
+15. **Набор пересмотрен после вливания главной ветки.** Он выбирается по тому, что ветка везёт
+    теперь, а не по тому, что правил автор. Ветка, не тронувшая ни строки показа, прогоняет
+    снимки витрин: с момента вливания их гоняет конвейер на её коде, и красное придёт на её
+    отчёт.
 
 Сразу после публикации элемент переводится в разбор, и сверка очереди прогоняется ещё раз: до
 открытия PR состояние она не судит, а после открытия расхождение видит.
@@ -243,6 +256,11 @@ npm run task:move -- 86 in-review
 Сделанное рассуждением и сделанное замером в теле PR разводятся прямо: непроверенное,
 названное проверенным, ревьювер принимает за проверенное.
 
+**Раздел «Чем подтверждено» называет и то, что не гонялось.** Список одного прогнанного
+неотличим от полного набора, и ревьювер по нему решает, что можно не перепроверять. Цена ошибки
+здесь не красный конвейер, а доверие к разделу: однажды прочитанный как полнота, дальше он
+перепроверяется весь.
+
 ## Частые промахи
 
 - Область и итерация не заданы: элемент заведён, но на доску команды не попал.

package/assets/patterns/git-workflow-commit.github.md

@@ -249,6 +249,11 @@ $GH api "repos/$REPO/pulls/321" \
 Учётная запись, из-под которой пришлось пушить, в этот вызов не переносится: пуш и авторство
 PR выбираются отдельно, и `GH_TOKEN` для публикации — всегда токен бота.
 
+Перечитывают его и по времени, а не только после вызовов, которые молча ничего не сделали:
+состояние PR читается перед тем, как что-либо о нём сказать. Между «прогон зелёный» и следующей
+фразой владелец успевает влить PR, и всё сказанное о нём после этого — про вчерашний день. Так
+владельцу и было предложено влить то, что он влил часом раньше.
+
 Открытый PR означает, что задача ждёт разбора, — колонка переставляется тем же движением:
 
 ```bash
@@ -293,6 +298,14 @@ npm run task:move -- 86 in-review
     номером в заголовке; PR один на задачу, и закрывает он её целиком.
 13. **Состояние PR прочитано, а не выведено из кодов возврата** — автор `<бот>`,
     ревьювер — владелец, метки те же, что у задачи. Владельцу называют прочитанное.
+14. **Набор взят из файла конвейера, а не собран по памяти.** Гейт пуша заведомо уже: он стоит
+    между командой и пушем, и всё, что дольше секунд, из него вынесено. Что гоняет конвейер,
+    написано в его файле — этот список и повторяется локально; зелёный гейт полнотой набора не
+    является.
+15. **Набор пересмотрен после вливания главной ветки.** Он выбирается по тому, что ветка везёт
+    теперь, а не по тому, что правил автор. Ветка, не тронувшая ни строки показа, прогоняет
+    снимки витрин: с момента вливания их гоняет конвейер на её коде, и красное придёт на её
+    отчёт.
 
 Сразу после публикации задача переставляется в разбор — `npm run task:move -- <номер>
 in-review`, — и `npm run check:board` прогоняется ещё раз: до открытия PR колонку он не судит,
@@ -301,6 +314,11 @@ in-review`, — и `npm run check:board` прогоняется ещё раз:
 Сделанное рассуждением и сделанное замером в теле PR разводятся прямо: непроверенное,
 названное проверенным, ревьювер принимает за проверенное.
 
+**Раздел «Чем подтверждено» называет и то, что не гонялось.** Список одного прогнанного
+неотличим от полного набора, и ревьювер по нему решает, что можно не перепроверять. Цена ошибки
+здесь не красный конвейер, а доверие к разделу: однажды прочитанный как полнота, дальше он
+перепроверяется весь.
+
 ## Частые промахи
 
 - `gh` в оболочке пользователя подменён — звать `/opt/homebrew/bin/gh` напрямую.

package/assets/patterns/git-workflow-commit.gitlab.md

@@ -221,6 +221,11 @@ glab mr view 205 --output json \
 Учётная запись, из-под которой пришлось пушить, в этот вызов не переносится: пуш и авторство
 MR выбираются отдельно, и токен для публикации — всегда токен машинной работы.
 
+Перечитывают его и по времени, а не только после вызовов, которые молча ничего не сделали:
+состояние MR читается перед тем, как что-либо о нём сказать. Между «прогон зелёный» и следующей
+фразой владелец успевает влить MR, и всё сказанное о нём после этого — про вчерашний день. Так
+владельцу и было предложено влить то, что он влил часом раньше.
+
 Открытый MR означает, что задача ждёт разбора, — список переставляется тем же движением:
 
 ```bash
@@ -256,6 +261,14 @@ npm run task:move -- 86 in-review
 сделано>`, тем же номером, что стоит у задачи и в имени ветки.
 12. **Очередь работ сходится** — `npm run check:board`.
 13. **Состояние MR прочитано, а не выведено из кодов возврата.**
+14. **Набор взят из файла конвейера, а не собран по памяти.** Гейт пуша заведомо уже: он стоит
+    между командой и пушем, и всё, что дольше секунд, из него вынесено. Что гоняет конвейер,
+    написано в его файле — этот список и повторяется локально; зелёный гейт полнотой набора не
+    является.
+15. **Набор пересмотрен после вливания главной ветки.** Он выбирается по тому, что ветка везёт
+    теперь, а не по тому, что правил автор. Ветка, не тронувшая ни строки показа, прогоняет
+    снимки витрин: с момента вливания их гоняет конвейер на её коде, и красное придёт на её
+    отчёт.
 
 Сразу после публикации задача переставляется в разбор, и сверка очереди прогоняется ещё раз: до
 открытия MR список она не судит, а после открытия расхождение видит.
@@ -263,6 +276,11 @@ npm run task:move -- 86 in-review
 Сделанное рассуждением и сделанное замером в теле MR разводятся прямо: непроверенное,
 названное проверенным, ревьювер принимает за проверенное.
 
+**Раздел «Чем подтверждено» называет и то, что не гонялось.** Список одного прогнанного
+неотличим от полного набора, и ревьювер по нему решает, что можно не перепроверять. Цена ошибки
+здесь не красный конвейер, а доверие к разделу: однажды прочитанный как полнота, дальше он
+перепроверяется весь.
+
 ## Частые промахи
 
 - Метка списка не поставлена при заведении: задача есть, а на доске её нет. Доска показывает

package/assets/patterns/reuse-first-extend.md

@@ -45,6 +45,36 @@ grep -rn "<похожий приём>" libs/admin libs/site --include='*.html' |
 Спрашивается до того, как написан первый файл. То же относится к своей базе и к своему
 инлайновому стилю.
 
+## Своё готовое объявляется признаком
+
+Заведённое с одобрения владельца видит только тот, кто о нём знает. Чтобы следующий его не
+обошёл, дерево дописывает признак в свой файл признаков — тот, что назван ключом
+`reuse.signals` в настройке проверок:
+
+```json
+{
+    "key": "<короткое имя признака>",
+    "ext": ".ts",
+    "mode": "presence",
+    "scope": "whole",
+    "find": "implements +<интерфейс, который закрывает основа>",
+    "cancel": "extends +<основа>",
+    "instead": "<основа> — она уже держит <что именно>"
+}
+```
+
+Область объявляется явно. `whole` читает правку вместе с содержимым файла и берётся там, где
+признак судит устройство класса: наследование и метка объявлены один раз и в точечную правку не
+попадают, поэтому признак без `whole` молчит всегда. `added` читает только добавленный текст и
+берётся там, где признак судит саму строку — сырой тег, свой стиль.
+
+Отмена `cancel` обязательна везде, где готовое можно позвать законно: без неё признак отбивает и
+того, кто основу уже унаследовал. Пустой её не оставляют — признак без отмены объявляется без
+этого поля вовсе.
+
+Ключ, совпавший с пакетным, замещает его: дерево вправе сказать о своём готовом точнее, чем
+пакет, который его не видел.
+
 ## Разовое отступление объявляется маркером
 
 ```html

package/assets/patterns/spec-driven-domain.md

@@ -48,8 +48,8 @@ docs/specs/<домен>/
 процедуры домен обслуживает.
 
 ```markdown
-**Зависимости:** `pricing` (сумма заявки), `availability` (занятость дат)
-**Законы:** `access`, `locales`, `money`, `ownership`
+**Зависимости:** `catalog` (состав заявки), `availability` (занятость дат)
+**Законы:** `access`, `locales`, `lists`
 **Процедуры:** `libs/api/<домен>`
 ```
 

package/assets/rules/git-workflow.azure.md

@@ -108,6 +108,21 @@ description: Правило под «Закон о поставке» для д
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до слияния. Четыре слияния подряд так и уехали в главную ветку, ломая
   выкатку.
+- **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
+  красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
+  конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,
+  отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
+  разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
+  зелёный гейт был прочитан как «локально всё зелено».
+- **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
+  теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
+  проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
+  снимки витрин с того момента, как вливание принесло чужую правку оформления.
+- **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
+  протухает в ту минуту, когда её подтянули в последний раз, и молчит об этом: она не пуста и не
+  сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
+  смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
+  изнутри выглядит правильным.
 - **Рабочий элемент привязывается к PR при создании, а не после.** `az repos pr create`
   принимает `--work-items`; привязка второй командой обходится молча, когда у токена нет права
   править чужой элемент, и PR остаётся ни с чем не связанным.

package/assets/rules/git-workflow.github.md

@@ -118,6 +118,21 @@ description: Правило под «Закон о поставке» для д
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до мержа. Четыре мержа подряд так и уехали в главную ветку, ломая выкатку.
+- **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
+  красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
+  конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,
+  отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
+  разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
+  зелёный гейт был прочитан как «локально всё зелено».
+- **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
+  теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
+  проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
+  снимки витрин с того момента, как вливание принесло чужую правку оформления.
+- **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
+  протухает в ту минуту, когда её подтянули в последний раз, и молчит об этом: она не пуста и не
+  сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
+  смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
+  изнутри выглядит правильным.
 - **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
   молча не создаёт — разбор при этом выглядит запрошенным.
 - **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На

package/assets/rules/git-workflow.gitlab.md

@@ -108,6 +108,21 @@ description: Правило под «Закон о поставке» для д
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до слияния. Четыре слияния подряд так и уехали в главную ветку, ломая
   выкатку.
+- **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
+  красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
+  конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,
+  отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
+  разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
+  зелёный гейт был прочитан как «локально всё зелено».
+- **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
+  теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
+  проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
+  снимки витрин с того момента, как вливание принесло чужую правку оформления.
+- **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
+  протухает в ту минуту, когда её подтянули в последний раз, и молчит об этом: она не пуста и не
+  сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
+  смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
+  изнутри выглядит правильным.
 - **Слияние по кнопке «Merge when pipeline succeeds» не заменяет проверок до пуша.** Конвейер
   видит только то, что уже отправлено, а отправленная красная ветка занимает очередь работ и
   выглядит готовой к разбору.

package/assets/rules/reuse-first.md

@@ -46,9 +46,12 @@ description: Правило под «Закон о единообразии пр
   раз в общем слое приложения, а экран её только применяет теми же директивами BEM.
 - **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в ките или в
   базовом классе, и его видят остальные экраны.
-- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки
-  у неё те же, что у гарда, а смотрит она файл целиком: гейт падает на новом месте, старое
-  остаётся числом в сводке.
+- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки у
+  неё те же, что у гарда, потому что оба читают одни и те же объявленные наборы, а смотрит она
+  файл целиком: гейт падает на новом месте, старое остаётся числом в сводке.
+- **Признаки объявляются деревом, а не зашиты в проверку.** Дерево берёт из rt-tools не всё, и
+  признак о готовом из пакета, которого здесь нет, отвечает ложно ровно так же, как имя чужого
+  приложения.
 
 ## Чего из закона здесь нет
 
@@ -67,16 +70,24 @@ description: Правило под «Закон о единообразии пр
 
 ## Признаки, по которым видно, что готовое обошли
 
-- в шаблоне фичи стоит нативный `<input>`, `<button>`, `<select>`, `<table>` или `<dialog>`;
-- отказ или предупреждение собраны руками — свой `role="alert"` вместо `rt-message`;
-- в `.scss` фичи появились `position: fixed` на весь экран, свой backdrop, `z-index` от тысячи,
-  `@keyframes` вращения или мерцания;
-- в файле стилей экрана объявлена раскладка — `display: flex` с `gap` и `padding` на `:host`;
-- компонент реализует `ControlValueAccessor` сам, а не наследует `RtFormControlBase`;
-- имя файла кончается на `-button`, `-input`, `-dialog`, `-spinner` или `-table` вне
-  кита;
-- маппер переводит поля вручную, без `BaseMapper`;
-- процедура бэкенда объявлена без `@ConnectProcedure()`.
+Списком их здесь нет: признак — это данные, а не текст правила и не код проверки. Наборы лежат
+при пакете, по файлу на пакет rt-tools, и в каждом только то, что везёт он сам. Дерево называет
+нужные ему наборы ключом `reuse.bundles` в настройке проверок и дописывает свои признаки файлом,
+названным ключом `reuse.signals`; совпавший ключ замещает пакетный, новый дописывается. Гард на
+правке и сплошная проверка читают отсюда оба — разойтись им нечем.
+
+Что бывает признаком:
+
+- нативный контрол в шаблоне там, где кит везёт свой;
+- отказ, предупреждение или ожидание, собранные руками вместо готового;
+- наложение поверх страницы, объявленное своими стилями, — подложка, порядок слоёв, вращение;
+- раскладка, объявленная в файле стилей экрана, а не применённая директивами из общего слоя;
+- своя реализация того, что даёт основа кита, вместо наследования;
+- имя файла, повторяющее имя китового примитива, вне кита.
+
+Признак называет свою область: наследование основы и метка класса в точечную правку не попадают,
+и признак, судящий их по добавленному тексту, молчит всегда. Признак называет и отмену — образец,
+при котором он не срабатывает: основа уже унаследована, готовое уже позвано.
 
 ## Ловушки
 
@@ -90,3 +101,10 @@ description: Правило под «Закон о единообразии пр
   отступ, оставаясь тем же кодом.
 - Ответ, данный до чтения образца, образец отменяет: согласованная форма выборки списка
   переигрывалась вместе с контрактом через два вопроса после того, как была принята.
+- **Набор объявляется по тому, что дерево потребляет, а не по тому, что пакет везёт.** Дерево, в
+  котором кит написан, а не позван, объявив его набор, получает советы звать кит на файлах самого
+  кита: признак верен, но обращён не туда. Такое дерево объявляет только те наборы, чьё готовое
+  оно берёт со стороны.
+- **Гард, не получивший ни одного признака, неотличим от гарда, которому нечего отбивать.** Он
+  говорит об этом сам, и первая же правка в дереве без объявленных наборов это показывает.
+  Молчание проверки признаком порядка не считается — сначала смотрят, есть ли ей чем судить.

package/assets/skills/agent-kit.md

@@ -19,14 +19,15 @@ description: Переносимый слой правил агента — за
 
 ## Где что настраивается
 
-| Что меняешь                                    | Куда правка                                        |
-| ---------------------------------------------- | -------------------------------------------------- |
-| какое правило гейт требует под какой файл      | `.claude/rt-kit/gate-map.sh` — своя `skill_for`    |
-| порты, адреса, линтеры, форма ветки, инвентарь | `.claude/rt-kit/project.sh` — свои `rt_*`          |
-| пути и идентификаторы, которыми живут проверки | `.claude/rt-kit/checks.json`                       |
-| раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>` |
-| что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`       |
-| сам механизм — гард, проверка, текст правила   | ресурс в пакете                                    |
+| Что меняешь                                    | Куда правка                                            |
+| ---------------------------------------------- | ------------------------------------------------------ |
+| какое правило гейт требует под какой файл      | `.claude/rt-kit/gate-map.sh` — своя `skill_for`        |
+| порты, адреса, линтеры, форма ветки, инвентарь | `.claude/rt-kit/project.sh` — свои `rt_*`              |
+| пути и идентификаторы, которыми живут проверки | `.claude/rt-kit/checks.json`                           |
+| какие признаки единообразия дерево берёт       | `checks.json`, ключи `reuse.bundles` и `reuse.signals` |
+| раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>`     |
+| что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`           |
+| сам механизм — гард, проверка, текст правила   | ресурс в пакете                                        |
 
 Надстройка объявляет функцию заново и вправе позвать умолчание тем же именем с суффиксом
 `_default`. Слияние текста идёт по разделам `## `: совпавший заголовок замещает, новый
@@ -84,6 +85,10 @@ npx agent-kit propose       # отправить предложения, адр
 
 ## Ловушки
 
+- **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
+  строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
+  которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
+
 - **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
   отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
   зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала

package/lib/assets.d.ts

@@ -19,6 +19,6 @@ export interface IAsset {
  * ресурса нет. У разложенного `git-workflow` хостинга в имени не остаётся: второго вида в этом
  * дереве нет, а агенту, который правило читает, различать их незачем.
  */
-export declare function targetOf(entry: IEntryOfCatalog, layout: Readonly<Record<TKind, string>>): string;
+export declare function targetOf(entry: Pick<IEntryOfCatalog, 'id' | 'kind' | 'name'>, layout: Readonly<Record<TKind, string>>): string;
 export declare function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[];
 //# sourceMappingURL=assets.d.ts.map

package/lib/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAyB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,OAAO,EAA2B,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,MAAM;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAUD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAIhG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAWnF"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,eAAe,EAAe,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,OAAO,EAA2B,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,MAAM;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAUD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAI9H;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CASnF"}

package/lib/assets.js

@@ -6,7 +6,7 @@
  * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.
  */
 import { join } from 'node:path';
-import { isChosen, readCatalog } from './catalog.js';
+import { chosenEntries, readCatalog } from './catalog.js';
 import { SKILL_FILE, SKILL_KINDS } from './config.js';
 /** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */
 const extensionOf = (id) => {
@@ -27,9 +27,7 @@ export function targetOf(entry, layout) {
         : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);
 }
 export function collectAssets(config, assetsDir) {
-    return readCatalog(assetsDir)
-        .filter((entry) => isChosen(entry, config))
-        .map((entry) => ({
+    return chosenEntries(readCatalog(assetsDir), config).map((entry) => ({
         id: entry.id,
         kind: entry.kind,
         name: entry.name,

package/lib/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAmB,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAW,UAAU,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AAetE,kFAAkF;AAClF,MAAM,WAAW,GAA2B,CAAC,EAAU,EAAU,EAAE;IAC/D,MAAM,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB,EAAE,MAAuC;IACpF,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,WAAW,CAAC,SAAS,CAAC;SACxB,MAAM,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SACpE,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QACtC,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACtC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC/B,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { IEntryOfCatalog, isChosen, readCatalog } from './catalog.js';\nimport { IConfig, SKILL_FILE, SKILL_KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /** Имя без рода, вида и расширения: `delivery`. У скила — имя каталога, которым его зовут. */\n    readonly name: string;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n    /** Запускается ли файл сам по себе: гарда без права на запуск не существует. */\n    readonly executable: boolean;\n}\n\n/** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */\nconst extensionOf: (id: string) => string = (id: string): string => {\n    const dot: number = id.lastIndexOf('.');\n    const slash: number = id.lastIndexOf('/');\n\n    return dot > slash ? id.slice(dot) : '';\n};\n\n/**\n * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть\n * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом —\n * по имени, а не по идентификатору: слой законов из идентификатора в путь переезжает, а вид\n * ресурса нет. У разложенного `git-workflow` хостинга в имени не остаётся: второго вида в этом\n * дереве нет, а агенту, который правило читает, различать их незачем.\n */\nexport function targetOf(entry: IEntryOfCatalog, layout: Readonly<Record<TKind, string>>): string {\n    return SKILL_KINDS.includes(entry.kind)\n        ? join(layout[entry.kind], entry.name, SKILL_FILE)\n        : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return readCatalog(assetsDir)\n        .filter((entry: IEntryOfCatalog): boolean => isChosen(entry, config))\n        .map((entry: IEntryOfCatalog): IAsset => ({\n            id: entry.id,\n            kind: entry.kind,\n            name: entry.name,\n            text: entry.text,\n            target: targetOf(entry, config.layout),\n            executable: entry.executable,\n        }));\n}\n"]}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAW,UAAU,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AAetE,kFAAkF;AAClF,MAAM,WAAW,GAA2B,CAAC,EAAU,EAAU,EAAE;IAC/D,MAAM,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoD,EAAE,MAAuC;IAClH,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QAC1F,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACtC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC/B,CAAC,CAAC,CAAC;AACR,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { chosenEntries, IEntryOfCatalog, readCatalog } from './catalog.js';\nimport { IConfig, SKILL_FILE, SKILL_KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /** Имя без рода, вида и расширения: `delivery`. У скила — имя каталога, которым его зовут. */\n    readonly name: string;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n    /** Запускается ли файл сам по себе: гарда без права на запуск не существует. */\n    readonly executable: boolean;\n}\n\n/** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */\nconst extensionOf: (id: string) => string = (id: string): string => {\n    const dot: number = id.lastIndexOf('.');\n    const slash: number = id.lastIndexOf('/');\n\n    return dot > slash ? id.slice(dot) : '';\n};\n\n/**\n * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть\n * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом —\n * по имени, а не по идентификатору: слой законов из идентификатора в путь переезжает, а вид\n * ресурса нет. У разложенного `git-workflow` хостинга в имени не остаётся: второго вида в этом\n * дереве нет, а агенту, который правило читает, различать их незачем.\n */\nexport function targetOf(entry: Pick<IEntryOfCatalog, 'id' | 'kind' | 'name'>, layout: Readonly<Record<TKind, string>>): string {\n    return SKILL_KINDS.includes(entry.kind)\n        ? join(layout[entry.kind], entry.name, SKILL_FILE)\n        : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return chosenEntries(readCatalog(assetsDir), config).map((entry: IEntryOfCatalog): IAsset => ({\n        id: entry.id,\n        kind: entry.kind,\n        name: entry.name,\n        text: entry.text,\n        target: targetOf(entry, config.layout),\n        executable: entry.executable,\n    }));\n}\n"]}

package/lib/catalog.d.ts

@@ -30,6 +30,22 @@ export interface IEntryOfCatalog {
      */
     readonly requires: readonly string[];
 }
+/** Что объявила шапка ресурса. Пустое поле и отсутствующее здесь одно и то же. */
+export interface IFrontMatter {
+    readonly name: string;
+    readonly kind: string;
+    /** Закон, под которым стоит правило. */
+    readonly law: string;
+    /** Правило, при котором стоит паттерн. */
+    readonly rule: string;
+}
+/**
+ * Вступление между `---` в начале файла; его нет — вернётся пустая шапка.
+ *
+ * Живёт при каталоге, потому что связь родителя с потомком читают двое: сверка связности пакета
+ * и каскад отказа. Объявление у одного из них заводило бы круговой импорт между ними.
+ */
+export declare function frontMatterOf(text: string): IFrontMatter;
 /**
  * Что ресурс о себе объявил. Имена читаются идентификаторами — `hooks/observe.sh`: короткая
  * форма совпала бы у закона и правила с одним именем, а требование, указавшее не туда, хуже
@@ -91,6 +107,63 @@ export interface IGapOfVariant {
  * существующие в `skip` — дерево тем самым говорит, что обходится без этого ресурса.
  */
 export declare function variantGaps(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IGapOfVariant[];
+/** Ресурс, снятый вслед за отвергнутым родителем. */
+export interface ICascadeCut {
+    readonly id: string;
+    /** Ближайший родитель: у правила — его закон, у паттерна — его правило. */
+    readonly parent: string;
+    /**
+     * Отвергнутый корень цепочки — то, что дерево действительно отвергло или не выбрало.
+     * Ближайшего родителя мало: паттерн уходит вслед за правилом, которого в отказе нет, и
+     * искать его там читатель пойдёт зря.
+     */
+    readonly root: string;
+}
+/**
+ * Ресурсы, снятые каскадом: правила при невзятом законе и паттерны при невзятых правилах.
+ *
+ * Связь читается из вступления самого ресурса — отдельный список при пакете разошёлся бы с
+ * ресурсами молча, тем же молчанием, ради которого каскад и заводится. Родитель ищется по
+ * последнему звену имени: полного пути в шапке нет, потому что переезд закона между слоями
+ * переписывал бы шапки всех правил при нём.
+ *
+ * Родителя в каталоге нет вовсе — каскад молчит: снимать не по чему, а промах в шапке судит
+ * сверка связности пакета, до всякой раскладки в дереве.
+ */
+export declare function cascadeCuts(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly ICascadeCut[];
+/**
+ * Ресурсы, названные выбором поимённо и всё равно снятые каскадом.
+ *
+ * Дерево, назвавшее правило в выборе при невыбранном законе, не получает его молча — то самое
+ * молчание, ради которого каскад и заводится, только с другой стороны: там о снятии не знал тот,
+ * кто ничего не просил, здесь — тот, кто попросил прямо.
+ */
+export declare function namedButCut(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly ICascadeCut[];
+/**
+ * Что ложится в дерево: прямой отбор за вычетом снятого каскадом.
+ *
+ * Отдельной функцией, а не внутри `isChosen`, потому что каскад знает весь каталог, а отбор —
+ * один ресурс: связь родителя с потомком по одной записи не видна.
+ */
+export declare function chosenEntries(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IEntryOfCatalog[];
+/** Строка отказа, которая ничего не снимает. */
+export interface IIdleSkip {
+    readonly id: string;
+    /** Чем названное ею уже снято: имя отвергнутого родителя, либо пусто — такого ресурса нет. */
+    readonly by: string;
+}
+/**
+ * Строки отказа, которые ничего не снимают: названное ими снято каскадом или в каталоге не
+ * значится вовсе.
+ *
+ * Не отказ, а предупреждение: настройка, верная до обновления пакета, становится лишней сама,
+ * без единой правки в дереве, и отбивать за это раскладку значило бы наказывать за вчерашнюю
+ * правоту.
+ *
+ * Строка на ресурс чужого вида лишней не считается никогда: ею дерево гасит отказ о ресурсе,
+ * у которого нет подходящего вида, — то есть работу она делает.
+ */
+export declare function idleSkips(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IIdleSkip[];
 /** Выбранный ресурс, чьё требование в дерево не поехало. */
 export interface IBrokenLink {
     /** Кто требует — идентификатор выбранного ресурса. */