@rt-tools/agent-kit 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/assets/checks/check-file-size.mjs +19 -4
  2. package/assets/checks/check-state-next.mjs +10 -2
  3. package/assets/checks/rt-kit-checks.config.mjs +16 -2
  4. package/assets/defaults/project.sh +9 -1
  5. package/assets/defaults/turn-map.md +8 -6
  6. package/assets/hooks/browser-guard-device-id.sh +3 -1
  7. package/assets/hooks/browser-guard-no-asking.sh +3 -1
  8. package/assets/hooks/browser-guard-no-other-drivers.sh +5 -3
  9. package/assets/hooks/browser-guard-require-select.sh +4 -2
  10. package/assets/hooks/claim-guard.sh +3 -1
  11. package/assets/hooks/conscience-guard.sh +3 -1
  12. package/assets/hooks/dev-server-guard.sh +5 -3
  13. package/assets/hooks/dispatch.sh +69 -0
  14. package/assets/hooks/docs-guard.sh +6 -4
  15. package/assets/hooks/exam-guard.sh +5 -3
  16. package/assets/hooks/git-guard-delivery.sh +37 -5
  17. package/assets/hooks/git-guard-main.sh +6 -4
  18. package/assets/hooks/git-guard-push-tests.sh +6 -4
  19. package/assets/hooks/grill-gate.sh +4 -2
  20. package/assets/hooks/handoff-entry-guard.sh +4 -2
  21. package/assets/hooks/handoff-write.sh +27 -6
  22. package/assets/hooks/hook-input.sh +54 -0
  23. package/assets/hooks/lint-after-edit.sh +5 -3
  24. package/assets/hooks/postmortem-guard.sh +3 -1
  25. package/assets/hooks/proposal-guard.sh +3 -1
  26. package/assets/hooks/prose-style-guard.sh +5 -3
  27. package/assets/hooks/qa-dataid-guard.sh +4 -2
  28. package/assets/hooks/rerun-guard.sh +5 -3
  29. package/assets/hooks/reuse-first-guard.sh +5 -3
  30. package/assets/hooks/rule-article.sh +99 -0
  31. package/assets/hooks/skill-gate-rearm.sh +3 -1
  32. package/assets/hooks/skill-gate.sh +23 -2
  33. package/assets/hooks/skill-loaded.sh +3 -1
  34. package/assets/hooks/sql-guard-request.sh +2 -1
  35. package/assets/hooks/sql-guard.sh +4 -2
  36. package/assets/hooks/task-flow-guard.sh +6 -4
  37. package/assets/hooks/turn-exit-guard.sh +42 -17
  38. package/assets/hooks/waiting-turn-guard.sh +3 -1
  39. package/assets/hooks/window-fill-guard.sh +6 -4
  40. package/assets/laws/work-conduct.md +5 -9
  41. package/assets/patterns/dependencies-upgrade.md +1 -1
  42. package/assets/patterns/doc-style-write.md +3 -3
  43. package/assets/patterns/git-workflow-commit.azure.md +2 -202
  44. package/assets/patterns/git-workflow-commit.github.md +2 -258
  45. package/assets/patterns/git-workflow-commit.gitlab.md +1 -217
  46. package/assets/patterns/git-workflow-docker.md +3 -3
  47. package/assets/patterns/git-workflow-merge.md +3 -2
  48. package/assets/patterns/git-workflow-migration.md +3 -3
  49. package/assets/patterns/git-workflow-pr.azure.md +224 -0
  50. package/assets/patterns/git-workflow-pr.github.md +280 -0
  51. package/assets/patterns/git-workflow-pr.gitlab.md +240 -0
  52. package/assets/patterns/git-workflow-restart.md +3 -3
  53. package/assets/patterns/git-workflow-secrets.md +3 -3
  54. package/assets/patterns/task-flow-archive.md +193 -0
  55. package/assets/patterns/task-flow-close.md +3 -173
  56. package/assets/patterns/task-flow-handoff.md +4 -4
  57. package/assets/pitfalls/doc-style.md +80 -0
  58. package/assets/pitfalls/git-workflow.azure.md +50 -0
  59. package/assets/pitfalls/git-workflow.github.md +78 -0
  60. package/assets/pitfalls/git-workflow.gitlab.md +49 -0
  61. package/assets/pitfalls/spec-driven.md +36 -0
  62. package/assets/pitfalls/styling-bem.md +45 -0
  63. package/assets/pitfalls/task-flow.md +62 -0
  64. package/assets/pitfalls/testing.md +70 -0
  65. package/assets/rules/deploy-flow.azure.md +106 -0
  66. package/assets/rules/deploy-flow.github.md +113 -0
  67. package/assets/rules/deploy-flow.gitlab.md +108 -0
  68. package/assets/rules/doc-style.md +25 -76
  69. package/assets/rules/git-workflow.azure.md +6 -92
  70. package/assets/rules/git-workflow.github.md +14 -127
  71. package/assets/rules/git-workflow.gitlab.md +6 -93
  72. package/assets/rules/spec-driven.md +39 -30
  73. package/assets/rules/styling-bem.md +20 -39
  74. package/assets/rules/task-flow.md +17 -199
  75. package/assets/rules/testing.md +3 -64
  76. package/assets/rules/turn-conduct.md +206 -0
  77. package/assets/rules/typescript-conventions.md +15 -0
  78. package/assets/skills/agent-kit.md +35 -12
  79. package/assets/templates/pitfalls.md +10 -0
  80. package/assets/templates/rule.md +5 -3
  81. package/bin/agent-kit.d.ts.map +1 -1
  82. package/bin/agent-kit.js +1 -42
  83. package/bin/agent-kit.js.map +1 -1
  84. package/lib/assets.d.ts.map +1 -1
  85. package/lib/assets.js +6 -1
  86. package/lib/assets.js.map +1 -1
  87. package/lib/cascade.d.ts.map +1 -1
  88. package/lib/cascade.js +19 -1
  89. package/lib/cascade.js.map +1 -1
  90. package/lib/commands.d.ts.map +1 -1
  91. package/lib/commands.js +1 -0
  92. package/lib/commands.js.map +1 -1
  93. package/lib/config.d.ts +16 -1
  94. package/lib/config.d.ts.map +1 -1
  95. package/lib/config.js +8 -0
  96. package/lib/config.js.map +1 -1
  97. package/lib/hooks-map.d.ts +13 -0
  98. package/lib/hooks-map.d.ts.map +1 -1
  99. package/lib/hooks-map.js +33 -1
  100. package/lib/hooks-map.js.map +1 -1
  101. package/lib/ship.d.ts +1 -2
  102. package/lib/ship.d.ts.map +1 -1
  103. package/lib/ship.js +0 -54
  104. package/lib/ship.js.map +1 -1
  105. package/package.json +1 -1
  106. package/rt-tools-agent-kit-0.12.0.tgz +0 -0
  107. package/assets/commands/agent-kit-digest.md +0 -89
  108. package/assets/commands/rules-review.md +0 -98
  109. package/assets/patterns/cargo-triage-mark.md +0 -119
  110. package/assets/rules/cargo-triage.md +0 -126
  111. package/lib/cargo-state.d.ts +0 -62
  112. package/lib/cargo-state.d.ts.map +0 -1
  113. package/lib/cargo-state.js +0 -118
  114. package/lib/cargo-state.js.map +0 -1
  115. package/rt-tools-agent-kit-0.11.0.tgz +0 -0
