coding-buddy-mcp 1.1.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-buddy-mcp",
-  "version": "1.1.0",
+  "version": "2.1.0",
   "description": "A pair programming buddy MCP for Claude Code — optimizes cost and productivity based on Claude Code internals analysis",
   "type": "module",
   "main": "dist/index.js",

package/scripts/guard-claude-md.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Coding Buddy — CLAUDE.md/settings.json 세션 중 수정 차단
+# preToolUse:Edit|Write 에서 실행
+# exit 2 = 차단, exit 0 = 허용
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | python3 -c "
+import sys,json
+d = json.load(sys.stdin)
+print(d.get('file_path', d.get('path', d.get('input',{}).get('file_path',''))))
+" 2>/dev/null)
+
+if echo "$FILE_PATH" | grep -qiE 'CLAUDE\.md$|CLAUDE\.local\.md$'; then
+  echo "⚠️ [Coding Buddy] CLAUDE.md 수정은 캐시 브레이크를 유발합니다. 세션 시작 전에 수정하세요. 지금 수정하면 캐시가 깨져서 이후 모든 요청의 input 비용이 10배 증가합니다."
+  exit 2
+fi
+
+if echo "$FILE_PATH" | grep -qiE '\.claude/settings\.json$'; then
+  echo "⚠️ [Coding Buddy] settings.json 수정은 캐시 브레이크를 유발할 수 있습니다. 세션 시작 전에 수정하세요."
+  exit 2
+fi
+
+exit 0

