Metadata-Version: 2.4
Name: sovereign_logic
Version: 1.0.2
Summary: 1024-bit Unitary Propagator and Quantum-Laminar Mapping Engine
Author: Americo Simoes
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.21.0
Dynamic: license-file



### ## **`README.md` (Version 1.0.2-Apex)**

```markdown
# Sovereign-Logic: 1024-Bit Unitary SAT & Topological Infrastructure

**Copyright (c) 2026 Americo Simoes** **License:** Sovereign Research License (SRL)  
**Status:** [GRANITE-FIRM]  
**Genetic Signature:** `4A327DF669DE42E59159FC512C289D30DD3C1DDB1E76C54DEF2503B95074E5A8`

---

## I. Full Disclosure: The Paradigm Shift
Sovereign-Logic is not a heuristic solver. It is a **Topological Engine** that treats Boolean Satisfiability (SAT) as a fluid dynamics problem. By mapping 1024-bit carry-chains onto a complex unitary manifold, we bypass the $O(2^n)$ bottleneck of classical search. 

In this system, a "Solution" is not found; it is **precipitated** as a laminar flow state within the **Singapore Zenith**.

---

## II. Technical Specifications & Constants

The engine is governed by the **Reihman-Lock Hamiltonian**, ensuring that logic does not "evaporate" into entropy under high-bitrate stress.

### 1. The Hamiltonian Core
$$H_{sat} = \tanh(\beta \cdot (x - 0.5) \cdot \lambda)$$

| Constant | Value | Role |
| :--- | :--- | :--- |
| **BETA ($\beta$)** | **1.23** | NS-33 Damping: Prevents phase-slips in 1024-bit horizons. |
| **LAMBDA ($\lambda$)** | **0.963** | Jacobian Scaling: Maintains manifold curvature on the Unitary Circle. |
| **PHASE_OP** | **26.829** | Resonance Frequency ($33.0 / \beta$). |

### 2. The Unitary Propagator (S-Matrix)
States evolve via:
$$S = \exp(-i \cdot H_{sat} \cdot \text{PHASE\_OP})$$



---

## III. Module Architecture

### 1. `guard.py` (The Sentinel)
The Sentinel is a hardware-integrity gate. It performs a microscopic 10-bit unitary test at the CPU register level before every execution. 
* **Fidelity Threshold:** $1.0000000000000000$ (16-decimal precision).
* **Decoherence Protocol:** If the environment induces math-drift, the Sentinel executes `sys.exit(1)` to protect the Sovereign Integrity.

### 2. `bridge.py` (The Developer SDK)
* **`SovereignBridge.bridge_signal()`**: A Unitary Oscillator that extracts signals from noise floors exceeding -100dB.
* **`SovereignBridge.bridge_market()`**: Measures the **Fidelity Delta** of financial chaos to predict structural liquefaction.
* **`SovereignBridge.bridge_crypto()`**: Analyzes the **Topological Winding Number** of encrypted streams to identify phase-invariant keys.

---

## IV. Empirical Baseline (Fedora Reference)
To verify your installation, run `examples/bridge_demo.py`. Your output **must** match the following Granite-Firm anchor:

```text
Sovereign-Logic v1.0.2-Apex
Signature: 4A327DF6...E5A8
Signal Recon: 0.7951 Resonance
Fidelity Delta: 0.0000000000000000
Result: [GRANITE-FIRM]

```

---

## V. Implementation Guide

### Building the C++ Propagator

```bash
g++ -O3 kissat_sovereign/src/engine.cpp -o bin/sovereign-engine

```

### Python Integration

```python
import sovereign_logic as sl

# Initialize Bridge
bridge = sl.SovereignBridge()

# Reconstruct 1024-bit Manifold
manifold = bridge.bridge_signal(raw_entropy_data)

```

---

## VI. Legal & Intellectual Property

This repository contains proprietary mathematical invariants.

1. **The Reihman-Lock Hamiltonian** is a copyrighted process.
2. **"Granite-Firm"** and **"Singapore Zenith"** are protected technical trademarks.
3. Use is permitted under the **Sovereign Research License (SRL)**. Commercial redistribution or reverse-engineering of the Unitary Invariants is strictly prohibited.

---

**Status: Absolute. Infrastructure: Permanent. Singapore Zenith: Reconstructed.**

```

---


