pikasTech-unidesk/scripts/native/hwlab/runtime-gitops-verify.mjs

#!/usr/bin/env node
// SPEC: PJ2026-01060703 CI/CD branch follower runtime GitOps verify.
// Responsibility: fail publish before Argo when rendered runtime GitOps violates UniDesk overlay gates.
import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
import { createRequire } from "node:module";
import path from "node:path";

const requireFromScript = createRequire(import.meta.url);
const requireFromCwd = createRequire(path.join(process.cwd(), "package.json"));
const YAML = requireYaml();
const repoDir = process.cwd();
const overlay = readOverlay();
const runtimePath = requiredOverlayString("runtimePath");
const runtimeDir = path.resolve(repoDir, runtimePath);
const prometheusOperatorKinds = new Set(["ServiceMonitor", "PrometheusRule", "PodMonitor", "Probe"]);

if (!existsSync(runtimeDir)) {
  fail("runtime-path-missing", { runtimePath });
}

const checks = [];
if (overlay?.observability?.prometheusOperator === false) {
  checks.push("prometheus-operator-disabled");
  const refs = findPrometheusOperatorResources();
  if (refs.length > 0) fail("prometheus-operator-resource-present", { runtimePath, refs: refs.slice(0, 12), refCount: refs.length });
}
if (overlay?.codeAgentRuntime?.enabled && overlay.codeAgentRuntime.kafkaEventBridge?.enabled) {
  checks.push("code-agent-runtime-kafka-event-bridge-enabled");
  verifyTransactionalProjectionAuthority(overlay.codeAgentRuntime.kafkaEventBridge);
  verifyCodeAgentRuntimeWorkloads();
}

console.error(JSON.stringify({ event: "unidesk-runtime-gitops-verify", ok: true, runtimePath, checks }));

function findPrometheusOperatorResources() {
  const refs = [];
  for (const file of listYamlFiles(runtimeDir)) {
    const rel = path.relative(repoDir, file);
    for (const doc of splitYamlDocuments(readFileSync(file, "utf8"))) {
      refs.push(...prometheusOperatorResourceRefs(doc, rel));
    }
  }
  return refs;
}

function verifyTransactionalProjectionAuthority(kafka) {
  const expected = {
    directPublish: false,
    liveKafkaSse: false,
    kafkaRefreshReplay: false,
    transactionalProjector: true,
    projectionOutboxRelay: true,
    projectionRealtime: true,
  };
  const actual = Object.fromEntries(Object.keys(expected).map((name) => [name, kafka.features?.[name]]));
  const invalid = Object.entries(expected).filter(([name, value]) => actual[name] !== value).map(([name]) => name);
  if (invalid.length > 0) fail("kafka-event-bridge-authority-invalid", { invalid, expected, actual });
}

function verifyCodeAgentRuntimeWorkloads() {
  const expectedByWorkload = {
    "hwlab-cloud-api": {
      HWLAB_KAFKA_ENABLED: "true",
      HWLAB_KAFKA_AGENTRUN_EVENT_CONSUME_ENABLED: "true",
      HWLAB_KAFKA_DIRECT_PUBLISH_ENABLED: "false",
      HWLAB_WORKBENCH_LIVE_KAFKA_SSE_ENABLED: "false",
      HWLAB_WORKBENCH_KAFKA_REFRESH_REPLAY_ENABLED: "false",
      HWLAB_KAFKA_TRANSACTIONAL_PROJECTOR_ENABLED: "true",
      HWLAB_KAFKA_PROJECTION_OUTBOX_RELAY_ENABLED: "true",
      HWLAB_WORKBENCH_PROJECTION_REALTIME_ENABLED: "true",
    },
    "hwlab-cloud-web": {
      HWLAB_WORKBENCH_LIVE_KAFKA_SSE_ENABLED: "false",
      HWLAB_WORKBENCH_KAFKA_REFRESH_REPLAY_ENABLED: "false",
      HWLAB_WORKBENCH_PROJECTION_REALTIME_ENABLED: "true",
    },
  };
  const found = new Set();
  for (const file of listYamlFiles(runtimeDir)) {
    const rel = path.relative(repoDir, file);
    for (const document of parseStructuredDocuments(readFileSync(file, "utf8"), file)) {
      const items = isKubernetesList(document) ? document.items : [document];
      for (const item of items) {
        const workloadName = String(item?.metadata?.labels?.["app.kubernetes.io/name"] ?? item?.metadata?.name ?? "");
        const expected = expectedByWorkload[workloadName];
        if (!expected) continue;
        const container = item?.spec?.template?.spec?.containers?.find((candidate) => candidate?.name === workloadName);
        if (!container) fail("code-agent-runtime-container-missing", { file: rel, workload: workloadName, container: workloadName });
        if (!Array.isArray(container.env)) fail("code-agent-runtime-env-missing", { file: rel, workload: workloadName, container: workloadName });
        const actual = Object.fromEntries(container.env.filter((item) => typeof item?.name === "string").map((item) => [item.name, item.value]));
        const invalid = Object.entries(expected)
          .filter(([name, value]) => actual[name] !== value)
          .map(([name, value]) => ({ name, expected: value, actual: actual[name] ?? null }));
        if (invalid.length > 0) fail("code-agent-runtime-capability-env-invalid", { file: rel, workload: workloadName, container: workloadName, invalid });
        found.add(workloadName);
      }
    }
  }
  const missing = Object.keys(expectedByWorkload).filter((workloadName) => !found.has(workloadName));
  if (missing.length > 0) fail("code-agent-runtime-workload-missing", { runtimePath, missing });
}

