@wellgrow/cli 0.1.3 → 0.2.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/dist/index.js +55 -679
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/templates/manual/hooks.md +0 -61
package/package.json
CHANGED
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
# フック
|
|
2
|
-
|
|
3
|
-
ツール実行やセッションの各タイミングに処理を差し込む仕組み。ガードレール（危険な操作のブロック）や自動チェックに使う。
|
|
4
|
-
|
|
5
|
-
`~/.wellgrow/hooks/` に JSON ファイルとして配置する。config.toml の `[hooks].paths` が常に読み込まれ、agent.toml の `[hooks].paths` で追加できる。
|
|
6
|
-
|
|
7
|
-
## イベント
|
|
8
|
-
|
|
9
|
-
| イベント | タイミング | matcher 対象 |
|
|
10
|
-
|---------|-----------|-------------|
|
|
11
|
-
| `PreToolUse` | ツール実行前 | ツール名 |
|
|
12
|
-
| `PostToolUse` | ツール実行成功後 | ツール名 |
|
|
13
|
-
| `PostToolUseFailure` | ツール実行失敗後 | ツール名 |
|
|
14
|
-
| `PermissionRequest` | 権限要求時 | ツール名 |
|
|
15
|
-
| `SessionStart` | セッション開始時 | ソース名 |
|
|
16
|
-
| `SessionEnd` | セッション終了時 | 理由 |
|
|
17
|
-
| `UserPromptSubmit` | プロンプト送信時 | — |
|
|
18
|
-
| `Stop` | 停止要求時 | — |
|
|
19
|
-
|
|
20
|
-
## 設定例
|
|
21
|
-
|
|
22
|
-
```json
|
|
23
|
-
{
|
|
24
|
-
"hooks": {
|
|
25
|
-
"PreToolUse": [
|
|
26
|
-
{
|
|
27
|
-
"matcher": "Bash",
|
|
28
|
-
"hooks": [
|
|
29
|
-
{
|
|
30
|
-
"type": "command",
|
|
31
|
-
"command": "echo 'checking...'",
|
|
32
|
-
"timeout": 10
|
|
33
|
-
}
|
|
34
|
-
]
|
|
35
|
-
}
|
|
36
|
-
]
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
`matcher`: 完全一致、正規表現、または `"*"` で全マッチ。
|
|
42
|
-
|
|
43
|
-
## フック種別
|
|
44
|
-
|
|
45
|
-
**command**: コマンドを実行する。
|
|
46
|
-
|
|
47
|
-
- 終了コード 0 → 許可（そのまま続行）
|
|
48
|
-
- 終了コード 2 → ブロック（ツール実行を中止し、stderr の内容がエージェントにフィードバックされる）
|
|
49
|
-
- それ以外 → 無視（フック自体の失敗として扱われ、ツール実行には影響しない）
|
|
50
|
-
|
|
51
|
-
```json
|
|
52
|
-
{ "type": "command", "command": "...", "timeout": 30 }
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
**prompt**: LLM にプロンプトを送り、その応答をエージェントのコンテキストに注入する。コードレビューや安全性チェックなど、判断を伴う処理に使う。
|
|
56
|
-
|
|
57
|
-
- `$ARGUMENTS` にはツール名・入力パラメータなどイベントごとのデータが JSON で入る
|
|
58
|
-
|
|
59
|
-
```json
|
|
60
|
-
{ "type": "prompt", "prompt": "...", "model": "claude-sonnet-4-6" }
|
|
61
|
-
```
|