@@ -20,8 +20,10 @@
20
20
  # нулём и молчит. Сжатие он не отбивает никогда: остановленное сжатие оставит заход без места.
21
21
 
22
22
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
23
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
23
24
 
24
- input="$(cat 2>/dev/null)"
25
+ rt_hook_read
26
+ input="$RT_HOOK_INPUT"
25
27
  [ -z "$input" ] && exit 0
26
28
 
27
29
  command -v jq >/dev/null 2>&1 || exit 0
@@ -33,13 +35,21 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
33
35
  [ -f "$profile" ] && . "$profile" 2>/dev/null
34
36
  done
35
37
 
36
- workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
38
+ workdir="$(rt_hook_cwd)"
37
39
  [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
38
40
  cd "$workdir" 2>/dev/null || exit 0
39
41
  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
40
42
 
43
+ # Пустое имя ветки хук не останавливает. На отсоединённой голове имени нет, а всё, что едет в
44
+ # передачу, лежит в дереве и доступно целиком: имя нужно только файлу. Прежний выход нулём был
45
+ # полным молчанием — сжатие приходило без передачи, и заход после него начинал с пустого места.
41
46
  branch="$(git branch --show-current 2>/dev/null)"
42
- [ -z "$branch" ] && exit 0
47
+ head_name=""
48
+ if [ -z "$branch" ]; then
49
+ head_name="$(git rev-parse --short HEAD 2>/dev/null)"
50
+ [ -z "$head_name" ] && head_name='detached'
51
+ head_name="detached-$head_name"
52
+ fi
43
53
 
44
54
  root="$(git rev-parse --show-toplevel 2>/dev/null)"
45
55
  [ -z "$root" ] && exit 0
@@ -56,7 +66,12 @@ mkdir -p "$root/$handoff_dir" 2>/dev/null || exit 0
56
66
  trigger="$(printf '%s' "$input" | jq -r '.trigger // "auto"' 2>/dev/null)"
57
67
  [ -z "$trigger" ] && trigger='auto'
58
68
 
59
- progress="$root/$tasks_dir/$branch/progress.md"
69
+ # Файл передачи ищут по имени ветки; голове без имени он называется её коротким снимком.
70
+ handoff_name="$branch"
71
+ [ -z "$handoff_name" ] && handoff_name="$head_name"
72
+
73
+ progress=""
74
+ [ -n "$branch" ] && progress="$root/$tasks_dir/$branch/progress.md"
60
75
 
61
76
  # Строка раздела «Где стоим» по её названию. Пусто — работа идёт вне папки задачи, и выдумывать
62
77
  # за неё состояние нельзя: в передаче тогда стоит то, что известно дереву.
@@ -76,12 +91,16 @@ uncommitted="$(git status --short 2>/dev/null | head -20)"
76
91
  ahead="$(git log --oneline origin/main..HEAD 2>/dev/null | head -20)"
77
92
  [ -z "$ahead" ] && ahead='нет коммитов сверх главной'
78
93
 
79
- target="$root/$handoff_dir/$branch.md"
94
+ target="$root/$handoff_dir/$handoff_name.md"
80
95
 
81
96
  {
82
97
  printf '# Передача захода — сжатие контекста (%s)\n\n' "$trigger"
83
98
  printf '**Рабочее дерево:** %s\n' "$root"
84
- printf '**Ветка:** %s\n\n' "$branch"
99
+ if [ -n "$branch" ]; then
100
+ printf '**Ветка:** %s\n\n' "$branch"
101
+ else
102
+ printf '**Ветка:** имени нет — отсоединённая голова %s\n\n' "$head_name"
103
+ fi
85
104
 
86
105
  if [ -n "$state" ]; then
87
106
  printf '## Где стоим\n\n'
@@ -90,6 +109,8 @@ target="$root/$handoff_dir/$branch.md"
90
109
  [ -n "$next_step" ] && printf -- '- **Следующий шаг:** %s\n' "$next_step"
91
110
  [ -n "$pull" ] && printf -- '- **PR:** %s\n' "$pull"
92
111
  printf '\nХод работы целиком — `%s/%s/progress.md`; замысел рядом с ним.\n\n' "$tasks_dir" "$branch"
112
+ elif [ -z "$branch" ]; then
113
+ printf '## Где стоим\n\nИмени у головы нет, папки задачи при ней тоже: состояние работы взять неоткуда. Читающая сторона ищет передачу по имени ветки, а не найдя его — по последней записи каталога.\n\n'
93
114
  else
94
115
  printf '## Где стоим\n\nПапки задачи у этой ветки нет: состояние работы взять неоткуда.\n\n'
95
116
  fi
@@ -0,0 +1,54 @@
1
+ #!/usr/bin/env bash
2
+ # Общее чтение ввода хука. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента он не
3
+ # подключается. Его источают сами гарды — тем же приёмом, каким они источают общий хвост отказа.
4
+ #
5
+ # Зачем он есть. Ввод приходит одним объектом, и каждому гарду из него нужны те же поля: имя
6
+ # инструмента, командная строка, путь правки, рабочий каталог. Пока каждый доставал их сам, один
7
+ # вызов агента стоил больше сотни разборов одного и того же текста — по шесть-семь на гард,
8
+ # восемнадцать гардов на событие. Разбор стоит шесть миллисекунд, запуск оболочки — пять.
9
+ #
10
+ # Как это работает. Диспетчер разбирает ввод однажды и кладёт поля в окружение. Гард спрашивает
11
+ # их отсюда: есть в окружении — берёт готовое, нет — разбирает сам. Второе — это прямой вызов:
12
+ # так гарды зовут наборы сценариев, и работать они обязаны и без диспетчера.
13
+ #
14
+ # ПОЧЕМУ ЧТЕНИЕ ПОТОКА — ОТДЕЛЬНАЯ КОМАНДА, А НЕ ЗНАЧЕНИЕ. Подстановка команд исполняется в
15
+ # подоболочке, и всё, что она запомнила, умирает вместе с ней: первый вызов вычитал бы поток, а
16
+ # второй получил бы пустоту — и гард пропустил бы вызов, который обязан был отбить. Поэтому поток
17
+ # читается командой `rt_hook_read`, кладущей ввод в переменную текущей оболочки, а не функцией,
18
+ # возвращающей его через подстановку.
19
+ #
20
+ # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, пустое поле — пустая строка. Сломанное
21
+ # чтение не имеет права заклинить работу: гард на пустом поле выходит нулём.
22
+
23
+ # Читает ввод в `RT_HOOK_INPUT`, если его там ещё нет. Зовётся командой, а не подстановкой.
24
+ rt_hook_read() {
25
+ [ -n "${RT_HOOK_INPUT:-}" ] && return 0
26
+
27
+ RT_HOOK_INPUT="$(cat 2>/dev/null)"
28
+ export RT_HOOK_INPUT
29
+ return 0
30
+ }
31
+
32
+ # Поле ввода по имени переменной и пути в объекте: `rt_hook_field RT_HOOK_TOOL '.tool_name'`.
33
+ # Переменная окружения главнее разбора — её кладёт диспетчер, разобравший ввод один раз.
34
+ rt_hook_field() {
35
+ local name="$1" path="$2"
36
+
37
+ # Готовому верят только по признаку разбора, а не по тому, что переменная объявлена. Пустая
38
+ # переменная в окружении означает «поля нет», и без признака она неотличима от «поле есть и
39
+ # оно пустое»: гард переставал разбирать ввод и пропускал вызовы, которые обязан был отбить.
40
+ # Наборы поймали это шестнадцатью провалами — окружение прогона несло пустые значения.
41
+ if [ "${RT_HOOK_PARSED:-}" = '1' ] && [ -n "${!name+x}" ]; then
42
+ printf '%s' "${!name}"
43
+ return 0
44
+ fi
45
+
46
+ rt_hook_read
47
+ printf '%s' "$RT_HOOK_INPUT" | jq -r "${path} // empty" 2>/dev/null
48
+ }
49
+
50
+ # Поля, которые спрашивают все гарды.
51
+ rt_hook_tool() { rt_hook_field RT_HOOK_TOOL '.tool_name'; }
52
+ rt_hook_cmd() { rt_hook_field RT_HOOK_CMD '.tool_input.command'; }
53
+ rt_hook_file() { rt_hook_field RT_HOOK_FILE '.tool_input.file_path'; }
54
+ rt_hook_cwd() { rt_hook_field RT_HOOK_CWD '.cwd'; }
@@ -30,14 +30,16 @@
30
30
  # Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
31
31
  # каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
32
32
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
33
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
33
34
 
34
35
  MAX_FILES=12
35
36
 
36
- input="$(cat 2>/dev/null)"
37
+ rt_hook_read
38
+ input="$RT_HOOK_INPUT"
37
39
  [ -z "$input" ] && exit 0
38
40
  command -v jq >/dev/null 2>&1 || exit 0
39
41
 
40
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
42
+ tool="$(rt_hook_tool)"
41
43
  case "$tool" in
42
44
  Edit | Write | MultiEdit | mcp__webstorm__create_new_file) mode="edit" ;;
43
45
  Bash) mode="move" ;;
