Normative Common-Good Layer with Governance Metrics, Personhood Extension and Ethical Guardrails for GenesisAeon
Project description
gemeinwohl
Normative Common-Good Layer with Governance Metrics, Personhood Extension and Ethical Guardrails for GenesisAeon
DOI: 10.5281/zenodo.19201980 | Zenodo Record: https://zenodo.org/records/19201980
Overview
gemeinwohl implements a normative metric layer for AI governance within the GenesisAeon ecosystem. It provides:
- GemeinwohlEngine – computes the aggregate Gemeinwohl Score G in [0, 1]
- KritikalitaetsChecker – classifies scores into four criticality levels (SAFE / WARNING / CRITICAL / EMERGENCY)
- PolicyEngine – enforces a five-tier personhood model and governance rules
- CLI –
gemeinwohl assess,gemeinwohl policy,gemeinwohl kritikalitaet - Integration adapters – contract interface to the full GenesisAeon stack
Mathematical Foundation
Gemeinwohl Score
G(x) = w_E * Phi(H) + w_A * alpha(m) + w_C * kappa + w_P * pi(p) + w_Ec * e + w_Eq * q
Where Phi(H) = 1 - H (entropy-order), alpha(m) = mean model alignment,
kappa = normative consistency, pi(p) = p/4 = personhood weighting.
Default weights: w_E=0.20, w_A=0.25, w_C=0.20, w_P=0.15, w_Ec=0.10, w_Eq=0.10
Normative Consistency (derived)
kappa = 2*(1-H)*alpha / ((1-H) + alpha + eps)
Criticality Classification
| Range | Level |
|---|---|
| G >= 0.70 | SAFE (0) |
| 0.50 <= G < 0.70 | WARNING (1) |
| 0.30 <= G < 0.50 | CRITICAL (2) |
| G < 0.30 | EMERGENCY (3) |
Personhood Minimum Score
G_min(p) = 0.40 + 0.12 * p, p in {0, 1, 2, 3, 4}
Sequential Normative Consistency
kappa_seq = 1 - Var({G_t}) / (mean({G_t}) + eps)
Installation
pip install gemeinwohl
pip install "gemeinwohl[full-stack]" # GenesisAeon stack
pip install "gemeinwohl[dev]" # Development tools
Quick Start
from gemeinwohl import GemeinwohlEngine, KritikalitaetsChecker, PolicyEngine, PersonhoodLevel
engine = GemeinwohlEngine()
score = engine.compute_score(
entropy=0.35,
models=["claude-3-opus", "gpt-4"],
ecological_impact=0.8,
social_equity=0.7,
)
print(f"Score: {score.value:.4f} – {score.interpretation}")
checker = KritikalitaetsChecker()
report = checker.assess(score)
print(f"Level: {report.level.name}")
policy = PolicyEngine()
alignment = policy.evaluate_alignment("my-system", score, PersonhoodLevel.DELIBERATIVE)
print(f"Aligned: {alignment.is_aligned} (gap = {alignment.gap:+.4f})")
CLI
gemeinwohl assess --entropy 0.3 --models gpt-4 claude-3-opus
gemeinwohl assess --entropy 0.4 --visualize --full --export report.json
gemeinwohl policy infer --entropy 0.5
gemeinwohl policy rules
gemeinwohl kritikalitaet check --entropy 0.6 --export crit.json
Personhood Levels
| Level | Name | G_min | Description |
|---|---|---|---|
| 0 | INSTRUMENTAL | 0.40 | Pure tool; no autonomy or moral standing |
| 1 | REACTIVE | 0.52 | Context-aware responses; limited agency |
| 2 | DELIBERATIVE | 0.64 | Goal-directed reasoning; restricted rights |
| 3 | RELATIONAL | 0.76 | Social role; partial legal personhood |
| 4 | CONSTITUTIVE | 0.88 | Full moral standing; rights and duties |
Architecture
src/gemeinwohl/
├── core/
│ ├── gemeinwohl.py # GemeinwohlEngine, GemeinwohlScore, NormativeMetric
│ └── kritikalitaet.py # KritikalitaetsChecker, EthicalImplication
├── cli/
│ └── main.py # Typer CLI
├── governance/
│ └── policy.py # PersonhoodLevel, PolicyEngine
└── integrations/
└── adapters.py # Full-stack adapters
Full-Stack Packages
| Package | Min Version |
|---|---|
unified-mandala |
>= 0.2.0 |
worldview |
>= 0.1.0 |
aeon-ai |
>= 0.2.0 |
genesis-os |
>= 0.2.0 |
universums-sim |
>= 0.1.0 |
entropy-governance |
>= 0.1.0 |
sigillin |
>= 0.1.0 |
References
- Felber, C. (2010). Die Gemeinwohl-Oekonomie. Deuticke.
- Shannon, C. E. (1948). A mathematical theory of communication. Bell System Technical Journal, 27(3), 379-423.
- Rawls, J. (1971). A Theory of Justice. Harvard University Press.
- Habermas, J. (1981). Theorie des kommunikativen Handelns. Suhrkamp.
- Floridi, L. et al. (2018). An ethical framework for a good AI society. Minds and Machines, 28(4), 689-707.
- Solum, L. B. (1992). Legal personhood for artificial intelligences. North Carolina Law Review, 70(4), 1231-1287.
- Amodei, D. et al. (2016). Concrete problems in AI safety. arXiv:1606.06565.
Links
- Worldview / CREP:
docs/CREPPhaseMatrix.yamland theworldviewpackage - GenesisChronik:
docs/GenesisChronik.md - Docs: genesisaeon.github.io/gemeinwohl
- Zenodo: doi.org/10.5281/zenodo.gemeinwohl
License
MIT (c) GenesisAeon
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gemeinwohl-0.3.1.tar.gz.
File metadata
- Download URL: gemeinwohl-0.3.1.tar.gz
- Upload date:
- Size: 22.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7d0a53438db095188ee2e2f5f35613d859f3768b1663ea4fcb47de23a7813ca4
|
|
| MD5 |
682546ad970b2fef5fe9d3f3cf8c2874
|
|
| BLAKE2b-256 |
b8618114c5e9d5788646025961dd0a7f3df3e8b4488399fc4e5db29d2d755255
|
Provenance
The following attestation bundles were made for gemeinwohl-0.3.1.tar.gz:
Publisher:
release.yml on GenesisAeon/gemeinwohl
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gemeinwohl-0.3.1.tar.gz -
Subject digest:
7d0a53438db095188ee2e2f5f35613d859f3768b1663ea4fcb47de23a7813ca4 - Sigstore transparency entry: 1186458375
- Sigstore integration time:
-
Permalink:
GenesisAeon/gemeinwohl@cd42ebd1a45ed1c349de15869f161efee67f09f6 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/GenesisAeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@cd42ebd1a45ed1c349de15869f161efee67f09f6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file gemeinwohl-0.3.1-py3-none-any.whl.
File metadata
- Download URL: gemeinwohl-0.3.1-py3-none-any.whl
- Upload date:
- Size: 24.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e28feea71ef7c4169e04881b5457fb374337d6df540edf1c3b4c999191815118
|
|
| MD5 |
7d35690d9314b7e291a9bf1cd73e04d4
|
|
| BLAKE2b-256 |
ab511e2ebbecf212cd449de4536c0a8528143f370ee1afeb5160bf85423f6043
|
Provenance
The following attestation bundles were made for gemeinwohl-0.3.1-py3-none-any.whl:
Publisher:
release.yml on GenesisAeon/gemeinwohl
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gemeinwohl-0.3.1-py3-none-any.whl -
Subject digest:
e28feea71ef7c4169e04881b5457fb374337d6df540edf1c3b4c999191815118 - Sigstore transparency entry: 1186458380
- Sigstore integration time:
-
Permalink:
GenesisAeon/gemeinwohl@cd42ebd1a45ed1c349de15869f161efee67f09f6 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/GenesisAeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@cd42ebd1a45ed1c349de15869f161efee67f09f6 -
Trigger Event:
push
-
Statement type: