From 356489df54936934b915be74ee45c54c2c9a9f9d Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Tue, 9 Jun 2026 16:45:12 +0200
Subject: [PATCH] hack: add script to sync AI governance OpenAPI spec

Add hack/sync-governance-api.sh to re-vendor the AI Governance Policy API
spec from the private docker/governor-services repo. The vendored copy at
content/reference/api/ai-governance/api.yaml is a verbatim copy of upstream,
so the script fetches it via gh (using the caller's own auth, no repo
secrets) and prints a diff summary for review. Mirrors the existing
hack/sync-cli-docs.sh convention.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
---
 hack/sync-governance-api.sh | 55 +++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100755 hack/sync-governance-api.sh

diff --git a/hack/sync-governance-api.sh b/hack/sync-governance-api.sh
new file mode 100755
index 0000000000..601696737c
--- /dev/null
+++ b/hack/sync-governance-api.sh
@@ -0,0 +1,55 @@
+#!/bin/bash
+# Re-vendor the AI Governance OpenAPI spec from docker/governor-services.
+#
+# The spec at content/reference/api/ai-governance/api.yaml is a verbatim copy
+# of the upstream openapi.yaml — no transformation is applied. This script
+# fetches the latest version and overwrites the local copy, then prints a diff
+# summary so you can sanity-check before committing.
+#
+# Requires: gh (authenticated with access to the private docker/governor-services
+# repo). No secrets are stored in this repo — auth comes from your own gh login.
+#
+# Usage: hack/sync-governance-api.sh [ref]
+#   ref   optional git ref (branch, tag, or SHA). Defaults to the repo default branch.
+set -euo pipefail
+
+REPO="docker/governor-services"
+SRC_PATH="governor-service-api/openapi.yaml"
+DEST="content/reference/api/ai-governance/api.yaml"
+REF="${1:-}"
+
+# Resolve this repo's root so the script works from any working directory.
+ROOT="$(git -C "$(dirname "$0")" rev-parse --show-toplevel)"
+DEST_ABS="$ROOT/$DEST"
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "error: gh CLI not found. Install it and run 'gh auth login'." >&2
+  exit 1
+fi
+
+api_path="repos/$REPO/contents/$SRC_PATH"
+[ -n "$REF" ] && api_path="$api_path?ref=$REF"
+
+echo "Fetching $SRC_PATH from $REPO${REF:+@$REF}..."
+tmp="$(mktemp)"
+trap 'rm -f "$tmp"' EXIT
+
+if ! gh api "$api_path" --jq '.content' | base64 -d > "$tmp"; then
+  echo "error: failed to fetch spec. Check 'gh auth status' and repo access." >&2
+  exit 1
+fi
+
+if [ ! -s "$tmp" ]; then
+  echo "error: fetched spec is empty — aborting without overwriting $DEST." >&2
+  exit 1
+fi
+
+if diff -q "$DEST_ABS" "$tmp" >/dev/null 2>&1; then
+  echo "Already up to date — $DEST is identical to upstream."
+  exit 0
+fi
+
+cp "$tmp" "$DEST_ABS"
+echo "Updated $DEST. Review the change:"
+echo
+git -C "$ROOT" --no-pager diff --stat -- "$DEST"