Metadata-Version: 2.4
Name: darkelf-cocoa
Version: 4.3
Summary: Darkelf Cocoa privacy browser for macOS
Author: Dr. Kevin Moore
License: LGPL-3.0-or-later
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pyobjc
Requires-Dist: tldextract

# 🧿 Darkelf Cocoa Browser

### Ephemeral, Post-Quantum Privacy Browser (macOS / Cocoa)

Darkelf is a memory-only, privacy-first web browser built using PyObjC + WebKit, featuring a deterministic Post-Quantum Integrity Layer (PQ) and an on-device AI security engine (MiniAI Sentinel).

---

# 🚀 Darkelf Cocoa 4.3

### Stability • Accuracy • Privacy Reinforced

Darkelf Cocoa 4.3 focuses on strengthening internal consistency, reducing false positives, and improving real-world resilience across browsing, detection, and cryptographic layers.

---

## 🧪 Stability & Verification
- ✅ All 59 Pytests passing  
- Improved cold boot consistency  
- Hardened lifecycle + state handling  
- Stable under stress / long-session runtime  

---

## 🧠 MiniAI Sentinel (Detection Engine)

### Enhanced Detection Accuracy
- Refined behavioral heuristics  
- Reduced false positives under load  
- Improved classification for:
  - scraping activity  
  - credential abuse patterns  
  - automation frameworks  

### Smarter Thresholding
- Tuned for real-world browsing behavior  
- Concurrency-safe detection logic  
- No false triggers from high-performance systems  

---

## 🕸️ Scraper Detection (Reworked)

### Hybrid Detection Model
- Same-path burst detection (test-safe)  
- Multi-path enumeration detection (real-world)  

### Improvements
- Eliminates false positives from:
  - hardware concurrency  
  - rapid navigation  
- Better alignment with real attacker behavior  

---

## 🛡️ Network Policy Engine (Enhanced)

- 🔒 Fixed HTTP → HTTPS upgrade enforcement  
- 🚫 Stricter tracker blocking (domain-level precision)  
- Works correctly without active tab context  
- Reduced interference with legitimate traffic  

---

## 🔐 Post-Quantum Integrity Layer (PQ)

### Enhancements in 4.3
- Stronger stateful request chaining  
- Improved replay resistance  
- Better entropy tracking  
- Stable behavior across rapid navigation  

### Identity Model
- `_pq_seed` → per-tab root identity  
- `_pq_salt` → hidden entropy  
- `_pq_counter` → monotonic progression  
- `_pq_prev_chain` → chain continuity  

### Chain Construction
```
chain = SHA3_512(
    seed +
    normalized_url +
    previous_chain +
    counter +
    salt
)
```

### Features
- Canonical URL normalization  
- Replay detection (~200 chain window)  
- TLS certificate binding  
- Deterministic third-party deception  
- Rendering isolation (Canvas/WebGL/Audio)  

### Identity Rotation
```
seed → SHA3_256(seed)
```

---

## 🎯 Content Rules / Adblocking

- Refined and consolidated rule sets  
- Improved compatibility with PQ fingerprint system  
- Better filtering of:
  - trackers  
  - ad iframes  
  - consent frameworks  
- Reduced site breakage  
- Improved CNN / news-site handling (container-safe filtering)

---

## ⚙️ JavaScript Hardening (PQ Unified)

- All JS privacy surfaces aligned under PQ-seeded entropy  
- Consistent spoofing across:
  - Canvas  
  - WebGL  
  - Font fingerprinting  

---

## 🎨 Fingerprint Isolation

### Per-Tab Isolation Model
- 🔁 Per-tab randomized rotation  
- Unified device profile per tab session:
  - Canvas hashes  
  - WebGL output  
  - Font metrics  

### Result
- Eliminates cross-tab correlation vectors  
- Prevents long-session fingerprint linking  

---

## 🧩 Architecture Improvements

- Clear separation between:
  - network policy layer  
  - MiniAI detection engine  
  - PQ cryptographic state  

- Reduced duplication  
- Fewer edge-case inconsistencies  
- Improved long-session stability  

---

## 🔐 Ephemeral Browsing

- No disk persistence  
- Memory-only cookies/cache/storage  
- Automatic cleanup on exit  
- Downloads disabled by default  

---

## 🕵️ Privacy & Anti-Tracking

- First-party isolation (FPI)  
- Deterministic third-party deception  
- Ad + tracker blocking  
- Fingerprint surface reduction  

---

## ⚙️ Installation

```bash
git clone https://github.com/yourrepo/darkelf
cd darkelf
python browser.py
```

---

## 📦 PyPI

```bash
pip install darkelf-cocoa
darkelf
```

---

## 🔐 Security Model

- Zero persistence  
- Deterministic identity isolation  
- Replay resistance  
- Behavioral anomaly detection  
- No telemetry  

---

## 📜 License
LGPL-3.0-or-later  
© Dr. Kevin Moore (2025)
