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:
DongHyeonka
2026-11-08 00:02:22 +09:00
commit ddbfc3dcc3
11 changed files with 1700 additions and 0 deletions
+81
View File
@@ -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)