package/scripts/model-recommend.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+# Coding Buddy — 프롬프트 분석 → 모든 강제 규칙을 여기서 처리
+# 신뢰도 100%가 필요한 것만 훅에 넣는다.
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | python3 -c "
+import sys,json
+d = json.load(sys.stdin)
+print(d.get('message', d.get('prompt', d.get('content', d.get('text', '')))))
+" 2>/dev/null)
+
+[ -z "$PROMPT" ] && exit 0
+
+LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+HINTS=""
+
+# =============================================
+# 1. 모호한 요청 감지 → 되묻기 강제
+# =============================================
+HAS_PATH=false
+echo "$PROMPT" | grep -qE '[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+\.[a-zA-Z]{1,5}' && HAS_PATH=true
+
+VAGUE=false
+if [ "$HAS_PATH" = false ]; then
+  if echo "$LOWER" | grep -qiE '버그.*(찾|fix)|리팩토링|refactor|개선|improve|테스트.*작성|write.*test|에러가 나|error|코드.*리뷰|review|설명해|explain|분석해|analyz|CSS.*수정|스타일.*수정|성능.*개선|최적화|optimiz'; then
+    VAGUE=true
+  fi
+fi
+
+if [ "$VAGUE" = true ]; then
+  HINTS="IMPORTANT: 이 요청은 구체적이지 않습니다. 도구를 호출하지 말고 구체적인 파일 경로와 증상/범위를 먼저 물어보세요. "
+fi
+
+# =============================================
+# 2. 주제 변경 감지 → 새 세션 안내
+# =============================================
+if echo "$LOWER" | grep -qiE '그건 됐고|이제 다른|다음으로|다른 작업|이건 끝|넘어가|다음 할|switch to|move on|next task|다른 거 하자|이제.*쪽 작업'; then
+  HINTS="${HINTS}IMPORTANT: 주제가 바뀌었습니다. 반드시 안내 → 새 작업이니 새 세션에서 시작하는 게 비용과 품질 모두 유리합니다. "
+fi
+
+# =============================================
+# 3. 복잡도 분석 → 모델 추천
+# =============================================
+COMPLEXITY="medium"
+MODEL="Sonnet (\$15/\$75)"
+CMD="/model sonnet"
+
+if echo "$LOWER" | grep -qiE '오타|typo|rename|이름.*변경|format|포맷|간단|simple|주석|import|복사|quick|삭제.*줄'; then
+  COMPLEXITY="simple"
+  MODEL="Haiku (\$1/\$5)"
+  CMD="/model haiku"
+elif echo "$LOWER" | grep -qiE 'migrat|마이그레이션|architect|아키텍처|전체.*리팩|redesign|rewrite|스키마|schema|from scratch|전체 구조|시스템.*설계|전체.*변경|overhaul'; then
+  COMPLEXITY="complex"
+  MODEL="Opus (\$15/\$75)"
+  CMD="/model opus"
+fi
+
+# 모호하지 않고, 작업성 프롬프트일 때만 모델 추천
+IS_TASK=false
+if echo "$LOWER" | grep -qiE '해줘|해주세요|수정|추가|만들|삭제|변경|작성|구현|보여|봐줘|읽어|찾아|고쳐|바꿔|올려|fix|add|create|remove|update|write|implement|refactor|migrate|show|read|find|check|설정|분석|검사|확인|review|test|빌드|build|deploy|설명|explain|마이그레이션|migration|리팩토링|아키텍처'; then
+  IS_TASK=true
+fi
+
+if [ "$VAGUE" = false ] && [ "$IS_TASK" = true ]; then
+  if [ "$COMPLEXITY" = "simple" ]; then
+    HINTS="${HINTS}IMPORTANT: 응답 첫 줄에 반드시 포함 → 💡 모델 추천: ${MODEL}. Haiku는 thinking 토큰이 없어 output 비용이 크게 절감됩니다 (Sonnet/Opus의 thinking은 \$75/1M으로 과금). 현재 모델이 다르면 새 세션에서 ${CMD} 을 안내하세요. "
+  else
+    HINTS="${HINTS}IMPORTANT: 응답 첫 줄에 반드시 포함 → 💡 모델 추천: ${MODEL}. 현재 모델이 다르면 새 세션에서 ${CMD} 을 안내하세요. "
+  fi
+  # 3.3 파일 경로 명시 + 3.2 압축 생존 키워드
+  HINTS="${HINTS}IMPORTANT: 응답에서 파일을 언급할 때 반드시 전체 경로를 사용하세요 (예: src/auth/login.ts). 미완성 작업이 있으면 'todo:', 'next:', 'pending:' 키워드를 포함하세요. 둘 다 압축 후에도 보존됩니다. "
+fi
+
+# =============================================
+# 4. 복잡한 작업 → Plan Mode 제안
+# =============================================
+if [ "$COMPLEXITY" = "complex" ] && [ "$VAGUE" = false ]; then
+  HINTS="${HINTS}IMPORTANT: 이 작업은 복잡합니다. 반드시 안내 → Plan Mode에서 먼저 계획을 세운 후 실행하는 것을 권장합니다. "
+fi
+
+# =============================================
+# 5. 캐시 브레이크 감지
+# =============================================
+if echo "$LOWER" | grep -qiE 'claude\.md.*(수정|추가|변경|편집|만들|update|edit|modify|add|create)'; then
+  HINTS="${HINTS}IMPORTANT: CLAUDE.md 수정은 캐시 브레이크를 유발합니다. 반드시 경고 → 세션 시작 전에 수정하세요. 지금 수정하면 이후 모든 요청 비용이 10배 증가합니다. "
+fi
+
+if echo "$LOWER" | grep -qiE '모델.*(바꿔|변경|전환|switch)|haiku로|sonnet으로|opus로|change.*model|switch.*model'; then
+  HINTS="${HINTS}IMPORTANT: 세션 중 모델 변경은 캐시 브레이크(비용 10배)입니다. 반드시 안내 → 새 세션에서 모델을 바꾸세요. "
+fi
+
+if echo "$LOWER" | grep -qiE 'mcp.*(추가|삭제|켜|끄|설정|변경|add|remove|enable|disable)'; then
+  HINTS="${HINTS}IMPORTANT: MCP 변경은 캐시 브레이크입니다. 안내 → MCP 설정은 세션 시작 전에 하세요. "
+fi
+
+# =============================================
+# 6. 전체 프로젝트 탐색 → 범위 축소
+# =============================================
+if echo "$LOWER" | grep -qiE '전체 구조|프로젝트 전체|전체 파일|모든 파일|entire project|all files|whole project|전체.*파악|프로젝트.*설명'; then
+  HINTS="${HINTS}IMPORTANT: 전체 프로젝트 탐색은 비용이 큽니다. 구체적인 디렉토리나 파일을 지정하도록 안내하세요. "
+fi
+
+# =============================================
+# 7. 다중 독립 작업 → 서브에이전트 병렬 제안
+# =============================================
+NUMBERED=$(echo "$PROMPT" | grep -oE '[0-9]+\.' | wc -l | tr -d ' ')
+if [ "$NUMBERED" -ge 3 ] 2>/dev/null; then
+  HINTS="${HINTS}IMPORTANT: 독립적인 작업이 여러 개 있습니다. 서브에이전트(Explore/general-purpose)로 병렬 처리하면 속도가 빨라집니다. "
+elif echo "$LOWER" | grep -qiE '동시에|병렬|parallel|함께.*해줘|같이.*해줘'; then
+  HINTS="${HINTS}IMPORTANT: 서브에이전트(Explore/general-purpose)로 병렬 처리하면 속도가 빨라집니다. "
+fi
+
+# =============================================
+# 8. 테스트/빌드 실행 → 출력 크기 제한 안내
+# =============================================
+if echo "$LOWER" | grep -qiE 'cargo test|pnpm test|npm test|yarn test|pytest|jest|vitest|빌드|build|pnpm run|npm run'; then
+  HINTS="${HINTS}IMPORTANT: 테스트/빌드 출력은 16KB에서 잘립니다. 결과가 길면 '| tail -50' 을 붙여서 마지막 부분만 보세요. "
+fi
+
+# =============================================
+# 9. 코드 수정 완료 신호 → /diff→/commit→/pr 파이프라인
+# =============================================
+if echo "$LOWER" | grep -qiE '커밋|commit|pr 올려|pr 만들|push|머지|merge|배포|deploy|다 됐|완료|finished|done.*push'; then
+  HINTS="${HINTS}IMPORTANT: 코드 변경 후 파이프라인 안내 → /diff 로 변경사항 확인 → /commit 으로 커밋 → /pr 로 PR 생성. "
+fi
+
+# =============================================
+# 10. 기능 구현 요청 → 검증 루프 + TDD 제안
+# =============================================
+if echo "$LOWER" | grep -qiE '기능.*추가|feature.*add|구현해|implement|만들어줘|추가해줘|개발해|작성해줘'; then
+  if [ "$HAS_PATH" = true ]; then
+    HINTS="${HINTS}IMPORTANT: 구현 후 검증 루프를 안내하세요 → 1) 구현 2) lint/clippy 확인 3) 기존 테스트 통과 확인 4) 새 기능 테스트 추가 5) 전체 테스트 통과 확인. TDD가 가능하면 테스트를 먼저 작성하고 실패 확인 후 구현하는 것을 제안하세요. "
+  fi
+fi
+
+# =============================================
+# 11. 코드 리뷰 요청 → 서브에이전트 독립 리뷰 제안
+# =============================================
+if echo "$LOWER" | grep -qiE '리뷰해|review|검토해|확인해줘.*코드|코드.*봐줘|점검'; then
+  if [ "$HAS_PATH" = true ]; then
+    HINTS="${HINTS}IMPORTANT: 서브에이전트로 독립 리뷰를 제안하세요 → 메인 대화의 편향 없이 보안, 에러 핸들링, 엣지 케이스를 별도 에이전트가 검토하면 품질이 올라갑니다. "
+  fi
+fi
+
+# =============================================
+# 12. 대규모 변경 → 점진적 작업 제안
+# =============================================
+if echo "$LOWER" | grep -qiE '전체.*수정|전부.*바꿔|모든.*파일|대규모|전체.*변경|all.*files.*change|전체.*업데이트'; then
+  HINTS="${HINTS}IMPORTANT: 대규모 변경은 점진적으로 진행하세요 → 1단계씩 나눠서 각 단계마다 /diff로 확인 → /commit으로 체크포인트. 한 번에 10개 파일 수정하면 리뷰 불가능 + 버그 유입됩니다. "
+fi
+
+# =============================================
+# 출력 (매칭된 힌트만 출력 — 불필요한 토큰 없음)
+# =============================================
+[ -n "$HINTS" ] && echo "$HINTS"
+exit 0

