RATATOSKRATATOSK
로그인

데이터 이해하기

Ratatosk의 모든 표면(웹, 알림, API, MCP)은 같은 데이터에서 나옵니다. 구조를 알면 어느 표면에서든 같은 방식으로 읽을 수 있습니다.

릴리스 리뷰

수집된 릴리스 하나마다 리뷰 하나가 만들어집니다:

  • coverage: 원문을 얼마나 읽을 수 있었는지. full_reviewed는 전문을 읽고 판단했다는 뜻입니다. 원문이 너무 짧거나 접근이 어려우면 insufficient로 정직하게 표시하고 원문을 그대로 첨부합니다.
  • assessment: 이 릴리스의 성격 요약 한 줄.
  • facts: 아래 참조. facts가 0건이면서 coverage가 full_reviewed인 것은 "읽었는데 특이사항이 없다"는 뜻입니다. 누락이 아니라 검증된 침묵입니다.

Facts

fact는 릴리스 노트에서 추출한, 확인 가능한 변경 사실 하나입니다.

  • fact_type (9종): security_fix, dependency_bump, capability_removed, capability_deprecated, api_version_changed, identifier_renamed, validation_tightened, default_changed, behavior_changed
  • severity (5단계): info, low, medium, high, critical
  • entities: 그 fact가 건드리는 식별자들. CVE 번호, CRD, feature gate, 플래그, 메트릭, 설정 필드, 의존성 등. 내 매니페스트의 이름과 대조하는 용도입니다.
  • applies_if: 해당 조건. "이 기능을 쓰는 경우에만"처럼 적용 조건이 있으면 담기고, 없으면 무조건 해당입니다.
  • references: 원문 인용(quote)과 출처. 모든 fact는 원문으로 되짚을 수 있습니다.

"조치 필요"의 기준

웹 홈과 이메일 알림이 사용하는 기준은 같습니다:

  • 시큐리티 픽스는 심각도와 무관하게 전부 표시합니다.
  • 그 외에는 호환성이 깨지는 변경(제거·기본값 변경 등) 중심으로 추립니다.
  • 웹 홈의 "조치 필요" 창은 최근 7일(롤링)입니다.

시간 기준

저장·표시·집계의 모든 시간은 UTC입니다. 릴리스 날짜는 GitHub에 게시된 시각(published_at) 기준입니다.

커버리지

추적 대상은 CNCF 랜드스케이프 기반이며, 현재 목록과 각 프로젝트의 분석 이력은 /projects에서 볼 수 있습니다.