@@ -54,7 +56,7 @@ if [ "$mode" = "move" ]; then
54
56
  esac
55
57
  fi
56
58
 
57
- workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
59
+ workdir="$(rt_hook_cwd)"
58
60
  [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
59
61
  cd "$workdir" 2>/dev/null || exit 0
60
62
  [ -f package.json ] || exit 0
@@ -22,8 +22,10 @@
22
22
  # РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
23
23
 
24
24
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
25
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
25
26
 
26
- input="$(cat 2>/dev/null)"
27
+ rt_hook_read
28
+ input="$RT_HOOK_INPUT"
27
29
  [ -z "$input" ] && exit 0
28
30
 
29
31
  command -v jq >/dev/null 2>&1 || exit 0
@@ -21,8 +21,10 @@
21
21
  # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
22
22
 
23
23
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
24
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
24
25
 
25
- input="$(cat 2>/dev/null)"
26
+ rt_hook_read
27
+ input="$RT_HOOK_INPUT"
26
28
  [ -z "$input" ] && exit 0
27
29
 
28
30
  command -v jq >/dev/null 2>&1 || exit 0
@@ -13,19 +13,21 @@
13
13
  # FAIL-OPEN: нет узла, нет проверки, чужой инструмент, не `.md` → пропуск.
14
14
 
15
15
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
16
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
16
17
 
17
- input="$(cat 2>/dev/null)"
18
+ rt_hook_read
19
+ input="$RT_HOOK_INPUT"
18
20
  [ -z "$input" ] && exit 0
19
21
  command -v jq >/dev/null 2>&1 || exit 0
20
22
  command -v node >/dev/null 2>&1 || exit 0
21
23
 
22
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
24
+ tool="$(rt_hook_tool)"
23
25
  case "$tool" in
24
26
  Edit | Write | MultiEdit) ;;
