Ranvier
EN

현황

서브모듈 상태를 한눈에 확인하세요.

각 모듈의 현재 가능 범위와 검증 방법을 한 곳에서 확인할 수 있습니다.

업데이트 일자: 2026-07-17
ranvier 출시 준비 완료cli 출시 준비 완료studio 동결studio-server 활성 개발vscode 출시 준비 완료

ranvier

처음 사용하는 개발자가 타입 안전한 의사결정 흐름을 만들고 기준 예제를 실행하며 HTTP 어댑터를 연결할 수 있는 핵심 Rust 모듈입니다.

단계: 출시 준비 완료
커밋: 732d0734a3f9e479932935f6022545fbca8a66f1 최종 검증: 2026-07-17

버전

현재 0.51.0
라인 0.51.x
채널 안정
배포 상태 배포됨
버전 출처 ranvier/Cargo.toml [workspace.package.version]

배포 결과물

ranvier-core crates.io 0.51.0 배포됨
ranvier-macros crates.io 0.51.0 배포됨
ranvier-runtime crates.io 0.51.0 배포됨
ranvier-http crates.io 0.51.0 배포됨
ranvier-std crates.io 0.51.0 배포됨
ranvier-guard crates.io 0.51.0 배포됨
ranvier-audit crates.io 0.51.0 배포됨
ranvier-compliance crates.io 0.51.0 배포됨
ranvier-inspector crates.io 0.51.0 배포됨
ranvier-openapi crates.io 0.51.0 배포됨
ranvier-test crates.io 0.51.0 배포됨
ranvier crates.io 0.51.0 배포됨

현재 가능한 작업

  • Axon, Transition, Outcome, Bus 계약으로 타입 안전한 의사결정 파이프라인을 구성하고 fault, 분기, 재시도, 타임아웃, 패닉 복구, 스트리밍 결과와 명시적으로 공유한 읽기 전용 병렬 컨텍스트를 다룰 수 있습니다.
  • Experimental cancellation API로 도메인 Outcome을 바꾸지 않고 Axon, 병렬/스트리밍 실행, 영속화/보상, 관리형 HTTP·Inspector·cluster 수명주기에 구조화된 취소를 전파할 수 있습니다.
  • 타입 안전한 JSON·쿼리·경로·페이지네이션·의미 검증 경계를 사용해 선택한 의사결정 워크플로를 네이티브 HTTP 또는 Tower/Axum 하이브리드 방식으로 노출할 수 있습니다.
  • 인증, CORS, 보안 헤더, 요청 제한, 멱등성, 속도 제한, 프록시 신뢰 등 경로 단위 정책을 조합 가능한 Guard로 적용할 수 있습니다.
  • 계약 기반 OpenAPI와 Problem Details를 제공하고, 애플리케이션 필요에 따라 정적·SPA·템플릿 콘텐츠와 WebSocket 또는 SSE 엔드포인트를 서빙할 수 있습니다.
  • Inspector의 메트릭, 트레이스, 페이로드 캡처, DLQ, 중단점, 실행 계보, 라우트 메타데이터, 릴레이, 스키마 기반 샘플로 실행 중인 의사결정을 관측하고 디버깅할 수 있습니다.
  • 영속 체크포인트, 보상, 감사 sink, 명시적 장애 복구 동작으로 재개 가능한 세션 및 작업 워크플로를 실행할 수 있습니다.
  • 설정 프로필, 구조화 로깅, TLS, Prometheus/OTLP 텔레메트리, 배포 환경이 통제하는 Inspector 보안으로 서비스를 운영할 수 있습니다.
  • AxonTestKit, Timeline, TestApp, ranvier-test 도구로 의사결정과 HTTP 동작을 인프로세스 테스트하고 반복 가능한 성능 기준을 확인할 수 있습니다.
  • SemVer 검사, 버전이 있는 스키마, Schematic diff/policy 산출물로 라이브러리와 실행 구조의 호환성을 검증할 수 있습니다.
  • API, 실시간 흐름, Saga, 정책 집행, LLM-as-Transition 사용 사례를 다루는 tier 기반 예제와 참조 구현으로 지원 패턴을 학습하고 검증할 수 있습니다.

