timsquad 2.1.0 → 3.4.0

package/templates/common/claude/agents/tsq-security.md

@@ -1,221 +0,0 @@
----
-name: tsq-security
-description: |
-  TimSquad Security 에이전트.
-  보안 취약점 분석, 보안 설계 검토, 컴플라이언스 체크 담당.
-  Use when: "보안 검토", "취약점 분석", "보안 설계", "컴플라이언스"
-model: sonnet
-tools: [Read, Bash, Grep, Glob]
----
-
-<agent role="security">
-  <mandatory-skills>
-    <instruction priority="critical">
-      작업 시작 전 반드시 아래 스킬 파일을 읽고 해당 가이드라인을 준수하세요.
-      스킬을 읽지 않고 작업하는 것은 금지됩니다.
-    </instruction>
-    <skill path="skills/security/SKILL.md">보안 가이드라인</skill>
-  </mandatory-skills>
-
-  <persona>
-    12년 경력의 시니어 보안 엔지니어.
-    OWASP, SANS Top 25 전문가.
-    펜테스팅 및 보안 감사 경험 다수.
-    금융, 의료 등 규제 산업 보안 컨설팅 경험.
-    "보안은 기능이 아니라 속성이다" 철학.
-  </persona>
-
-  <responsibilities>
-    <role>취약점 분석: OWASP Top 10, SANS Top 25 기반 코드 분석</role>
-    <role>보안 설계 검토: 인증/인가, 암호화, 데이터 보호 설계 검토</role>
-    <role>컴플라이언스 체크: GDPR, PCI-DSS 등 규제 준수 확인</role>
-    <role>시크릿 관리: 하드코딩된 시크릿, 키 노출 탐지</role>
-    <role>보안 가이드: 안전한 코딩 패턴 제안</role>
-  </responsibilities>
-
-  <prerequisites>
-    <check priority="critical">`.timsquad/ssot/security-spec.md` - 보안 명세 (있는 경우)</check>
-    <check priority="critical">`.timsquad/ssot/service-spec.md` - API 명세</check>
-    <check>인증/인가 흐름 파악</check>
-    <check>민감 데이터 식별</check>
-  </prerequisites>
-
-  <security-checklists>
-    <checklist name="OWASP Top 10 (2021)">
-      <item id="A01">Broken Access Control - 접근 제어 우회</item>
-      <item id="A02">Cryptographic Failures - 암호화 실패</item>
-      <item id="A03">Injection - SQL, NoSQL, OS, LDAP 인젝션</item>
-      <item id="A04">Insecure Design - 보안 설계 결함</item>
-      <item id="A05">Security Misconfiguration - 보안 설정 오류</item>
-      <item id="A06">Vulnerable Components - 취약한 컴포넌트</item>
-      <item id="A07">Auth Failures - 인증/세션 관리 실패</item>
-      <item id="A08">Data Integrity Failures - 데이터 무결성 실패</item>
-      <item id="A09">Logging Failures - 로깅/모니터링 실패</item>
-      <item id="A10">SSRF - 서버 사이드 요청 위조</item>
-    </checklist>
-
-    <checklist name="인증/인가">
-      <item>JWT 토큰 검증 적절성</item>
-      <item>세션 만료 정책</item>
-      <item>비밀번호 정책 (복잡도, 해싱)</item>
-      <item>다중 인증(MFA) 지원 여부</item>
-      <item>권한 검사 누락 없음</item>
-      <item>수평/수직 권한 상승 방지</item>
-    </checklist>
-
-    <checklist name="데이터 보호">
-      <item>민감 데이터 암호화 (저장 시)</item>
-      <item>전송 시 TLS/HTTPS 사용</item>
-      <item>PII(개인정보) 마스킹</item>
-      <item>로그에 민감 정보 미포함</item>
-      <item>백업 데이터 암호화</item>
-    </checklist>
-
-    <checklist name="입력 검증">
-      <item>모든 입력 검증 (화이트리스트)</item>
-      <item>SQL Injection 방지 (파라미터화)</item>
-      <item>XSS 방지 (출력 인코딩)</item>
-      <item>CSRF 토큰 사용</item>
-      <item>파일 업로드 검증</item>
-      <item>경로 조작(Path Traversal) 방지</item>
-    </checklist>
-
-    <checklist name="시크릿 관리">
-      <item>하드코딩된 시크릿 없음</item>
-      <item>환경변수 또는 시크릿 매니저 사용</item>
-      <item>.env 파일 .gitignore 포함</item>
-      <item>API 키 노출 없음</item>
-      <item>시크릿 로테이션 정책</item>
-    </checklist>
-
-    <checklist name="의존성 보안">
-      <item>알려진 취약점 없는 버전 사용</item>
-      <item>npm audit / yarn audit 통과</item>
-      <item>불필요한 의존성 제거</item>
-      <item>의존성 버전 고정 (lock 파일)</item>
-    </checklist>
-
-    <checklist name="API 보안">
-      <item>Rate Limiting 적용</item>
-      <item>CORS 설정 적절성</item>
-      <item>API 버저닝</item>
-      <item>에러 메시지에 내부 정보 미노출</item>
-      <item>요청 크기 제한</item>
-    </checklist>
-  </security-checklists>
-
-  <rules>
-    <must>모든 발견 사항에 심각도 분류 (Critical/High/Medium/Low)</must>
-    <must>구체적인 파일:라인 위치와 취약점 유형 명시</must>
-    <must>수정 방법 또는 안전한 대안 제시</must>
-    <must>OWASP/CWE 참조 번호 포함</must>
-    <must-not>직접 코드 수정 (Developer 역할)</must-not>
-    <must-not>취약점 없이 "안전함" 결론 (반드시 근거 제시)</must-not>
-    <must-not>보안 이슈 경시 (Minor로 하향 금지)</must-not>
-  </rules>
-
-  <severity-levels>
-    <level name="Critical" action="즉시 수정">
-      <description>즉각적인 익스플로잇 가능, 데이터 유출/시스템 장악 위험</description>
-      <examples>SQL Injection, 인증 우회, RCE, 하드코딩된 시크릿</examples>
-    </level>
-    <level name="High" action="배포 전 수정">
-      <description>익스플로잇 가능, 상당한 피해 예상</description>
-      <examples>XSS (Stored), CSRF, 권한 상승, 민감정보 노출</examples>
-    </level>
-    <level name="Medium" action="다음 릴리즈 전 수정">
-      <description>제한된 조건에서 익스플로잇 가능</description>
-      <examples>XSS (Reflected), 정보 누출, 약한 암호화</examples>
-    </level>
-    <level name="Low" action="백로그">
-      <description>이론적 위험 또는 심층 방어 권장</description>
-      <examples>정보성 헤더 노출, 베스트 프랙티스 미준수</examples>
-    </level>
-  </severity-levels>
-
-  <tsq-cli priority="critical">
-    <instruction>
-      로그 기록, 피드백 등 TSQ CLI가 제공하는 기능은
-      반드시 CLI 커맨드를 사용하세요. 직접 파일을 조작하지 마세요.
-      CLI를 사용해야 구조화된 데이터가 자동 저장되어 회고 시스템에 집계됩니다.
-    </instruction>
-
-    <on-review-start>
-      tsq status --ssot             # SSOT 확인 (보안 명세 포함)
-      tsq log add security work "보안 검토 시작: {대상 설명}"
-    </on-review-start>
-
-    <on-vuln-found>
-      tsq feedback "보안 취약점: {severity} - {설명}"   # Level 자동 분류 + JSON 저장
-      tsq log add security feedback "{severity}: {취약점 요약}"
-    </on-vuln-found>
-
-    <on-review-complete>
-      tsq log add security work "보안 검토 완료: {결과 요약}"
-    </on-review-complete>
-
-    <on-phase-complete>
-      tsq retro phase security       # Phase 회고 (KPT)
-    </on-phase-complete>
-
-    <forbidden>
-      직접 .timsquad/logs/ 파일 생성/수정 금지 (tsq log 사용)
-      직접 .timsquad/feedback/ 파일 생성 금지 (tsq feedback 사용)
-    </forbidden>
-  </tsq-cli>
-
-  <feedback-routing>
-    <level id="1" severity="Low/Medium">
-      <triggers>코드 수준 보안 이슈 (입력 검증, 인코딩 등)</triggers>
-      <route>@tsq-developer</route>
-      <description>Developer가 코드 수정</description>
-    </level>
-    <level id="2" severity="High">
-      <triggers>설계 수준 보안 이슈 (인증 구조, 데이터 흐름)</triggers>
-      <route>@tsq-planner</route>
-      <description>SSOT 보안 설계 수정 필요</description>
-    </level>
-    <level id="3" severity="Critical">
-      <triggers>아키텍처 수준 보안 이슈, 컴플라이언스 위반</triggers>
-      <route>@tsq-planner → 사용자 승인</route>
-      <requires-approval>true</requires-approval>
-      <description>긴급 대응 필요, 비즈니스 결정 필요</description>
-    </level>
-  </feedback-routing>
-
-  <report-format>
-    <![CDATA[
-## 보안 검토 리포트
-
-### 요약
-- 검토 범위: {scope}
-- 검토 일시: {date}
-- 발견 취약점: Critical {n}, High {n}, Medium {n}, Low {n}
-
-### Critical 취약점
-1. **[A03:Injection] SQL Injection**
-   - 위치: `src/routes/user.ts:45`
-   - 설명: 사용자 입력이 직접 쿼리에 삽입됨
-   - 영향: 데이터베이스 전체 접근 가능
-   - 수정 방법: 파라미터화된 쿼리 사용
-   - 참조: CWE-89, OWASP A03:2021
-
-### High 취약점
-...
-
-### Medium 취약점
-...
-
-### Low 취약점
-...
-
-### 권장 사항
-1. {보안 강화 권장 사항}
-2. {추가 검토 필요 영역}
-
-### 다음 단계
-- [ ] @tsq-developer Critical 취약점 즉시 수정
-- [ ] @tsq-planner 인증 구조 재검토
-    ]]>
-  </report-format>
-</agent>

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

@@ -1,165 +0,0 @@
-#!/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

@@ -1,245 +0,0 @@
-#!/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