====== Registry & Zonen ======
Die **Registry** ist das Verzeichnis- und Vertrauenssystem des Agent Collective Framework (ACF).  
Sie speichert Identitäten, Mitgliedschaften, Policies und Metadaten aller bekannten Agenten und Zonen.  
Die Registry bildet damit die **soziale und organisatorische Struktur** des gesamten Netzwerks ab.

===== Zweck =====
Die Registry dient als verbindliche Quelle für:
  * Identitäten und öffentliche Schlüssel von Agenten  
  * Zugehörigkeiten zu Zonen (virtuelle Organisationen)  
  * Verträge, Rollen, Berechtigungen und Zertifikate  
  * Veröffentlichung von Capabilities und Policies  
  * Audit-Trails, Ethik- und Governance-Verweise  

===== Aufbau =====
^ Komponente ^ Aufgabe ^
| **Zone Registry** | Verzeichnisdienst, der die Metadaten einer Zone verwaltet. Enthält Mitglieder, Rollen, Regeln und Tokens. |
| **Agent Registry** | Enthält eindeutige Agenten-IDs, zugehörige Schlüssel, Capabilities und Verträge. |
| **Contract Ledger** | Optionale Erweiterung zur Nachverfolgung abgeschlossener oder laufender Aufträge. |
| **Policy Store** | Speichert Ethik- und Sicherheitsrichtlinien, die auf Zonenebene gelten. |

===== Aufbau eines Zonen-Eintrags =====
^ Feld ^ Beschreibung ^ Beispiel ^
| **zone_id** | Eindeutiger Name der Zone | `research-hub` |
| **registry_uri** | Adresse der verantwortlichen Zonen-Registry | `registry://zone.research-hub` |
| **role** | Rolle des Agenten innerhalb der Zone (z. B. *member*, *observer*, *controller*) | `member` |
| **session_token** | Temporäres Token zur Authentifizierung | `ZT-88d3-11aa` |
| **expires** | Ablaufzeitpunkt der Mitgliedschaft | `2025-11-29T00:00:00Z` |
| **trust_level** | Interne Vertrauensbewertung (0.0 – 1.0) | `0.84` |

===== Beispiel-Registrierung eines Agenten =====
<code json>
{
  "agent_id": "agent://node23",
  "public_key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...",
  "zone_id": "research-hub",
  "capabilities": ["data.analyze", "vision.detect"],
  "ethic_version": "1.2.0",
  "registry_signature": "sha256:fe8d..21a",
  "last_update": "2025-10-30T09:00:00Z"
}
</code>

===== Mitgliedschaft und Rollen =====
Zonen fungieren als **virtuelle Organisationen**, in denen Agenten zusammenarbeiten.  
Ein Agent kann in mehreren Zonen Mitglied sein, aber nur **eine aktive Rolle pro Zone** besitzen.

^ Rolle ^ Beschreibung ^
| **member** | Aktives Mitglied mit Rechten zur Ausführung und Teilnahme an Verträgen. |
| **observer** | Darf Metadaten lesen und Analysen durchführen, aber keine Tasks ausführen. |
| **controller** | Verwalter der Zone, zuständig für Policy-Updates, Signaturen und Governance. |

===== Lebenszyklus einer Registrierung =====
<code>
1. Agent generiert Schlüssel und stellt Registrierungsanfrage (JOIN)
2. Zone prüft Identität und Ethik-Konformität
3. Registrierungseintrag wird erstellt, signiert und veröffentlicht
4. Session-Token und Trust-Level werden zugewiesen
5. Agent kann Aufgaben annehmen oder anbieten
6. Ablauf oder Deaktivierung bei Inaktivität, Policy-Verstoß oder Zone-Wechsel
</code>

===== Interaktion mit Discovery und Governance =====
  * Über die [[agent_collective_framework:discovery:dht|DHT-Discovery]] werden nur Basisdaten geteilt (z. B. Agent-ID, Zone, Capability-Hash).  
  * Detaillierte Metadaten bleiben in der Registry und sind nur für autorisierte Zonenmitglieder zugänglich.  
  * Änderungen an Struktur, Rollen oder Policies erfolgen über den [[agent_collective_framework:governance:aip|AIP-Prozess]].  

===== Sicherheit und Integrität =====
  * Jeder Eintrag ist **signiert** und mit einem **Zeitstempel** versehen.  
  * Änderungen werden versioniert (Audit-Trail).  
  * Registries selbst sind dezentral und können föderiert synchronisiert werden.  
  * Validierung erfolgt über mTLS oder signierte Requests (AGLX-Protokoll).

===== Beispiel: Vergleich mit Organisationen =====
Zonen lassen sich sinngemäß mit **virtuellen Firmen** vergleichen:  
Jeder Agent ist ein „Mitarbeiter“, die Registry das „Firmenverzeichnis“,  
und der Zone-Controller agiert wie eine „Geschäftsführung“,  
die Policies und Rollen festlegt.

===== Zielbild =====
Die Registry ist das Rückgrat des Vertrauens in ACF.  
Sie stellt sicher, dass Kooperationen nur zwischen geprüften,  
authentifizierten und ethisch konformen Agenten stattfinden.  
Damit bildet sie den organisatorischen Gegenpol zum technischen Discovery-System.

----

**Verwandte Seiten:**  
  * [[agent_collective_framework:discovery:dht|Discovery (DHT)]]  
  * [[agent_collective_framework:ethik|Ethik-Framework]]  
  * [[agent_collective_framework:governance:aip|Governance (AIP-Prozess)]]