Metadata-Version: 2.4
Name: rafael-framework
Version: 1.1.1
Summary: Resilience-Adaptive Framework for Autonomous Evolution & Learning
Home-page: https://github.com/Rafael2022-prog/rafael
Author: RAFAEL Team
Author-email: RAFAEL Team <info@rafaelabs.xyz>
Maintainer: RAFAEL Framework
Maintainer-email: RAFAEL Framework <info@rafaelabs.xyz>
License: Proprietary
Project-URL: Homepage, https://github.com/Rafael2022-prog/rafael
Project-URL: Documentation, https://github.com/Rafael2022-prog/rafael/tree/main/docs
Project-URL: Repository, https://github.com/Rafael2022-prog/rafael
Project-URL: Bug Tracker, https://github.com/Rafael2022-prog/rafael/issues
Keywords: resilience,chaos-engineering,antifragile,adaptive-systems,evolution,machine-learning,devops,reliability
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Distributed Computing
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.20.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Provides-Extra: web
Requires-Dist: fastapi>=0.95.0; extra == "web"
Requires-Dist: uvicorn>=0.20.0; extra == "web"
Provides-Extra: all
Requires-Dist: rafael-framework[dev,web]; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: maintainer
Dynamic: requires-python

# 🔱 RAFAEL: Resilience-Adaptive Framework for Autonomous Evolution & Learning

