feat: Add PyPI and Zenodo integration files

- Add .zenodo.json for Zenodo metadata
- Add CITATION.cff for academic citations
- Add PyPI/Zenodo GitHub workflow
- Add release automation script
- Update MANIFEST.in to include new files

Author: fer

.github/workflows/pypi-zenodo.yml

@@ -0,0 +1,52 @@
+name: PyPI and Zenodo Integration
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      force_publish:
+        description: 'Force publish to PyPI'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  pypi-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write  # For trusted publishing to PyPI
+    
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build setuptools-scm[toml] twine
+    
+    - name: Build distribution
+      run: python -m build
+    
+    - name: Check distribution
+      run: python -m twine check dist/*
+    
+    - name: Publish to PyPI
+      if: github.event_name == 'release' || inputs.force_publish
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        verbose: true
+    
+    - name: Upload to Zenodo
+      if: github.event_name == 'release'
+      run: |
+        echo "Zenodo integration will be triggered automatically via GitHub-Zenodo webhook"
+        echo "Make sure Zenodo webhook is configured at https://zenodo.org/account/settings/github/"

.zenodo.json

@@ -0,0 +1,56 @@
+{
+  "title": "TNFR-Python-Engine: Resonant Fractal Nature Theory Implementation",
+  "description": "Canonical computational implementation of TNFR - a paradigm shift from modeling 'things' to modeling coherent patterns that persist through resonance. This Python package provides the complete TNFR physics engine including the 13 structural operators, unified grammar validation (U1-U6), and the four canonical structural fields (Φ_s, |∇φ|, K_φ, ξ_C). Features include: nodal equation dynamics (∂EPI/∂t = νf·ΔNFR), structural potential confinement, phase synchronization, and multi-scale coherence analysis.",
+  "creators": [
+    {
+      "name": "FMG",
+      "affiliation": "TNFR Research"
+    }
+  ],
+  "keywords": [
+    "TNFR",
+    "complex systems", 
+    "fractals",
+    "resonance",
+    "networks",
+    "structural dynamics",
+    "structural analysis",
+    "nodal equation",
+    "coherence",
+    "phase synchronization"
+  ],
+  "license": "MIT",
+  "upload_type": "software",
+  "access_right": "open",
+  "language": "eng",
+  "related_identifiers": [
+    {
+      "identifier": "https://github.com/fermga/TNFR-Python-Engine",
+      "relation": "isSupplementTo",
+      "resource_type": "software"
+    },
+    {
+      "identifier": "https://pypi.org/project/tnfr/",
+      "relation": "isIdenticalTo",
+      "resource_type": "software"
+    }
+  ],
+  "subjects": [
+    {
+      "term": "Complex Systems",
+      "scheme": "keyword"
+    },
+    {
+      "term": "Network Theory",
+      "scheme": "keyword"
+    },
+    {
+      "term": "Fractal Dynamics",
+      "scheme": "keyword"
+    },
+    {
+      "term": "Structural Analysis",
+      "scheme": "keyword"
+    }
+  ]
+}

CITATION.cff

@@ -0,0 +1,29 @@
+cff-version: 1.2.0
+title: "TNFR-Python-Engine: Resonant Fractal Nature Theory Implementation"
+message: "If you use this software, please cite it as below."
+type: software
+authors:
+  - given-names: "FMG"
+    family-names: ""
+    affiliation: "TNFR Research"
+repository-code: "https://github.com/fermga/TNFR-Python-Engine"
+url: "https://pypi.org/project/tnfr/"
+abstract: >-
+  Canonical computational implementation of TNFR - a paradigm shift from 
+  modeling 'things' to modeling coherent patterns that persist through resonance. 
+  This Python package provides the complete TNFR physics engine including the 
+  13 structural operators, unified grammar validation (U1-U6), and the four 
+  canonical structural fields (Φ_s, |∇φ|, K_φ, ξ_C).
+keywords:
+  - "TNFR"
+  - "complex systems"
+  - "fractals"
+  - "resonance"
+  - "networks"
+  - "structural dynamics"
+  - "nodal equation"
+  - "coherence"
+  - "phase synchronization"
+license: MIT
+version: "9.0.0"
+date-released: "2025-11-13"

scripts/release.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""
+Release automation script for TNFR-Python-Engine.
+
+This script helps automate the release process to PyPI and ensures
+all metadata is properly updated.
+"""
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+
+def run_command(cmd, cwd=None, check=True):
+    """Run a command and return the result."""
+    print(f"Running: {' '.join(cmd)}")
+    result = subprocess.run(cmd, cwd=cwd, capture_output=True, text=True)
+    if check and result.returncode != 0:
+        print(f"Error running command: {result.stderr}")
+        sys.exit(1)
+    return result
+
+
+def update_version_in_citation(version):
+    """Update version in CITATION.cff."""
+    citation_file = Path("CITATION.cff")
+    if citation_file.exists():
+        content = citation_file.read_text()
+        lines = content.split('\n')
+        for i, line in enumerate(lines):
+            if line.startswith('version:'):
+                lines[i] = f'version: "{version}"'
+                break
+        citation_file.write_text('\n'.join(lines))
+        print(f"Updated CITATION.cff with version {version}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Release TNFR to PyPI")
+    parser.add_argument("version", help="Version to release (e.g., 9.0.1)")
+    parser.add_argument("--dry-run", action="store_true", help="Perform a dry run")
+    parser.add_argument("--skip-tests", action="store_true", help="Skip running tests")
+    
+    args = parser.parse_args()
+    version = args.version
+    
+    # Ensure we're in the correct directory
+    if not Path("pyproject.toml").exists():
+        print("Error: Must be run from the project root directory")
+        sys.exit(1)
+    
+    print(f"Preparing release {version}")
+    
+    # Update version in citation file
+    update_version_in_citation(version)
+    
+    # Run tests unless skipped
+    if not args.skip_tests:
+        print("Running tests...")
+        run_command([sys.executable, "-m", "pytest", "tests/", "-x"])
+    
+    # Clean previous builds
+    print("Cleaning previous builds...")
+    run_command([sys.executable, "-c", "import shutil; shutil.rmtree('dist', ignore_errors=True)"])
+    run_command([sys.executable, "-c", "import shutil; shutil.rmtree('build', ignore_errors=True)"])
+    
+    # Build the package
+    print("Building package...")
+    run_command([sys.executable, "-m", "build"])
+    
+    # Check the distribution
+    print("Checking distribution...")
+    run_command([sys.executable, "-m", "twine", "check", "dist/*"])
+    
+    if args.dry_run:
+        print("Dry run complete. To actually release, run without --dry-run")
+        return
+    
+    # Create and push git tag
+    tag = f"v{version}"
+    print(f"Creating git tag {tag}")
+    run_command(["git", "tag", tag])
+    run_command(["git", "push", "origin", tag])
+    
+    # Upload to PyPI
+    print("Uploading to PyPI...")
+    run_command([sys.executable, "-m", "twine", "upload", "dist/*"])
+    
+    print(f"Successfully released version {version}")
+    print(f"PyPI: https://pypi.org/project/tnfr/{version}/")
+    print("GitHub Actions will handle Zenodo integration automatically.")
+
+
+if __name__ == "__main__":
+    main()