README / README.md
petter2025's picture
Update README.md
4089d58 verified
---
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)