#json-schema #engine #typed #transition #schematic #axon #protocol-agnostic #foundation-framework

ranvier-core

Protocol-agnostic core for Ranvier - Typed Decision Engine

5 unstable releases

Uses new Rust 2024

new 0.7.0 Feb 22, 2026
0.2.0 Feb 22, 2026
0.1.2 Feb 7, 2026
0.1.1 Feb 7, 2026
0.1.0 Feb 5, 2026

#1128 in Debugging


Used in 10 crates

MIT/Apache

52KB
1K SLoC

Ranvier Core (ranvier-core)

The Kernel: Pure logic engine for the Ranvier Framework.

🎯 Purpose

ranvier-core is the foundation of the entire framework. It defines the abstract concepts required to build a "Circuit-First" decision engine. It is designed to be:

  • Protocol Agnostic: Does not depend on Hyper, HTTP, or any specific transport.
  • Circuit-Based: Everything is an Axon or a Transition.
  • Introspectable: Capable of generating a self-describing "Schematic" (JSON Schema) of the business logic.

🔑 Key Components

  • Axon Trait: The circuit interface. Defines how a component takes an Input and returns an Outcome.
  • Transition Trait: The atomic unit of logic that drives state changes.
  • Outcome Enum: The result of an execution (Next, Branch, Fault, End).
  • Bus: A type-map container for passing state and context through a circuit.

🚀 Development Direction

  • Strict Separation: Keep this crate free of transport-layer dependencies.
  • Type Safety: Leverage Rust's type system to ensure valid state transitions.
  • Telemetry: Built-in tracing for visual debugging in Ranvier Studio.

Dependencies

~9–13MB
~147K SLoC