25
27
  *) exit 0 ;;
26
28
  esac
27
29
 
28
- path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
30
+ path="$(rt_hook_file)"
29
31
  case "$path" in
30
32
  *.md) ;;
31
33
  *) exit 0 ;;
@@ -26,13 +26,15 @@
26
26
  # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
27
27
 
28
28
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
29
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
29
30
 
30
- input="$(cat 2>/dev/null)"
31
+ rt_hook_read
32
+ input="$RT_HOOK_INPUT"
31
33
  [ -z "$input" ] && exit 0
32
34
  command -v jq >/dev/null 2>&1 || exit 0
33
35
  command -v perl >/dev/null 2>&1 || exit 0
34
36
 
35
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
37
+ tool="$(rt_hook_tool)"
36
38
  case "$tool" in
37
39
  # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
38
40
  # ветки разметка заводилась мимо всех проверок.
@@ -21,19 +21,21 @@
21
21
  # упавшего прогона зовут и без него, а угадывать, о каком задании речь, значит отбивать наугад.
22
22
 
23
23
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
24
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
24
25
 
25
- input="$(cat 2>/dev/null)"
26
+ rt_hook_read
27
+ input="$RT_HOOK_INPUT"
26
28
  [ -z "$input" ] && exit 0
27
29
  command -v jq >/dev/null 2>&1 || exit 0
28
30
 
29
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
31
+ tool="$(rt_hook_tool)"
30
32
  case "$tool" in
31
33
  # Терминал среды и универсальный исполнитель кладут команду в то же поле.
32
34
  Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
33
35
  *) exit 0 ;;
34
36
  esac
35
37
 
36
- cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
38
+ cmd="$(rt_hook_cmd)"
37
39
  [ -z "$cmd" ] && exit 0
38
40
 
39
41
  # Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
@@ -33,13 +33,15 @@
33
33
  # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
34
34
 
35
35
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
36
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
36
37
 
37
- input="$(cat 2>/dev/null)"
38
+ rt_hook_read
39
+ input="$RT_HOOK_INPUT"
38
40
  [ -z "$input" ] && exit 0
39
41
  command -v jq >/dev/null 2>&1 || exit 0
40
42
  command -v perl >/dev/null 2>&1 || exit 0
41
43
 
42
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
44
+ tool="$(rt_hook_tool)"
43
45
  shell_cmd=""
44
46
  case "$tool" in
45
47
  # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
@@ -54,7 +56,7 @@ case "$tool" in
54
56
  # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
55
57
  # потому что снаружи выглядит закрытым.
56
58
  Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
57
- shell_cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
59
+ shell_cmd="$(rt_hook_cmd)"
58
60
  [ -z "$shell_cmd" ] && exit 0
