Prometheus
EN DE

Dokumentation · 07 / 09

Maintainers

Wer autorisiert ist, und welche Federation-Artefakte zwei Co-Signaturen aus verschiedenen Organisationen brauchen.

Quelle MAINTAINERS.mdLesezeit ~2 Min.

Diese Datei führt die aktuell autorisierten Maintainer des prometheus-project-Repos. Mindestens zwei Maintainer-DIDs aus unterschiedlichen Organisationen müssen folgende Federation-Artefakte co-signieren, bevor sie wirksam werden (concept/ADR-v2-0001, ADR-v2-0006):

  • mirrors.json im prometheus-federation-Repo
  • alias-table.json im prometheus-federation-Repo (ADR-v2-0008)
  • Release-Tags der Form proto-vX.Y.Z (dev-docs/adr-dev/ADR-DEV-0003)
  • Schema-Major-Bumps (submission.vN.json)

Aktive Maintainer#

HandleOrganisationDID (did:key:z…)Rolle
mortisnexus(initial bootstrap — Organisation noch unbestimmt)did:key:z<TODO-bootstrap-key>Tech-Lead, proto-Maintainer
<TODO-co-maintainer>(TODO — zweite Organisation Pflicht)did:key:z<TODO-second-key>Co-Signer-Pflicht für Federation-Artefakte

Stopp-Kriterium für Federation-Launch: Solange nur eine Maintainer-DID eingetragen ist, ist mirrors.json formal mit bootstrap_single_sig: true zu markieren (ADR-v2-0006), und Open-Data-Consumer dürfen warnen. Der zweite Co-Signer ist vor dem ersten produktiven Mirror-Launch (concept/06-offene-punkte.md P1-6 Bootstrap-Finanzierung + Multi-Org-Bindung) zu finden — Vorschläge gerne als Issue im Repo.

DID-Generierung (für neue Maintainer)#

Eine Maintainer-DID wird einmal pro Person erzeugt; der private Schlüssel verlässt nie den Maintainer-Host:

cd src/proto/crypto-py
. .venv/bin/activate
python3 -c "
from prometheus_proto import didkey, ed25519
priv, pub = ed25519.generate_keypair()
print('private (hex, KEEP SECRET):', priv.hex())
print('public  (hex):              ', pub.hex())
print('did:key:                    ', didkey.public_to_did(pub))
"

Den private-Wert in eine Datei unter ~/.config/prometheus/maintainer-keys/ mit chmod 600 legen, nicht im Repo speichern (das ist genau die Funktion von .secure/ in lokalen Klonen — und .secure/ ist gitignored, siehe .gitignore).

Rollen & Verantwortung#

RolleVerantwortung
Tech-LeadSchema-Drift, ADR-Review, Sprint-INDEX-Pflege, finale Architektur-Entscheidungen
Co-SignerMulti-Sig auf Federation-Artefakte (s. o.), unabhängiger Reality-Check bei kritischen ADRs
Sprint-OwnerPro Sprint (siehe sprints/) ein Owner-Hinweis im Sprint-Header; der Owner darf delegieren, bleibt aber bis zur Freigabe verantwortlich
Privacy-LeadWacht über k-Anon-Constraints, D-2-1-Re-Identifikations-Risiken (concept/03-risikoprofil.md), entscheidet über DP-Noise-Parameter ab Phase 2
Mirror-Operator-LiaisonSchnittstelle zu Mirror-Betreibern, owner der mirrors.json-Updates und AGB-Template-Versions

Aufnahme / Entlassung#

Neue Maintainer werden per Pull Request gegen diese Datei vorgeschlagen, mit folgendem Stand zum Zeitpunkt des PR-Merges:

  1. PR-Body enthält die neue DID, Handle, Organisation und Rollen-Wunsch.
  2. Zwei bestehende Maintainer co-signieren den Merge (über git-PGP oder ed25519-Detached-Signature auf den Commit-Hash, Resultat in .maintainers/ abgelegt — Verzeichnis-Layout in zukünftigem ADR-DEV-0004 zu fixieren).
  3. Innerhalb von 14 Tagen ein erfolgreicher Co-Sign auf das nächste Federation-Artefakt (Beweis der Reality-Check-Fähigkeit).

Entlassungen folgen demselben Pfad — PR + Co-Sign + öffentlicher Audit-Log-Eintrag (Sigstore Rekor).