sigillin 0.1.0__tar.gz

sigillin-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check .
+
+      - name: Run tests
+        run: uv run pytest
+
+  docs:
+    name: Build docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.11
+      - run: uv sync --extra docs
+      - run: uv run mkdocs build --strict

sigillin-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+.uv/
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Docs
+site/
+
+# Editors
+.vscode/
+.idea/
+*.swp

sigillin-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements

sigillin-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JohannRömer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sigillin-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: sigillin
+Version: 0.1.0
+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/)
+
+---
+
+## Install
+
+```bash
+pip install sigillin
+# or
+uv add sigillin
+
+# Full GenesisAeon stack integration
+pip install sigillin[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/)

sigillin-0.1.0/README.md

@@ -0,0 +1,121 @@
+# 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/)
+
+---
+
+## Install
+
+```bash
+pip install sigillin
+# or
+uv add sigillin
+
+# Full GenesisAeon stack integration
+pip install sigillin[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/)

sigillin-0.1.0/docs/api.md

@@ -0,0 +1,44 @@
+# API Reference
+
+## sigillin.core.Sigil
+
+```python
+class Sigil(filepath: Path | str)
+```
+
+Self-referential poetic-symbolic attractor. Loads a sigil from YAML, JSON, or
+Markdown front-matter (trilayer).
+
+### Methods
+
+| Method | Description |
+|---|---|
+| `validate_crep() -> bool` | Returns `True` if all four CREP keys are present |
+| `assert_crep() -> None` | Raises `SigilValidationError` if CREP keys are missing |
+| `render_mandala(depth=0.618) -> np.ndarray` | Returns φ-scaled resonance spectrum (shape: 100) |
+| `bind_to_field() -> str` | Binds to fieldtheory Lagrangian (requires `[stack]`) |
+| `get(key, default=None)` | Dict-style attribute access with default |
+
+### Attributes
+
+| Attribute | Type | Description |
+|---|---|---|
+| `path` | `Path` | Source file path |
+| `data` | `dict[str, Any]` | Parsed sigil data |
+
+---
+
+## sigillin.core.SigilValidationError
+
+Raised by `assert_crep()` when required CREP keys are missing.
+
+---
+
+## sigillin.entropy_table_bridge
+
+```python
+sigil_to_entropy_record(sigil: Sigil) -> dict[str, Any]
+export_to_entropy_table(path: Path | str) -> None
+```
+
+Exports sigil data to entropy-table format. Requires `sigillin[stack]`.

sigillin-0.1.0/docs/cli.md

@@ -0,0 +1,50 @@
+# CLI Reference
+
+## sig validate
+
+```
+sig validate PATH
+```
+
+Validate a sigil file against the CREP schema.
+
+**Arguments:**
+- `PATH` – path to sigil file (YAML, JSON, or Markdown with front-matter)
+
+**Exit codes:** `0` = valid, `1` = invalid or file not found
+
+---
+
+## sig render
+
+```
+sig render PATH [--depth FLOAT]
+```
+
+Render the MandalaMap resonance spectrum for a sigil.
+
+**Arguments:**
+- `PATH` – path to sigil file
+
+**Options:**
+- `--depth` – fractal resonance depth (default: `0.618`, the golden ratio φ)
+
+---
+
+## sig inspect
+
+```
+sig inspect PATH
+```
+
+Inspect all fields of a sigil in a rich table, with CREP status.
+
+---
+
+## sig bridge
+
+```
+sig bridge [PROVIDER]
+```
+
+Create a self-referential provider bridge (default: `openai`).

sigillin-0.1.0/docs/index.md