[![Live Demo](https://img.shields.io/badge/Live-Demo-purple?style=for-the-badge&logo=rocket)](https://demo.rafaelabs.xyz)
[![Dashboard](https://img.shields.io/badge/Dashboard-Live-blue?style=for-the-badge&logo=chart-line)](https://dashboard.rafaelabs.xyz)
[![API Docs](https://img.shields.io/badge/API-Docs-green?style=for-the-badge&logo=book)](https://api.rafaelabs.xyz)
[![Website](https://img.shields.io/badge/Website-rafaelabs.xyz-orange?style=for-the-badge&logo=globe)](https://rafaelabs.xyz)

> **"Sistem yang tidak mati oleh kekacauan, akan lahir kembali lebih cerdas darinya."**

## 🌐 Live Resources

- **🏠 Main Site**: [rafaelabs.xyz](https://rafaelabs.xyz) - Bilingual landing page (EN/ID)
- **📊 Dashboard**: [dashboard.rafaelabs.xyz](https://dashboard.rafaelabs.xyz) - Real-time monitoring
- **🔌 API Docs**: [api.rafaelabs.xyz](https://api.rafaelabs.xyz) - Interactive API documentation
- **🎮 Demo**: [demo.rafaelabs.xyz](https://demo.rafaelabs.xyz) - Try chaos testing live
- **🚀 Beta Program**: [beta.rafaelabs.xyz](https://beta.rafaelabs.xyz) - Join early adopters
- **💻 GitHub**: [github.com/Rafael2022-prog/rafael](https://github.com/Rafael2022-prog/rafael)

## 🧩 Filosofi Inti

RAFAEL tidak hanya menangani error — ia menganggap error, serangan, dan kegagalan sebagai **bahan baku evolusi**.

Setiap insiden menjadi pemicu pembelajaran, bukan sekadar log di dashboard.

**Ini bukan sekadar monitoring atau chaos engineering. Ini sistem imun digital generatif.**

## 🏗️ Arsitektur

```
┌─────────────────────────────────────────────────────────────┐
│                    RAFAEL CORE ENGINE                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Adaptive     │  │  Mutation    │  │   Fitness    │      │
│  │ Resilience   │→ │ Orchestrator │→ │  Evaluator   │      │
│  │ Genome (ARG) │  │              │  │              │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
           ↓                    ↓                    ↓
┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
│   CHAOS FORGE    │  │ RESILIENCE VAULT │  │  GUARDIAN LAYER  │
│ Attack Simulator │  │  Pattern Store   │  │  Ethics Control  │
└──────────────────┘  └──────────────────┘  └──────────────────┘
           ↓                    ↓                    ↓
┌─────────────────────────────────────────────────────────────┐
│                      RAFAEL DEVKIT                           │
│         CLI • SDK • Annotations • Dashboard                  │
└─────────────────────────────────────────────────────────────┘
```

## 🚀 Quick Start

### Installation

```bash
# Python
pip install rafael-framework

# Node.js
npm install @rafael/core

# Flutter
flutter pub add rafael
```

### Basic Usage

```python
from rafael import AntiFragile, RafaelCore

# Initialize RAFAEL
rafael = RafaelCore(
    app_name="my-fintech-app",
    resilience_level="adaptive"
)

# Decorate critical functions
@AntiFragile(
    retry_policy="adaptive",
    fallback="genomic",
    isolation_level="high"
)
async def process_payment(transaction):
    # Your critical code here
    return await payment_gateway.process(transaction)

# Start autonomous evolution
rafael.start_evolution()
```

## 📦 Komponen

### 1. Rafael Core Engine
- **Adaptive Resilience Genome (ARG)**: DNA ketahanan untuk setiap modul
- **Mutation Orchestrator**: Menguji kombinasi strategi baru di sandbox
- **Fitness Evaluator**: Menilai dan mengadopsi mutasi yang lebih tangguh

### 2. Chaos Forge
- Simulator serangan adaptif berbasis threat intelligence
- Auto-run mingguan atau trigger berbasis confidence score
- Output: Resilience Delta Report

### 3. Resilience Vault
- Repository pola ketahanan terbukti
- Import/export strategi mitigasi
- Community-verified patterns

### 4. RAFAEL DevKit
- CLI tools untuk testing dan deployment
- SDK untuk Flutter, Python, Node.js
- Local dashboard untuk monitoring evolusi

### 5. Guardian Layer
- Approval workflow untuk mutasi signifikan
- Immutable resilience log
- Compliance integration (ISO 27001, SOC 2)

## 🎯 Use Cases

### Fintech Application
```python
@AntiFragile(threat_model="financial_fraud")
async def detect_fraud(transaction):
    # RAFAEL automatically activates:
    # - Two-factor verification on suspicious patterns
    # - IP blocking for known attack vectors
    # - Pattern immunization for future threats
    pass
```

### Mobile Game
```python
@AntiFragile(load_strategy="adaptive_degradation")
async def handle_game_session(player_id):
    # RAFAEL automatically:
    # - Reduces graphics quality on server overload
    # - Shifts logic to client-side when needed
    # - Learns optimal degradation strategies
    pass
```

### dApp
```python
@AntiFragile(blockchain_fallback="layer2")
async def execute_transaction(tx_data):
    # RAFAEL automatically:
    # - Switches to Layer-2 when network is slow
    # - Maintains smooth UX during delays
    # - Optimizes strategy selection over time
    pass
```

## 📊 Dashboard

Access the RAFAEL dashboard:

```bash
rafael dashboard --port 8080
```

View:
- Real-time resilience score
- Evolution timeline
- Active mutations
- Threat simulations
- Fitness metrics

## 🔧 Configuration

```yaml
# rafael.config.yaml
app:
  name: "my-app"
  environment: "production"

resilience:
  genome:
    mutation_rate: 0.1
    sandbox_isolation: true
    auto_adopt_threshold: 0.85
  
  chaos_forge:
    enabled: true
    schedule: "weekly"
    threat_sources:
      - "global_threat_intel"
      - "custom_scenarios"
  
  vault:
    auto_import: true
    community_patterns: true
    verification_required: true

guardian:
  approval_required: true
  audit_log: true
  compliance:
    - "ISO27001"
    - "SOC2"
```

## 🛡️ Security & Ethics

RAFAEL follows strict ethical guidelines:
- ✅ All mutations require developer approval for production
- ✅ Immutable audit logs for all changes
- ✅ Sandbox isolation for testing
- ✅ Compliance-ready architecture
- ✅ Privacy-preserving learning

## 📚 Documentation

### Online Documentation
- **[API Documentation](https://api.rafaelabs.xyz)** - Interactive API reference with live examples
- **[Dashboard Guide](https://dashboard.rafaelabs.xyz)** - Real-time monitoring and management
- **[Interactive Demo](https://demo.rafaelabs.xyz)** - Try chaos testing in your browser

### Local Documentation
- [Core Concepts](./docs/core-concepts.md)
- [Architecture Deep Dive](./docs/architecture.md)
- [Best Practices](./docs/best-practices.md)
- [Community Patterns](./docs/community-patterns.md)
- [Deployment Guide](./SERVER_DEPLOYMENT_GUIDE.md)

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md)

## 🚀 Production Status

RAFAEL Framework is **LIVE** and running in production:

- ✅ **All Systems Operational** - 100% uptime
- ✅ **SSL Secured** - All domains protected with Let's Encrypt
- ✅ **Auto-Scaling** - Ready for production traffic
- ✅ **Monitored** - Real-time health checks
- ✅ **Tested** - Comprehensive test suite (19/19 passing)

### Quick Links
```bash
# Test the API
curl https://api.rafaelabs.xyz/api/status

# Try chaos testing
Visit: https://demo.rafaelabs.xyz

# Monitor your systems
Visit: https://dashboard.rafaelabs.xyz
```

## 📄 License

Proprietary License - All Rights Reserved. See [LICENSE](./LICENSE) for details.

For licensing inquiries, contact: licensing@rafaelabs.xyz

## 🌟 Philosophy

> "What doesn't kill the system, makes it smarter."

RAFAEL transforms chaos into intelligence, failures into immunity, and attacks into evolution.

---

**Built with ❤️ for resilient systems**
