tfx-hooks

tfx-hooks — 훅 우선순위 관리자

Claude Code 훅의 실행 순서를 관리합니다. triflux 훅이 항상 최우선 실행되도록 보장합니다.

핵심 개념

Claude Code는 같은 이벤트에 매칭된 훅을 병렬 실행합니다. 순서 보장이 불가능합니다. triflux의 hook-orchestrator는 이벤트당 하나의 진입점을 두고, 내부에서 우선순위대로 순차 실행합니다.

settings.json → hook-orchestrator.mjs (단일 진입점)
                    ↓ hook-registry.json 읽기
                    ↓ priority 순 정렬
                    1. triflux 훅 (priority=0)
                    2. OMC 훅 (priority=50)
                    3. 외부 훅 (priority=100)

워크플로우

Step 1: 현재 상태 확인

Bash("node hooks/hook-manager.mjs status")

결과 JSON에서 orchestrated 필드로 적용 여부를 판단한다.

Step 2: 메인 메뉴 (AskUserQuestion)

question: "훅 관리 — 어떤 작업을 수행하시겠습니까?"
header: "Hook Manager"
options:
  - label: "현재 상태 보기"
    description: "settings.json 훅 스캔 + 오케스트레이터 적용 상태"
  - label: "오케스트레이터 적용"
    description: "모든 훅을 통합 — triflux 최우선 실행 보장"
  - label: "변경점 미리보기 (diff)"
    description: "적용 시 어떻게 바뀌는지 확인"
  - label: "원래대로 복원"
    description: "오케스트레이터 제거, 원래 settings.json 훅으로 복원"
  - label: "개별 훅 관리"
    description: "특정 훅 활성/비활성, 우선순위 변경"

Step 3: 선택에 따른 분기

"현재 상태 보기"

Bash("node hooks/hook-manager.mjs scan")

결과 JSON을 파싱하여 테이블로 표시:

## 현재 훅 상태

| 이벤트 | 훅 수 | 소스 |
|--------|-------|------|
| SessionStart | 4 | triflux(3), session-vault(1) |
| PreToolUse | 3 | triflux(1), omc(2) |
| ...    | ...   | ... |

오케스트레이터: ❌ 미적용 / ✅ 적용됨 (N개 이벤트)

"오케스트레이터 적용"

먼저 diff를 보여준 후 확인:

Bash("node hooks/hook-manager.mjs diff")

결과를 표시한 뒤 AskUserQuestion:

question: "위 변경을 적용하시겠습니까?"
header: "확인"
options:
  - label: "적용"
    description: "settings.json 백업 후 오케스트레이터 적용"
  - label: "취소"
    description: "변경 없이 돌아가기"

"적용" 선택 시:

Bash("node hooks/hook-manager.mjs apply")

적용 결과 표시:

✅ 오케스트레이터 적용 완료
   N개 이벤트 → 1개 오케스트레이터로 통합
   실행 순서: triflux(0) → OMC(50) → external(100)
   복원: /tfx-hooks → 원래대로 복원
   또는: triflux hooks restore

"변경점 미리보기 (diff)"

Bash("node hooks/hook-manager.mjs diff")