crowny-ratelimit 배포 패키지 v1.0.0

개요

흩어진 6개 레이트리밋 도구를 배포 가능한 정식 패키지로 통합. 울트라 병렬(Workflow 6에이전트, 모델분업)로 빌드. 단일 진입점 CLI + 멱등 설치 + 대시보드 + compact 권고 + 셀프테스트 + 문서.

위치 / 구조

/Users/ef/crowny-ratelimit/ (전역 호출: crowny-rl, 심볼릭 ~/.local/bin/crowny-rl)

bin/crowny-rl         통합 진입점 라우터 (심볼릭링크 resolve)
lib/                  검증된 6도구 (수정금지, 위임)
  crowny-throttle.sh        티어별 동시한도 거버너 (+velocity)
  crowny-throttle-wave.sh   울트라 병렬 웨이브 게이트
  crowny-throttle-hook.sh   PreToolUse 429감지+페이싱
  crowny-turn-governor.sh   UserPromptSubmit 턴 스태거
  crowny-autoloop.sh        영속 자율주도
  분업성과.sh                모델분업 정량추적
core/스로틀.한선       4상 AIMD 결정엔진
install.sh / uninstall.sh   멱등 설치/제거 (settings.json 훅 + 심볼릭 + LaunchAgent)
dashboard.sh          통합 대시보드 (8섹션 한 화면)
compact-advisor.sh    ITPM 범인 지목 + /compact 권고
test.sh               셀프테스트 (16항목)
README.md             배포 문서 / SPEC.md 인터페이스 SSOT / VERSION

명령

crowny-rl                 대시보드
crowny-rl velocity [초]    토큰속도
crowny-rl compact         ITPM 범인 지목
crowny-rl throttle|wave|turn|auto|perf <args>   하위도구 위임
crowny-rl install|uninstall|test|version|help

검증 결과

• 셀프테스트 16/16 PASS, 전 파일 bash -n OK
• install.sh 멱등 입증: 기존 훅 감지→SKIP, 훅수 불변(Pre 2/UPS 1), JSON유효, settings.json.bak 백업
• 대시보드 8섹션 실연동, compact-advisor ITPM 범인 정확 지목
• 버그 1건 발견·수정: 심볼릭링크 호출 시 PKG 탐지 깨짐(readlink resolve) + 함수밖 return→exit

빌드 방식 (울트라 병렬 + 모델분업 실측)

Workflow 6에이전트 병렬: 도구제작 4=sonnet, 문서/테스트 2=haiku. 84만토큰, 첫시도 거의 통과(통합검증서 sonnet 버그 1건). 정량성과 기록: 도구제작 sonnet 디버그 0.5회/건, haiku·opus 0회 — 분업성과.sh에 실측 누적.

레이트리밋 3층 해법 (패키지가 통합)

• 예방: 턴 스태거(UserPromptSubmit, AIMD) — 분당 턴수 캡 → ITPM↓
• 반응: 429감지 백오프(PreToolUse) — penalize + 전역 백오프 45s
• 가시화: velocity / compact-advisor — 범인 세션 지목 → /compact 유도(최대레버)

잔여

• README 15KB(과할 수 있음, 추후 압축 검토)
• crowny-hub 퍼블리시(배포)는 사용자 결정 대기
• compact-advisor 임계(ITPM 80만 등) 실데이터로 튜닝 여지