@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.
- package/assets/checks/check-file-size.mjs +19 -4
- package/assets/checks/check-state-next.mjs +10 -2
- package/assets/checks/rt-kit-checks.config.mjs +16 -2
- package/assets/defaults/project.sh +9 -1
- package/assets/defaults/turn-map.md +8 -6
- package/assets/hooks/browser-guard-device-id.sh +3 -1
- package/assets/hooks/browser-guard-no-asking.sh +3 -1
- package/assets/hooks/browser-guard-no-other-drivers.sh +5 -3
- package/assets/hooks/browser-guard-require-select.sh +4 -2
- package/assets/hooks/claim-guard.sh +3 -1
- package/assets/hooks/conscience-guard.sh +3 -1
- package/assets/hooks/dev-server-guard.sh +5 -3
- package/assets/hooks/dispatch.sh +69 -0
- package/assets/hooks/docs-guard.sh +6 -4
- package/assets/hooks/exam-guard.sh +5 -3
- package/assets/hooks/git-guard-delivery.sh +37 -5
- package/assets/hooks/git-guard-main.sh +6 -4
- package/assets/hooks/git-guard-push-tests.sh +6 -4
- package/assets/hooks/grill-gate.sh +4 -2
- package/assets/hooks/handoff-entry-guard.sh +4 -2
- package/assets/hooks/handoff-write.sh +27 -6
- package/assets/hooks/hook-input.sh +54 -0
- package/assets/hooks/lint-after-edit.sh +5 -3
- package/assets/hooks/postmortem-guard.sh +3 -1
- package/assets/hooks/proposal-guard.sh +3 -1
- package/assets/hooks/prose-style-guard.sh +5 -3
- package/assets/hooks/qa-dataid-guard.sh +4 -2
- package/assets/hooks/rerun-guard.sh +5 -3
- package/assets/hooks/reuse-first-guard.sh +5 -3
- package/assets/hooks/rule-article.sh +99 -0
- package/assets/hooks/skill-gate-rearm.sh +3 -1
- package/assets/hooks/skill-gate.sh +23 -2
- package/assets/hooks/skill-loaded.sh +3 -1
- package/assets/hooks/sql-guard-request.sh +2 -1
- package/assets/hooks/sql-guard.sh +4 -2
- package/assets/hooks/task-flow-guard.sh +6 -4
- package/assets/hooks/turn-exit-guard.sh +42 -17
- package/assets/hooks/waiting-turn-guard.sh +3 -1
- package/assets/hooks/window-fill-guard.sh +6 -4
- package/assets/laws/work-conduct.md +5 -9
- package/assets/patterns/dependencies-upgrade.md +1 -1
- package/assets/patterns/doc-style-write.md +3 -3
- package/assets/patterns/git-workflow-commit.azure.md +2 -202
- package/assets/patterns/git-workflow-commit.github.md +2 -258
- package/assets/patterns/git-workflow-commit.gitlab.md +1 -217
- package/assets/patterns/git-workflow-docker.md +3 -3
- package/assets/patterns/git-workflow-merge.md +3 -2
- package/assets/patterns/git-workflow-migration.md +3 -3
- package/assets/patterns/git-workflow-pr.azure.md +224 -0
- package/assets/patterns/git-workflow-pr.github.md +280 -0
- package/assets/patterns/git-workflow-pr.gitlab.md +240 -0
- package/assets/patterns/git-workflow-restart.md +3 -3
- package/assets/patterns/git-workflow-secrets.md +3 -3
- package/assets/patterns/task-flow-archive.md +193 -0
- package/assets/patterns/task-flow-close.md +3 -173
- package/assets/patterns/task-flow-handoff.md +4 -4
- package/assets/pitfalls/doc-style.md +80 -0
- package/assets/pitfalls/git-workflow.azure.md +50 -0
- package/assets/pitfalls/git-workflow.github.md +78 -0
- package/assets/pitfalls/git-workflow.gitlab.md +49 -0
- package/assets/pitfalls/spec-driven.md +36 -0
- package/assets/pitfalls/styling-bem.md +45 -0
- package/assets/pitfalls/task-flow.md +62 -0
- package/assets/pitfalls/testing.md +70 -0
- package/assets/rules/deploy-flow.azure.md +106 -0
- package/assets/rules/deploy-flow.github.md +113 -0
- package/assets/rules/deploy-flow.gitlab.md +108 -0
- package/assets/rules/doc-style.md +25 -76
- package/assets/rules/git-workflow.azure.md +6 -92
- package/assets/rules/git-workflow.github.md +14 -127
- package/assets/rules/git-workflow.gitlab.md +6 -93
- package/assets/rules/spec-driven.md +39 -30
- package/assets/rules/styling-bem.md +20 -39
- package/assets/rules/task-flow.md +17 -199
- package/assets/rules/testing.md +3 -64
- package/assets/rules/turn-conduct.md +206 -0
- package/assets/rules/typescript-conventions.md +15 -0
- package/assets/skills/agent-kit.md +35 -12
- package/assets/templates/pitfalls.md +10 -0
- package/assets/templates/rule.md +5 -3
- package/bin/agent-kit.d.ts.map +1 -1
- package/bin/agent-kit.js +1 -42
- package/bin/agent-kit.js.map +1 -1
- package/lib/assets.d.ts.map +1 -1
- package/lib/assets.js +6 -1
- package/lib/assets.js.map +1 -1
- package/lib/cascade.d.ts.map +1 -1
- package/lib/cascade.js +19 -1
- package/lib/cascade.js.map +1 -1
- package/lib/commands.d.ts.map +1 -1
- package/lib/commands.js +1 -0
- package/lib/commands.js.map +1 -1
- package/lib/config.d.ts +16 -1
- package/lib/config.d.ts.map +1 -1
- package/lib/config.js +8 -0
- package/lib/config.js.map +1 -1
- package/lib/hooks-map.d.ts +13 -0
- package/lib/hooks-map.d.ts.map +1 -1
- package/lib/hooks-map.js +33 -1
- package/lib/hooks-map.js.map +1 -1
- package/lib/ship.d.ts +1 -2
- package/lib/ship.d.ts.map +1 -1
- package/lib/ship.js +0 -54
- package/lib/ship.js.map +1 -1
- package/package.json +1 -1
- package/rt-tools-agent-kit-0.12.0.tgz +0 -0
- package/assets/commands/agent-kit-digest.md +0 -89
- package/assets/commands/rules-review.md +0 -98
- package/assets/patterns/cargo-triage-mark.md +0 -119
- package/assets/rules/cargo-triage.md +0 -126
- package/lib/cargo-state.d.ts +0 -62
- package/lib/cargo-state.d.ts.map +0 -1
- package/lib/cargo-state.js +0 -118
- package/lib/cargo-state.js.map +0 -1
- 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
|
-
|
|
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="$(
|
|
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
|
-
|
|
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
|
-
|
|
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/$
|
|
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
|
-
|
|
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
|
-
|
|
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="$(
|
|
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="$(
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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="$(
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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="$(
|
|
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
|
-
|
|
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
|
-
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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
|
-
|
|
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="$(
|
|
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="$(
|
|
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="$(
|
|
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
|