beta-clustering-utac 1.0.0__tar.gz

beta_clustering_utac-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 beta-clustering-utac` or `git describe --tags`)
+- Python version:
+- OS:
+
+## Additional context
+
+Anything else relevant — logs, screenshots, related issues.

beta_clustering_utac-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 or Diamond Interface methods are welcome.)
+
+## Alternatives considered
+
+Any alternative approaches you've thought about.
+
+## Additional context
+
+Links to relevant papers, prior discussion, or related issues/PRs.

beta_clustering_utac-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,31 @@
+## Summary
+
+What does this PR do, in one or two sentences?
+
+## Related issue(s)
+
+Closes #...
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change (Diamond Interface or other 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 changes `run_cycle` / `get_crep_state` / `get_utac_state` /
+      `get_phase_events` / `to_zenodo_record`: noted as a breaking change
+      and version bump plan described above
+- [ ] If this touches scientific claims/predictions: sources cited and
+      speculative vs. validated status is clear
+
+## Additional notes
+
+Anything reviewers should know.

beta_clustering_utac-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 dev and docs dependencies
+        run: pip install -e ".[dev,docs]"
+      - name: Build docs
+        run: mkdocs build --strict

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

@@ -0,0 +1,79 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install build tools
+        run: pip install build
+      - name: Build wheel and sdist
+        run: python -m build
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}
+
+  publish-zenodo:
+    name: Publish to Zenodo
+    needs: github-release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Upload to Zenodo
+        run: |
+          echo "Zenodo upload triggered for tag ${{ github.ref_name }}"
+          echo "Configure ZENODO_TOKEN secret and zenodraft/action for automatic upload."
+        # Replace with actual zenodo-upload action when token is configured:
+        # uses: zenodraft/action@main
+        # with:
+        #   concept-doi: 10.5281/zenodo.XXXXXXXX  # <- enter your concept DOI
+        #   token: ${{ secrets.ZENODO_TOKEN }}

beta_clustering_utac-1.0.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

beta_clustering_utac-1.0.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

beta_clustering_utac-1.0.0/.zenodo.json

@@ -0,0 +1,43 @@
+{
+  "title": "beta-clustering-utac: β-Clustering over 78 Threshold Systems with Φ^(1/3) Inter-Cluster Scaling",
+  "version": "1.0.0",
+  "description": "Package 32 of the GenesisAeon Feldtheorie framework. Implements the full β-clustering analysis from UTAC v1.0: 78 threshold systems across astrophysics, climate, AI, biology, and neuroscience. Key finding: β clusters by domain (not universal convergence), with inter-cluster ratios following Φ^(1/3) ≈ 1.17480 scaling. Includes Diamond interface (run_cycle, get_crep_state, get_utac_state, get_phase_events, to_zenodo_record), CREP-bridge (β↔Γ), one-way ANOVA universality test, and MLE β-estimator.",
+  "creators": [
+    {
+      "name": "Römer, Johann",
+      "affiliation": "MOR Research Collective"
+    }
+  ],
+  "keywords": [
+    "beta-clustering",
+    "UTAC",
+    "threshold systems",
+    "golden ratio",
+    "phi scaling",
+    "CREP",
+    "GenesisAeon",
+    "complex systems",
+    "criticality",
+    "tipping points",
+    "phase transitions",
+    "universality"
+  ],
+  "license": "MIT",
+  "upload_type": "software",
+  "related_identifiers": [
+    {
+      "identifier": "10.5281/zenodo.17472834",
+      "relation": "isPartOf",
+      "scheme": "doi"
+    },
+    {
+      "identifier": "10.5281/zenodo.19645351",
+      "relation": "isDocumentedBy",
+      "scheme": "doi"
+    }
+  ],
+  "notes": "GenesisAeon Package 32. Φ^(1/3) ≈ 1.17480 as universal inter-cluster scaling exponent. Universality hypothesis rejected via one-way ANOVA (F >> 2.5). σ ≈ 2.2 emerges from β-distribution as CREP coupling constant.",
+  "communities": [
+    { "identifier": "genesisaeon" }
+  ]
+}

beta_clustering_utac-1.0.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# 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` (Zenodo community entry),
+  `RELEASE_GUIDE.md`, `CONTRIBUTING.md`, issue/PR templates.
+
+### Changed
+- Project metadata (`pyproject.toml`) corrected: `[project].name` now
+  reads `beta-clustering-utac` (previously `diamond-setup`, a leftover
+  from the bundled scaffold tool), description, authors, and project URLs
+  updated to match the actual package and its Zenodo DOI
+  (10.5281/zenodo.17472834).

