Eason4real/releaseguard-ai
TypeScript0 / 0
배포 후 이상 징후를 감지해 증거 기반 조사와 승인·복구 검증까지 기록하는 TypeScript 웹 Agent Demo입니다.
TL;DR
ReleaseGuard AI는 소프트웨어 배포 후 이상 징후를 감지하고 원인 조사부터 승인, 조치, 복구 검증까지 연결하는 감사 가능한 AI Agent 웹 Demo입니다. 규칙 기반 위험 감지와 Planner의 제한된 도구 호출, 경쟁 가설과 증거 링크를 사용해 조사 과정을 기록합니다. 공개 모드는 브라우저 메모리의 결정론적 Replay 데이터만 사용하며 실제 LLM, GitHub, D1, 외부 쓰기 작업을 차단합니다. 개발자는 Next.js와 TypeScript 구조, 22개 조사 benchmark, 328/328 통과 테스트를 바탕으로 안전한 포트폴리오 Demo나 내부 운영용 기반으로 판단할 수 있지만 PRIVATE_LIVE 운영에는 별도 인증과 비밀 관리가 필요합니다.
핵심 포인트
- ReleaseGuard AI는 배포 후 이상 징후를 규칙으로 감지하고 Agent 조사 흐름으로 연결합니다. baseline, sample-size, consecutive-window 조건을 함께 사용합니다. 공개 Demo에서는 결정론적 Replay 데이터로 같은 조사 결과를 재현합니다.
- Planner가 도구 호출과 예산을 구조화하고 경쟁 가설마다 지지·반박 증거를 연결합니다. ToolCall, ToolResult, Evidence, 진단 기록이 조사 과정에 남습니다. 유사 사고는 현재 원인의 증명이 아닌 가설 형성 단서로만 취급합니다.
- CREATE_GITHUB_ISSUE 쓰기 작업은 사람의 승인 뒤에만 실행됩니다. 승인 경계와 실행 후 복구 검증을 별도 기록으로 분리합니다. 실제 운영에 적용하려면 PRIVATE_LIVE를 접근 통제하고 GitHub·모델 자격 증명을 배포 비밀로 관리해야 합니다.
- Next.js App Router와 TypeScript 기반의 full-stack 웹 애플리케이션입니다. Cloudflare Worker와 D1을 호스팅 경로로 사용하고 로컬·CI에서는 시뮬레이션 또는 fallback을 사용합니다. Node.js 22.13.0 이상과 npm lockfile 환경이 필요합니다.
벤치마크
| 벤치마크 | 지표 | 값 | 비교 |
|---|---|---|---|
| 결정론적 조사 benchmark | 테스트 케이스 수 | 22 cases | — |
| npm test | 통과 검사 수 | 328/328 checks | README의 최신 검증 실행 결과이며 운영 데이터 성능 수치가 아닙니다. |
158
Stars
21
Forks
+206
Trending
0
조회수
158 watchers0 open issues
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.