Submodule capabilities at a glance.

Can do now

• Define typed decision flows with Axon/Transition/Outcome contracts, explicit Bus wiring, and `Never` error type for infallible pipelines. 61 maintained examples covering all 10 crates.
• Run protocol-agnostic core circuits through HTTP ingress adapters with dynamic routing, request extractors, lifecycle controls, middleware composition, and per-path policy overrides.
• Apply HTTP security/policy stacks with `ranvier-std` Guard nodes (CorsGuard, RateLimit, SecurityHeaders, IpFilter) — visible in Schematic and Inspector Timeline.
• Generate OpenAPI docs and Swagger UI from request/response contracts via `ranvier-openapi`.
• Serve static directories and SPA fallback with cache/compression options for fullstack-style delivery.
• Handle WebSocket/SSE real-time flows and inject connection/session context into Bus.
• Build LLM-as-Transition pipelines for AI classification, content moderation, and policy enforcement.
• Write in-process HTTP integration tests with `TestApp/TestRequest/TestResponse` and runtime path assertions with `AxonTestKit`/`Timeline`.
• Store and query traces with `ranvier-inspector` TraceStore, secure endpoints with BearerAuth, and route alerts via AlertHook/AlertDispatcher.
• Run session/job/persistence patterns and resume faulted workflows from checkpoints with PersistenceStore and compensation hooks.
• Validate API compatibility and detect structural drift with cargo-semver-checks and schematic diff/policy CLI commands.
• Monitor per-node metrics (throughput, latency percentiles, error rate), inspect in-transit payloads, manage dead letters, set conditional breakpoints, and detect stalled nodes through the built-in Inspector REST + WebSocket server.
• Register JSON Schema on circuit nodes via `.with_input_schema::<T>()` builder API or `#[transition(schema)]` macro attribute. Inspector serves schema-enriched route metadata (`GET /api/v1/routes`), relays HTTP requests into running circuits (`POST /api/v1/relay`), and generates empty templates or random sample payloads from schema (`POST /api/v1/routes/schema`, `POST /api/v1/routes/sample`).
• Configure production infrastructure with `RanvierConfig` (`ranvier.toml` + env overrides + profile system), structured logging (`init_logging()` with JSON/pretty/compact), and optional TLS via `rustls`.
• Return RFC 7807 Problem Details error responses with `ProblemDetail`/`IntoProblemDetail`, and retry faulted transitions with `RetryPolicy` (fixed/exponential backoff) via `Axon::then_with_retry()`.
• Provide quantitative performance baselines with criterion micro-benchmarks (Axon latency, Bus operations, Transition chains) and Axum/Actix-web comparison servers.
• Demonstrate real-world patterns through three reference applications: Todo API (CRUD + JWT auth), Chat Server (multi-room WebSocket), and E-commerce Order Pipeline (4-stage Saga compensation + audit trail + multi-tenancy).
• Automate version migration with `ranvier migrate --from 0.20 --to 0.25` for import path replacement, crate dependency swaps. TOML-based migration rules (text_replace, rename_import, warn) with --dry-run mode.
• Export Prometheus exposition metrics from Inspector `/metrics` endpoint, auto-initialize OTLP TracerProvider via TelemetryConfig, log HTTP requests with AccessLogGuard path redaction, persist audit events to PostgreSQL with PostgresAuditSink hash-chain integrity, and auto-register OpenAPI SecurityScheme (bearerAuth) with ProblemDetail (RFC 7807) error responses.
• Understand framework design philosophy through PHILOSOPHY.md ('Opinionated Core, Flexible Edges' principle) and architecture decision rationale via DESIGN_PRINCIPLES.md (ADR format covering Paradigm Test, Tower Separation, and Opinionated Core enforcement).
• Implement authentication using two approaches: Transition-based (examples/auth-transition — Bus context propagation, Schematic visualization, easier testing) or Tower integration (examples/auth-tower-integration — AsyncAuthorizeRequest trait for ecosystem compatibility).
• Compare authentication strategies with docs/guides/auth-comparison.md: 7-feature comparison table, performance benchmarks (~1-2μs overhead both), when-to-use decision tree, and migration paths between Transition and Tower approaches.

Current limitations

No active limitation items.

Product boundaries

• Token/claim-to-role mapping for inspector auth headers is not built into core runtime and depends on deployment gateway policy. deployment-gateway

Can do now