현재 제한 사항

  • 협력적 취소는 yield하지 않는 CPU/블로킹 코드를 선점하지 않으며 강제 종료 뒤 보상 완료를 보장하지 않습니다. runtime
  • 분산 내구성, ID, 텔레메트리 보장은 명시적으로 구성한 외부 서비스가 필요하며 인메모리 개발 기본값은 프로덕션 보장을 의미하지 않습니다. deployment
  • M419-RQ10의 단일 2-CPU 인메모리 fixture 결과는 외부 서비스, 다른 머신, WebSocket/SSE population 또는 adopter 코드의 보편 처리량·지연 SLO가 아닙니다. runtime

제품 경계

  • Inspector 역할·테넌트에 대한 토큰 또는 클레임 매핑은 코어 런타임의 ID 공급자 기능이 아니므로 배포 환경의 게이트웨이 또는 ID 시스템과 통합해야 합니다. deployment
  • Ranvier는 ORM, 범용 리버스 프록시, 호스팅 플랫폼이 아니며 애플리케이션이 해당 경계의 전문 생태계 구성요소를 통합해야 합니다. application

검증 명령

기본 제품 및 Canonical 예제 검증 통과
node scripts/tiered_example_gate.mjs --lane developer --phase check
타입 흐름 예제 실행 확인 통과
cargo run -p typed-state-tree
Guard 크레이트 테스트 확인 (15개 Guard, advanced feature 포함) 통과
cargo run -p routing-params-demo
OpenAPI 생성기 회귀 테스트 확인 통과
cargo test -p ranvier-http
OpenAPI 데모 컴파일 확인 통과
cargo test -p ranvier-http --test test_app_health
정적 서빙/SPA fallback 회귀 테스트 확인 통과
cargo test -p ranvier-http --features validation
정적 SPA 데모 컴파일 확인 통과
cargo run -p ranvier-http --example validation_struct_level --features validation
WebSocket ingress 업그레이드/이벤트 브리지 테스트 확인 통과
cargo test -p ranvier-guard --features advanced
WebSocket ingress 데모 컴파일 확인 통과
cargo test -p ranvier-openapi
Inspector TraceStore + BearerAuth 테스트 확인 통과
cargo check -p openapi-demo
Supported 릴리스 lane 검증 통과
cargo test -p ranvier-http
Lab 주간 컴파일 lane 검증 통과
cargo check -p static-spa-demo
예제 회귀 스모크(M119) 확인 통과
cargo test -p ranvier-http
Inspector quick-view 스모크 확인 통과
cargo check -p websocket-ingress-demo
Schematic diff/policy 스모크 확인 통과
cargo test -p ranvier-inspector
Fullstack embedded static 스모크 확인 통과
node scripts/tiered_example_gate.mjs --lane release --phase all
M132 ecosystem reference 조합 스모크 확인 통과
node scripts/tiered_example_gate.mjs --lane lab --phase all
Session 패턴 예제 컴파일 확인 통과
./scripts/m119_examples_smoke.ps1
Inspector 메트릭 수집 + stall 감지 테스트 확인 통과
./scripts/m131_inspector_quickview_smoke.ps1
Inspector 조건부 중단점 + 페이로드 캡처 테스트 확인 통과
./scripts/m131_schematic_diff_policy_smoke.ps1
Fullstack embedded static smoke 통과
./scripts/m131_fullstack_embedded_smoke.ps1
Runtime timeline integration assertion 통과
cargo test -p ranvier-runtime timeline_assertion_works_in_integration_test
M132 SeaORM ecosystem reference run 통과
cargo run -p ecosystem-seaorm-demo
M132 Diesel ecosystem reference run 통과
cargo run -p ecosystem-diesel-demo
M132 Redis ecosystem reference run 통과
cargo run -p ecosystem-redis-demo
M132 NATS ecosystem reference run 통과
cargo run -p ecosystem-nats-demo
M132 Meilisearch ecosystem reference run 통과
cargo run -p ecosystem-meilisearch-demo
Session pattern example compile 통과
cargo check -p session-pattern
Inspector metrics + stall detection tests 통과
cargo test -p ranvier-inspector metrics stall
Inspector conditional breakpoint + payload capture tests 통과
cargo test -p ranvier-inspector breakpoint payload
Guard demo compile (legacy CorsGuard, RateLimit, SecurityHeaders, IpFilter) 통과
cargo check -p guard-demo
Guard integration demo compile (12 Guards: 7 global + 3 per-route) 통과
cargo check -p guard-integration-demo
Auth JWT role-based demo compile (IamVerifier, IamPolicy, with_iam) 통과
cargo check -p auth-jwt-role-demo
M419 cooperative cancellation and managed lifecycle tests 통과
cargo test -p ranvier-core -p ranvier-runtime -p ranvier-http -p ranvier-inspector --all-features
M419 cancellation public inventory and compile contract 통과
node scripts/api_surface_inventory.mjs --check && node scripts/candidate_api_baseline.mjs --check && node scripts/candidate_compile_contract.mjs
M419 candidate SemVer gate 통과
node scripts/candidate_api_semver.mjs

