Metadata-Version: 2.2
Name: sigma-c-framework
Version: 2.0.2
Summary: Critical Susceptibility Framework for Quantum, GPU, Financial, Climate, Seismic, and Magnetic analysis
Author-email: ForgottenForge <info@forgottenforge.xyz>
License: AGPL-3.0-or-later OR Commercial
Project-URL: Homepage, https://github.com/forgottenforge/sigmacore
Project-URL: Documentation, https://github.com/forgottenforge/sigmacore/blob/main/DOCUMENTATION.md
Project-URL: Repository, https://github.com/forgottenforge/sigmacore
Project-URL: Issues, https://github.com/forgottenforge/sigmacore/issues
Keywords: critical-phenomena,phase-transitions,quantum-computing,gpu-optimization,financial-analysis,climate-science,seismology,susceptibility
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
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
Classifier: Programming Language :: C++
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
License-File: license_AGPL.txt
License-File: license_COMMERCIAL.txt
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: tqdm>=4.60.0
Requires-Dist: matplotlib>=3.4.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: requests>=2.25.0
Requires-Dist: yfinance>=0.1.63
Requires-Dist: pynvml>=11.0.0
Requires-Dist: scikit-learn>=1.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: quantum
Requires-Dist: amazon-braket-sdk>=1.9.0; extra == "quantum"
Provides-Extra: gpu
Requires-Dist: cupy>=9.0.0; extra == "gpu"
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: mypy>=0.900; extra == "dev"

# Sigma-C Framework v2.0.2 "Rigorous Control"

Universal Criticality Analysis & Active Control System

[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
[![Version](https://img.shields.io/badge/version-2.0.2-green.svg)](https://pypi.org/project/sigma-c-framework/)
[![Status](https://img.shields.io/badge/status-production-success.svg)]()

## 🚀 Overview

Sigma-C v2.0.2 is a rigorous active control system that detects, analyzes, and maintains critical points across quantum, GPU, financial, climate, and ML systems.

**New in v2.0.2**: **Rigor Refinement** - Enhanced numerical stability, AI safety constraints, and statistical significance testing.

## ✨ What's New in v2.0.2

### Core Features
- **Observable Discovery**: Automatic identification of optimal order parameters
- **Multi-Scale Analysis**: Wavelet-based criticality detection across scales
- **Active Control**: PID controller for critical point maintenance
- **Streaming Calculation**: O(1) real-time susceptibility updates (Welford's Algorithm)

### New Domains
- **Climate**: Mesoscale boundary detection
- **Seismic**: Gutenberg-Richter analysis with Significance Testing
- **Magnetic**: Critical exponents validation
- **Edge Computing**: Power efficiency optimization
- **LLM Cost**: Model selection via Pareto frontier with Safety Constraints

### 🔌 Universal Connectivity
- **Quantum**: Qiskit, PennyLane, Cirq, AWS Braket
- **ML**: PyTorch, JAX, TensorFlow
- **Finance**: QuantLib, Zipline
- **DevOps**: Kubernetes, GitHub Actions, Grafana
- **Web**: REST API, GraphQL, WebAssembly

## 📦 Installation

```bash
# Core framework
pip install sigma-c-framework

# With all integrations
pip install sigma-c-framework[all]

# Specific integrations
pip install sigma-c-framework[quantum]   # Qiskit, PennyLane
pip install sigma-c-framework[ml]        # PyTorch, JAX
pip install sigma-c-framework[devops]    # K8s, Grafana
```

## 🔧 Quick Start

### Quantum (Qiskit)
```python
from qiskit import QuantumCircuit
from sigma_c.connectors.qiskit import QiskitSigmaC

circuit = QuantumCircuit(3)
circuit.h(0)
circuit.cx(0, 1)

# Automatic criticality analysis
result = QiskitSigmaC.analyze(circuit)
print(f"σ_c = {result['sigma_c']:.4f}")
```

### Machine Learning (PyTorch)
```python
from sigma_c.ml.pytorch import CriticalModule, SigmaCLoss

class MyNet(CriticalModule):
    def forward(self, x):
        return self.critical_forward(x)  # Auto σ_c tracking

criterion = SigmaCLoss(lambda_critical=0.1)
```

### Universal Bridge (Any Framework)
```python
from sigma_c.connectors.bridge import SigmaCBridge

@SigmaCBridge.wrap_any_function
def my_function(x):
    return x ** 2

result = my_function(5)
print(result.__sigma_c__)  # Criticality metadata
```

### DevOps (Kubernetes)
```yaml
apiVersion: sigma-c.io/v1
kind: CriticalityMonitor
metadata:
  name: app-monitor
spec:
  target:
    app: my-app
  thresholds:
    cpu: 0.8
  actions:
    scale: true
```

## 📚 Documentation

- **[Integrations Guide](docs/INTEGRATIONS.md)** - All 22+ integrations
- **[API Reference](docs/API_REFERENCE_v2.0.md)** - Complete API docs
- **[Release Notes](docs/releases/RELEASE_NOTES_v2.0.2.md)** - What's new in v2.0.2
- **[Examples](examples_v4/)** - Code examples

## 🎯 Use Cases

- **Quantum Computing**: Optimize circuits for NISQ devices
- **GPU/HPC**: Detect cache transitions, thermal throttling
- **Finance**: Predict market crashes, optimize portfolios
- **ML**: Train robust models, detect overfitting
- **Climate**: Identify mesoscale boundaries
- **Edge/IoT**: Optimize power efficiency

## 🛡️ License

**Open Source**: AGPL-3.0-or-later  
**Commercial**: Contact [nfo@forgottenforge.xyz](mailto:nfo@forgottenforge.xyz)

Copyright © 2025 ForgottenForge.xyz
