Documentation

Runtime Governance and Execution Control Plane for AI Systems

Everything you need to understand, evaluate, and implement the RIO Protocol. All documentation is open source and available on GitHub.

Whitepapers

RIO Protocol Whitepaper v2

By Brian K. Rasmussen

Complete technical whitepaper covering the governed execution model, protocol design, threat model, and enterprise applications.

RIO Protocol Whitepaper v1

By Brian K. Rasmussen

Original whitepaper establishing the foundational concepts of runtime intelligence orchestration.

v1 vs v2 Receipt Comparison

The v2 receipt system introduces cryptographic hashing, post-execution verification, risk scoring, and hash-chain ledger entries. Below is a side-by-side comparison of what changed between v1 and v2.

Field / Featurev1 Receiptv2 Receipt
Protocol VersionNot specifiedprotocol_version: "v2"
Receipt IDreceipt_id (UUID)receipt_id (UUID) — unchanged
Intent HashNot presentintent_hash (SHA-256 of intent payload)
Action HashNot presentaction_hash (SHA-256 of action + params)
Verification HashNot presentverification_hash (SHA-256 of verification result)
Verification StatusNot presentverification_status: verified | failed | skipped
Risk ScoreNot presentrisk_score (0–100 numeric)
Risk CategoryNot presentrisk_category: LOW | MEDIUM | HIGH
Timestampsrequested_at, decided_at, executed_atSame fields — ISO 8601 format enforced
Signaturehash (SHA-256 of payload)signature (RSA-PSS 2048-bit, base64)
Hash Fieldhash (receipt integrity)receipt_hash (SHA-256 of canonical payload)
Ledger Entryblock_index, current_hash, previous_hashSame + previous_ledger_hash for chain verification
Denial ReceiptsBasic denial recordFull v2 denial receipt with signature + ledger entry
Tamper DetectionHash comparison onlyRSA-PSS signature + hash chain + independent verification
Test Coverage47 tests across 12 suites57 tests across 14 suites (10 new v2 tests)

Upgrade path: v2 is backward-compatible. During transition, the pipeline generates both v1 and v2 receipts. Existing integrations continue to work with v1 fields while new consumers can use the enhanced v2 fields for stronger verification.

System Documentation

Comprehensive documentation covering every aspect of the RIO system, from high-level overview to implementation details.

Protocol Specifications

15 formal protocol specifications defining the behavior of every pipeline stage. Implementation-independent — any language or platform can implement RIO by satisfying these specs.

Security & Verification

Tools and documentation for independently verifying the integrity of the system, its ledger, and its receipts.

Source Code & Examples

The full implementation, example integrations, and demo scripts.