참고 문서

  • ranvier/README.md

cli

Ranvier 사용자가 명령 표면을 확인하고 예제 기반 schematic/projection 산출물을 생성할 수 있는 명령줄 도구입니다.

단계: 출시 준비 완료
커밋: 8443d96048aaa27b27a629f6379fd1209ecbceae 최종 검증: 2026-07-16

버전

현재 0.8.0
라인 0.8.x
채널 안정
배포 상태 배포됨
버전 출처 cli/Cargo.toml [package.version]

배포 결과물

ranvier-cli crates.io 0.8.0 배포됨

현재 가능한 작업

  • 지원 명령 표면을 확인하고 산출물을 처리하기 전에 호환되지 않는 Schematic 스키마 버전을 거부할 수 있습니다.
  • 명시적 의존성 선택과 함께 API, worker, scheduler, Saga, screening, pipeline 및 도메인 템플릿에서 매크로 중심 프로젝트를 생성할 수 있습니다.
  • 워크스페이스, 예제, Timeline 입력에서 Schematic 및 trace projection 산출물을 내보낼 수 있습니다.
  • Git ref 사이의 Schematic을 비교하고 버전이 있는 TOML 구조 정책을 CI 친화적 종료 코드로 집행할 수 있습니다.
  • Schematic 산출물에서 자립형 HTML 상태 페이지를 생성할 수 있습니다.
  • dry-run, verbose, JSON 보고 모드로 명시적 규칙 기반 버전 마이그레이션을 계획하고 적용할 수 있습니다.
  • 로컬 또는 원격 카탈로그에서 예제 Schematic을 탐색·가져오기·검증할 수 있습니다.
  • 캡처, 환경 변수 보간, 어설션, glob 선택과 text·JSON·JUnit 출력을 사용해 요청 컬렉션을 헤드리스 실행할 수 있습니다.

현재 제한 사항

현재 제한 사항이 없습니다.

제품 경계

  • CLI는 대화형 IDE 또는 다중 사용자 실시간 모니터링 화면이 아니며 해당 흐름에는 VS Code 확장이나 Studio 제품을 사용해야 합니다. cli
  • 프로젝트 생성과 마이그레이션 규칙은 임의의 애플리케이션 비즈니스 변경을 추론하지 못하므로 생성·변환 결과를 검토해야 합니다. cli

검증 명령

CLI 명령 표면 확인 통과
cargo run -- --help
Schematic export 명령 확인 통과
cargo run -- schematic basic-schematic --output schematic.json
Schematic diff 명령 표면 확인 통과
cargo run -- schematic diff --help
Schematic policy check 명령 표면 확인 통과
cargo run -- schematic policy check --help
Catalog list 명령 확인 통과
cargo run -- catalog list --local --json
Catalog fetch + verify E2E 확인 통과
cargo run -- catalog fetch basic-schematic --local --output /tmp/basic.json && cargo run -- catalog verify /tmp/basic.json

참고 문서

  • cli/README.md

studio

Bevy 0.18 기반 GPU 가속 네이티브 데스크톱 앱으로, 3D Schematic 그래프 시각화, 실시간 엣지 데이터 플로우 애니메이션, Payload 검사, 인터랙티브 중단점 디버깅, 프로덕션 UX(설정/검색/21개 단축키)를 제공합니다.

단계: 동결
커밋: 6aebe20390f07f041fb1371dc226fb4a3a096dd9 최종 검증: 2026-07-16

버전