59
61
  # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её разбора
60
62
  # путь стоит за кавычкой, и до него не дотягивается ни один образец.
@@ -0,0 +1,99 @@
1
+ #!/usr/bin/env bash
2
+ # Разбор признака применимости у статьи правила. Помощник: своего события не объявляет, его
3
+ # подключает тот, кому нужен текст статьи, — гейт правил в своём отказе.
4
+ #
5
+ # Правило весит от двадцати до шестидесяти килобайт, а под конкретную правку подпадает одна его
6
+ # статья. Отказ, зовущий правило целиком, платит за решение полной ценой правила — и учит не
7
+ # тому: дешевле не читать лишнего, то есть работать хуже разведанным.
8
+ #
9
+ # Признак стоит при самой статье: карта гейта знает путь и правило, но не знает, какая из двух
10
+ # десятков статей про этот путь. Статья знает о себе всё.
11
+ #
12
+ # - **Заголовок статьи.** Текст статьи, как обычно.
13
+ # <!-- rt-when: *.scss *.css -->
14
+ #
15
+ # Комментарий не виден в собранной разметке и не мешает читать статью; образцы разделены
16
+ # пробелом и сверяются с путём правки самой оболочкой, а не поиском по словам: поиск называет не
17
+ # ту статью и молчит об этом.
18
+ #
19
+ # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: статья без признака законна, правило без единого признака — тоже. Не
20
+ # нашлось ни одной подошедшей статьи — печатается пусто, и зовущий остаётся при прежнем отказе.
21
+
22
+ # Статьи правила, чей признак совпал с путём правки. Доводы: файл правила, путь правки.
23
+ # Печатает текст подошедших статей целиком, по статье, разделяя их пустой строкой.
24
+ rt_rule_articles() {
25
+ rule_file="$1"
26
+ edited="$2"
27
+ [ -f "$rule_file" ] || return 0
28
+ [ -n "$edited" ] || return 0
29
+
30
+ # Статьи выбираются в два прохода: сперва номера строк, где стоят признаки, и сами образцы,
31
+ # затем — текст той статьи, чей образец совпал. Сопоставление делает оболочка: `case` знает
32
+ # правила путей, а разборщик текста — нет.
33
+ while IFS=' ' read -r line patterns; do
34
+ [ -n "$line" ] || continue
35
+ hit=''
36
+ # Образцы разбираются под выключенным раскрытием имён: `*.scss` в цикле развернулось бы
37
+ # в имена файлов рабочего каталога, и статья выбиралась бы по тому, где стоял вызов.
38
+ # Разделитель задаётся здесь же — внешний мог быть переопределён тем, кто нас позвал.
39
+ set -f
40
+ old_ifs="$IFS"
41
+ IFS=' '
42
+ # shellcheck disable=SC2086
43
+ set -- $patterns
44
+ IFS="$old_ifs"
45
+ set +f
46
+ for pattern in "$@"; do
47
+ [ -n "$pattern" ] || continue
48
+ # shellcheck disable=SC2254
49
+ case "$edited" in
50
+ $pattern) hit=1; break ;;
51
+ esac
52
+ # Образец без каталога сверяется и с именем файла: статья говорит «про такие файлы»,
53
+ # а правка приходит полным путём.
54
+ # shellcheck disable=SC2254
55
+ case "${edited##*/}" in
56
+ $pattern) hit=1; break ;;
57
+ esac
58
+ done
59
+ [ -n "$hit" ] || continue
60
+ rt_rule_article_at "$rule_file" "$line"
61
+ done <<EOF
62
+ $(rt_rule_article_marks "$rule_file")
63
+ EOF
64
+ }
65
+
66
+ # Признаки правила: строка «номер строки — образцы». Отдельной функцией, потому что её же зовёт
67
+ # сверка полноты текстов: правило, у которого признак записан не той формой, тихо остаётся без
68
+ # статьи в отказе, и заметить это нечем.
69
+ rt_rule_article_marks() {
70
+ [ -f "$1" ] || return 0
71
+ grep -n 'rt-when:' "$1" 2>/dev/null \
72
+ | sed -e 's/^\([0-9]*\):.*rt-when:[[:space:]]*/\1 /' -e 's/[[:space:]]*-->.*$//'
73
+ }
74
+
75
+ # Текст статьи, внутри которой стоит строка с признаком. Статья начинается ближайшим сверху
76
+ # пунктом списка верхнего уровня и кончается перед следующим таким пунктом или перед строкой без
77
+ # отступа: продолжение статьи всегда идёт с отступом.
78
+ rt_rule_article_at() {
79
+ awk -v mark="$2" '
80
+ NR <= mark && /^- / { start = NR }
81
+ { line[NR] = $0 }
82
+ END {
83
+ if (!start) { exit }
84
+ for (i = start + 1; i <= NR; i++) {
85
+ if (line[i] ~ /^- / || (line[i] !~ /^[ \t]/ && line[i] != "")) { break }
86
+ stop = i
87
+ }
88
+ if (!stop) { stop = start }
89
+ last = start
90
+ for (i = start; i <= stop; i++) {
91
+ if (line[i] ~ /rt-when:/) { continue }
92
+ if (line[i] == "" && i == stop) { continue }
93
+ print line[i]
94
+ last = i
95
+ }
96
+ print ""
97
+ }
98
+ ' "$1" 2>/dev/null
99
+ }
@@ -13,8 +13,10 @@
13
13
  # отбивает.
