screen → frontend function → endpoint → service → mapper/ORM → SQL → table → column
column ← SQL ← mapper ← service ← endpoint ← frontend function ← screen
레인 셋이 이것을 만듭니다. SQL 레인(Python 과 sqlglot)은 DDL 파일이나 고정된
카탈로그 스냅샷을 스키마로, MyBatis XML 을 파싱 가능한 statement 로, 그
statement 를 테이블과 컬럼의 읽기와 쓰기로 바꿉니다. Java 레인(JDK 자체
파서. Gradle 도 Maven 도 의존성 classpath 도 쓰지 않습니다)은 그 위에
endpoint → controller → service → mapper 를 잇고, SQL 로 쓰이지 않고 @Entity
나 Spring Data 로 선언된 영속성도 함께 다룹니다. 웹 레인(동봉된 파서, 설치
없음)은 엔드포인트 위쪽의 코드, 즉 프런트엔드 호출과 화면이 되는 라우터 선언을
읽습니다.
정직성 계약
모든 답은 네 개의 필드를 달고 다니며, 직렬화 전에 검사받습니다. 비슷하게 생긴
객체를 손으로 만들어 넘기면 나가기 전에 assertContract() 에서 죽습니다.
basis 는 이 답이 어느 커밋과 어느 pack 다이제스트에 근거하는지, 그리고 그
상태가 current, behind, provisional-overlay, unknown 중 무엇인지입니다.
unknown 은 절대 current 로 읽히지 않습니다.
trust 는 계산된 수준(UNCERTIFIED, GOLDEN_FAIL, GOLDEN_PASS)이며
타이핑해 넣은 값이 아닙니다. 골든 코퍼스가 없으면 UNCERTIFIED 입니다.
limits 는 엔진이 보지 못한 것을 범위와 함께 말로 적은 것입니다.
truncated 는 목록별로 얼마나 잘렸는지와 진짜 전체 개수입니다.
빈 목록은 왜 비었는지를 말합니다. not-shipped(축이 아예 만들어지지 않음),
degraded(필요한 것 없이 만들어짐), none(찾아봤고 없었음)입니다. 이 셋은 서로
다른 답이며 [] 하나로 뭉개지지 않습니다.
어디에 쓰는가
SAST 와 CodeQL 은 취약점을 찾습니다. Cascade 는 변경이 어디까지 닿는지를, 화면
에서 DB 컬럼까지의 왕복을 찾습니다. 그것도 모든 엣지에 등급을 달고, 빌드 한 번
없이 소스만 읽어서 답합니다. 어떤 SAST 나 의존성 스캐너도 그 왕복을 답하지
않습니다. 소스만으로 호출이 확정되지 않는 곳은 엣지를 지어내는 대신 그렇다고
표시합니다. 보정할 수 있는 답이라야 에이전트가 손댈 수 있는 답이기 때문입니다.
빠른 시작
준비물과, 무엇이 빠졌는지 알려 주는 명령 하나입니다.
node bin/cascade.mjs setup # SQL 레인: python 을 만들고 고정된 sqlglot 을 설치합니다# plus a JDK 17+ for the Java lane (`brew install openjdk`; set JAVA_HOME)# the web lane needs nothing: its parser is vendored
node bin/cascade.mjs doctor # every prerequisite, its state, the remedy