현재 0.2.0
라인 0.2.x
채널 프리뷰
배포 상태 내부 배포
버전 출처 studio/Cargo.toml [package.version]

배포 결과물

ranvier-studio cargo 0.2.0 내부용

현재 가능한 작업

  • Guard, Transition, Compensation 레이어를 GPU 가속 3D Schematic으로 렌더링할 수 있습니다.
  • 여러 카메라 모드와 노드 포커스 선택으로 대규모 의사결정 그래프를 탐색하고 검색할 수 있습니다.
  • Inspector WebSocket 이벤트에서 실시간 노드 상태와 엣지 데이터 흐름 변화를 추적할 수 있습니다.
  • 대상 Inspector가 페이로드 캡처를 명시적으로 활성화한 경우 캡처된 JSON 페이로드를 검사할 수 있습니다.
  • 데스크톱 디버거에서 중단점을 설정하고 의사결정 실행을 일시정지·단계 실행·재개할 수 있습니다.
  • 전용 패널에서 Bus, 회로, 라우트, DLQ, 릴레이 작업, 트레이스 Timeline을 검사할 수 있습니다.
  • 반복되는 데스크톱 세션을 위해 Inspector 연결, 인증, 갱신, 화면 설정을 저장할 수 있습니다.

현재 제한 사항

현재 제한 사항이 없습니다.

제품 경계

  • Studio는 인라인 소스 탐색을 위한 1차 IDE 화면이 아니며 해당 흐름은 VS Code 확장 범위입니다. studio
  • Studio는 네이티브 데스크톱 애플리케이션으로 모바일 또는 웹 브라우저에서 실행되지 않습니다. studio

검증 명령

Inspector 연결 + 3D Schematic 로드 확인 통과
cargo run -p ranvier-studio -- --url http://localhost:9090
실시간 노드 상태 변화 확인 통과
Send request to target service > Observe node state changes in Studio
Breakpoint 설정 + Debug 제어 확인 통과
Right-click node > Set Breakpoint > Trigger > Step > Resume

참고 문서

  • studio/README.md

studio-server

Ranvier의 첫 'Built with Ranvier' 참조 애플리케이션인 웹 모니터링 대시보드 서버. 타입 안전 Axon 파이프라인으로 Inspector API를 릴레이하고, SvelteFlow 인터랙티브 Schematic과 8페이지 대시보드를 서빙합니다. Studio Desktop(Bevy, v0.2.0 동결)의 후계.

단계: 활성 개발
커밋: a2f14d401ef5f0507bb5aa2a50794c7e8b5b4a01 최종 검증: 2026-07-16

버전

현재 0.19.0
라인 0.19.x
채널 프리뷰
배포 상태 내부 배포
버전 출처 studio-server/Cargo.toml [package.version]

배포 결과물

studio-server cargo 0.19.0 내부용
studio-dashboard npm 0.1.0 내부용

현재 가능한 작업

  • 브라우저 기반 팀 모니터링 대시보드를 제공하고 Ranvier Axon 파이프라인으로 Inspector API를 릴레이할 수 있습니다.
  • 설정 가능한 폴링으로 서비스 상태, 처리량, 지연, 오류, 노드, 회로, 라우트, DLQ 신호를 요약할 수 있습니다.
  • 인터랙티브 Schematic에서 회로 토폴로지를 탐색하고 노드 상세와 중단점을 제어할 수 있습니다.
  • 새 이벤트 피드백과 함께 Inspector 생명주기 이벤트를 필터링하고 모니터링할 수 있습니다.
  • Trace Timeline에서 실행 구간을 active, slow, success, fault로 구분해 검사할 수 있습니다.
  • DLQ 페이로드를 검토하고 재시도 또는 폐기 작업을 요청할 수 있습니다.
  • 유지관리되는 컨테이너와 Compose 설정으로 대시보드와 Rust 릴레이를 함께 빌드·배포할 수 있습니다.

현재 제한 사항

  • Studio Server는 Inspector WebSocket 실시간 스트리밍 대신 HTTP 폴링을 사용합니다. studio-server

제품 경계

  • Studio Server는 네이티브 Studio 애플리케이션의 3D GPU 가속 시각화를 제공하지 않습니다. studio

검증 명령