14
14
 
15
15
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
16
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
16
17
 
17
- input="$(cat 2>/dev/null)"
18
+ rt_hook_read
19
+ input="$RT_HOOK_INPUT"
18
20
  [ -z "$input" ] && exit 0
19
21
 
20
22
  sid="$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null)"
@@ -24,12 +24,14 @@
24
24
  # Сломанный гейт не имеет права остановить работу совсем.
25
25
 
26
26
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
27
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
27
28
 
28
- input="$(cat 2>/dev/null)"
29
+ rt_hook_read
30
+ input="$RT_HOOK_INPUT"
29
31
  [ -z "$input" ] && exit 0
30
32
 
31
33
  sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
32
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
34
+ tool="$(rt_hook_tool)"
33
35
 
34
36
  # Умолчание карты ищется и рядом с самим хуком: уезжают они вместе.
35
37
  rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -175,6 +177,25 @@ if [ -n "$law" ]; then
175
177
  && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
176
178
  fi
177
179
 
180
+ # Статья, под которую подпадает эта правка. Правило весит от двадцати до шестидесяти килобайт,
181
+ # и отказ, зовущий его целиком, платит за решение полной ценой правила. Статья говорит о своей
182
+ # применимости сама — разбирает её помощник рядом; нет помощника или нет размеченных статей,
183
+ # отказ остаётся прежним, и это тот же отказ в пользу работы, что и везде.
184
+ #
185
+ # Загрузку правила статья не отменяет: она снимает чтение правила целиком, а не сам отказ.
186
+ # Правило целиком остаётся вторым ходом — для того, кому статьи мало.
187
+ # shellcheck disable=SC1090
188
+ [ -f "$rt_hooks_dir/rule-article.sh" ] && . "$rt_hooks_dir/rule-article.sh" 2>/dev/null
189
+ if [ "$kind" != "command" ] && [ "$kind" != "browser" ] && command -v rt_rule_articles >/dev/null 2>&1; then
190
+ article="$(rt_rule_articles "$root/$rules_dir/${req}/SKILL.md" "$target" 2>/dev/null)"
191
+ if [ -n "$article" ]; then
192
+ reason="Отбито гейтом правил. Под эту правку подпадает статья правила «${req}»:
193
+
194
+ ${article}
195
+ Статья снимает чтение правила целиком, а не отказ: загрузи правило «${req}» инструментом Skill и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
196
+ fi
197
+ fi
198
+
178
199
  # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
