bouncer-status

name	bouncer-status
description	ai-bouncer 설치 상태, 설정, 건강 진단을 한눈에 보여줌. '바운서 상태', 'bouncer status', '설치 확인', 'bouncer 설정' 요청 시 트리거.

/bouncer-status

ai-bouncer 설치 상태와 설정을 보여주는 스킬. 빠르게 동작해야 한다.

2단계 출력

Step 1: 설정 즉시 출력 (config.json 읽기만)

먼저 config.json을 읽어서 설정을 즉시 보여준다. python 스크립트 쓰지 말고 cat이나 jq로 빠르게.

# 로컬 우선, 없으면 전역
LOCAL_CONFIG="$(git rev-parse --show-toplevel 2>/dev/null)/.claude/ai-bouncer/config.json"
GLOBAL_CONFIG="$HOME/.claude/ai-bouncer/config.json"

출력:

📋 ai-bouncer 설정

  범위: global (~/.claude)
  커밋 전략: per-step
  커밋 스킬: true
  실행 모드: hooks
  에이전트 모드: team
  docs git 추적: false

건강 진단 중...

config.json이 없으면:

📋 ai-bouncer: ❌ 미설치
  로컬/전역 모두 config.json 없음.
  설치: bash <(curl -fsSL https://raw.githubusercontent.com/kangraemin/ai-bouncer/main/install.sh)

→ 여기서 종료.

Step 2: 건강 진단 (설정 출력 후)

"건강 진단 중..." 출력한 뒤 아래 항목을 확인한다.

2-1. 업데이트 확인

bouncer-update-check.sh를 사용해서 업데이트 필요 여부를 확인한다.

# 로컬 또는 전역에서 bouncer-update-check.sh 찾기
UPDATE_CHECK="$TARGET_DIR/scripts/bouncer-update-check.sh"
[ -f "$UPDATE_CHECK" ] || UPDATE_CHECK="$HOME/.claude/scripts/bouncer-update-check.sh"

bash "$UPDATE_CHECK" --check-only 2>/dev/null

결과에 따라:

• up-to-date → ✅ 최신 버전
• update-available → ⚠️ 업데이트 있음 (현재: xxx → 최신: yyy)
• 실패 → ❓ 확인 불가

업데이트가 있으면 진단 결과 출력 후 "업데이트할까요?" 라고 물어본다. 사용자가 동의하면 /update-bouncer 스킬을 실행한다.

2-2. Hook 등록 상태

매번 GitHub remote에서 최신 hooks.json을 fetch해서 required hooks 목록을 동적으로 구성한다.

REPO="${AI_BOUNCER_REPO:-kangraemin/ai-bouncer}"
RAW_BASE="https://raw.githubusercontent.com/$REPO/main"
REMOTE_HOOKS_JSON=$(curl -sf --max-time 5 "$RAW_BASE/hooks/hooks.json" 2>/dev/null)
# fetch 실패 시 로컬 설치본 fallback
[ -z "$REMOTE_HOOKS_JSON" ] && REMOTE_HOOKS_JSON=$(cat "$BOUNCER_DATA_DIR/hooks/hooks.json" 2>/dev/null || echo "{}")

REMOTE_HOOKS_JSON에서 {event: [{matcher, file}]} 구조를 파싱해 hook 목록을 추출한다.

각 hook에 대해 3단계 판정:

# a. settings.json 등록 여부
# b. 파일 존재 여부 ($BOUNCER_DATA_DIR/hooks/<file>)
# c. 파일 내용 일치 여부:
REMOTE_FILE=$(curl -sf --max-time 3 "$RAW_BASE/hooks/<file>" 2>/dev/null)
LOCAL_FILE=$(cat "$BOUNCER_DATA_DIR/hooks/<file>" 2>/dev/null)
# md5 또는 sha256 비교

판정 기준:

• ✅ 등록됨 + 파일 존재 + 내용 최신 (remote와 일치)
• ⚠️ 등록됨 + 파일 존재 + 내용 구버전 (remote와 다름)
• ⚠️ 등록됨 + 파일 없음
• ❌ 미등록
• ❓ curl 실패로 확인 불가 (로컬 기준으로 fallback)

2-3. CLAUDE.md 규칙

grep -q 'ai-bouncer-rule' "$TARGET_DIR/CLAUDE.md"

2-4. 파일 무결성

앞서 2-2에서 fetch한 REMOTE_HOOKS_JSON의 모든 file 값을 추출해, 해당 hook 파일이 $BOUNCER_DATA_DIR/hooks/ 하위에 실제 존재하고 내용이 remote와 일치하는지 확인한다. (2-2 fetch 데이터 재활용)

manifest.json은 보조 참고용 — remote hooks.json에 없는 파일은 체크 불필요.

2-5. 활성 태스크

find .ai-bouncer-tasks -name ".active" 2>/dev/null

진단 결과 출력

건강 진단 결과

  업데이트: ✅ 최신 버전
  Hook: ✅ 8/8 정상
  CLAUDE.md: ✅ 규칙 주입됨
  파일 무결성: ✅ 20/20
  활성 태스크: 없음

문제가 있을 때만 상세 표시:

건강 진단 결과

  업데이트: ⚠️ 업데이트 있음 (현재: abc1234 → 최신: def5678)
  Hook: ⚠️ 6/8
    ❌ subagent-track.sh — 미등록
    ⚠️ bash-gate.sh — 등록됨, 파일 없음
  CLAUDE.md: ❌ 규칙 없음
  파일 무결성: ⚠️ 18/20
    누락: agents/dev.md, agents/qa.md
  활성 태스크: my-task (development/normal)

  수정 방법: bash install.sh --config 또는 재설치

업데이트할까요?

규칙

• 읽기 전용 — 파일을 수정하지 않는다
• Step 1 (설정)을 먼저 출력한 뒤 Step 2 (진단)를 실행한다. 한번에 모으지 않는다.
• python 대신 jq/grep/bash를 써서 빠르게 동작한다
• 전역/로컬 둘 다 있으면 양쪽 다 보여준다