핵심 개념
CLI 경계
CLI는 런타임 요청 처리가 아니라 export/검증 흐름을 담당합니다.
배포 전에는 산출물 기준으로 구조를 점검합니다.
산출물 경로
schematic 출력은 정적 흐름 구조를 고정합니다.
projection 출력은 inspector/diagnostics 점검 입력으로 사용합니다.
역량 스냅샷
가능
`ranvier --help`로 명령 표면과 사용법을 빠르게 확인할 수 있습니다.
워크스페이스 예제에서 schematic 산출물을 생성할 수 있습니다.
`ranvier schematic diff`로 git ref 간 회로 구조 변화를 비교할 수 있습니다.
TOML 규칙 기반 구조 정책 검증을 실행하고 위반 시 비정상 종료코드를 반환할 수 있습니다.
입력 산출물 처리 전에 schematic 스키마 버전 호환성을 검증할 수 있습니다.
schematic/timeline/example 입력에서 trace projection 산출물을 생성할 수 있습니다.
`ranvier new`로 매크로 중심 템플릿에서 새 프로젝트를 생성할 수 있습니다.
`ranvier migrate`로 dry-run/verbose/JSON 모드의 버전 마이그레이션 워크플로를 실행할 수 있습니다.
`ranvier catalog list/fetch/verify`로 원격 또는 로컬 카탈로그에서 예제 schematic을 조회하고 가져올 수 있습니다.
`ranvier test`로 API 테스트 컬렉션을 헤드리스 실행할 수 있습니다 — 순차 HTTP 실행, 어설션 평가(10개 연산자), 캡처 체이닝, 환경 변수 보간, glob 지원, text/JSON/JUnit XML 형식 출력으로 CI 통합 지원.
`ranvier new`로 dialoguer 기반 인터랙티브 프로젝트 생성(10개 템플릿), 의존성 선택기(DB/Auth/Observability), `.ranvier/collections/` 및 `.env.example` 자동 생성을 수행할 수 있습니다.
`ranvier status build` 및 `ranvier status from-schematic`으로 Schematic JSON에서 자립형 HTML 상태 페이지를 생성할 수 있습니다. v0.21 ranvier-status 크레이트 통합에서 복원됨.
제한
빠른 시작
ranvier --help
ranvier schematic basic-schematic --output schematic.json
ranvier status projection-from-timeline ./dist/sample.timeline.json --output ./dist/trace주요 워크플로
명령 표면과 인자 규칙을 빠르게 확인합니다.
예제 기반 schematic 산출물을 생성합니다.
projection 산출물을 inspector/diagnostics 점검 흐름에 연결합니다.
검증 명령
CLI 명령 표면 확인
cargo run -- --helpSchematic export 명령 확인
cargo run -- schematic basic-schematic --output schematic.jsonSchematic diff 명령 표면 확인
cargo run -- schematic diff --helpSchematic policy check 명령 표면 확인
cargo run -- schematic policy check --helpCatalog list 명령 확인
cargo run -- catalog list --local --jsonCatalog fetch + verify E2E 확인
cargo run -- catalog fetch basic-schematic --local --output /tmp/basic.json && cargo run -- catalog verify /tmp/basic.json샘플 재현 페이지
재현 절차는 /ko/manual/samples/cli에서 확인하세요.
최신 capability 상태와 버전 산출물은 /ko/status에서 확인하세요.