timsquad 2.0.0 → 2.1.0

package/templates/common/claude/hooks/auto-metrics.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# TimSquad Auto Metrics Collector
+# SessionEnd 이벤트 시 호출되어 세션 JSONL을 분석하고
+# .timsquad/retrospective/metrics/latest.json 에 누적 메트릭 갱신
+#
+# 토큰 비용: 0 (순수 파일 I/O)
+# 사용법: auto-metrics.sh <jsonl_file> <session_id_short>
+
+set -euo pipefail
+
+JSONL_FILE="${1:-}"
+SESSION_SHORT="${2:-unknown}"
+
+if [ -z "$JSONL_FILE" ] || [ ! -f "$JSONL_FILE" ]; then
+  exit 0
+fi
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+METRICS_DIR="$PROJECT_DIR/.timsquad/retrospective/metrics"
+mkdir -p "$METRICS_DIR"
+
+LATEST_FILE="$METRICS_DIR/latest.json"
+TODAY=$(date +"%Y-%m-%d")
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# ============================================================
+# JSONL에서 세션 통계 추출
+# ============================================================
+
+TOTAL_EVENTS=$(wc -l < "$JSONL_FILE" | tr -d ' ')
+
+if [ "$TOTAL_EVENTS" -lt 3 ]; then
+  exit 0
+fi
+
+# 도구 사용
+TOOL_USES=$(jq -r 'select(.event == "PostToolUse")' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+TOOL_FAILURES=$(jq -r 'select(.event == "PostToolUseFailure")' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+SUBAGENTS=$(jq -r 'select(.event == "SubagentStart")' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+
+# 토큰 (SessionEnd에서 추출)
+TOKEN_DATA=$(jq -c 'select(.event == "SessionEnd") | .total_usage // {}' "$JSONL_FILE" 2>/dev/null | head -1)
+if [ -z "$TOKEN_DATA" ] || [ "$TOKEN_DATA" = "{}" ]; then
+  TOKEN_INPUT=0
+  TOKEN_OUTPUT=0
+  TOKEN_CACHE_CREATE=0
+  TOKEN_CACHE_READ=0
+else
+  TOKEN_INPUT=$(echo "$TOKEN_DATA" | jq -r '.total_input // 0')
+  TOKEN_OUTPUT=$(echo "$TOKEN_DATA" | jq -r '.total_output // 0')
+  TOKEN_CACHE_CREATE=$(echo "$TOKEN_DATA" | jq -r '.total_cache_create // 0')
+  TOKEN_CACHE_READ=$(echo "$TOKEN_DATA" | jq -r '.total_cache_read // 0')
+fi
+
+# CLI 채택률
+TOTAL_BASH=$(jq -r 'select(.event == "PostToolUse" and .tool == "Bash") | .detail.command // ""' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+TSQ_BASH=$(jq -r 'select(.event == "PostToolUse" and .tool == "Bash") | .detail.command // ""' "$JSONL_FILE" 2>/dev/null | grep -c '^\(tsq\|npx tsq\)' || echo "0")
+
+# ============================================================
+# latest.json 읽기 또는 초기화
+# ============================================================
+
+if [ -f "$LATEST_FILE" ]; then
+  EXISTING=$(cat "$LATEST_FILE")
+else
+  EXISTING='{}'
+fi
+
+# 기존 값 추출 (없으면 0)
+PREV_SESSIONS=$(echo "$EXISTING" | jq -r '.totalSessions // 0')
+PREV_EVENTS=$(echo "$EXISTING" | jq -r '.totalEvents // 0')
+PREV_TOOL_USES=$(echo "$EXISTING" | jq -r '.totalToolUses // 0')
+PREV_FAILURES=$(echo "$EXISTING" | jq -r '.totalFailures // 0')
+PREV_SUBAGENTS=$(echo "$EXISTING" | jq -r '.subagentCount // 0')
+PREV_INPUT=$(echo "$EXISTING" | jq -r '.tokens.totalInput // 0')
+PREV_OUTPUT=$(echo "$EXISTING" | jq -r '.tokens.totalOutput // 0')
+PREV_CACHE_CREATE=$(echo "$EXISTING" | jq -r '.tokens.totalCacheCreate // 0')
+PREV_CACHE_READ=$(echo "$EXISTING" | jq -r '.tokens.totalCacheRead // 0')
+PREV_BASH=$(echo "$EXISTING" | jq -r '.cliAdoption.totalBashCommands // 0')
+PREV_TSQ=$(echo "$EXISTING" | jq -r '.cliAdoption.tsqCommands // 0')
+
+# ============================================================
+# 누적 갱신
+# ============================================================
+
+NEW_SESSIONS=$((PREV_SESSIONS + 1))
+NEW_EVENTS=$((PREV_EVENTS + TOTAL_EVENTS))
+NEW_TOOL_USES=$((PREV_TOOL_USES + TOOL_USES))
+NEW_FAILURES=$((PREV_FAILURES + TOOL_FAILURES))
+NEW_SUBAGENTS=$((PREV_SUBAGENTS + SUBAGENTS))
+NEW_INPUT=$((PREV_INPUT + TOKEN_INPUT))
+NEW_OUTPUT=$((PREV_OUTPUT + TOKEN_OUTPUT))
+NEW_CACHE_CREATE=$((PREV_CACHE_CREATE + TOKEN_CACHE_CREATE))
+NEW_CACHE_READ=$((PREV_CACHE_READ + TOKEN_CACHE_READ))
+NEW_BASH=$((PREV_BASH + TOTAL_BASH))
+NEW_TSQ=$((PREV_TSQ + TSQ_BASH))
+
+# 파생 지표
+TOTAL_ATTEMPTS=$((NEW_TOOL_USES + NEW_FAILURES))
+if [ "$TOTAL_ATTEMPTS" -gt 0 ]; then
+  TOOL_EFFICIENCY=$((NEW_TOOL_USES * 100 / TOTAL_ATTEMPTS))
+else
+  TOOL_EFFICIENCY=0
+fi
+
+ALL_INPUT=$((NEW_INPUT + NEW_CACHE_CREATE + NEW_CACHE_READ))
+if [ "$ALL_INPUT" -gt 0 ]; then
+  CACHE_HIT_RATE=$((NEW_CACHE_READ * 100 / ALL_INPUT))
+else
+  CACHE_HIT_RATE=0
+fi
+
+if [ "$NEW_BASH" -gt 0 ]; then
+  CLI_ADOPTION=$((NEW_TSQ * 100 / NEW_BASH))
+else
+  CLI_ADOPTION=0
+fi
+
+# ============================================================
+# latest.json 갱신
+# ============================================================
+
+jq -n -c \
+  --arg ts "$TIMESTAMP" \
+  --arg date "$TODAY" \
+  --arg last_session "$SESSION_SHORT" \
+  --argjson sessions "$NEW_SESSIONS" \
+  --argjson events "$NEW_EVENTS" \
+  --argjson tool_uses "$NEW_TOOL_USES" \
+  --argjson failures "$NEW_FAILURES" \
+  --argjson efficiency "$TOOL_EFFICIENCY" \
+  --argjson subagents "$NEW_SUBAGENTS" \
+  --argjson input "$NEW_INPUT" \
+  --argjson output "$NEW_OUTPUT" \
+  --argjson cache_create "$NEW_CACHE_CREATE" \
+  --argjson cache_read "$NEW_CACHE_READ" \
+  --argjson cache_rate "$CACHE_HIT_RATE" \
+  --argjson bash_total "$NEW_BASH" \
+  --argjson tsq_total "$NEW_TSQ" \
+  --argjson cli_rate "$CLI_ADOPTION" \
+  '{
+    updatedAt: $ts,
+    lastDate: $date,
+    lastSession: $last_session,
+    totalSessions: $sessions,
+    totalEvents: $events,
+    totalToolUses: $tool_uses,
+    totalFailures: $failures,
+    toolEfficiency: $efficiency,
+    subagentCount: $subagents,
+    tokens: {
+      totalInput: $input,
+      totalOutput: $output,
+      totalCacheCreate: $cache_create,
+      totalCacheRead: $cache_read,
+      cacheHitRate: $cache_rate
+    },
+    cliAdoption: {
+      totalBashCommands: $bash_total,
+      tsqCommands: $tsq_total,
+      adoptionRate: $cli_rate
+    }
+  }' | jq '.' > "$LATEST_FILE"
+
+exit 0

package/templates/common/claude/hooks/auto-worklog.sh

@@ -0,0 +1,245 @@
+#!/bin/bash
+# TimSquad Auto Work Log Generator
+# SessionEnd 이벤트 시 호출되어 세션 JSONL을 분석하고
+# .timsquad/logs/{date}-session.md 작업 로그를 자동 생성
+#
+# 사용법: auto-worklog.sh <jsonl_file> <session_id_short>
+
+set -euo pipefail
+
+JSONL_FILE="${1:-}"
+SESSION_SHORT="${2:-unknown}"
+
+if [ -z "$JSONL_FILE" ] || [ ! -f "$JSONL_FILE" ]; then
+  exit 0
+fi
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+LOGS_DIR="$PROJECT_DIR/.timsquad/logs"
+mkdir -p "$LOGS_DIR"
+
+TODAY=$(date +"%Y-%m-%d")
+LOG_FILE="$LOGS_DIR/${TODAY}-session.md"
+TIMESTAMP=$(date +"%H:%M:%S")
+
+# ============================================================
+# JSONL에서 통계 추출
+# ============================================================
+
+TOTAL_EVENTS=$(wc -l < "$JSONL_FILE" | tr -d ' ')
+
+# 최소 이벤트 수 체크 (너무 짧은 세션은 스킵)
+if [ "$TOTAL_EVENTS" -lt 3 ]; then
+  exit 0
+fi
+
+# 도구 사용 횟수
+TOOL_EVENTS=$(jq -r 'select(.event == "PostToolUse") | .tool' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+FAILURES=$(jq -r 'select(.event == "PostToolUseFailure")' "$JSONL_FILE" 2>/dev/null | wc -l | tr -d ' ')
+
+# 서브에이전트 사용
+SUBAGENT_STARTS=$(jq -r 'select(.event == "SubagentStart") | .detail.subagent_type' "$JSONL_FILE" 2>/dev/null)
+SUBAGENT_COUNT=$(echo "$SUBAGENT_STARTS" | grep -c '.' 2>/dev/null || echo "0")
+
+# 도구별 횟수 (상위 5개)
+TOOL_BREAKDOWN=$(jq -r 'select(.event == "PostToolUse") | .tool' "$JSONL_FILE" 2>/dev/null \
+  | sort | uniq -c | sort -rn | head -5 \
+  | awk '{printf "%s(%d) ", $2, $1}')
+
+# 수정된 파일 목록
+FILES_MODIFIED=$(jq -r 'select(.event == "PostToolUse" and (.tool == "Write" or .tool == "Edit")) | .detail.file_path // empty' "$JSONL_FILE" 2>/dev/null \
+  | sort -u)
+
+# 읽은 파일 목록 (상위 10개)
+FILES_READ=$(jq -r 'select(.event == "PostToolUse" and .tool == "Read") | .detail.file_path // empty' "$JSONL_FILE" 2>/dev/null \
+  | sort -u | head -10)
+
+# Bash 커맨드 (상위 5개)
+BASH_COMMANDS=$(jq -r 'select(.event == "PostToolUse" and .tool == "Bash") | .detail.command // empty' "$JSONL_FILE" 2>/dev/null \
+  | head -5)
+
+# 서브에이전트 상세
+SUBAGENT_DETAILS=$(jq -r 'select(.event == "SubagentStart") | "\(.detail.subagent_type): \(.detail.description // "")"' "$JSONL_FILE" 2>/dev/null)
+
+# 타임라인
+FIRST_TS=$(jq -r '.timestamp' "$JSONL_FILE" 2>/dev/null | head -1)
+LAST_TS=$(jq -r '.timestamp' "$JSONL_FILE" 2>/dev/null | tail -1)
+
+FIRST_TIME=$(echo "$FIRST_TS" | sed 's/.*T//;s/Z//')
+LAST_TIME=$(echo "$LAST_TS" | sed 's/.*T//;s/Z//')
+
+# ============================================================
+# 작업 로그 생성
+# ============================================================
+
+# 파일이 없으면 헤더 생성
+if [ ! -f "$LOG_FILE" ]; then
+  cat > "$LOG_FILE" << EOF
+# session 작업 로그 - ${TODAY}
+
+> TimSquad Auto Work Log - Claude Code 세션 이벤트에서 자동 생성
+
+---
+
+EOF
+fi
+
+# 로그 항목 추가
+{
+  echo ""
+  echo "## [$TIMESTAMP] work"
+  echo ""
+  echo "**Session:** \`$SESSION_SHORT\` ($FIRST_TIME ~ $LAST_TIME)"
+  echo ""
+  echo "### 세션 통계"
+  echo "- 총 이벤트: $TOTAL_EVENTS"
+  echo "- 도구 사용: $TOOL_EVENTS회"
+  if [ "$FAILURES" -gt 0 ]; then
+    echo "- 실패: ${FAILURES}회"
+  fi
+  if [ "$SUBAGENT_COUNT" -gt 0 ]; then
+    echo "- 서브에이전트: ${SUBAGENT_COUNT}회"
+  fi
+  echo "- 도구 분포: $TOOL_BREAKDOWN"
+  echo ""
+
+  # 수정 파일
+  if [ -n "$FILES_MODIFIED" ]; then
+    echo "### 수정된 파일"
+    echo "$FILES_MODIFIED" | while read -r f; do
+      [ -n "$f" ] && echo "- \`$f\`"
+    done
+    echo ""
+  fi
+
+  # 서브에이전트 활동
+  if [ -n "$SUBAGENT_DETAILS" ] && [ "$SUBAGENT_COUNT" -gt 0 ]; then
+    echo "### 서브에이전트 활동"
+    echo "$SUBAGENT_DETAILS" | while read -r line; do
+      [ -n "$line" ] && echo "- $line"
+    done
+    echo ""
+  fi
+
+  # 주요 Bash 명령
+  if [ -n "$BASH_COMMANDS" ]; then
+    echo "### 주요 명령"
+    echo '```'
+    echo "$BASH_COMMANDS"
+    echo '```'
+    echo ""
+  fi
+
+  # 토큰 사용량 (SessionEnd 이벤트에서 추출)
+  SESSION_END_USAGE=$(jq -c 'select(.event == "SessionEnd") | .total_usage // empty' "$JSONL_FILE" 2>/dev/null | head -1)
+
+  if [ -n "$SESSION_END_USAGE" ] && [ "$SESSION_END_USAGE" != "{}" ]; then
+    TOTAL_INPUT=$(echo "$SESSION_END_USAGE" | jq -r '.total_input // 0')
+    TOTAL_OUTPUT=$(echo "$SESSION_END_USAGE" | jq -r '.total_output // 0')
+    TOTAL_CACHE_CREATE=$(echo "$SESSION_END_USAGE" | jq -r '.total_cache_create // 0')
+    TOTAL_CACHE_READ=$(echo "$SESSION_END_USAGE" | jq -r '.total_cache_read // 0')
+    TOTAL_TURNS=$(echo "$SESSION_END_USAGE" | jq -r '.turns // 0')
+
+    # cache hit rate 계산
+    TOTAL_ALL_INPUT=$((TOTAL_INPUT + TOTAL_CACHE_CREATE + TOTAL_CACHE_READ))
+    if [ "$TOTAL_ALL_INPUT" -gt 0 ]; then
+      CACHE_HIT_RATE=$((TOTAL_CACHE_READ * 100 / TOTAL_ALL_INPUT))
+    else
+      CACHE_HIT_RATE=0
+    fi
+
+    echo "### 토큰 사용량"
+    echo ""
+    echo "| 항목 | 토큰 | 의미 |"
+    echo "|------|------|------|"
+    echo "| Input | $(printf "%'d" "$TOTAL_INPUT") | 새로 처리된 입력 (캐시 미스) |"
+    echo "| Output | $(printf "%'d" "$TOTAL_OUTPUT") | 생성된 출력 (비용 주요 부분) |"
+    echo "| Cache Create | $(printf "%'d" "$TOTAL_CACHE_CREATE") | 새로 캐시 저장 (첫 턴에 높음) |"
+    echo "| Cache Read | $(printf "%'d" "$TOTAL_CACHE_READ") | 캐시 재사용 (높을수록 효율적) |"
+    echo "| **Cache Hit Rate** | **${CACHE_HIT_RATE}%** | **80%+ 우수 / 60-80% 보통 / <60% 주의** |"
+    echo "| Turns | $TOTAL_TURNS | API 호출 횟수 |"
+    echo ""
+  fi
+
+} >> "$LOG_FILE"
+
+# ============================================================
+# 품질 경고 (threshold 기반 자동 감지)
+# 토큰 비용: 0 - 순수 조건 체크
+# ============================================================
+
+ALERT_FILE="$LOGS_DIR/${TODAY}-alerts.md"
+ALERTS_FOUND=0
+
+# Alert 1: 도구 실패율 > 10%
+TOTAL_ATTEMPTS=$((TOOL_EVENTS + FAILURES))
+if [ "$TOTAL_ATTEMPTS" -gt 5 ]; then
+  FAIL_RATE=$((FAILURES * 100 / TOTAL_ATTEMPTS))
+  if [ "$FAIL_RATE" -gt 10 ]; then
+    if [ "$ALERTS_FOUND" -eq 0 ] && [ ! -f "$ALERT_FILE" ]; then
+      echo "# Quality Alerts - ${TODAY}" > "$ALERT_FILE"
+      echo "" >> "$ALERT_FILE"
+      echo "> TimSquad 자동 품질 경고 - threshold 초과 시 자동 생성" >> "$ALERT_FILE"
+      echo "" >> "$ALERT_FILE"
+    fi
+    echo "- **[$TIMESTAMP]** Tool Failure Rate ${FAIL_RATE}% (> 10%) - 세션 \`$SESSION_SHORT\`" >> "$ALERT_FILE"
+    echo "  - 도구 실패 ${FAILURES}/${TOTAL_ATTEMPTS}회. 에이전트 프롬프트나 권한 설정 점검" >> "$ALERT_FILE"
+    ALERTS_FOUND=1
+  fi
+fi
+
+# Alert 2: Cache Hit Rate < 60% (토큰 데이터가 있을 때만)
+if [ -n "$SESSION_END_USAGE" ] && [ "$SESSION_END_USAGE" != "{}" ]; then
+  if [ "$TOTAL_ALL_INPUT" -gt 0 ] && [ "$CACHE_HIT_RATE" -lt 60 ]; then
+    if [ "$ALERTS_FOUND" -eq 0 ] && [ ! -f "$ALERT_FILE" ]; then
+      echo "# Quality Alerts - ${TODAY}" > "$ALERT_FILE"
+      echo "" >> "$ALERT_FILE"
+      echo "> TimSquad 자동 품질 경고 - threshold 초과 시 자동 생성" >> "$ALERT_FILE"
+      echo "" >> "$ALERT_FILE"
+    fi
+    echo "- **[$TIMESTAMP]** Cache Hit Rate ${CACHE_HIT_RATE}% (< 60%) - 세션 \`$SESSION_SHORT\`" >> "$ALERT_FILE"
+    echo "  - 프롬프트 구조 불안정. CLAUDE.md 또는 에이전트 프롬프트 검토" >> "$ALERT_FILE"
+    ALERTS_FOUND=1
+  fi
+fi
+
+# ============================================================
+# 자동 피드백 생성 (실패 패턴 감지)
+# 도구 실패 3회 이상 → 자동으로 FB-XXXX.json 생성
+# 토큰 비용: 0
+# ============================================================
+
+if [ "$FAILURES" -ge 3 ]; then
+  FEEDBACK_DIR="$PROJECT_DIR/.timsquad/feedback"
+  mkdir -p "$FEEDBACK_DIR"
+
+  # 다음 피드백 번호 결정
+  EXISTING_COUNT=$(ls "$FEEDBACK_DIR"/FB-*.json 2>/dev/null | wc -l | tr -d ' ')
+  NEXT_NUM=$((EXISTING_COUNT + 1))
+  FB_ID=$(printf "FB-%04d" "$NEXT_NUM")
+  FB_FILE="$FEEDBACK_DIR/${FB_ID}.json"
+
+  # 실패한 도구 목록 추출
+  FAILED_TOOLS=$(jq -r 'select(.event == "PostToolUseFailure") | .tool // "unknown"' "$JSONL_FILE" 2>/dev/null \
+    | sort | uniq -c | sort -rn | head -3 \
+    | awk '{printf "%s(%d) ", $2, $1}')
+
+  jq -n \
+    --arg id "$FB_ID" \
+    --arg ts "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
+    --arg msg "세션 ${SESSION_SHORT}에서 도구 실패 ${FAILURES}회 감지. 실패 도구: ${FAILED_TOOLS}" \
+    --arg trigger "tool_failure" \
+    --arg session "$SESSION_SHORT" \
+    '{
+      id: $id,
+      timestamp: $ts,
+      type: "auto-feedback",
+      level: 1,
+      trigger: $trigger,
+      message: $msg,
+      routeTo: "developer",
+      tags: ["auto-detected", "tool_failure", $session]
+    }' > "$FB_FILE"
+fi
+
+exit 0

package/templates/common/claude/hooks/event-logger.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# TimSquad Event Logger - Claude Code Hook
+# PostToolUse, Stop, SessionStart, SessionEnd 이벤트를 자동 기록
+#
+# 저장 위치: .timsquad/logs/sessions/{date}-{session_id_short}.jsonl
+# 형식: JSON Lines (한 줄 = 하나의 이벤트)
+
+set -euo pipefail
+
+# 프로젝트 루트 결정
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+SESSIONS_DIR="$PROJECT_DIR/.timsquad/logs/sessions"
+mkdir -p "$SESSIONS_DIR"
+
+# stdin에서 JSON 읽기
+INPUT=$(cat)
+
+# 기본 필드 추출
+EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // "unknown"')
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+SESSION_SHORT="${SESSION_ID:0:8}"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+TODAY=$(date +"%Y-%m-%d")
+
+# 로그 파일 경로
+LOG_FILE="$SESSIONS_DIR/${TODAY}-${SESSION_SHORT}.jsonl"
+
+# 이벤트별 데이터 추출
+case "$EVENT" in
+  PostToolUse|PostToolUseFailure)
+    TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // "unknown"')
+
+    # tool_input에서 핵심 정보만 추출 (전체 content 제외 - 용량 절약)
+    case "$TOOL_NAME" in
+      Write|Edit)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
+          file_path: .tool_input.file_path,
+          action: "'"$TOOL_NAME"'"
+        }')
+        ;;
+      Read)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
+          file_path: .tool_input.file_path,
+          action: "Read"
+        }')
+        ;;
+      Bash)
+        # 커맨드만 추출 (출력 제외)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
+          command: (.tool_input.command // "" | .[0:200]),
+          action: "Bash"
+        }')
+        ;;
+      Glob|Grep)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
+          pattern: (.tool_input.pattern // ""),
+          path: (.tool_input.path // ""),
+          action: "'"$TOOL_NAME"'"
+        }')
+        ;;
+      Task)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{
+          description: (.tool_input.description // ""),
+          subagent_type: (.tool_input.subagent_type // ""),
+          action: "Task"
+        }')
+        ;;
+      *)
+        TOOL_SUMMARY=$(echo "$INPUT" | jq -c '{action: "'"$TOOL_NAME"'"}')
+        ;;
+    esac
+
+    # 성공 여부
+    if [ "$EVENT" = "PostToolUseFailure" ]; then
+      STATUS="failure"
+    else
+      STATUS="success"
+    fi
+
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "$EVENT" \
+      --arg sid "$SESSION_SHORT" \
+      --arg tool "$TOOL_NAME" \
+      --arg status "$STATUS" \
+      --argjson summary "$TOOL_SUMMARY" \
+      '{timestamp: $ts, event: $ev, session: $sid, tool: $tool, status: $status, detail: $summary}')
+    ;;
+
+  Stop)
+    # transcript에서 마지막 assistant 턴의 토큰 사용량 추출
+    TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
+    USAGE='{}'
+
+    if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+      # 마지막 assistant 메시지의 usage 추출
+      LAST_USAGE=$(tac "$TRANSCRIPT_PATH" | jq -c 'select(.type == "assistant" and .message.usage) | .message.usage' 2>/dev/null | head -1)
+
+      if [ -n "$LAST_USAGE" ] && [ "$LAST_USAGE" != "null" ]; then
+        USAGE=$(echo "$LAST_USAGE" | jq -c '{
+          input: (.input_tokens // 0),
+          output: (.output_tokens // 0),
+          cache_create: (.cache_creation_input_tokens // 0),
+          cache_read: (.cache_read_input_tokens // 0)
+        }')
+      fi
+
+      # 누적 토큰 합산
+      CUMULATIVE=$(jq -s -c '{
+        total_input: ([.[].message.usage.input_tokens // 0] | add),
+        total_output: ([.[].message.usage.output_tokens // 0] | add),
+        total_cache_create: ([.[].message.usage.cache_creation_input_tokens // 0] | add),
+        total_cache_read: ([.[].message.usage.cache_read_input_tokens // 0] | add),
+        turns: length
+      }' <(jq -c 'select(.type == "assistant" and .message.usage)' "$TRANSCRIPT_PATH" 2>/dev/null) 2>/dev/null || echo '{}')
+    fi
+
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "Stop" \
+      --arg sid "$SESSION_SHORT" \
+      --argjson usage "${USAGE:-'{}'}" \
+      --argjson cumulative "${CUMULATIVE:-'{}'}" \
+      '{timestamp: $ts, event: $ev, session: $sid, usage: $usage, cumulative: $cumulative}')
+    ;;
+
+  SessionStart)
+    SOURCE=$(echo "$INPUT" | jq -r '.source // "unknown"')
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "SessionStart" \
+      --arg sid "$SESSION_SHORT" \
+      --arg src "$SOURCE" \
+      --arg cwd "$(echo "$INPUT" | jq -r '.cwd // ""')" \
+      '{timestamp: $ts, event: $ev, session: $sid, source: $src, cwd: $cwd}')
+    ;;
+
+  SessionEnd)
+    # transcript에서 최종 토큰 합산
+    TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
+    TOTAL_USAGE='{}'
+
+    if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+      TOTAL_USAGE=$(jq -s -c '{
+        total_input: ([.[].message.usage.input_tokens // 0] | add),
+        total_output: ([.[].message.usage.output_tokens // 0] | add),
+        total_cache_create: ([.[].message.usage.cache_creation_input_tokens // 0] | add),
+        total_cache_read: ([.[].message.usage.cache_read_input_tokens // 0] | add),
+        turns: length
+      }' <(jq -c 'select(.type == "assistant" and .message.usage)' "$TRANSCRIPT_PATH" 2>/dev/null) 2>/dev/null || echo '{}')
+    fi
+
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "SessionEnd" \
+      --arg sid "$SESSION_SHORT" \
+      --argjson total_usage "${TOTAL_USAGE:-'{}'}" \
+      '{timestamp: $ts, event: $ev, session: $sid, total_usage: $total_usage}')
+
+    # SessionEnd 시 자동화 스크립트 체인 실행
+    # 1. 작업 로그 자동 생성
+    AUTO_WORKLOG="$PROJECT_DIR/.claude/hooks/auto-worklog.sh"
+    if [ -f "$AUTO_WORKLOG" ]; then
+      bash "$AUTO_WORKLOG" "$LOG_FILE" "$SESSION_SHORT" &
+    fi
+
+    # 2. 메트릭 자동 수집 (누적 갱신, 토큰 비용 0)
+    AUTO_METRICS="$PROJECT_DIR/.claude/hooks/auto-metrics.sh"
+    if [ -f "$AUTO_METRICS" ]; then
+      bash "$AUTO_METRICS" "$LOG_FILE" "$SESSION_SHORT" &
+    fi
+    ;;
+
+  SubagentStart)
+    AGENT_TYPE=$(echo "$INPUT" | jq -r '.subagent_type // "unknown"')
+    AGENT_DESC=$(echo "$INPUT" | jq -r '.description // ""' | head -c 200)
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "SubagentStart" \
+      --arg sid "$SESSION_SHORT" \
+      --arg atype "$AGENT_TYPE" \
+      --arg desc "$AGENT_DESC" \
+      '{timestamp: $ts, event: $ev, session: $sid, detail: {subagent_type: $atype, description: $desc}}')
+    ;;
+
+  SubagentStop)
+    AGENT_TYPE=$(echo "$INPUT" | jq -r '.subagent_type // "unknown"')
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "SubagentStop" \
+      --arg sid "$SESSION_SHORT" \
+      --arg atype "$AGENT_TYPE" \
+      '{timestamp: $ts, event: $ev, session: $sid, detail: {subagent_type: $atype}}')
+    ;;
+
+  *)
+    LOG_ENTRY=$(jq -n -c \
+      --arg ts "$TIMESTAMP" \
+      --arg ev "$EVENT" \
+      --arg sid "$SESSION_SHORT" \
+      '{timestamp: $ts, event: $ev, session: $sid}')
+    ;;
+esac
+
+# JSONL 파일에 append
+echo "$LOG_ENTRY" >> "$LOG_FILE"
+
+exit 0