medium-modulation 0.1.0__tar.gz → 1.0.0__tar.gz

medium_modulation-1.0.0/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

medium_modulation-1.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Report something that isn't working as expected
+title: "[BUG] "
+labels: bug
+assignees: ""
+---
+
+## Description
+
+A clear and concise description of the bug.
+
+## Steps to reproduce
+
+1. ...
+2. ...
+3. ...
+
+## Expected behavior
+
+What you expected to happen.
+
+## Actual behavior
+
+What actually happened (include full error messages / tracebacks if any).
+
+## Environment
+
+- Package version: (`pip show medium-modulation` or `git describe --tags`)
+- Python version:
+- OS:
+
+## Additional context
+
+Anything else relevant — logs, screenshots, related issues.

medium_modulation-1.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,29 @@
+---
+name: Feature request
+about: Suggest a new feature, module, or enhancement
+title: "[FEATURE] "
+labels: enhancement
+assignees: ""
+---
+
+## Summary
+
+A clear and concise description of the feature.
+
+## Motivation
+
+Why is this needed? What problem does it solve, or what new capability
+does it enable within the GenesisAeon ecosystem?
+
+## Proposed approach
+
+How might this be implemented? (Sketches, pseudocode, references to
+related GenesisAeon packages are welcome.)
+
+## Alternatives considered
+
+Any alternative approaches you've thought about.
+
+## Additional context
+
+Links to relevant papers, prior discussion, or related issues/PRs.

medium_modulation-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Summary
+
+What does this PR do, in one or two sentences?
+
+## Related issue(s)
+
+Closes #...
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change (public API)
+- [ ] Documentation
+- [ ] Tooling / CI / release process
+- [ ] Dependency update
+
+## Checklist
+
+- [ ] Tests added/updated and passing locally (`pytest`)
+- [ ] `CHANGELOG.md` updated under `## [Unreleased]`
+- [ ] Documentation updated (README, docstrings, notebooks if relevant)
+- [ ] If this touches scientific claims/predictions: sources cited and
+      speculative vs. validated status is clear
+
+## Additional notes
+
+Anything reviewers should know.

medium_modulation-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "master", "claude/**"]
+  pull_request:
+    branches: ["main", "master"]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff + mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+      - name: Run ruff
+        run: ruff check src tests
+      - name: Run mypy
+        run: mypy src
+
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run pytest with coverage
+        run: pytest --cov=src --cov-report=xml
+      - name: Upload coverage
+        if: matrix.python-version == '3.11'
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+
+  docs:
+    name: Docs (mkdocs --strict)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install docs dependencies
+        run: pip install -e ".[docs]"
+      - name: Build docs
+        run: mkdocs build --strict

medium_modulation-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,121 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+      - "v*.*.*-rc*"
+      - "v*.*.*-alpha*"
+      - "v*.*.*-beta*"
+
+permissions:
+  contents: write
+  id-token: write   # for PyPI trusted publishing, if configured
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade pip build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test:
+    name: Run test suite
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install package with dev/test extras
+        run: |
+          python -m pip install --upgrade pip
+          if python -c "import tomllib" 2>/dev/null; then :; fi
+          pip install -e ".[dev]" 2>/dev/null || pip install -e ".[test]" 2>/dev/null || pip install -e "."
+          pip install pytest pytest-cov
+
+      - name: Run tests
+        run: pytest -q || pytest -q --no-header
+
+  publish-canary:
+    name: Publish canary (TestPyPI + pre-release)
+    needs: [build, test]
+    if: contains(github.ref_name, '-rc') || contains(github.ref_name, '-alpha') || contains(github.ref_name, '-beta')
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+          skip-existing: true
+
+      - name: Create GitHub pre-release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          prerelease: true
+          generate_release_notes: true
+
+  publish-production:
+    name: Publish production (PyPI + release + Zenodo archive)
+    needs: [build, test]
+    if: ${{ !contains(github.ref_name, '-rc') && !contains(github.ref_name, '-alpha') && !contains(github.ref_name, '-beta') }}
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      # TODO: if this repo prefers PyPI Trusted Publishing (OIDC, no stored
+      # token), replace the `password:` line below with the trusted-publishing
+      # form of pypa/gh-action-pypi-publish.
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          prerelease: false
+          generate_release_notes: true
+
+      # NOTE: Zenodo archival of this GitHub Release happens automatically
+      # IF this repo has Zenodo-GitHub integration enabled at
+      # https://zenodo.org/account/settings/github/ (a per-repo, per-owner
+      # OAuth toggle on zenodo.org — cannot be set from a workflow file).
+      # Once enabled, every GitHub Release like this one mints/updates a
+      # Zenodo DOI automatically using the .zenodo.json metadata in this repo.

{medium_modulation-0.1.0 → medium_modulation-1.0.0}/.gitignore

@@ -1,22 +1,22 @@
-# Python
-__pycache__/
-*.py[cod]
-*.egg-info/
-.eggs/
-dist/
-build/
-.venv/
-.uv/
-
-# Testing
-.coverage
-htmlcov/
-.pytest_cache/
-
-# Docs
-site/
-
-# Editors
-.vscode/
-.idea/
-*.swp
+# 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 → medium_modulation-1.0.0}/.pre-commit-config.yaml

