feat(plugin): 하네스 플러그인과 마켓을 더한다
문제: 되돌릴 수 없는 명령 차단, 비밀 값 알림, 예측·실측 장부가 소유자 기계의 ~/.claude에만 있거나 아예 없다. 다른 기계·파생 서비스·새 프로젝트는 받을 길이 없고, 훅 코드에 이력과 리뷰도 없다. 고른 방법: 이 repo를 플러그인 마켓으로 두고 공통 플러그인 harness 하나를 싣는다(설계 harness/01-harness-design.md 11절, 결정 Q13 (c)·Q15). - H12(PreToolUse Bash): 호스팅 원격 force push·--mirror·보호 브랜치 지우기, 작업 폴더·/tmp 밖이나 너무 넓은 rm -r, DB·볼륨·migration 삭제를 막는다. 셸 파서는 소유자 전역 guard_bash.py와 정의가 같은 사본이다. 사용자 전역 설정에 guard_bash.py H12가 있으면 건너뛰어 두 번 막지 않는다. - N4(PostToolUse Write·Edit): 비밀 값 모양을 몇 줄로 알리고 막지 않는다. - 장부 SessionStart·Stop 훅: ~/.claude/harness/에 세션 기록 경로와 누적 실측을 쓴다. 출력이 없어 컨텍스트 비용이 0이다. - 스킬 estimate·retro·techdebt: 모두 모델이 부르고 발동 조건을 설명에 문단으로 적었다(결정 Q9). 버린 대안: H12에 git reset --hard·clean·checkout -- .를 넣는 것(설계 5.1절). 이 기계 세션 기록의 Bash 명령 43,078개에서 정당한 사용이 61·32·31건이라 거짓 양성이 크다. 전역 훅을 플러그인으로 옮기는 것은 Q13대로 안정된 뒤에 한다. 위험: H12 판정이 전역 훅과 두 벌이다. 소유자 기계의 전역 훅 시험이 두 사본의 정의를 비교한다. 원격(ssh) rm은 작업 폴더를 몰라 너무 넓은 대상만 막는다. 검증: - python3 -m unittest discover -s plugins/harness/tests: 17개 통과. 조건을 하나씩 끈 사본 12개에서 모두 실패를 확인했다. - 같은 판정을 이 기계 세션 기록 명령 43,078개에 돌려 5건이 막힘: 의도한 막힘 3(desktop 작업 폴더 통째 rm 2, -p 없는 down -v 1), 시험용 볼륨 rm 1, 당시 프로젝트 폴더를 알 수 없는 rm 1. - claude plugin validate --strict: 마켓·플러그인 모두 통과. - 로컬 경로 마켓으로 설치(--scope local) 뒤 새 세션에서 스킬 셋이 보이고 SessionStart·Stop 훅이 기록을 썼다. 항상 드는 비용 약 698토큰.
This commit is contained in:
Executable
+81
@@ -0,0 +1,81 @@
|
||||
#!/usr/bin/env python3
|
||||
"""하네스 플러그인 PostToolUse(Write·Edit·MultiEdit) 넛지 — N4 비밀 값 알림.
|
||||
|
||||
방금 쓴 내용에 비밀 값처럼 보이는 것이 있으면 모델에게 몇 줄 알린다. 막지 않는다(종료 코드 0).
|
||||
- 모양으로 아는 것: 개인 키 머리, AWS 접근 키, GitHub·GitLab·Slack 토큰, sk- API 키, Google API 키
|
||||
- 값이 있는 대입: password·secret·token·api_key 같은 이름에 예시가 아닌 값(따옴표 안이거나 6자 이상)
|
||||
값이 `example`·`dummy`·`changeme`·`${…}`·`<…>`처럼 예시나 참조이면 알리지 않는다.
|
||||
알림에는 값의 앞 4자만 쓴다(값 전체를 컨텍스트에 다시 넣지 않는다).
|
||||
|
||||
시험: `python3 -m unittest discover -s plugins/harness/tests`
|
||||
"""
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
|
||||
PATTERNS = [
|
||||
("개인 키", re.compile(r"-----BEGIN (?:[A-Z0-9]+ )*PRIVATE KEY-----")),
|
||||
("AWS 접근 키", re.compile(r"\b(?:AKIA|ASIA)[0-9A-Z]{16}\b")),
|
||||
("GitHub 토큰", re.compile(r"\b(?:gh[pousr]_[A-Za-z0-9]{36,}|github_pat_[A-Za-z0-9_]{60,})\b")),
|
||||
("GitLab 토큰", re.compile(r"\bglpat-[A-Za-z0-9_-]{20,}")),
|
||||
("Slack 토큰", re.compile(r"\bxox[abprs]-[A-Za-z0-9-]{10,}")),
|
||||
("API 키(sk-)", re.compile(r"\bsk-(?:ant-|proj-)?[A-Za-z0-9_-]{32,}")),
|
||||
("Google API 키", re.compile(r"\bAIza[0-9A-Za-z_-]{35}\b")),
|
||||
]
|
||||
ASSIGN_RE = re.compile(
|
||||
r"(?i)\b([A-Za-z0-9_.-]*(?:password|passwd|secret|api[_-]?key|access[_-]?key|private[_-]?key|token))"
|
||||
r"\s*[:=]\s*(?:(['\"])([^'\"\n]{4,})\2|([^\s'\"#,;]{6,}))")
|
||||
PLACEHOLDER_RE = re.compile(
|
||||
r"(?i)example|dummy|sample|changeme|change-me|placeholder|your[-_ ]|xxx|\*\*\*|redacted|fake|test|"
|
||||
r"^(none|null|true|false|secret|password|token)$|localhost")
|
||||
REFERENCE_CHARS = set("$<>{}()[]%")
|
||||
MAX_LINES = 5
|
||||
|
||||
|
||||
def written_text(tool_input):
|
||||
"""도구 입력에서 새로 쓴 글만 모은다."""
|
||||
parts = [tool_input.get("content"), tool_input.get("new_string")]
|
||||
parts += [e.get("new_string") for e in tool_input.get("edits") or [] if isinstance(e, dict)]
|
||||
return "\n".join(p for p in parts if isinstance(p, str))
|
||||
|
||||
|
||||
def mask(value):
|
||||
return value[:4] + "…" if len(value) > 4 else "…"
|
||||
|
||||
|
||||
def findings(text):
|
||||
out = []
|
||||
for line_no, line in enumerate(text.split("\n"), 1):
|
||||
for label, pattern in PATTERNS:
|
||||
m = pattern.search(line)
|
||||
if m and not PLACEHOLDER_RE.search(m.group(0)):
|
||||
out.append("%d줄: %s 모양 `%s`" % (line_no, label, mask(m.group(0))))
|
||||
for m in ASSIGN_RE.finditer(line):
|
||||
value = m.group(3) or m.group(4)
|
||||
if value.isdigit() or REFERENCE_CHARS & set(value) or PLACEHOLDER_RE.search(value):
|
||||
continue
|
||||
out.append("%d줄: `%s`에 값 `%s`" % (line_no, m.group(1), mask(value)))
|
||||
return out
|
||||
|
||||
|
||||
def main():
|
||||
data = json.load(sys.stdin)
|
||||
if data.get("tool_name") not in ("Write", "Edit", "MultiEdit"):
|
||||
return 0
|
||||
tool_input = data.get("tool_input") or {}
|
||||
found = findings(written_text(tool_input))
|
||||
if not found:
|
||||
return 0
|
||||
path = tool_input.get("file_path", "")
|
||||
lines = ["[N4 비밀 값 알림] %s에 비밀 값처럼 보이는 것이 있다:" % path] + found[:MAX_LINES - 2]
|
||||
lines.append("진짜 값이면 지우고 환경 변수·비밀 저장소에서 읽는다. 예시 값이면 `example`·`dummy`로 표시한다.")
|
||||
print(json.dumps({"hookSpecificOutput": {"hookEventName": "PostToolUse",
|
||||
"additionalContext": "\n".join(lines)}}, ensure_ascii=False))
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
try:
|
||||
sys.exit(main())
|
||||
except Exception: # 넛지는 실패해도 작업을 막지 않는다
|
||||
sys.exit(0)
|
||||
Reference in New Issue
Block a user