package/scripts/session-check.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Coding Buddy — SessionStart 훅
+# 오래된 세션을 resume한 경우 새 세션을 권장한다.
+
+# 최근 세션 파일의 수정 시간을 확인
+SESSION_DIR="$HOME/.claude/projects"
+if [ ! -d "$SESSION_DIR" ]; then
+  exit 0
+fi
+
+# 가장 최근 세션 파일 찾기
+LATEST=$(find "$SESSION_DIR" -name "*.jsonl" -type f 2>/dev/null | xargs ls -t 2>/dev/null | head -1)
+if [ -z "$LATEST" ]; then
+  exit 0
+fi
+
+# 파일 수정 시간과 현재 시간 차이 (초)
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  FILE_TIME=$(stat -f %m "$LATEST" 2>/dev/null)
+else
+  FILE_TIME=$(stat -c %Y "$LATEST" 2>/dev/null)
+fi
+
+NOW=$(date +%s)
+DIFF=$(( NOW - FILE_TIME ))
+HOURS=$(( DIFF / 3600 ))
+
+# 1시간 이상 된 세션이면 경고
+if [ "$HOURS" -ge 1 ]; then
+  echo "IMPORTANT: 이전 세션이 ${HOURS}시간 전 것입니다. 압축이 누적되어 맥락 손실과 비용 증가가 발생합니다. 새 세션 시작을 권장하세요."
+fi
+
+exit 0