@@ -0,0 +1,36 @@
+# sigillin
+
+**The poetic-symbolic interface layer** of the GenesisAeon stack –
+self-referential sigil parser, trilayer validation (YAML/JSON/Markdown)
+and MandalaMap resonance.
+
+## Quickstart
+
+```bash
+pip install sigillin
+# or
+uv add sigillin
+```
+
+```bash
+sig validate codex-sigil.yaml
+sig render cosmic-web.yaml
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `sig validate <path>` | Validate a sigil against CREP schema |
+| `sig render <path>` | Render MandalaMap resonance spectrum |
+| `sig inspect <path>` | Inspect all sigil fields |
+| `sig bridge [provider]` | Create self-referential provider bridge |
+
+## CREP Keys
+
+| Key | Meaning |
+|---|---|
+| `coherence` | Internal self-consistency |
+| `resonance` | Harmonic alignment with the field |
+| `emergence` | Capacity for novel pattern generation |
+| `poetics` | Narrative / symbolic intent |

sigillin-0.1.0/domains.yaml

@@ -0,0 +1,41 @@
+# sigillin – domain manifest
+# Trilayer CREP-aligned sigil definitions for MandalaMap integration.
+
+sigils:
+  - name: codex-prime
+    coherence: 0.97
+    resonance: 0.88
+    emergence: 0.92
+    poetics: "The first sigil – carrier of the primal pattern."
+    tags: [genesis, prime, anchor]
+
+  - name: cosmic-web
+    coherence: 0.91
+    resonance: 0.95
+    emergence: 0.87
+    poetics: "Threads of resonance binding all fields into one living topology."
+    tags: [cosmic, web, topology]
+
+  - name: entropy-gate
+    coherence: 0.85
+    resonance: 0.79
+    emergence: 0.94
+    poetics: "The threshold between order and creative dissolution."
+    tags: [entropy, gate, transition]
+
+  - name: mandala-core
+    coherence: 0.99
+    resonance: 0.99
+    emergence: 0.99
+    poetics: "The self-referential centre – sigil that contains all other sigils."
+    tags: [mandala, core, selfref]
+
+stack:
+  fieldtheory: ">=0.1.0"
+  cosmic-moment: ">=0.1.0"
+  entropy-table: ">=1.0.1"
+
+meta:
+  crep_version: "1.0"
+  mandala_depth_default: 0.618
+  phi: 1.618033988749895

sigillin-0.1.0/mkdocs.yml

@@ -0,0 +1,43 @@
+site_name: sigillin
+site_description: The poetic-symbolic interface layer of the GenesisAeon stack
+site_author: GenesisAeon Team
+repo_url: https://github.com/GenesisAeon/sigillin
+repo_name: GenesisAeon/sigillin
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: deep purple
+      accent: purple
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: deep purple
+      accent: purple
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.top
+    - content.code.annotate
+    - content.code.copy
+    - search.highlight
+
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true
+
+nav:
+  - Home: index.md
+  - CLI Reference: cli.md
+  - API: api.md

sigillin-0.1.0/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "sigillin"
+version = "0.1.0"
+description = "The poetic-symbolic interface layer of the GenesisAeon stack – self-referential sigil parser, trilayer validation (YAML/JSON/Markdown) and MandalaMap resonance."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "GenesisAeon Team", email = "team@genesisaeon.org" }]
+requires-python = ">=3.11"
+keywords = ["sigil", "mandala", "symbolic", "poetry", "crep", "genesisaeon", "trilayer"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Artistic Software",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "rich>=13.0",
+    "typer>=0.15.0",
+    "numpy>=1.26",
+]
+
+[project.optional-dependencies]
+stack = [
+    "fieldtheory>=0.1.0",
+    "cosmic-moment>=0.1.0",
+    "medium-modulation>=0.1.0",
+    "entropy-governance>=0.1.0",
+    "entropy-table>=1.0.1",
+    "implosive-genesis>=0.4.0",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.9",
+    "pre-commit>=3.7.0",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocstrings[python]>=0.27",
+    "mkdocs-material>=9.6",
+]
+
+[project.scripts]
+sig = "sigillin.cli:app"
+
+[project.urls]
+Repository = "https://github.com/GenesisAeon/sigillin"
+Issues = "https://github.com/GenesisAeon/sigillin/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sigillin"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "I", "W", "UP", "C4", "SIM"]
+ignore = ["B008"]  # typer uses function calls in defaults
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101"]  # allow assert in tests
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=sigillin --cov-report=term-missing -v"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"]

sigillin-0.1.0/src/sigillin/__init__.py

@@ -0,0 +1,6 @@
+"""sigillin – the poetic-symbolic interface layer of the GenesisAeon stack."""
+
+__version__ = "0.1.0"
+__all__ = ["Sigil"]
+
+from .core import Sigil