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

현재 가능한 작업

• Axon/Transition/Outcome 계약, 명시적 Bus 주입, 무결 파이프라인용 `Never` 에러 타입으로 타입 안전한 의사결정 흐름을 구성할 수 있습니다. 12개 크레이트 전체를 다루는 69개 유지보수 예제 포함. `try_outcome!` 매크로로 `Result<T, E>`를 `Outcome`으로 변환하며 transition 내부 조기 반환을 지원하고, `Outcome::from_result()` / `Outcome::and_then()` / `Outcome::map_fault()` 콤비네이터로 함수형 합성이 가능합니다.
• 프로토콜-애그노스틱 코어 회로를 HTTP 인그레스 어댑터에 연결하고 동적 라우팅, 요청 추출, 라이프사이클 제어, 미들웨어 조합, 경로 단위 정책 override를 구성할 수 있습니다. `QueryParams`가 URI 쿼리 스트링에서 자동으로 Bus에 주입되며 `get_parsed::<T>()`로 타입 안전한 추출을 지원합니다. `RouteGroup`으로 공유 접두사 + Guard를 최대 2단계 중첩 스코핑하고, `post_json_out`으로 body 없는 POST→JSON 엔드포인트를 구성하며, `PageParams`/`Paginated<T>`로 자동 클램핑 내장 페이지네이션을 제공합니다.
• `ranvier-guard` 크레이트(15개 Guard: Cors, AccessLog, SecurityHeaders, IpFilter, RateLimit, Compression, RequestSizeLimit, RequestId, Auth, ContentType, Timeout, Idempotency + advanced feature: Decompression, ConditionalRequest, Redirect)로 파이프라인 우선 미들웨어를 적용할 수 있습니다 — `HttpIngress::guard()` 자동 와이어링, 경로별 `guards![]` 조합, `GuardIntegration` 트레이트로 Bus↔HTTP 브릿징, RateLimitGuard 버킷 TTL 기반 만료 버킷 지연 정리, TrustedProxies XFF 위조 방지(신뢰 프록시 체인 검증). `CorsGuard::permissive()`로 개발 환경에서 한 줄로 CORS를 구성할 수 있습니다.
• `ranvier-openapi`로 요청/응답 계약 기반 OpenAPI 문서와 Swagger UI를 생성할 수 있습니다. `post_typed::<T>()`는 schemars를 통해 요청 바디 JSON Schema를 자동 추출하고, 경로 파라미터(`:id`)를 OpenAPI 파라미터로 자동 문서화합니다.
• 확장된 MIME 지원(18종), ETag 기반 304 Not Modified, 디렉터리 인덱스, immutable cache 감지, 사전 압축 서빙(.br/.gz 우선), Range 요청 지원(206 Partial Content)으로 정적 디렉터리를 서빙하고 SPA fallback을 구성하며, feature-gated `TemplateResponse<T>`로 Askama HTML 템플릿을 렌더링할 수 있습니다.
• WebSocket/SSE 실시간 흐름을 처리하고 연결/세션 컨텍스트를 Bus에 주입할 수 있습니다.
• LLM-as-Transition 패턴으로 AI 분류/모더레이션 파이프라인을 구축하고 콘텐츠 정책을 적용할 수 있습니다.
• `TestApp/TestRequest/TestResponse`로 인-프로세스 HTTP 통합 테스트를 작성하고 `AxonTestKit`/`Timeline`으로 실행 경로를 단언할 수 있습니다.
• `ranvier-inspector`로 TraceStore 영속 저장(VecDeque 링 버퍼 + 설정 가능한 TTL), BearerAuth 인증(릴리스 빌드에서 미인증 Inspector 경고), AlertHook 알림, OTLP 연동을 구성할 수 있습니다.
• session/job/persistence 패턴을 실행하고 PersistenceStore와 compensation hook으로 장애 워크플로를 체크포인트에서 재개할 수 있습니다.
• cargo-semver-checks와 schematic diff/policy CLI 명령으로 API 호환성과 구조 드리프트를 검증할 수 있습니다.
• 내장 Inspector REST + WebSocket 서버로 노드별 메트릭(처리량, 레이턴시 백분위, 에러율) 수집, 페이로드 검사, DLQ 관리, 조건부 중단점, 정체 감지를 제공할 수 있습니다. DebugControl은 parking_lot::Mutex + AtomicBool/AtomicU8로 패닉 안전성을 보장합니다. 저장된 트레이스에서 실행 계보를 추출(`GET /api/v1/lineage/:trace_id`)하고 두 트레이스를 구조적으로 비교(`GET /api/v1/traces/diff?a=&b=`)하여 경로 분기, 결과 차이, 지연 시간 델타를 파악할 수 있습니다.
• `.with_input_schema::<T>()` 빌더 API 또는 `#[transition(schema)]` 매크로 속성으로 회로 노드에 JSON Schema를 등록할 수 있습니다. Inspector가 스키마 포함 라우트 메타데이터 제공(`GET /api/v1/routes`), 실행 중인 회로에 HTTP 요청 릴레이(`POST /api/v1/relay`), 스키마 기반 빈 템플릿/랜덤 샘플 생성(`POST /api/v1/routes/schema`, `POST /api/v1/routes/sample`)을 제공합니다.
• `RanvierConfig`(`ranvier.toml` + 환경변수 오버라이드 + 프로필 시스템)로 프로덕션 인프라를 구성하고 `init_logging()`(JSON/pretty/compact)으로 구조화 로깅을 초기화하며 `rustls` TLS를 선택적으로 활성화할 수 있습니다.
• RFC 7807 `ProblemDetail`/`IntoProblemDetail`로 표준 에러 응답을 반환하고, `Axon::then_with_retry()`(RetryPolicy 고정/지수 백오프)로 실패한 트랜지션을 재시도하며, `Axon::then_with_timeout()`으로 트랜지션 실행 시간을 제한하고, `Axon::catch_unwind()`로 트랜지션 패닉을 `Outcome::Fault`로 복구할 수 있습니다.
• criterion 마이크로벤치마크(Axon 레이턴시, Bus 연산, Transition 체인)와 Axum/Actix-web 비교 서버로 정량 성능 기준을 제공합니다.
• 세 개의 참조 애플리케이션으로 실제 패턴을 보여줍니다: Todo API(CRUD + JWT 인증), Chat Server(다중 방 WebSocket), E-commerce Order Pipeline(4단계 Saga 보상 + 감사 추적 + 다중 테넌시).
• `ranvier migrate --from 0.20 --to 0.25`로 버전 간 import 경로 교체, 크레이트 의존성 전환을 자동화할 수 있습니다. TOML 기반 마이그레이션 규칙(text_replace, rename_import, warn)과 --dry-run 모드를 제공합니다.
• Inspector `/metrics` Prometheus 포맷 메트릭 내보내기, TelemetryConfig으로 OTLP TracerProvider 자동 초기화, AccessLogGuard 경로 마스킹 HTTP 요청 로깅, PostgresAuditSink 해시 체인 감사 이벤트 영속 저장, FileAuditSink 로그 로테이션(BySize/ByDate/ByBoth 정책), OpenAPI SecurityScheme(bearerAuth) + ProblemDetail(RFC 7807) 에러 응답 자동 등록을 수행할 수 있습니다. `MerkleAuditSink`(feature-gated `merkle`)로 이벤트 배치 Merkle 트리를 구축하고, `MerkleProof` 포함 증명 생성/검증, `AnchorService` 트레이트로 외부 루트 앵커링을 지원합니다. `AuditLog<S>` Transition으로 Axon 체인에 감사 로깅을 합성하고(`AuditAction`/`AuditActor` 타입 이벤트, 논블로킹 sink 기록), cookbook/example/app-local helper를 통해 안전 동적 SQL `QueryBuilder` 패턴(`$N` 파라미터 바인딩, 컬럼명 검증, 선택적 필터, LIMIT/OFFSET 페이지네이션)을 적용할 수 있습니다.
• PHILOSOPHY.md('Opinionated Core, Flexible Edges' 원칙)를 통해 프레임워크 설계 철학을 이해하고 DESIGN_PRINCIPLES.md(Paradigm Test, Tower 분리, Opinionated Core 적용을 다루는 ADR 형식)로 아키텍처 결정 근거를 파악할 수 있습니다.
• Transition 기반(Bus 컨텍스트, Schematic 시각화) 또는 Tower 통합(AsyncAuthorizeRequest) 인증을 구현할 수 있으며, auth-comparison 가이드로 7개 항목 비교 표, 벤치마크, 결정 트리, 마이그레이션 경로를 참조할 수 있습니다.
• `Axon::then_fn()` 클로저 기반 Transition으로 인라인 파이프라인 단계를 정의하고, `post_typed::<T>()` / `put_typed::<T>()` / `patch_typed::<T>()`와 `Axon::typed::<In, E>()` 타입 입력 파이프라인으로 타입 안전한 HTTP 바디 주입을 수행할 수 있습니다 — JSON 자동 역직렬화 및 컴파일 타임 타입 보장. `post_json()` / `put_json()` / `patch_json()`으로 `JsonSchema` derive 없이 JSON 바디 역직렬화를 지원하며, `Axon::execute_simple()`로 `Res=()` 파이프라인의 `&()` 인자를 생략할 수 있습니다.
• `TransitionErrorContext`로 파이프라인 장애를 진단할 수 있습니다 — `Outcome::Fault` 시 파이프라인 이름, 트랜지션 라벨, 0-기반 단계 인덱스를 Bus에 자동 주입합니다.
• `ranvier-test` 크레이트로 간결한 파이프라인 테스트를 작성할 수 있습니다: `TestBus` 빌더, `TestAxon` 단일 호출 실행기, `assert_outcome_ok!` / `assert_outcome_err!` 어설션 매크로(선택적 값 검사 클로저 지원).
• `StreamingTransition` 트레이트로 단일 `Outcome` 대신 `Stream<Item>`을 생성하는 스트리밍 파이프라인을 구축할 수 있습니다. `StreamingAxon` 런타임 타입, `Axon::then_stream()` / `then_stream_with_timeout()` 터미널 빌더, `post_sse()` / `post_sse_typed()` SSE HTTP 엔드포인트, 스트림 타임아웃(init/idle/total), `TestAxon::run_stream()` + `assert_stream_items!` 테스트 지원, `#[streaming_transition]` 매크로로 보일러플레이트 없는 정의, `StreamingAxon::map_items()`로 per-item 스트림 변환(PII 필터링, 토큰 카운팅, 포맷 변환).