179
200
  # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
180
201
  # shellcheck disable=SC1090
@@ -8,8 +8,10 @@
8
8
  # Хук только наблюдает: он всегда пропускает и ничего не отбивает.
9
9
 
10
10
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
11
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
11
12
 
12
- input="$(cat 2>/dev/null)"
13
+ rt_hook_read
14
+ input="$RT_HOOK_INPUT"
13
15
  [ -z "$input" ] && exit 0
14
16
 
15
17
  sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
@@ -11,6 +11,7 @@
11
11
  # Три вида ввода: запрос через подключение редактора, команда оболочки и та же команда,
12
12
  # завёрнутая в универсальный исполнитель. Инструмент, не названный здесь, гарда не касается.
13
13
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
14
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
14
15
 
15
16
  sql_read_request() {
16
17
  sql=""
@@ -25,7 +26,7 @@ sql_read_request() {
25
26
  # Терминал IDE исполняет ту же командную строку и кладёт её в то же поле, что и Bash:
26
27
  # без этой ветки весь гард обходился сменой инструмента.
27
28
  Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
28
- cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
29
+ cmd="$(rt_hook_cmd)"
29
30
  [ -z "$cmd" ] && exit 0
30
31
 
31
32
  # Универсальный исполнитель зовёт ЛЮБОЙ инструмент редактора по имени, в том числе
@@ -41,12 +41,14 @@
41
41
  # запрос. Доставки запроса внутри такой команды не бывает, так что цена послабления нулевая.
42
42
 
43
43
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
44
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
44
45
 
45
- input="$(cat 2>/dev/null)"
46
+ rt_hook_read
47
+ input="$RT_HOOK_INPUT"
46
48
  [ -z "$input" ] && exit 0
47
49
  command -v jq >/dev/null 2>&1 || exit 0
48
50
 
49
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
51
+ tool="$(rt_hook_tool)"
50
52
 
51
53
  # Рабочий каталог нужен одному правилу — разрешению адреса миграции: `DATABASE_URL`
52
54
  # обычно не назван в команде и лежит в `.env` рядом с проектом.
@@ -26,8 +26,10 @@
26
26
  # гард не должен мешать работать.
27
27
 
28
28
  . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
29
+ . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
29
30
 
30
- input="$(cat 2>/dev/null)"
31
+ rt_hook_read
32
+ input="$RT_HOOK_INPUT"
31
33
  [ -z "$input" ] && exit 0
32
34
  command -v jq >/dev/null 2>&1 || exit 0
33
35
 
@@ -45,7 +47,7 @@ done
45
47
  [ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
46
48
  command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
47
49
 
48
- tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
50
+ tool="$(rt_hook_tool)"
49
51
  candidates=""
50
52
  case "$tool" in
51
53
  # Инструмент редактора заводит файл теми же двумя данными, только называет их иначе —
@@ -61,7 +63,7 @@ case "$tool" in
61
63
  # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
62
64
  # потому что снаружи выглядит закрытым.
63
65
  Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
64
- cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
66
+ cmd="$(rt_hook_cmd)"
65
67
  [ -z "$cmd" ] && exit 0
66
68
  # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её разбора
67
69
  # путь стоит за кавычкой, и до него не дотягивается ни один образец.
@@ -127,7 +129,7 @@ deny() {
127
129
  }
128
130
 
129
131
  # Ветку смотрим там же, где пойдёт правка: у worktree она своя.
130
- workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
132
+ workdir="$(rt_hook_cwd)"
131
133
  [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
132
134
  cd "$workdir" 2>/dev/null || exit 0
133
135
  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0