서버 시작 + 대시보드 접근 확인 통과
cargo run -p studio-server > open http://localhost:9040
Inspector 릴레이 API 프록시 확인 통과
curl http://localhost:9040/api/v1/metrics
npm run build 정적 빌드 확인 통과
cd frontend && npm run build

참고 문서

  • studio-server/README.md

vscode

Ranvier를 VSCode에서 처음 사용할 때 필요한 VS Code-native 회로 탐색, source jump, diagnostics 오버레이, 이슈 이동, 접근성 보강 대화상자, API 요청 테스트 흐름을 제공하는 확장입니다.

단계: 출시 준비 완료
커밋: 27f53657659b085e2e6e860d487e969a56c29ee0 최종 검증: 2026-07-16

버전

현재 0.4.0
라인 0.4.x
채널 프리뷰
배포 상태 배포됨
버전 출처 vscode/package.json [version]

배포 결과물

ranvier-vscode vscode-marketplace 0.4.0 배포됨

현재 가능한 작업

  • Schematic 그래프를 렌더링하고 매핑된 회로 노드와 Rust 소스 위치 사이를 양방향으로 탐색할 수 있습니다.
  • 진단 결과를 VS Code Problems에 투영하고 편집기 또는 명령 팔레트에서 노드 연결 이슈를 순회할 수 있습니다.
  • Inspector에 연결해 노드별 히트맵, 생명주기 이벤트, 정체 노드 경고, 중단점 연계 디버깅을 사용할 수 있습니다.
  • 캐시된 스키마 폴백을 갖춘 회로 인지 API Explorer에서 HTTP 요청을 발견·구성·전송·검사·저장·재실행할 수 있습니다.
  • 반복 가능한 API 작업을 위해 스키마 기반 본문, 프리셋, 환경 변수, 컬렉션, 제한된 요청 이력을 관리할 수 있습니다.
  • 비밀정보 마스킹과 충돌 처리를 적용해 요청을 가져오거나 내보내고, 스키마 검사·어설션·JUnit 요약을 포함한 배치를 실행할 수 있습니다.
  • 프로토콜에 맞는 연결, 메시지, 이벤트, 필터, 재연결 화면으로 HTTP, WebSocket, SSE 엔드포인트를 시험할 수 있습니다.
  • Schematic에서 스트리밍 Transition과 데이터 흐름 엣지를 일반 파이프라인 노드와 구분할 수 있습니다.
  • 선별된 Rust 및 복합 워크플로 스니펫을 삽입하고 예제 Schematic을 탐색하며 통합 터미널에서 학습 예제를 실행할 수 있습니다.
  • 명령 팔레트 진입점과 팀 키 바인딩 템플릿을 갖춘 접근 가능한 EN/KO 단일 사이드바에서 Circuit, Toolbox, Feature, API 도구를 사용할 수 있습니다.

현재 제한 사항

  • 실시간 메트릭과 디버그 제어에는 접근 가능하고 인증된 Inspector가 필요하며 오프라인 동작은 캐시 또는 정적 산출물로 제한됩니다. deployment

제품 경계

  • 확장은 Rust 컴파일러나 CLI를 대체하지 않으며 Schematic과 진단 산출물은 프로젝트 도구에서 생성해야 합니다. vscode
  • 확장은 개발자 IDE 보조 도구이며 다중 사용자 프로덕션 모니터링 화면이 아니므로 팀 모니터링에는 Studio Server를 사용해야 합니다. studio-server

검증 명령

회로 뷰 열기 확인 통과
Command Palette > Ranvier: Open Circuit View
진단 오버레이 반영 확인 통과
Command Palette > Ranvier: Refresh Diagnostics
노드 이슈 이동 확인 통과
Command Palette > Ranvier: Go To Next Node Issue / Ranvier: Go To Previous Node Issue
서버 연결 + 히트맵 모드 전환 확인 통과
Connect to Inspector server > Toggle heatmap modes in Circuit View
이벤트 스트림 패널 필터링 확인 통과
Circuit View > Events panel > Filter by node/type/text
정체 노드 시각적 경고 확인 통과
Stall threshold exceeded > Node shows pulsing glow

참고 문서

  • vscode/README.md
  • vscode/README.ko.md
검증 명령이 실패하면 모듈 설정과 필요한 입력 파일을 확인한 뒤 같은 명령을 다시 실행하세요.