@@ -1,17 +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
+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-1.0.0/.zenodo.json

@@ -0,0 +1,33 @@
+{
+  "title": "medium-modulation — P-MEDIUM: Resonant medium between S∝A and S∝V – fractal modulation operators, resonance spectra and tunable interference for controlled information propagation.",
+  "description": "<p>Resonant medium between S∝A and S∝V – fractal modulation operators, resonance spectra and tunable interference for controlled information propagation.</p><p>Part of the <strong>GenesisAeon</strong> ecosystem (P-MEDIUM, domain: fractal modulation (S_A/S_V → coherent emergence)).</p><p>Dual-licensed: source code under GPL-3.0-or-later, documentation under CC BY 4.0.</p><p>See <a href=\"https://github.com/GenesisAeon/medium-modulation\">github.com/GenesisAeon/medium-modulation</a> for source, documentation, and reproducibility notebooks.</p>",
+  "creators": [
+    {
+      "name": "Römer, Johann",
+      "affiliation": "Independent Researcher / MOR Research Collective"
+    }
+  ],
+  "license": "GPL-3.0-or-later",
+  "upload_type": "software",
+  "access_right": "open",
+  "keywords": [
+    "GenesisAeon",
+    "P-MEDIUM",
+    "fractal modulation (S_A/S_V → coherent emergence)",
+    "UTAC",
+    "CREP",
+    "open science"
+  ],
+  "related_identifiers": [
+    {
+      "identifier": "10.5281/zenodo.19645351",
+      "relation": "isPartOf",
+      "resource_type": "publication-article",
+      "scheme": "doi"
+    }
+  ],
+  "version": "1.0.0",
+  "communities": [
+    { "identifier": "genesisaeon" }
+  ]
+}

medium_modulation-1.0.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [1.0.0] - 2026
+### Added
+- Initial v1.0.0 release as part of the GenesisAeon ecosystem-wide 1.0.0
+  milestone.
+- Standardized release tooling: `.zenodo.json`, GitHub Actions release
+  workflow (`.github/workflows/release.yml`), `RELEASE_GUIDE.md`,
+  `CONTRIBUTING.md`, issue/PR templates.
+
+### Changed
+- Project metadata (`pyproject.toml`) normalized: version bumped to
+  1.0.0, `requires-python`, and GenesisAeon-ecosystem dependency pins
+  updated to `entropy-governance>=1.0.0`, `entropy-table>=2.0.0`,
+  `implosive-genesis>=1.0.0`.
+- Re-licensed from MIT to a dual license: source code under
+  GPL-3.0-or-later, documentation under CC BY 4.0.

medium_modulation-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing
+
+Thanks for your interest in contributing to this GenesisAeon ecosystem
+package!
+
+## Getting started
+
+1. Fork and clone the repository.
+2. Create a virtual environment: `python -m venv .venv && source .venv/bin/activate`
+   (or `.venv\Scripts\activate` on Windows).
+3. Install in editable mode with dev dependencies:
+   `pip install -e ".[dev]"`.
+4. Run the test suite: `pytest`.
+
+## Code style
+
+- Format and lint with `ruff check` / `ruff format`.
+- Type-check with `mypy`.
+- Keep functions documented with docstrings (NumPy style, matching the
+  existing codebase).
+
+## Licensing of contributions
+
+This repository is dual-licensed: source code under GPL-3.0-or-later
+(see `LICENSE-CODE`), documentation under CC BY 4.0 (see `LICENSE-DOCS`).
+By submitting a pull request, you agree that your contribution is
+licensed under the same terms as the file(s) you are modifying.
+
+## Pull requests
+
+- One logical change per PR.
+- Add or update tests for any behavioral change.
+- Update `CHANGELOG.md` under an `## [Unreleased]` section.
+- Fill out the PR template (`.github/PULL_REQUEST_TEMPLATE.md`).
+
+## Reporting issues
+
+Please use the issue templates in `.github/ISSUE_TEMPLATE/` — they help us
+triage bug reports vs. feature requests quickly.
+
+## Scientific claims
+
+This is part of a research framework. If your contribution touches any
+scientific model, prediction, or benchmark (e.g. CREP `Γ` values, UTAC
+parameters, falsifiable predictions), please:
+- Cite the source (paper, dataset, or prior GenesisAeon Zenodo record).
+- Clearly mark speculative vs. validated claims.

medium_modulation-1.0.0/LICENSE

@@ -0,0 +1,12 @@
+This repository is dual-licensed:
+
+  - Source code (everything under src/, tests/, and other code files) is
+    licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).
+    See LICENSE-CODE for the full text.
+
+  - Documentation (README.md, README_QUICKSTART.md, docs/, and any
+    rendered MkDocs site) is licensed under the Creative Commons
+    Attribution 4.0 International License (CC BY 4.0).
+    See LICENSE-DOCS for the full text.
+
+Copyright (C) 2026 Johann Römer / GenesisAeon Project