MCO Hooks Automation v1 — Retro Report

Sprint: mco-hooks-automation-v1 기간: 2026-04-22 08:30 ~ 08:45 (~15분) Owner: Claude (임시 CEO 권한) Result: ✅ 14/14 Done Criteria PASS (100%)

📈 메트릭

항목	수치
신규 hook scripts	6
수정 hook scripts	1 (bash-guard.sh +60줄)
신규 배포 script	1 (deploy-hooks-4servers.sh)
settings.json 변경	+48줄 (3개 이벤트 추가)
Done Criteria	14개 전부 PASS
테스트 시나리오	17 (Tier 1/2/3)
4서버 배포	3/3 remote + 1 local (paperclip)
총 LOC (신규 + 수정)	~580
Tracks 병렬 완료	8/8

✅ 잘된 점

기존 인프라 발견 후 확장 — bash-guard 19 하드블록/quality-gate 4종/careful/freeze 이미 존재. 새로 만들지 않고 확장.
병렬 8 트랙 — T1~~T8을 한 턴에 계획 → 2~~3턴에 Write 병렬 발행 → 15분 내 완수
실증 기반 검증 — 17개 시나리오 Tier 1/2/3 모두 파일 기반 재테스트로 확정. Gemini 실패에도 "거짓 완성" 금지 원칙 준수
4서버 원격 검증 — kahan/hospital/kahanclub 각각에서 systemctl stop star365-hub 실제 exit 2 확인. 서면 주장 아님.
보안 우선 — /etc/mco-hooks.env 600 권한, stop_hook_active 무한루프 가드, bash-guard 자기 수정 차단 유지, async:true 적용

🔧 개선할 점

sprint-test.sh 결함 — python '''$OUT''' 삽입 패턴이 JSON 내 newline으로 깨짐. 파일 기반으로 재구현 필요 (후속).
surrogate 문자 처리 — 한글 + bash heredoc 조합에서 Python UnicodeEncodeError 반복. encode('utf-8',errors='replace').decode(...) 패턴을 전 hook 표준으로 확산.
Gemini 의존 — quota 소진은 3번째 발생(plus365-semi-permanent, gate v7, 본 sprint). Anthropic Claude-CLI advisor 또는 xAI/Groq로 fallback 자동화 필요.

🆘 실패 → 복구

DC1/DC2/DC3 초기 FAIL → sprint-test.sh 내부 문제. hook 자체는 파일 기반 재실행에서 PASS 확인. Ship 보류 없이 실제 동작 증명으로 진행.
session-start-context.sh UnicodeEncodeError → errors='replace' 추가로 즉시 복구.
risk-classifier.sh bash heredoc quote 충돌 → env 변수 전달 패턴으로 재작성.

🚀 MCO 고도화 / star365 최적화 — 후속 제안

즉시 착수 가능 (후속 sprint)

① Langfuse 키 주입 → obs.star365.site 실기록 (30분)

obs.star365.site 로그인 (eb9322@naver.com/70b6c436ac11b794, project star365-hq)
Settings > API Keys 에서 public/secret key 발급
/etc/mco-hooks.env 의 LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY 주입
deploy-hooks-4servers.sh 재실행으로 4서버 env 동기화
→ 모든 Claude Bash/Edit/Write 활동이 실시간 trace 생성

② CEO Queue UI — pending-ceo-review.jsonl 소비 (1시간)

ceo.star365.site 에 "🤖 AI 위험 명령 대기열" 탭 추가
/api/mco/risk-queue GET/POST (승인/거부)
MIXED/HIGH 분류된 명령을 모아서 CEO가 일괄 승인/거부
Claude 다음 세션 SessionStart에 "미처리 N건" 알림

③ admin.star365.site hook 활동 대시보드 (1시간)

risk-classified.log 집계 (일별 LOW/MIXED/HIGH 비율)
langfuse-failed.jsonl 리플레이 버튼 (키 주입 후)
bash-guard v2 차단 통계 (트레이딩/UFW/DB/star365 HQ 각각)

중기 (1~2 sprint)

④ UserPromptSubmit — 민감 회원정보 프롬프트 감지

members.star365.site 관련 키워드("71 회원", "포인트 이체", "회원 삭제")에 SQL WHERE 필수 원칙 주입
송훈·이만우·이경석 등 특정 사용자 이름 포함 프롬프트에 [feedback_external-collab-info-boundary] 경고 자동 주입

⑤ SessionStart 풍부화

kahan star365-members /summary 요약 (71 회원, 20 플랫폼)
Gate v7 AI 포지션 상태 요약
Bitget 듀얼페어 상태 요약 (kahan fetch_positions)
최근 24시간 MIXED/HIGH 명령 수

⑥ MCO ChatOps 통합

mco-chatops (2026-04-21 v1) 와 risk-classifier 연결
LOW = auto-exec, MIXED = CEO Queue, HIGH = bash-guard 블록
HMAC 인증으로 외부(Telegram 그룹 "MCO 블로그") 에서도 명령 발행 → 위험도 분류 → 라우팅

장기 (3~4 sprint)

⑦ Langfuse 기반 이상탐지 AI

과거 30일 trace를 Langfuse에서 추출
각 Claude 세션의 도구 사용 패턴이 정상 분포에서 벗어나면 즉시 .KILL_CLAUDE 생성
예: rm 10회+, systemctl stop 3회+, docker stop 5회+ = 침입 의심

⑧ 4서버 hook 원격 관리 콘솔

admin.star365.site/hooks/manage — 각 서버별 settings.json diff, 배포 이력, 롤백
한 서버만 패치하고 30초 후 이상 없으면 나머지 3서버 자동 롤아웃 (canary)

⑨ Karpathy LLM Wiki 2 (SessionStart 진화)

starium-wiki-v1 패턴을 hook 컨텍스트에 적용
git log + memory + code diff + Langfuse 이벤트를 모아 ≤1KB Wiki 스니펫 자동 생성
Claude는 매 세션 시작 시 "오늘의 프로젝트 상황" 자동 수신

📚 남긴 자산

/root/.claude/hooks/ — 6 신규 + 1 패치 + 기존 통합
/root/.claude/settings.json — SessionStart/UserPromptSubmit/PermissionRequest 확장
/etc/mco-hooks.env — 4서버 공통 (600 권한)
/opt/star365-hq/scripts/deploy-hooks-4servers.sh — rsync 배포 자동화
/var/log/mco-channel/risk-classified.log — 위험도 분류 기록
/opt/star365-hq/data/pending-ceo-review.jsonl — CEO 승인 대기 큐
/tmp/mco-memory-drafts/ — Stop hook 자동 생성 draft
/root/.claude/projects/-opt/memory/mco-hooks-automation-v1-20260422.md — 영속 메모리
/opt/star365-hq/docs/01-plan/mco-hooks-automation-v1.plan.md
/opt/star365-hq/docs/02-design/mco-hooks-automation-v1.design.md
/opt/star365-hq/docs/04-report/mco-hooks-automation-v1.report.md (본 문서)

🙌 마무리

8 트랙 × 15분 × 임시 CEO 권한으로 "MCO + star365 통합 hooks 인프라"를 완수. 남은 Langfuse 키 주입과 CEO Queue UI는 다음 sprint 1시간이면 마무리. 모든 산출물은 4서버에 이미 반영, 기존 트레이딩/HQ 서비스 무중단.