README.md

---
title: Agentic Reliability Framework (ARF) – Technical Overview
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: static
pinned: false
license: apache-2.0
---

# Agentic Reliability Framework (ARF) – Technical Overview

> 🔒 **The core ARF engine is access‑controlled and not open source.**  
> Available to qualified pilots under outcome‑based pricing.  
> The **public specification** and **demo UI** are Apache 2.0.

---

## 🧠 Core Engine (Protected)

### Bayesian Risk Fusion

Conjugate Beta priors (online) + HMC logistic regression (offline) + optional hierarchical hyperpriors.

$$
\text{risk} = w_{\text{conj}}\cdot\frac{\alpha}{\alpha+\beta} \;+\; w_{\text{hmc}}\cdot p_{\text{hmc}} \;+\; w_{\text{hyper}}\cdot \mu_{\text{hyper}}
$$

Weights are dynamic:

$$
w_{\text{hmc}} = \min\left(0.6,\; \frac{n}{n_0}\right), \qquad
w_{\text{hyper}} = \min\left(0.3,\; \text{base}\cdot(1-w_{\text{hmc}})\right)
$$

Posterior variance → 90% HDI for uncertainty quantification.

### Expected Loss Minimisation

Chooses `APPROVE`, `DENY`, or `ESCALATE` by minimising:

$$
\begin{aligned}
L_{\text{approve}} &= \text{COST\_FP}\cdot R + \text{COST\_IMPACT}\cdot b_{\text{mean}} + \dots \\
L_{\text{deny}} &= \text{COST\_FN}\cdot(1-R) + \text{COST\_OPP}\cdot v_{\text{mean}} \\
L_{\text{escalate}} &= \text{COST\_REVIEW} + \text{COST\_UNCERTAINTY}\cdot\psi
\end{aligned}
$$

### Execution Ladder (Rust)

Mechanical gates: `license`, `confidence`, `risk`, `rollback`, `causal`.

### Lyapunov Stability

Quadratic candidate $V(x,r) = \alpha r^2 + \beta\|x - x_{\text{des}}\|^2$ ensures healing actions converge.

### Cryptographic Signing

Ed25519 signatures for `HealingIntent` (Python `cryptography`, Rust `ed25519_dalek`).

---

## 📄 Public Specification (Open Source)

- [Data models & API contracts](https://github.com/arf-foundation/arf-spec) – `InfrastructureIntent`, `HealingIntent`, `RiskScore`, `GovernanceLoop`
- [Mathematics](https://arf-foundation.github.io/arf-spec/mathematics/) – Full Bayesian derivations, Lyapunov proof sketch
- [Governance loop](https://arf-foundation.github.io/arf-spec/governance/) – Step‑by‑step flow with constants (`COST_FP`, `COST_FN`, `EPISTEMIC_ESCALATION_THRESHOLD`)

---

## 🧪 Live Demos (Mock Data Only)

- [Interactive Risk Demo](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-v4) – Adjust priors, see HMC simulation, semantic memory retrieval.
- [Sandbox API](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-API/docs) – Mock FastAPI endpoint (returns simulated responses, no real Bayesian engine). *Interactive docs available at `/docs`*.

---

## 🔗 Public Repos

| Repo | Description |
|------|-------------|
| [`arf-spec`](https://github.com/arf-foundation/arf-spec) | Canonical specification (Apache 2.0) |
| [`arf-frontend`](https://github.com/arf-foundation/arf-frontend) | Demo UI (Next.js, Tailwind) |
| [`pitch-deck`](https://github.com/arf-foundation/pitch-deck) | Public overview |

Private repos (`agentic_reliability_framework`, `arf-api`, `enterprise`) are **pilot/enterprise only**.

---

## ✈️ Pilot Access

Request access via email: **petter2025us@outlook.com** (include use case, volume, cloud environment).  
Outcome‑based pricing – pay for risk reduction, not API calls.

- [Live spec site](https://arf-foundation.github.io/arf-spec/)
- [Demo dashboard](https://arf-frontend-sandy.vercel.app)