Metadata-Version: 2.4
Name: penta_v_kernel
Version: 0.2.1
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: System :: Networking
License-File: LICENSE
Summary: A mission-critical Geometric Stability Protocol (Python Bindings)
Keywords: kernel,load-balancing,geometry,rust-bindings
Home-Page: https://github.com
Author-email: Issac Andrew <Issaclex@proton.me>
License: Apache-2.0
Requires-Python: >=3.7
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM


# 🛡️ Penta-V Kernel (Penta-V-Core)
**The Sovereign Protocol for Geometric Stability & Thermal-Aware System Resilience.**

<h3>
  <code>Rust 🦀</code> 
  <code>Python 🐍</code> 
  <code>PyPI 📦</code> 
  <code>License: Apache-2.0 ⚖️</code>
</h3>

> "In the chaos of data, geometry is the only truth. The Penta-V Kernel doesn't just manage load; it redefines the physics of digital survival." — **The First Architect**

---

## 🏛️ Overview
The **Penta-V Kernel** is a mission-critical infrastructure component. It introduces a paradigm shift in system engineering: **Geometric Load Balancing**. 

Instead of traditional linear queuing, Penta-V treats system stressors as "Deficits" and dissipates them across a variable number of **Geometric Poles**. By dynamically transitioning between shapes—from the foundational Triangle to the asymptotic perfection of the Circle—the kernel ensures that no system shock can compromise the `SECURE_CORE`.

---

## ✅ System Integrity & Global Testing
Our architectural stability is verified through multi-platform automated suites. Every commit triggers a full geometric stress simulation across **Linux, Windows, and macOS**.

* **Distributed Mesh:** `test_mesh_pulse_telemetry_integrity` **PASSED** ✅
* **Geometric Efficiency:** `test_efficiency_comparison` **PASSED** ✅
* **Python Binding Logic:** `maturin_verification` **PASSED** ✅
* **Stress Resilience:** `test_decagon_stress_attack` **PASSED** ✅

---

## 🛰️ Phase IV: Distributed Geometric Mesh & Python Bindings
In version **v0.2.1**, Penta-V transcends the boundaries of low-level systems. We have implemented **High-Performance Python Bindings** (powered by PyO3), bringing kernel-level stability to the most popular language in the world.

*   **Stability Packets:** Zero-allocation telemetry for inter-kernel sync.
*   **Pythonic Resilience:** Access geometric immunity factors with a single `pip install`.
*   **Secure Peering:** Trust-boundary enforcement via the `secure_gate` protocol.

---

## 🚀 Installation & Usage

### 🐍 Python (via PyPI)
```bash
pip install penta_v_kernel
```
```python
import penta_v_kernel

# Calculate the impact of a 500-unit deficit on a Circle (The Shield)
impact = penta_v_kernel.calculate_impact(500.0, float('inf'))
print(f"Geometric Dissipation Result: {impact}") # Output: 0.0
```

### 🦀 Rust (via Cargo)
```toml
[dependencies]
penta_v_kernel = "0.2.1"
```
```rust
use penta_v_kernel::mesh::{MeshNode, MeshPulse};

fn main() {
    let mut node = MeshNode::new(0xAA55, true);
    let pulse = node.generate_pulse();
    println!("Node {} Stability: {}", pulse.node_id, pulse.stability_score);
}
```

---

## 📊 The Hierarchy of Immunity


| Shape | Poles ($N$) | Immunity ($\Phi$) | Tier | Use Case |
| :--- | :--- | :--- | :--- | :--- |
| **Triangle** | 3 | 1.00 | Foundation | Idle / Low-Power |
| **Hexagon** | 6 | 2.00 | Balanced | Standard Load |
| **Nonagon** | 9 | 3.00 | Triple-Stability | High-Traffic |
| **Dodecagon** | 12 | 4.00 | Quad-Stability | Critical Stress |
| **Circle** | $\infty$ | $\infty$ | **The Shield** | Asymptotic Defense |

---

## 📜 Roadmap
- [x] **Phase I**: Core Geometric Logic & Pole Mathematics.
- [x] **Phase II**: Real-time Thermal-Aware Decay Scaling & Guard Protection.
- [x] **Phase IV**: Distributed Mesh & Python Ecosystem Integration.
- [ ] **Phase V**: Hardware-level Silicon Acceleration (HDL Logic).

---

⚖️ **License**
Distributed under the Apache License 2.0. Created by **Isaac Andrew (The First Architect)**.

