chore(clickhouse): bring the ai_events satellite under declarative HCL (#67281)

Author: orian

posthog/clickhouse/hcl/check-live.sh

@@ -26,7 +26,7 @@ ENV="${VERIFY_LIVE_ENV:-local}"
 WARN="${VERIFY_LIVE_WARN:-0}"
 DUMPDIR="${1:-${LIVE_DUMP_DIR:?dump dir required (pass as arg1 or set LIVE_DUMP_DIR); run dump-live.sh first}}"
 
-ROLES=(ops logs)
+ROLES=(ops logs ai_events)
 
 # Object-name globs the gate ignores, parsed from exclude.hcl (the quoted glob
 # strings) — the same list dump-live.sh feeds hclexp -exclude, applied here to
@@ -86,5 +86,5 @@ if [ "$rc" -ne 0 ] && [ "$WARN" = "1" ]; then
   echo "check-live: drift detected (warn mode — not failing). Reconcile before enforcing."
   exit 0
 fi
-[ "$rc" -eq 0 ] && echo "check-live: OPS/LOGS live schema matches the HCL golden"
+[ "$rc" -eq 0 ] && echo "check-live: live schema matches the HCL golden for all managed roles"
 exit $rc

posthog/clickhouse/hcl/check.sh

@@ -26,7 +26,7 @@ MANIFEST="$HCL/nodes"
 #   - events_main / events_recent are Distributed proxies to the main events cluster
 #   - query_log_archive / writable_query_log_archive are Distributed over the OPS-only
 #     sharded_query_log_archive, which is absent from non-OPS (shared-only) compositions
-SKIP='custom_metrics,custom_metrics_backups,custom_metrics_dictionaries,custom_metrics_part_counts,custom_metrics_replication_queue,custom_metrics_server_crash,custom_metrics_table_sizes,custom_metrics_test,ops_query_log_archive_mv,events_main,events_recent,query_log_archive,writable_query_log_archive'
+SKIP='custom_metrics,custom_metrics_backups,custom_metrics_dictionaries,custom_metrics_part_counts,custom_metrics_replication_queue,custom_metrics_server_crash,custom_metrics_table_sizes,custom_metrics_test,ops_query_log_archive_mv,events_main,events_recent,query_log_archive,writable_query_log_archive,person,person_distinct_id2'
 
 rc=0
 while read -r env role layers; do

posthog/clickhouse/hcl/dump-live.sh

@@ -35,8 +35,9 @@ chmod 0755 "$OUTDIR" 2>/dev/null || true
 # Match the published ports in docker-compose.multinode-clickhouse.yml.
 #   role  default-host  default-port  default-db
 ROLES=(
-  "ops  localhost 9300 posthog"
-  "logs localhost 9500 posthog"
+  "ops       localhost 9300 posthog"
+  "logs      localhost 9500 posthog"
+  "ai_events localhost 9100 posthog"
 )
 
 # Pin to the same chschema build as bin/hclexp; override via repo variable.