• Inspect command surface and usage quickly with `ranvier --help`.
• Export schematic artifacts from workspace examples.
• Compare schematic changes across git refs with `ranvier schematic diff`.
• Run structural policy checks from TOML rules and fail with non-zero exit on violations.
• Validate schematic schema-version compatibility before processing input artifacts.
• Generate trace projection artifacts from schematic/timeline/example inputs.
• Scaffold new projects from macro-first templates via `ranvier new`.
• Run version migration workflows via `ranvier migrate` with dry-run/verbose/JSON modes.
• Browse and fetch example schematics from remote or local catalogs via `ranvier catalog list/fetch/verify`.
• Execute API test collections headlessly via `ranvier test` — sequential HTTP execution with assertion evaluation (10 operators), capture chaining, environment interpolation, glob support, and output in text/JSON/JUnit XML formats for CI integration.
• Scaffold new projects interactively via `ranvier new` with dialoguer-based template selection (10 templates), dependency chooser (DB/Auth/Observability), auto-generated `.ranvier/collections/` and `.env.example`.
• Generate self-contained HTML status pages from Schematic JSON via `ranvier status build` and `ranvier status from-schematic`. Restored from ranvier-status crate consolidation in v0.21.

Current limitations

No active limitation items.

Product boundaries

No explicit boundary items.

Can do now

• Load and render schematic node/edge graphs in the Studio viewer.
• Attach to remote inspector endpoints and load `/schematic` with trace overlays.
• Send optional Bearer auth plus role/tenant headers for remote attach requests.
• Filter and group failure history for faster incident triage.
• Export filtered failure reports as JSON with redact/profile presets.
• Include checksum/signature metadata on exports for integrity checks.

Current limitations

No active limitation items.

Product boundaries

• Studio is not the primary IDE surface for inline source navigation (VSCode extension scope). studio
• Final role/tenant enforcement still depends on upstream server or gateway policy. deployment-gateway

Can do now

• Render circuit graphs from `schematic.json` and sync them with the `Ranvier Circuit Nodes` panel.
• Jump to source locations from selected circuit nodes when mappings are available.
• Highlight mapped circuit nodes from the active editor file/line context.
• Project `diagnostics.json` results into webview, sidebar, and VSCode Problems.
• Reveal the mapped circuit node from the current editor line via command palette.
• Navigate next/previous node-linked issues with commands and default shortcuts.
• Provide localized EN/KO UX and keybinding override templates for team adoption.
• Auto-connect to Inspector servers and visualize per-node metrics with real-time heatmap overlays (traffic/latency/errors/none).
• Monitor Inspector lifecycle events in the event stream panel with node/type/text filters.
• Visually alert on stalled nodes exceeding thresholds with pulsing glow animations.
• Insert 6 Rust code snippets (rvtransition, rvroute, rvaxon, rvbus, rvtest) for rapid Ranvier development.
• Browse and run any example from catalog.json via the integrated terminal (`ranvier.runExample` command).
• Test API endpoints through the Circuit-Aware API Explorer sidebar — auto-discover routes from Inspector, compose requests with headers/params/body/auth tabs, view response with status/duration/circuit trace, and navigate offline with cached schemas.
• Manage request collections in `.ranvier/collections/` with save, duplicate, rename, delete, filter, sort, and group-by operations. Auto-save execution history with configurable retention policy.
• Generate empty body templates and faker-filled sample data from JSON Schema (server-first via Inspector, client-side fallback). Save named presets per request and interpolate `{{variable}}` from `.ranvier/environments/` files.
• Export collections to `.ranvier-bundle.json` or single requests to `.ranvier-request.json` with secret redaction (auto-detect sensitive patterns). Import with conflict detection and resolution dialog.
• Execute batch requests with sequential progress tracking, assertion evaluation (10 operators, JSON path targets), body validation against JSON Schema, and JUnit-compatible result summary. Keyboard chord shortcuts (Ctrl+R prefix) for send, template, and faker actions.
• Test WebSocket endpoints with bidirectional message log, connect/disconnect lifecycle, auto-reconnect, subprotocol headers, and message filtering (text/JSON, keyword search).
• Test SSE endpoints with event stream log (type, data, id, retry), event-type filtering, Last-Event-ID reconnection support, and session history.
• Consolidate auxiliary extension tools (Circuit, Toolbox, Features, API) into a unified, tabbed sidebar view powered by Svelte 5 for fast and seamless context switching.
• Ensure stable rendering and avoid runtime/CSP conflicts during Vite/Svelte 5 initialization across API Explorer, Toolbox, and Feature Hub panels.

Current limitations

No active limitation items.

Product boundaries

No explicit boundary items.