beta_clustering_utac-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# 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 src tests`.
+- Type-check with `mypy src` (strict mode).
+- Keep functions documented with docstrings.
+
+## Diamond Interface
+
+This package implements the GenesisAeon Diamond Interface
+(`run_cycle`, `get_crep_state`, `get_utac_state`, `get_phase_events`,
+`to_zenodo_record`) in `src/beta_clustering/system.py`. Any change to
+these methods' signatures or return shapes is a **breaking change** and
+requires a MAJOR version bump (see `RELEASE_GUIDE.md`).
+
+## 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 the
+β-clustering model, the Φ^(1/3) scaling claim, or the CREP-bridge:
+- Cite the source (paper, dataset, or prior GenesisAeon Zenodo record).
+- Clearly mark speculative vs. validated claims.

beta_clustering_utac-1.0.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.

beta_clustering_utac-1.0.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: beta-clustering-utac
+Version: 1.0.0
+Summary: GenesisAeon Package 32 — beta-clustering over 78 threshold systems with Phi^(1/3) inter-cluster scaling; bundles the diamond-setup project scaffold tool
+Project-URL: Homepage, https://github.com/GenesisAeon/beta-clustering-utac
+Project-URL: Repository, https://github.com/GenesisAeon/beta-clustering-utac
+Project-URL: Documentation, https://genesisaeon.github.io/beta-clustering-utac
+Project-URL: Issues, https://github.com/GenesisAeon/beta-clustering-utac/issues
+Project-URL: Zenodo, https://doi.org/10.5281/zenodo.17472834
+Author: Johann Römer
+License: MIT
+License-File: LICENSE
+Keywords: CREP,GenesisAeon,UTAC,beta-clustering,criticality,phi-scaling,scaffold
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; 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
+
+# beta-clustering-utac
+
+**Package 32 — GenesisAeon Feldtheorie**
+
+[![CI](https://github.com/GenesisAeon/beta-clustering-utac/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/beta-clustering-utac/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)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.17472834-blue)](https://doi.org/10.5281/zenodo.17472834)
+[![Package](https://img.shields.io/badge/GenesisAeon-Package%2032-gold)](https://doi.org/10.5281/zenodo.17472834)
+
+β-Clustering über 78 Schwellensysteme aus Astrophysik, Klimaforschung, KI, Biologie und Neurowissenschaft. Kern-Ergebnis: **domänenspezifische β-Cluster** mit **Φ^(1/3) ≈ 1.174 Inter-Cluster-Skalierung**.
+
+---
+
+## Ergebnis
+
+```
+Domain          β-Zentrum   Beispiele
+─────────────────────────────────────────────────────
+climate         0.09        AMOC, Arktiseis, Amazon
+ecological      0.23        Korallenbleiche, Epidemien
+neural          0.50        Neurale Kritikalität, Anfälle
+astrophysical   0.90        Sternkollaps, AGN-Zündung
+ai              1.75        Grokking, LLM-Emergence
+
+Inter-Cluster-Ratio: β_(n+1)/β_n ≈ Φ^(1/3) ≈ 1.17480
+Universalitäts-Hypothese: ABGELEHNT (F-Test, α=0.05)
+```
+
+## Installation
+
+```bash
+pip install beta-clustering-utac
+```
+
+## Quickstart
+
+```bash
+uv sync
+uv run python -c "
+from beta_clustering import BetaClusteringUTAC
+s = BetaClusteringUTAC()
+r = s.run_cycle()
+print(f'Systeme: {r[\"n_systems\"]}')
+print(f'Φ^(1/3): {r[\"phi_cuberoot\"]:.5f}')
+print(f'Inter-Cluster-Ratio: {r[\"inter_cluster_ratio\"]:.4f}')
+print(f'Universalität abgelehnt: {r[\"universality_rejected\"]}')
+"
+```
+
+## Diamond Interface
+
+```python
+from beta_clustering import BetaClusteringUTAC
+
+system = BetaClusteringUTAC()
+
+# Vollständige Analyse
+result = system.run_cycle(n_systems=78)
+
+# CREP-Zustand
+crep = system.get_crep_state()   # {C, R, E, P, gamma}
+
+# UTAC-Zustand
+utac = system.get_utac_state()   # {H, K, r, sigma, beta_mean}
+
+# Phasenübergänge (Cluster-Grenzen)
+events = system.get_phase_events()
+
+# Zenodo-Metadaten
+record = system.to_zenodo_record()
+
+# Φ^(1/3) Skalierungsratio
+ratio = system.phi_scaling_ratio()  # ≈ 1.174
+
+# Domain-β-Karte
+mapping = system.domain_beta_map()  # {domain: beta_centre}
+```
+
+## Struktur
+
+```
+src/beta_clustering/
+├── system.py              # BetaClusteringUTAC — Diamond Interface
+├── constants.py           # Φ, Φ^(1/3), Domain-Cluster-Zentren
+├── beta_estimator.py      # MLE β-Schätzung aus Schwellendaten
+├── cluster_detector.py    # Domänenspezifische Cluster-Erkennung
+├── phi_scaling.py         # Φ^(1/3) Inter-Cluster-Analyse
+├── domain_mapper.py       # Domain → β-Cluster Mapping
+├── crep_bridge.py         # β ↔ Γ Beziehung (CREP-Kopplung)
+├── universality_test.py   # Einweg-ANOVA (Universalität vs. Domain-spez.)
+└── benchmark.py           # Validierung gegen UTAC v1.0 Targets
+```
+
+## Falsifizierbare Vorhersage
+
+Φ^(1/3)-Skalierung sollte halten, wenn neue Domains (seismisch, Quanten, zellulär) hinzugefügt werden. Jede Domain mit Inter-Cluster-Ratio signifikant ≠ 1.174 falsifiziert die Behauptung.
+
+## Tests & Qualität
+
+```bash
+uv run pytest                     # 27 Tests, 90% Coverage
+uv run mypy src/beta_clustering/  # Keine Fehler (strict mode)
+uv run ruff check .               # Keine Fehler
+```
+
+## Citation
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.PLACEHOLDER.svg)](https://doi.org/10.5281/zenodo.PLACEHOLDER)
+
+DOI will be assigned automatically on first GitHub Release once
+Zenodo–GitHub integration is enabled for this repo. Until then, cite the
+existing concept DOI above (`10.5281/zenodo.17472834`).
+
+```bibtex
+@software{roemer_beta_clustering_utac_2025,
+  author    = {Römer, Johann},
+  title     = {beta-clustering-utac: β-Clustering over 78 Threshold Systems},
+  year      = {2025},
+  publisher = {Zenodo},
+  doi       = {10.5281/zenodo.17472834},
+  url       = {https://doi.org/10.5281/zenodo.17472834},
+  version   = {1.0.0},
+  note      = {GenesisAeon Package 32 — MOR Research Collective}
+}
+```
+
+---
+
+Auch enthalten: `diamond-setup` — universales Python-Projekt-Scaffold. Siehe [`README_QUICKSTART.md`](README_QUICKSTART.md).
+
+---
+
+GenesisAeon · MOR Research Collective · Johann Römer · Mai 2026