function splitYamlDocuments(text) {
  return text.split(/^---[ \t]*(?:#.*)?$/mu).map((doc) => doc.trim()).filter(Boolean);
}

function prometheusOperatorResourceRefs(text, file) {
  const jsonRefs = prometheusOperatorJsonResourceRefs(text, file);
  if (jsonRefs !== null) return jsonRefs;
  const api = text.match(/^\s*apiVersion:\s*["']?(monitoring\.coreos\.com\/[^"'\s#]+)["']?\s*(?:#.*)?$/mu);
  const kind = text.match(/^\s*kind:\s*["']?([^"'\s#]+)["']?\s*(?:#.*)?$/mu);
  if (!api || !kind || !prometheusOperatorKinds.has(kind[1])) return [];
  const name = text.match(/^\s*name:\s*["']?([^"'\s#]+)["']?\s*(?:#.*)?$/mu);
  return [{ file, kind: kind[1], name: name ? name[1] : null, container: null }];
}

function prometheusOperatorJsonResourceRefs(text, file) {
  const parsed = parseJsonDocument(text);
  if (parsed === null) return null;
  const items = isKubernetesList(parsed) ? parsed.items : [parsed];
  return items.filter(isPrometheusOperatorResource).map((item) => ({
    file,
    kind: item.kind,
    name: typeof item.metadata?.name === "string" ? item.metadata.name : null,
    container: isKubernetesList(parsed) ? "List.items" : null,
  }));
}

function isPrometheusOperatorResource(value) {
  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
  return typeof value.apiVersion === "string"
    && value.apiVersion.startsWith("monitoring.coreos.com/")
    && typeof value.kind === "string"
    && prometheusOperatorKinds.has(value.kind);
}

function isKubernetesList(value) {
  return value
    && typeof value === "object"
    && !Array.isArray(value)
    && value.apiVersion === "v1"
    && value.kind === "List"
    && Array.isArray(value.items);
}

function parseJsonDocument(text) {
  const trimmed = text.trim();
  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
  try {
    return JSON.parse(trimmed);
  } catch {
    return null;
  }
}

function parseStructuredDocuments(text, file) {
  const json = parseJsonDocument(text);
  if (json !== null) return [json];
  const documents = YAML.parseAllDocuments(text);
  const errors = documents.flatMap((document) => document.errors);
  if (errors.length > 0) fail("runtime-yaml-invalid", { file: path.relative(repoDir, file), errors: errors.map((error) => error.message) });
  return documents.map((document) => document.toJS()).filter((document) => document !== null);
}

function listYamlFiles(root) {
  const out = [];
  for (const name of readdirSync(root)) {
    const file = path.join(root, name);
    const stat = statSync(file);
    if (stat.isDirectory()) {
      out.push(...listYamlFiles(file));
    } else if (/\.(ya?ml)$/u.test(name)) {
      out.push(file);
    }
  }
  return out.sort();
}

function readOverlay() {
  const file = process.env.UNIDESK_RUNTIME_GITOPS_OVERLAY_FILE;
  if (file) return JSON.parse(readFileSync(file, "utf8"));
  const encoded = process.env.UNIDESK_RUNTIME_GITOPS_OVERLAY_B64;
  if (!encoded) throw new Error("UNIDESK_RUNTIME_GITOPS_OVERLAY_FILE or UNIDESK_RUNTIME_GITOPS_OVERLAY_B64 is required");
  return JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
}

function requireYaml() {
  try {
    return requireFromScript("yaml");
  } catch {
    return requireFromCwd("yaml");
  }
}

function requiredOverlayString(name) {
  const value = overlay[name];
  if (typeof value !== "string" || value.length === 0) throw new Error(`overlay.${name} is required`);
  return value;
}

function fail(reason, extra = {}) {
  console.error(JSON.stringify({ event: "unidesk-runtime-gitops-verify", ok: false, reason, ...extra }));
  process.exit(48);
}