{"id":46039656,"url":"https://github.com/anulum/scpn-phase-orchestrator","last_synced_at":"2026-03-07T08:00:37.359Z","repository":{"id":341321731,"uuid":"1169686203","full_name":"anulum/scpn-phase-orchestrator","owner":"anulum","description":"Domain-agnostic coherence control compiler built on Kuramoto/UPDE phase dynamics","archived":false,"fork":false,"pushed_at":"2026-03-04T04:44:26.000Z","size":1461,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-04T07:45:21.531Z","etag":null,"topics":["coherence-control","kuramoto","phase-dynamics","scpn","synchrony","upde"],"latest_commit_sha":null,"homepage":"https://anulum.github.io/scpn-phase-orchestrator","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anulum.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T03:42:28.000Z","updated_at":"2026-03-04T04:42:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/anulum/scpn-phase-orchestrator","commit_stats":null,"previous_names":["anulum/scpn-phase-orchestrator"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/anulum/scpn-phase-orchestrator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anulum%2Fscpn-phase-orchestrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anulum%2Fscpn-phase-orchestrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anulum%2Fscpn-phase-orchestrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anulum%2Fscpn-phase-orchestrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anulum","download_url":"https://codeload.github.com/anulum/scpn-phase-orchestrator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anulum%2Fscpn-phase-orchestrator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30111779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coherence-control","kuramoto","phase-dynamics","scpn","synchrony","upde"],"created_at":"2026-03-01T06:07:08.830Z","updated_at":"2026-03-05T06:00:54.631Z","avatar_url":"https://github.com/anulum.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SCPN Phase Orchestrator\n\nDomain-agnostic coherence control compiler built on Kuramoto/UPDE phase dynamics.\n\n[![CI](https://github.com/anulum/scpn-phase-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/anulum/scpn-phase-orchestrator/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/scpn-phase-orchestrator)](https://pypi.org/project/scpn-phase-orchestrator/)\n[![Docs](https://img.shields.io/badge/docs-gh--pages-blue)](https://anulum.github.io/scpn-phase-orchestrator/)\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\n![Synchronization Manifold](docs/assets/synchronization_manifold.png)\n\n## What It Does\n\nTreats Kuramoto phase dynamics as a universal synchrony state-space.\nAny hierarchical coupled-cycle system — plasma, cloud infrastructure,\ntraffic, power grids, factories, biology — maps onto the same engine.\n\n## Core Pipeline\n\n```\nDomain Binder → Oscillator Extractors (P/I/S) → UPDE Engine → Supervisor → Actuation Mapper\n```\n\n### 3-Channel Oscillator Model\n\n| Channel | Source | Phase Extraction |\n|---------|--------|-----------------|\n| **Physical (P)** | Continuous waveforms | Hilbert transform, zero-crossing |\n| **Informational (I)** | Event/decision streams | Event-phase from message timing |\n| **Symbolic (S)** | Discrete state sequences | Ring-phase θ=2πs/N, graph-walk |\n\n### 4 Universal Control Knobs\n\n| Knob | Meaning |\n|------|---------|\n| **K** | Coupling strength (Knm matrix) |\n| **α** | Phase lag (transport/actuator delays) |\n| **ζ** | Driver strength (external forcing) |\n| **Ψ** | Reference phase (control target) |\n\n### Dual Objective\n\n- **R_good**: Coherence to maintain (actuator ↔ target phase-lock)\n- **R_bad**: Coherence to suppress (harmful mode-locking)\n\n## Quickstart\n\n```bash\npip install -e \".[dev]\"\n\n# Validate a domain binding spec\nspo validate domainpacks/minimal_domain/binding_spec.yaml\n\n# Run a domain simulation\nspo run domainpacks/queuewaves/binding_spec.yaml --steps 1000\n\n# Replay from audit log\nspo replay audit.jsonl --output report.json\n```\n\n## Platform Support\n\n| Platform | Python engine | Rust FFI (optional) |\n|----------|--------------|---------------------|\n| Linux | Full | Full |\n| macOS | Full | Full |\n| Windows | Full | Experimental (requires MSVC toolchain) |\n\nThe PyPI package is pure Python. Rust FFI provides optional acceleration\nand is built from source via `maturin develop`.\n\n## Domainpacks\n\n| Pack | Domain | Purpose |\n|------|--------|---------|\n| `bio_stub` | Biology | Multi-scale biological oscillators (4 layers, 16 oscillators) |\n| `cardiac_rhythm` | Cardiology | Gap-junction coupling, arrhythmia (4 layers, 10 oscillators) |\n| `chemical_reactor` | Process control | Hopf bifurcation, Semenov limit (4 layers, 10 oscillators) |\n| `circadian_biology` | Chronobiology | SCN clock-gene coupled oscillators (4 layers, 10 oscillators) |\n| `epidemic_sir` | Epidemiology | Epidemic wave synchronisation (3 layers, 8 oscillators) |\n| `firefly_swarm` | Ecology | Flash synchronisation, Mirollo-Strogatz (2 layers, 8 oscillators) |\n| `fusion_equilibrium` | Fusion equilibrium | Grad-Shafranov + FusionCoreBridge (6 layers, 12 oscillators) |\n| `geometry_walk` | Graph systems | Random-walk phase coupling (2 layers, 8 oscillators) |\n| `laser_array` | Photonics | Semiconductor laser phase-locking (3 layers, 8 oscillators) |\n| `manufacturing_spc` | Manufacturing | Statistical process control (3 layers, 9 oscillators) |\n| `metaphysics_demo` | P/I/S showcase | Imprint + geometry ablation (3 layers, 7 oscillators) |\n| `minimal_domain` | Synthetic | Minimal-but-complete pipeline example (2 layers, 4 oscillators) |\n| `neuroscience_eeg` | Neuroscience | EEG band-\u003ephase, seizure detection (6 layers, 14 oscillators) |\n| `plasma_control` | Tokamak plasma | MHD/transport multi-scale control (8 layers, 16 oscillators) |\n| `pll_clock` | Telecommunications | PLL network clock synchronisation (3 layers, 8 oscillators) |\n| `power_grid` | Power systems | Swing equation = Kuramoto (5 layers, 12 oscillators) |\n| `quantum_simulation` | Quantum computing | Qubit register phase coupling (3 layers, 8 oscillators) |\n| `queuewaves` | Cloud/queues | Retry storm desynchronisation (3 layers, 6 oscillators) |\n| `rotating_machinery` | Vibration | Harmonics, ISO 10816 boundaries (4 layers, 10 oscillators) |\n| `swarm_robotics` | Robotics | Vicsek collective motion (3 layers, 8 oscillators) |\n| `traffic_flow` | Transportation | Signal coordination = phase sync (4 layers, 10 oscillators) |\n\n### Adding a Domain\n\n1. Create `domainpacks/\u003cname\u003e/binding_spec.yaml` declaring layers,\n   oscillator families, coupling, drivers, objectives, and boundaries.\n2. Optionally add `policy.yaml` for declarative supervisor rules.\n3. Validate: `spo validate domainpacks/\u003cname\u003e/binding_spec.yaml`\n4. Run: `spo run domainpacks/\u003cname\u003e/binding_spec.yaml --steps 1000`\n\nSee [`metaphysics_demo`](domainpacks/metaphysics_demo/) for a full\nexample exercising all three channels, imprint modulation, geometry\nprojection, and policy-driven control.  Spec format reference:\n[binding_spec.schema.json](docs/specs/binding_spec.schema.json).\n\n## Development\n\n```bash\npip install -e \".[dev]\"\nruff check src/ tests/\nruff format --check src/ tests/\npytest tests/ -v --tb=short\nmkdocs build\n```\n\n## License\n\nAGPL-3.0-or-later. Commercial licensing available — contact protoscience@anulum.li.\n\n## Citation\n\nSee [CITATION.cff](CITATION.cff).\n\n---\n\n© 1998–2026 Miroslav Šotek. All rights reserved.\nContact: www.anulum.li | protoscience@anulum.li\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanulum%2Fscpn-phase-orchestrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanulum%2Fscpn-phase-orchestrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanulum%2Fscpn-phase-orchestrator/lists"}