Update README.md

README.md

@@ -1,13 +1,3 @@
----
-title: README
-emoji: 📊
-colorFrom: indigo
-colorTo: red
-sdk: gradio
-pinned: false
-sdk_version: 6.9.0
----
-
 ---
 title: Agentic Reliability Framework
 emoji: 🤖
@@ -21,30 +11,64 @@ short_description: Bayesian governance for agentic systems
 
 # Agentic Reliability Framework (ARF)
 
-**Open‑source advisory engine for cloud infrastructure governance.**
+[![GitHub](https://img.shields.io/badge/github-arf--foundation-blue?logo=github)](https://github.com/arf-foundation/agentic-reliability-framework)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
+[![Python Versions](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/agentic-reliability-framework/)
+[![Hugging Face Spaces](https://img.shields.io/badge/🤗-spaces-orange)](https://huggingface.co/A-R-F)
 
+**Open‑source advisory engine for cloud infrastructure governance.**  
 ARF provides **provably safe, mathematically grounded recommendations**—approve, deny, or escalate—when users request provisioning, configuration, or access changes.
 
-## 🔍 What we do
+---
+
+## 🔍 What We Do
 
-- **Bayesian online learning** with conjugate priors
-- **Offline pattern discovery** via Hamiltonian Monte Carlo (HMC)
-- **Composable policy algebra** for fine‑grained rules
-- **Semantic memory** (FAISS) for context‑aware decisions
+- **Bayesian Online Learning** – Fast, conjugate updates for per‑category risk using beta‑binomial models.
+- **Offline Pattern Discovery** – Hamiltonian Monte Carlo (HMC/NUTS) logistic regression captures complex interactions (time‑of‑day, user role, environment).
+- **Composable Policy Algebra** – Build fine‑grained rules with AND/OR/NOT combinators.
+- **Semantic Memory** – FAISS‑based retrieval of similar past incidents for context‑aware decisions.
+- **Deterministic Probability Thresholds (DPT)** – Clear approve/deny/escalate decisions based on calibrated failure probabilities.
 
-## 🚀 Key Links
+---
+
+## 📊 Key Mathematical Insights
+
+| Concept | Implementation |
+|--------|----------------|
+| **Conjugate Priors** | Per‑category Beta priors, updated online with outcomes. |
+| **HMC Sampling** | Logistic regression with NUTS, serialized to JSON for hot‑loading. |
+| **Risk Fusion** | Dynamic weighted combination of conjugate, hyperprior, and HMC estimates. |
+| **DPT** | `Approve` if P(failure) < 0.2; `Deny` if > 0.8; otherwise `Escalate`. |
+
+---
 
-- [GitHub Repository](https://github.com/arf-foundation/agentic-reliability-framework)
-- [ARF v4 Demo Space](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-v4)
-- [Legacy API Demo](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-API)
+## 🚀 Quick Links
 
-## 📊 Deterministic Probability Thresholds (DPT)
+- 📦 **[GitHub Repository](https://github.com/arf-foundation/agentic-reliability-framework)** – Source code, issues, contributions.
+- 🤗 **[ARF v4 Demo Space](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-v4)** – Interactive Bayesian risk dashboard.
+- 🔧 **[Legacy API Demo](https://huggingface.co/spaces/A-R-F/Agentic-Reliability-Framework-API)** – v3.3.9 API for backward compatibility.
+- 📚 **[Documentation](https://docs.agentic-reliability-framework.io)** (coming soon) – Full specs, tutorials, and API reference.
 
-Instead of fuzzy logic, ARF uses transparent thresholds:
-- **Approve** if P(failure) < 0.2
-- **Deny** if P(failure) > 0.8
-- **Escalate** otherwise
+---
+
+## 🧪 Try It Now
+
+Click the Spaces below to interact with live demos. The v4 Space showcases the full Bayesian engine with real‑time risk scoring and policy evaluation.
+
+---
+
+## 🤝 Contributing
+
+ARF is open source under the Apache 2.0 license. We welcome contributions of all kinds—code, documentation, ideas, or feedback.
+
+- [Contribution Guidelines](https://github.com/arf-foundation/agentic-reliability-framework/blob/main/CONTRIBUTING.md)
+- [Open an Issue](https://github.com/arf-foundation/agentic-reliability-framework/issues)
+- [Start a Discussion](https://github.com/arf-foundation/agentic-reliability-framework/discussions)
+
+---
 
-## 🤝 Contribute
+## 📫 Contact
 
-ARF is open source (Apache 2.0). Contributions welcome!
+- Email: [petter2025us@outlook.com](mailto:petter2025us@outlook.com)
+- LinkedIn: [petterjuan](https://linkedin.com/in/petterjuan)
+- Book a call: [Calendly](https://calendly.com/petter2025us/30min)