Ranvier
KR Browse Docs

#Ranvier Manual โ€” Core Runtime and Boundary Guide

Version: 0.33.0 Updated: 2026-03-15 Applies to: ranvier (facade), ranvier-core, ranvier-runtime Category: Product Manuals

Use this page when you need explicit rules for Axon, Outcome, and adapter boundaries.

#Layer Model

  • Core: Protocol-agnostic contracts (Transition, Outcome, Bus, Schematic).
  • Runtime: Axon executes typed decision flow.
  • Adapter: Ingress/egress maps protocols to state and back.

#Core Types

Type Description
Transition Async state transform contract
Outcome Next, Branch, Jump, Emit, Fault
Bus Typed resource container with explicit reads

#Structural Guarantees

  • Ingress parses requests into typed input state.
  • Schematic is static and non-executable.
  • Run diff/validate/visualize before runtime.
  • LLM suggestions require explicit human review.

#Quickstart

cargo check --workspace
cargo run -p typed-state-tree
cargo run -p basic-schematic

#Workflows

  1. Define explicit transition flow with Axon and Outcome.
  2. Keep core protocol-agnostic; connect HTTP at adapter boundaries.
  3. Export Schematic and validate structure before rollout.
  • CLI Manual โ€” Commands and artifact flows
  • VSCode Manual โ€” Circuit view and diagnostics