훅 시스템

1// src/utils/hooks/hooksConfigManager.ts — 훅 이벤트 메타데이터
2 
3const hookEventMetadata = {
4  PreToolUse: {
5    summary: 'Before tool execution',
6    description: `Input: JSON of tool call arguments.
7Exit 0 → stdout/stderr not shown
8Exit 2 → show stderr to model and BLOCK tool call💡
9Other  → show stderr to user only, continue`,
10    matcherMetadata: {
11      fieldToMatch: 'tool_name',
12      values: toolNames,  // 도구 이름 목록으로 매칭
13    },
14  },
15  PostToolUse: {
16    summary: 'After tool execution',
17    description: `Input: JSON with "inputs" and "response".
18Exit 0 → stdout shown in transcript mode
19Exit 2 → show stderr to model immediately
20Other  → show stderr to user only`,
21  },
22  PostToolUseFailure: {
23    summary: 'After tool execution fails',
24    description: 'Input: JSON with error details',
25  },💡
26  PermissionDenied: {
27    summary: 'After auto mode classifier denies',
28    description: 'Return {"retry":true} to allow retry',
29  },
30  Notification: {
31    summary: 'When notification is sent',
32  },
33}
34 
35// ─── 5가지 훅 타입 ───💡
36// Command  → 셸 명령 실행 (가장 일반적)
37// Prompt   → LLM 쿼리 (모델 기반 결정)
38// Agent    → 포크된 하위 에이전트 (복잡 로직)
39// HTTP     → 웹훅 POST (SSRF 가드 적용)
40// Function → 세션 전용 콜백 (SDK/프로그래밍)
41 
42// 설정 예시 (settings.json):
43// "hooks": {
44//   "PreToolUse": [{
45//     "matcher": "Bash(git *)",
46//     "command": "echo 'Git command detected'"
47//   }]
48// }