package/TEST_CASES.md

@@ -1,165 +0,0 @@
-# Coding Buddy MCP 테스트 케이스
-
-아무 프로젝트에서 새 세션을 열고 아래 프롬프트를 하나씩 입력합니다.
-각 테스트 후 `/clear`로 초기화하고 다음 테스트를 진행하세요.
-
----
-
-## 테스트 0: MCP 연결 확인
-```
-/mcp
-```
-- [ ] coding-buddy가 목록에 보인다
-- [ ] 도구 3개 표시: analyze_task, setup_project, cost_reference
-
----
-
-## A. CRITICAL GATE (구체성 강제) — 가장 중요
-
-### A-1. 모호한 버그 요청 (한국어)
-```
-버그 찾아줘
-```
-- [ ] 도구를 호출하지 않고 파일 경로/증상을 되묻는다
-- [ ] Explore, Glob, Grep 등 탐색을 시작하지 않는다
-
-### A-2. 모호한 버그 요청 (영어)
-```
-find bugs in this project
-```
-- [ ] 되묻는다 (which file? what symptoms?)
-
-### A-3. 모호한 리팩토링
-```
-코드 리팩토링 해줘
-```
-- [ ] 범위를 확인한다 (어떤 파일? 어떤 부분?)
-
-### A-4. 모호한 테스트 요청
-```
-테스트 작성해줘
-```
-- [ ] 어떤 파일/함수에 대한 테스트인지 되묻는다
-
-### A-5. 모호한 에러 보고
-```
-에러가 나
-```
-- [ ] 에러 메시지와 발생 파일을 물어본다
-
-### A-6. 구체적 요청 → 바로 실행해야 함
-```
-package.json의 dependencies 섹션 보여줘
-```
-- [ ] 되묻지 않고 바로 파일을 읽는다
-
-### A-7. 구체적 버그 요청 → 바로 실행해야 함
-```
-src/index.ts의 main 함수에서 에러 핸들링이 빠져있어. 확인해줘
-```
-- [ ] 되묻지 않고 해당 파일을 바로 읽는다
-
----
-
-## B. 모델 추천 (analyze_task 도구 호출)
-
-### B-1. 단순 작업 → Haiku 추천
-```
-README.md에서 오타 하나 수정해줘. "recieve"를 "receive"로
-```
-- [ ] analyze_task 도구를 호출한다
-- [ ] Haiku를 추천한다
-
-### B-2. 중간 작업 → Sonnet 추천
-```
-src/components/LoginForm.tsx에 비밀번호 유효성 검사 추가해줘
-```
-- [ ] analyze_task 도구를 호출한다
-- [ ] Sonnet을 추천한다
-
-### B-3. 복잡한 작업 → Opus 추천 + Plan Mode 제안
-```
-인증 시스템을 JWT에서 세션 기반으로 전체 마이그레이션 해줘
-```
-- [ ] analyze_task 도구를 호출한다
-- [ ] Opus를 추천한다
-- [ ] Plan Mode를 먼저 쓰라고 제안한다
-
----
-
-## C. 세션 관리
-
-### C-1. 주제 변경 감지
-(먼저 아무 작업을 하나 한 후)
-```
-그건 됐고, 이제 CI/CD 파이프라인 설정해줘
-```
-- [ ] 새 세션을 시작하라고 제안한다
-
-### C-2. 작업 완료 후 정리 제안
-(아무 간단한 작업 완료 후 Claude가 "완료했습니다" 류의 답변을 한 후)
-- [ ] /clear 또는 새 세션을 제안한다
-
----
-
-## D. 캐시 보호
-
-### D-1. 모델 변경 경고
-```
-모델을 opus로 바꿔줘
-```
-- [ ] 캐시가 깨진다고 경고한다
-- [ ] 새 세션에서 바꾸라고 안내한다
-
-### D-2. CLAUDE.md 수정 경고
-```
-CLAUDE.md에 새로운 규칙 추가해줘
-```
-- [ ] 세션 시작 전에 수정하라고 경고한다 (캐시 브레이크)
-
----
-
-## E. 생산성
-
-### E-1. 복잡한 작업 → Plan Mode 제안
-```
-데이터베이스 스키마를 PostgreSQL에서 MongoDB로 마이그레이션 계획 세워줘
-```
-- [ ] Plan Mode를 먼저 제안한다
-
-### E-2. CLAUDE.md 없는 프로젝트에서 setup 제안
-(CLAUDE.md가 없는 프로젝트에서)
-```
-이 프로젝트 최적화하고 싶어
-```
-- [ ] setup_project 도구를 호출하거나 CLAUDE.md 생성을 제안한다
-
-### E-3. 비용 참조
-```
-Claude Code 모델별 가격이 어떻게 돼?
-```
-- [ ] cost_reference 도구를 호출한다
-- [ ] 모델별 단가표를 보여준다
-
----
-
-## F. Output 효율
-
-### F-1. 간결한 응답
-(아무 구체적 작업 후)
-- [ ] 불필요한 요약 없이 간결하게 답한다
-- [ ] "제가 한 작업을 정리하면..." 같은 반복 없음
-
----
-
-## 테스트 결과 요약
-
-| 카테고리 | 통과 | 실패 | 비고 |
-|---------|------|------|------|
-| A. 구체성 강제 (7개) | /7 | /7 | |
-| B. 모델 추천 (3개) | /3 | /3 | |
-| C. 세션 관리 (2개) | /2 | /2 | |
-| D. 캐시 보호 (2개) | /2 | /2 | |
-| E. 생산성 (3개) | /3 | /3 | |
-| F. Output 효율 (1개) | /1 | /1 | |
-| **합계** | **/18** | **/18** | |