Create README.md

README.md

@@ -0,0 +1,48 @@
+---
+title: "PiForge Ethical Dual-Forge"
+emoji: "🔨"
+colorFrom: "red"
+colorTo: "yellow"
+sdk: "gradio"
+sdk_version: "4.0.0"
+app_file: "app.py"
+pinned: false
+---
+
+# 🔨 PiForge Ethical Dual-Forge V1.2
+
+## Sovereign Canticle Powered Ethical Audit System
+
+### 🌌 Quantum Bridge Architecture
+This Space provides the ethical audit engine for the PiForge ecosystem, connecting Hugging Face's ML capabilities with Pi Network's decentralized platform through a secure quantum bridge.
+
+### 🚀 Features
+- **Ethical Scoring**: Real-time audit of project alignment with Sovereign Canticle principles
+- **Quantum Bridge**: Secure postMessage communication with Pi App Studio wrapper
+- **Mining Boost**: Automatic 15% mining boost activation at 691+ resonance
+- **Onion-Pi Viz**: Fractal visualization of 4-phase ethical cascade
+
+### 🔧 Technical Stack
+- **Frontend**: Gradio + Python
+- **Integration**: Pi SDK + postMessage API
+- **Security**: Sandboxed iframe + origin validation
+- **Visualization**: SVG animations + responsive design
+
+### 📊 Usage Flow
+1. **Entangle & Mine**: Pi authentication and session initiation
+2. **Verity Forge**: Truth alignment scoring (0-1000)
+3. **Qualia Quench**: Experience impact assessment (0-100)  
+4. **Resonance Ritual**: Harmonic synthesis and mining boost activation
+
+### 🔗 Integration
+```javascript
+// Quantum Bridge Communication
+window.parent.postMessage({
+  type: 'ethical_audit_complete',
+  results: {
+    ethical_score: 720,
+    resonance: 691,
+    mining_boost: 15,
+    proposal_id: 'prop_3701b5dedf34'
+  }
+}, "https://app.minepi.com");