현재 제한 사항

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

제품 경계

• role/tenant header의 토큰/클레임 검증 매핑은 게이트웨이/배포 인프라 측 통합이 필요합니다. deployment-gateway

현재 가능한 작업

• `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 기반 인터랙티브 프로젝트 생성(16개 템플릿, 도메인별 saga/llm-agent/compliance/webhook-delivery/multi-tenant-api/notification-hub 포함), 의존성 선택기(DB/Auth/Observability), `.ranvier/collections/` 및 `.env.example` 자동 생성을 수행할 수 있습니다.
• `ranvier status build` 및 `ranvier status from-schematic`으로 Schematic JSON에서 자립형 HTML 상태 페이지를 생성할 수 있습니다. v0.21 ranvier-status 크레이트 통합에서 복원됨.
• `ranvier new --template saga/screening/pipeline`로 패턴 중심 프로젝트를 생성할 수 있습니다. 기존 `compliance`→`screening`, `llm-agent`→`pipeline` rename + deprecated alias 지원.

현재 제한 사항

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

제품 경계

명시된 제품 경계 항목이 없습니다.

현재 가능한 작업

• Bevy 0.18 3D 렌더러로 Schematic 노드/엣지 그래프를 레이어(Guard/Transition/Compensation) 분리된 3D 공간에 렌더링할 수 있습니다.
• Orbit/Fly/TopDown 카메라 모드(1/2/3/T/R 키)와 Ctrl+F 검색 → Focus 연동으로 대규모 DAG 그래프를 탐색할 수 있습니다.
• WebSocket 실시간 이벤트 스트림으로 노드 상태(Running/Completed/Faulted/Stalled/Paused)를 즉각 반영하고 throughput 기반 동적 스케일링을 표시할 수 있습니다.
• 엣지 데이터 플로우 애니메이션(success=green, error=red, slow=yellow pulse)과 방향 화살표로 트랜지션 실행 흐름을 시각화할 수 있습니다.
• Payload Viewer(F 키) 패널에서 CapturedEvent의 JSON payload를 트리 뷰로 실시간 검사할 수 있습니다.
• Breakpoint CRUD 패널(B 키)과 우클릭 컨텍스트 메뉴로 중단점을 설정하고, Debug 컨트롤 바(Resume/Step/Pause)로 실행 흐름을 제어할 수 있습니다.
• Bus Inspector, Circuit Explorer, Routes, DLQ, Relay Proxy, Trace Timeline(줌/스크롤) 패널로 서비스 내부 상태를 검사할 수 있습니다.
• Settings 패널(S 키)에서 Inspector URL/토큰/갱신 간격을 설정하고 ~/.ranvier-studio.toml에 영속 저장할 수 있습니다.

현재 제한 사항

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

제품 경계

• Studio는 inline source navigation의 1차 IDE 도구가 아니며 이 범위는 VSCode 확장에 있습니다. studio
• 모바일/웹 브라우저에서 실행할 수 없습니다 — 데스크톱 네이티브 전용입니다. studio

현재 가능한 작업

• Ranvier 프레임워크(bus_injector, Guards, Axon)로 구축되어 프로덕션 적합성을 자체 인프라로 실증합니다.
• Inspector API 28개 엔드포인트를 Generic Relay Transition 패턴으로 프록시합니다.
• SvelteKit 5 + @xyflow/svelte 정적 빌드 대시보드(8페이지)를 serve_dir()로 서빙합니다.
• 대시보드 홈에서 서비스 상태(operational/degraded/down), 노드/회로/라우트 요약, DLQ 경고를 표시합니다.
• KPI 요약 카드(총 throughput, 평균 latency, 에러율, 노드/회로 수)와 노드별 메트릭을 자동 갱신(2/5/10/30초)으로 모니터링합니다.
• SvelteFlow 인터랙티브 Schematic으로 DAG 그래프를 시각화하고 노드 선택, 상세 패널, 중단점 토글 기능을 제공합니다.
• 이벤트 페이지에서 타입/텍스트 필터, 실시간 폴링(2초), 새 이벤트 하이라이트 애니메이션을 지원합니다.
• 트레이스 페이지에서 느린 요청 감지(>200ms), Gantt 차트 범례, 자동 갱신을 제공합니다.
• DLQ 뷰어에서 JSON 페이로드 확장/축소, Retry, Discard 액션을 지원합니다.
• Docker 배포(multi-stage Dockerfile + docker-compose)를 지원합니다.

현재 제한 사항

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

제품 경계

• 3D GPU 가속 시각화는 제공하지 않습니다 — 이 기능은 Studio(Bevy) 데스크톱 앱에 있습니다. studio
• WebSocket 실시간 스트리밍은 제공하지 않습니다 — HTTP 폴링 기반 갱신입니다. studio

현재 가능한 작업

• `schematic.json` 기반 회로 그래프를 렌더링하고 `Ranvier Circuit Nodes` 패널과 동기화할 수 있습니다.
• 매핑 정보가 있을 때 선택한 회로 노드에서 소스 위치로 점프할 수 있습니다.
• 현재 편집 파일/라인 문맥에서 매핑된 회로 노드를 하이라이트할 수 있습니다.
• `diagnostics.json` 결과를 웹뷰/사이드바/VSCode Problems에 투영할 수 있습니다.
• 명령 팔레트에서 현재 줄 기준 매핑된 회로 노드를 바로 찾을 수 있습니다.
• 명령과 기본 단축키로 다음/이전 노드 이슈를 이동할 수 있습니다.
• 팀 도입을 위해 EN/KO 로캘 UX와 단축키 오버라이드 템플릿을 제공합니다.
• Inspector 서버에 자동 연결하고 실시간 히트맵(트래픽/레이턴시/에러/없음)으로 노드 메트릭을 시각화할 수 있습니다.
• 이벤트 스트림 패널에서 노드/타입/텍스트 필터로 Inspector 생애주기 이벤트를 실시간 모니터링할 수 있습니다.
• 임계값을 초과한 정체 노드를 pulsing glow 애니메이션으로 시각적 경고 표시할 수 있습니다.
• 6종 Rust 코드 스니펫(rvtransition, rvroute, rvaxon, rvbus, rvtest)을 삽입하여 빠른 Ranvier 개발을 지원합니다.
• catalog.json의 예제를 통합 터미널에서 탐색 및 실행할 수 있습니다 (`ranvier.runExample` 명령어).
• Circuit-Aware API Explorer 사이드바에서 API 엔드포인트를 테스트할 수 있습니다 — Inspector에서 라우트 자동 발견, 헤더/파라미터/본문/인증 탭으로 요청 구성, 상태/시간/회로 트레이스와 함께 응답 표시, 캐시된 스키마로 오프라인 사용 가능.
• `.ranvier/collections/`에서 요청 컬렉션을 관리할 수 있습니다 — 저장, 복제, 이름변경, 삭제, 필터, 정렬, 그룹 기능. 실행 이력 자동 저장 및 보관 정책 설정 가능.
• JSON Schema 기반 빈 본문 템플릿 및 faker 자동 채움 데이터를 생성할 수 있습니다 (Inspector 서버 우선, 클라이언트 측 폴백). 요청별 프리셋 저장, `.ranvier/environments/` 파일의 `{{변수}}` 보간 지원.
• 컬렉션을 `.ranvier-bundle.json` 또는 단일 요청을 `.ranvier-request.json`으로 내보낼 수 있습니다 — 민감 패턴 자동 감지 비밀 수정 포함. 충돌 감지 및 해결 다이얼로그와 함께 가져오기 지원.
• 일괄 요청 실행(순차 진행 추적), 어설션 평가(10개 연산자, JSON 경로 대상), JSON Schema 기반 본문 검증, JUnit 호환 결과 요약을 제공합니다. 키보드 코드 단축키(Ctrl+R 접두사)로 전송, 템플릿, faker 작업 지원.
• WebSocket 엔드포인트를 양방향 메시지 로그, 연결/해제 라이프사이클, 자동 재연결, 서브프로토콜 헤더, 메시지 필터링(text/JSON, 키워드 검색)으로 테스트할 수 있습니다.
• SSE 엔드포인트를 이벤트 스트림 로그(type, data, id, retry), 이벤트 타입 필터, Last-Event-ID 재연결, 세션 히스토리로 테스트할 수 있습니다.
• Schematic 뷰어에서 스트리밍 파이프라인 노드를 점선 보라색 테두리, 스트림 아이콘, 애니메이션 엣지로 시각적으로 구분하여 `StreamingTransition`과 일반 `Transition` 노드를 식별할 수 있습니다.
• Svelte 5 기반의 통합된 탭 방식 사이드바로 확장 내 각종 보조 도구(Circuit, Toolbox, Features, API)를 단일 뷰에서 쉽고 빠르게 전환 사용할 수 있습니다.
• API Explorer, Toolbox, Feature Hub 패널 등에서 Vite/Svelte 5 렌더링 초기화 시 발생할 수 있는 잠재적 런타임/CSP 충돌을 방지하고 안정적인 렌더링을 보장합니다.
• Toolbox의 'Complex Workflows' 카테고리에서 Saga 보상, 캐스케이드 스크리닝, 타입 파이프라인, Branch 라우팅 스니펫 4개와 패턴 기반 학습 경로를 제공합니다.

현재 제한 사항

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

제품 경계

명시된 제품 경계 항목이 없습니다.