Upgrade auf v0.0.2

Diese Version vereinheitlicht den öffentlichen Mutation- und MCP-Vertrag. Aktualisieren Sie Clients und Deployments vor dem Rollout in einer Pilot-OU.

Mutation-Antworten sind jetzt Envelopes

Alle Mutation-Endpunkte, Template-Plan-/Mutation-Endpunkte, Resume und JSON-RPC Mutation-Methoden geben eine MutationEnvelope zurück. Parser dürfen nicht mehr von endpoint-spezifischen Legacy-Antwortformen ausgehen.

Verarbeiten Sie mindestens status, request_id, mutation_id, plan_id, summary, result, errors, next_actions und diagnostics. Fachliche Rejections antworten über HTTP mit 422 und einer Envelope mit status: "rejected"; JSON-RPC gibt sie innerhalb von result zurück. JSON-RPC-Protokoll-, Parameter-, Authentifizierungs- und Servicefehler bleiben im JSON-RPC error Envelope.

Zulässiger Detailgrad

response_detail akzeptiert nur noch standard und verbose. standard ist der Default. Der frühere Wert summary ist entfernt; debug ist reserviert und kein nutzbarer Request-Wert.

Kombinierte Mutation

POST /api/v1/mutations vergibt die mutation_id selbst. Verwenden Sie für sichere Wiederholungen Idempotency-Key, nicht eine erwartete, vom Client kontrollierte Mutation-ID. Der Key ist pro authentifiziertem Client, Endpoint und Request-Body gebunden.

Nur HTTP-JSON für Mutationen

adproxy-cli und HCL-Mutationsdateien werden nicht unterstützt. Verwenden Sie die HTTP-API, JSON-RPC oder JSONata-Templates. Templates rendern ebenfalls in den HTTP-Mutation-Request und liefern bei Plan/Mutation dieselbe Envelope.

Separater MCP Prozess

adproxy-server stellt kein /mcp bereit und lehnt mcp.enabled = true ab. Führen Sie MCP mit adproxy-mcp -config <mcp.hcl> aus. Jede HCL-Datei benötigt dennoch directory, snapshot und audit; halten Sie Server- und MCP-Dateien getrennt, wenn beide Prozesse laufen.

Vor dem Rollout prüfen

1. JSON-Parser auf MutationEnvelope und HTTP-422-Rejections umstellen.
2. Entfernte summary Response-Details aus Clients entfernen.
3. Kombinierte Retries auf Idempotency-Key umstellen.
4. Alte CLI- oder HCL-Mutationsaufrufe durch HTTP, JSON-RPC oder Templates ersetzen.
5. MCP als separaten Prozess mit eigener Konfiguration und eigenen Tokens betreiben.

Die vollständige Schlüsselreferenz steht unter Konfigurationsreferenz. MCP-spezifische Tool-Migrationen stehen unter AD MCP Upgrade v0.0.2.