Add complete universums-sim cosmic emergence simulation package

.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master, "claude/**"]
+  pull_request:
+    branches: [main, master]
+
+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: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e '.[dev]'
+
+      - name: Lint with ruff
+        run: ruff check src tests
+
+      - name: Type check with mypy
+        run: mypy src
+
+      - name: Run tests with coverage
+        run: |
+          pytest --cov=universums_sim --cov-report=xml --cov-fail-under=99 -x
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  docs:
+    name: Docs (mkdocs --strict)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install doc dependencies
+        run: |
+          pip install mkdocs mkdocs-material mkdocstrings[python] mkdocs-autorefs
+
+      - name: Build docs (strict)
+        run: mkdocs build --strict

.github/workflows/release.yml

@@ -0,0 +1,100 @@
+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
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install hatch build
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/universums-sim
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI (trusted publisher)
+        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
+
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/**
+          generate_release_notes: true
+
+  zenodo:
+    name: Zenodo Upload
+    needs: github-release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Validate .zenodo.json
+        run: python -c "import json; json.load(open('.zenodo.json'))"
+
+  deploy-docs:
+    name: Deploy documentation
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install doc dependencies
+        run: pip install mkdocs mkdocs-material mkdocstrings[python] mkdocs-autorefs
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

.gitignore

@@ -134,3 +134,16 @@ dist
 .yarn/build-state.yml
 .yarn/install-state.gz
 .pnp.*
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+.coverage
+coverage.xml
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.mypy_cache/
+.ruff_cache/

.zenodo.json

@@ -0,0 +1,36 @@
+{
+  "title": "universums-sim: Complete Cosmic Emergence Simulation for GenesisAeon",
+  "description": "universums-sim provides a complete PyPI package for cosmic emergence simulation with self-reflective observation and live visualization. Includes an extended Unified Lagrangian for N-body + field-theory dynamics, a symplectic leapfrog integrator, emergence event engine, entropy governance, live mandala visualization, 3D particle rendering, sonification, and a Dash GUI.",
+  "creators": [
+    {
+      "name": "GenesisAeon",
+      "affiliation": "GenesisAeon Research",
+      "orcid": ""
+    }
+  ],
+  "license": "MIT",
+  "version": "0.1.0",
+  "upload_type": "software",
+  "access_right": "open",
+  "keywords": [
+    "cosmology",
+    "simulation",
+    "emergence",
+    "quantum field theory",
+    "lagrangian mechanics",
+    "entropy",
+    "visualization",
+    "mandala",
+    "python",
+    "GenesisAeon"
+  ],
+  "related_identifiers": [
+    {
+      "identifier": "https://github.com/GenesisAeon/universums-sim",
+      "relation": "isSupplementTo",
+      "scheme": "url"
+    }
+  ],
+  "language": "eng",
+  "notes": "Built with the diamond-setup --template genesis pattern. Integrates genesis-os, aeon-ai, cosmic-web, fieldtheory, mirror-machine, advanced-weighting-systems, sigillin, entropy-governance, utac-core, mandala-visualizer, sonification, climate-dashboard, implosive-genesis, and entropy-table as optional [full-stack] dependencies."
+}