Metadata-Version: 2.4
Name: sigillin
Version: 0.3.1
Summary: The poetic-symbolic interface layer of the GenesisAeon stack â€“ self-referential sigil parser, trilayer validation (YAML/JSON/Markdown) and MandalaMap resonance.
Project-URL: Repository, https://github.com/GenesisAeon/sigillin
Project-URL: Issues, https://github.com/GenesisAeon/sigillin/issues
Author-email: GenesisAeon Team <team@genesisaeon.org>
License: MIT
License-File: LICENSE
Keywords: crep,genesisaeon,mandala,poetry,sigil,symbolic,trilayer
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Artistic Software
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Requires-Dist: numpy>=1.26
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.15.0
Provides-Extra: dev
Requires-Dist: pre-commit>=3.7.0; 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: 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: medium-modulation>=0.1.0; extra == 'stack'
Description-Content-Type: text/markdown

# sigillin

**The poetic-symbolic interface layer** – self-referential sigils that bind fieldtheory,
cosmic moments and entropy governance into living resonance.

[![CI](https://github.com/GenesisAeon/sigillin/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/sigillin/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/sigillin)](https://pypi.org/project/sigillin/)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19029975.svg)](https://doi.org/10.5281/zenodo.19029975)

---

## Install

```bash
pip install sigillin
# or
uv add sigillin

# Full GenesisAeon stack integration
pip install "sigillin[stack]"
```

**DOI**: [10.5281/zenodo.19029975](https://doi.org/10.5281/zenodo.19029975)
**PyPI**: `pip install sigillin` (oder `pip install "sigillin[stack]"` für den vollen GenesisAeon-Stack)

## Usage

```bash
# Validate a sigil against the CREP schema
sig validate codex-sigil.yaml

# Render MandalaMap resonance spectrum
sig render cosmic-web.yaml

# Inspect sigil fields
sig inspect codex-sigil.yaml

# Create a self-referential provider bridge
sig bridge openai
```

## Sigil format (trilayer: YAML / JSON / Markdown)

Sigillin accepts three source formats:

```yaml
# codex-sigil.yaml
coherence: 0.97
resonance: 0.88
emergence: 0.92
poetics: "The first sigil – carrier of the primal pattern."
```

```json
{ "coherence": 0.97, "resonance": 0.88, "emergence": 0.92, "poetics": "..." }
```

```markdown
---
coherence: 0.97
resonance: 0.88
emergence: 0.92
poetics: "The first sigil – carrier of the primal pattern."
---
# Codex Prime

Full narrative description here.
```

## CREP validation

Every sigil is validated against four pillars:

| Key | Meaning |
|---|---|
| `coherence` | Internal self-consistency |
| `resonance` | Harmonic alignment with the field |
| `emergence` | Capacity for novel pattern generation |
| `poetics` | Narrative / symbolic intent |

```python
from sigillin import Sigil

sigil = Sigil("codex-sigil.yaml")
sigil.validate_crep()   # True / False
sigil.assert_crep()     # raises SigilValidationError if invalid
```

## MandalaMap resonance

```python
spectrum = sigil.render_mandala(depth=0.618)  # φ-scaled resonance array
print(f"Peak: {spectrum.max():.4f}")
```

## Stack integration

With `pip install sigillin[stack]`, sigillin binds directly to the full GenesisAeon stack:

```python
sigil.bind_to_field()   # returns Lagrangian string from fieldtheory
```

```python
from sigillin.entropy_table_bridge import export_to_entropy_table
export_to_entropy_table("codex-sigil.yaml")
```

## Python API

```python
from sigillin import Sigil

sigil = Sigil("codex-sigil.yaml")
print(sigil["coherence"])          # 0.97
print(sigil.get("tags", []))       # []
print(repr(sigil))                 # Sigil(path=..., crep_valid=True)
```

---

Built with [uv](https://docs.astral.sh/uv/) · [Typer](https://typer.tiangolo.com/) ·
[Rich](https://rich.readthedocs.io/) · [NumPy](https://numpy.org/)
