medium-modulation 0.1.0__tar.gz

medium_modulation-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

medium_modulation-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

medium_modulation-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

medium_modulation-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.

medium_modulation-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: medium-modulation
+Version: 0.1.0
+Summary: Resonant medium between S∝A and S∝V – fractal modulation operators, resonance spectra and tunable interference for controlled information propagation.
+Project-URL: Repository, https://github.com/GenesisAeon/medium-modulation
+Project-URL: Issues, https://github.com/GenesisAeon/medium-modulation/issues
+Author-email: GenesisAeon Team <team@genesisaeon.org>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: entropy-governance>=0.1.0
+Requires-Dist: entropy-table>=1.0.1
+Requires-Dist: implosive-genesis>=0.4.0
+Requires-Dist: numpy>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sympy>=1.13.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.5.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# medium-modulation
+
+**The resonant medium between action and expanse.**
+
+[![CI](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+medium-modulation serves as the dynamic coupling layer that modulates the fundamental duality of the GenesisAeon framework: action-governed entropy production (S ∝ A) versus volume-governed informational expansion (S ∝ V).
+
+Through fractal modulation operators, resonance spectra, and tunable interference fields, it turns raw tension into coherent emergence.
+
+---
+
+## Install
+
+```bash
+pip install medium-modulation
+```
+
+## Usage
+
+```bash
+mm modulate --depth 0.7 --freq 2.3
+mm spectrum
+```
+
+## API
+
+```python
+from medium_modulation.core import modulated_entropy, resonance_spectrum, coupling_factor
+import numpy as np
+
+# Fractal medium modulation
+S_mod = modulated_entropy(S_A=1.0, S_V=1.618, depth=0.5, freq=1.0, t=0.0)
+
+# Resonance spectrum over frequency range
+freqs = np.linspace(0.1, 10, 50)
+spec = resonance_spectrum(freqs, depth=0.5)
+
+# Dynamic coupling strength
+kappa = coupling_factor(A=1.0, V=1.618, modulation_depth=0.5)
+```
+
+## Architecture
+
+```
+medium-modulation/
+├── src/medium_modulation/
+│   ├── core.py                  # Modulation operator + fractal coupling
+│   ├── cli.py                   # CLI mm
+│   └── entropy_table_bridge.py  # entropy-table integration
+├── tests/
+│   ├── test_core.py
+│   └── test_cli.py
+└── domains.yaml                 # Domain configuration
+```
+
+## Integrations
+
+| Package | Role |
+|---------|------|
+| `entropy-governance` | Duality factor α·S_A + (1-α)·S_V |
+| `entropy-table` | Domain relation registry |
+| `implosive-genesis` | Fractal emergence substrate |
+
+**DOI** (after Zenodo release): 10.5281/zenodo.XXXXXXX
+**PyPI**: https://pypi.org/project/medium-modulation/
+
+---
+
+Built with [SymPy](https://www.sympy.org/) · [NumPy](https://numpy.org/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)

medium_modulation-0.1.0/README.md

@@ -0,0 +1,72 @@
+# medium-modulation
+
+**The resonant medium between action and expanse.**
+
+[![CI](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/medium-modulation/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+medium-modulation serves as the dynamic coupling layer that modulates the fundamental duality of the GenesisAeon framework: action-governed entropy production (S ∝ A) versus volume-governed informational expansion (S ∝ V).
+
+Through fractal modulation operators, resonance spectra, and tunable interference fields, it turns raw tension into coherent emergence.
+
+---
+
+## Install
+
+```bash
+pip install medium-modulation
+```
+
+## Usage
+
+```bash
+mm modulate --depth 0.7 --freq 2.3
+mm spectrum
+```
+
+## API
+
+```python
+from medium_modulation.core import modulated_entropy, resonance_spectrum, coupling_factor
+import numpy as np
+
+# Fractal medium modulation
+S_mod = modulated_entropy(S_A=1.0, S_V=1.618, depth=0.5, freq=1.0, t=0.0)
+
+# Resonance spectrum over frequency range
+freqs = np.linspace(0.1, 10, 50)
+spec = resonance_spectrum(freqs, depth=0.5)
+
+# Dynamic coupling strength
+kappa = coupling_factor(A=1.0, V=1.618, modulation_depth=0.5)
+```
+
+## Architecture
+
+```
+medium-modulation/
+├── src/medium_modulation/
+│   ├── core.py                  # Modulation operator + fractal coupling
+│   ├── cli.py                   # CLI mm
+│   └── entropy_table_bridge.py  # entropy-table integration
+├── tests/
+│   ├── test_core.py
+│   └── test_cli.py
+└── domains.yaml                 # Domain configuration
+```
+
+## Integrations
+
+| Package | Role |
+|---------|------|
+| `entropy-governance` | Duality factor α·S_A + (1-α)·S_V |
+| `entropy-table` | Domain relation registry |
+| `implosive-genesis` | Fractal emergence substrate |
+
+**DOI** (after Zenodo release): 10.5281/zenodo.XXXXXXX
+**PyPI**: https://pypi.org/project/medium-modulation/
+
+---
+
+Built with [SymPy](https://www.sympy.org/) · [NumPy](https://numpy.org/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)

medium_modulation-0.1.0/docs/cli.md

@@ -0,0 +1,88 @@
+# CLI Reference
+
+## `diamond scaffold`
+
+Create a new project from a template.
+
+```
+Usage: diamond scaffold [OPTIONS] PROJECT_NAME
+
+Arguments:
+  PROJECT_NAME  Name of the new project (kebab-case recommended)
+
+Options:
+  -t, --template TEXT       Template to use [default: minimal]
+  -o, --output-dir PATH     Parent directory for the new project
+  --author TEXT             Author name
+  --description TEXT        Short project description
+  --python-version TEXT     Minimum Python version (e.g. 3.11)
+  --dry-run                 Preview files without writing them
+```
+
+**Examples**
+
+```bash
+# Minimal project in the current directory
+diamond scaffold my-lib
+
+# Genesis preset with custom author
+diamond scaffold my-physics-tool --template genesis --author "Ada Lovelace"
+
+# Preview what would be created
+diamond scaffold my-lib --dry-run
+
+# Output to a specific directory
+diamond scaffold my-lib --output-dir ~/projects
+```
+
+---
+
+## `diamond list-templates`
+
+List all available templates with their descriptions.
+
+```bash
+diamond list-templates
+```
+
+---
+
+## `diamond validate`
+
+Validate a project directory against diamond-setup best practices.
+
+```
+Usage: diamond validate [PATH]
+
+Arguments:
+  PATH  Project directory to validate [default: current directory]
+```
+
+Checks performed:
+
+| Check | Level |
+|-------|-------|
+| `pyproject.toml` present | **Error** |
+| `src/` layout present | Warning |
+| `tests/` directory present | Warning |
+| `.github/workflows/` present | Warning |
+| `README.md` present | Warning |
+| `.gitignore` present | Warning |
+
+```bash
+# Validate the current directory
+diamond validate
+
+# Validate a specific project
+diamond validate path/to/my-project
+```
+
+---
+
+## `diamond version`
+
+Print the installed version.
+
+```bash
+diamond version
+```

medium_modulation-0.1.0/docs/index.md

@@ -0,0 +1,37 @@
+# Diamond Setup
+
+**Universal Python project scaffold** — generate professional, CI-ready project skeletons in seconds.
+
+No cookiecutter, no Jinja2, no magic. Just a clean CLI, sensible templates, and a validator that keeps your projects healthy.
+
+## Quickstart
+
+```bash
+pip install diamond-setup
+# or with uv:
+uv tool install diamond-setup
+```
+
+```bash
+diamond scaffold my-new-tool
+cd my-new-tool && uv sync --dev && uv run pytest
+```
+
+## Why Diamond Setup?
+
+| Feature | diamond-setup | cookiecutter | copier |
+|---------|:---:|:---:|:---:|
+| Zero config needed | ✅ | ❌ | ❌ |
+| Built-in validator | ✅ | ❌ | ❌ |
+| Pure Python templates | ✅ | ❌ | ❌ |
+| `--dry-run` support | ✅ | ❌ | ✅ |
+| Extensible presets | ✅ | ✅ | ✅ |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `diamond scaffold <name>` | Create a new project |
+| `diamond list-templates` | Show available templates |
+| `diamond validate [path]` | Check a project's health |
+| `diamond version` | Show version |

medium_modulation-0.1.0/docs/templates.md

@@ -0,0 +1,111 @@
+# Templates
+
+Diamond Setup ships two built-in templates. Adding your own is a single Python file.
+
+---
+
+## `minimal`
+
+**The default.** A clean, modern Python project with everything you need and nothing you don't.
+
+```bash
+diamond scaffold my-lib
+diamond scaffold my-lib --template minimal
+```
+
+### Files generated
+
+```
+my-lib/
+├── src/
+│   └── my_lib/
+│       └── __init__.py
+├── tests/
+│   ├── __init__.py
+│   └── test_main.py
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── pyproject.toml
+├── README.md
+├── .gitignore
+└── .pre-commit-config.yaml
+```
+
+### Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `name` | *(required)* | Project name |
+| `description` | `"A Python project"` | Short description |
+| `author` | `"Your Name"` | Author name |
+| `python_version` | `"3.11"` | Minimum Python version |
+
+---
+
+## `genesis`
+
+A superset of `minimal` — adds a `domains.yaml` for domain/metric configuration and an `entropy-table` YAML bridge module.
+
+```bash
+diamond scaffold my-physics-tool --template genesis
+```
+
+### Extra files
+
+```
+my-physics-tool/
+├── domains.yaml           ← domain/metric configuration
+├── config/
+│   └── entropy.yaml       ← entropy-table bridge config
+└── src/
+    └── my_physics_tool/
+        ├── __init__.py
+        └── bridge.py      ← entropy-table export function
+```
+
+### Extra variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `metrics` | `"crep"` | Default metrics identifier |
+
+---
+
+## Adding a Custom Template
+
+1. Create `src/diamond_setup/templates/my_template.py`:
+
+```python
+TEMPLATE = {
+    "name": "my_template",
+    "description": "My custom template",
+    "variables": ["name", "description", "author", "python_version"],
+    "defaults": {
+        "description": "My project",
+        "author": "Your Name",
+        "python_version": "3.11",
+    },
+    "files": {
+        "README.md": "# ${name}\n\n${description}\n",
+        "pyproject.toml": "...",
+        # keys are relative paths, values are template strings
+        # use ${variable} for substitution
+        # use $$ for a literal dollar sign
+    },
+}
+```
+
+2. Register it in `src/diamond_setup/templates/__init__.py`:
+
+```python
+from .my_template import TEMPLATE as MY_TEMPLATE
+
+REGISTRY: dict[str, dict] = {
+    "minimal": MINIMAL_TEMPLATE,
+    "genesis": GENESIS_TEMPLATE,
+    "my_template": MY_TEMPLATE,  # ← add this
+}
+```
+
+That's it. `diamond list-templates` will immediately show it.

medium_modulation-0.1.0/domains.yaml

@@ -0,0 +1,5 @@
+domains:
+  medium-modulation:
+    coupling_baseline: 0.618
+    resonance_peak: 1.618
+    modulation_depth_default: 0.5

medium_modulation-0.1.0/mkdocs.yml

@@ -0,0 +1,43 @@
+site_name: Diamond Setup
+site_description: Universal Python project scaffold — generate professional project skeletons in seconds
+site_author: GenesisAeon
+repo_url: https://github.com/GenesisAeon/diamond-setup
+repo_name: GenesisAeon/diamond-setup
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: indigo
+      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
+  - Templates: templates.md

medium_modulation-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[project]
+name = "medium-modulation"
+version = "0.1.0"
+description = "Resonant medium between S∝A and S∝V – fractal modulation operators, resonance spectra and tunable interference for controlled information propagation."
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [{name = "GenesisAeon Team", email = "team@genesisaeon.org"}]
+dependencies = [
+    "entropy-governance>=0.1.0",
+    "entropy-table>=1.0.1",
+    "implosive-genesis>=0.4.0",
+    "sympy>=1.13.0",
+    "typer>=0.15.0",
+    "numpy>=2.0.0",
+    "rich>=13.0.0"
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-cov>=5.0", "ruff>=0.9"]
+docs = ["mkdocs>=1.6.0", "mkdocs-material>=9.5.0"]
+
+[project.scripts]
+mm = "medium_modulation.cli:app"
+
+[project.urls]
+Repository = "https://github.com/GenesisAeon/medium-modulation"
+Issues = "https://github.com/GenesisAeon/medium-modulation/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/medium_modulation"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "I", "W", "UP", "C4", "SIM"]
+ignore = ["B008"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=medium_modulation --cov-report=term-missing -v"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"]

medium_modulation-0.1.0/src/medium_modulation/__init__.py

@@ -0,0 +1,7 @@
+"""medium-modulation: Resonant medium between S∝A and S∝V."""
+
+__version__ = "0.1.0"
+
+from .core import coupling_factor, modulated_entropy, resonance_spectrum
+
+__all__ = ["coupling_factor", "modulated_entropy", "resonance_spectrum"]