Metadata-Version: 2.4
Name: mirror-machine
Version: 0.3.1
Summary: Theoretical Mirror Framework for the GenesisAeon stack â€“ self-referential loops, consciousness phase transitions and Mirror Principle simulation.
Project-URL: Repository, https://github.com/GenesisAeon/mirror-machine
Project-URL: Issues, https://github.com/GenesisAeon/mirror-machine/issues
Author-email: GenesisAeon Team <team@genesisaeon.org>
License: MIT
License-File: LICENSE
Keywords: consciousness,genesisaeon,mirror,phase-transition,self-referential
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Requires-Dist: numpy>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.15.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.9; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.6; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
Provides-Extra: stack
Requires-Dist: climate-dashboard>=0.1.0; extra == 'stack'
Requires-Dist: cosmic-moment>=0.1.0; extra == 'stack'
Requires-Dist: entropy-governance>=0.1.0; extra == 'stack'
Requires-Dist: entropy-table>=1.0.1; extra == 'stack'
Requires-Dist: fieldtheory>=0.1.0; extra == 'stack'
Requires-Dist: implosive-genesis>=0.4.0; extra == 'stack'
Requires-Dist: mandala-visualizer>=0.1.0; extra == 'stack'
Requires-Dist: medium-modulation>=0.1.0; extra == 'stack'
Requires-Dist: sigillin>=0.1.0; extra == 'stack'
Requires-Dist: sonification>=0.0.10; extra == 'stack'
Requires-Dist: utac-core>=0.1.0; extra == 'stack'
Description-Content-Type: text/markdown

# mirror-machine

**Theoretical Mirror Framework** – self-referential loops, consciousness phase transitions and Mirror Principle simulation for the GenesisAeon stack.

[![CI](https://github.com/GenesisAeon/mirror-machine/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/mirror-machine/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/mirror-machine)](https://pypi.org/project/mirror-machine/)

---

## Install

```bash
pip install mirror-machine
# with full GenesisAeon stack integration
pip install mirror-machine[stack]
```

## CLI Usage

```bash
# Reflect a sigil YAML through the Mirror Principle
mirror reflect --sigil codex-prime.yaml

# Simulate a consciousness phase transition
mirror phase-transition --beta 0.0625 --steps 100
```

## Python API

```python
from mirror_machine import MirrorMachine

mm = MirrorMachine("codex-prime.yaml")

# Self-referential state with reflection key
print(mm.state["reflection"])

# Consciousness phase transition curve
curve = mm.phase_transition(beta=0.0625, steps=200)
print(f"Peak emergence: {curve.max():.4f}")
```

## What It Does

| Concept | Implementation |
|---|---|
| **Mirror Principle** | `reflect()` — loads YAML sigil, creates `state["reflection"]` self-reference |
| **Phase Transition** | `phase_transition()` — sigmoid × golden-ratio oscillation (φ = 0.618) |
| **Entropy Bridge** | `MirrorMachineBridge` — optional link to `entropy-table` (requires `[stack]`) |

## Structure

```
mirror-machine/
├── src/mirror_machine/
│   ├── core.py                 # MirrorMachine – reflect + phase_transition
│   ├── cli.py                  # Typer CLI: mirror reflect / mirror phase-transition
│   └── entropy_table_bridge.py # Optional entropy-table integration
├── domains.yaml                # Mirror-machine domain configuration
└── tests/
```

## Citation

**DOI** (after Zenodo release): `10.5281/zenodo.XXXXXXX`
**PyPI**: https://pypi.org/project/mirror-machine/

---

Part of the [GenesisAeon](https://github.com/GenesisAeon) stack — the self-reflective core.
