#!/usr/bin/env node // SPEC: PJ2026-01060703 CI/CD branch follower runtime GitOps postprocess. // Responsibility: mutate rendered runtime GitOps files after HWLAB source render, before publish. import { existsSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } 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)) { emit({ ok: false, reason: "runtime-path-missing", runtimePath }); process.exit(45); } const result = postprocessRuntimeGitops(); emit({ ok: true, runtimePath, ...result }); function postprocessRuntimeGitops() { const prometheusOperatorDisabled = overlay?.observability?.prometheusOperator === false; const changedFiles = []; const deletedFiles = []; for (const file of listYamlFiles(runtimeDir)) { const changed = prometheusOperatorDisabled ? stripPrometheusOperatorResourcesFromFile(file) : "unchanged"; if (changed === "deleted") deletedFiles.push(path.relative(repoDir, file)); if (changed === "changed") changedFiles.push(path.relative(repoDir, file)); } const kustomizationChanged = prometheusOperatorDisabled ? pruneMissingKustomizationResources() : false; const codeAgentRuntimeChanged = patchCodeAgentRuntimeWorkloads(); return { observabilityPrometheusOperator: overlay?.observability?.prometheusOperator ?? null, observabilityWorkloadsChanged: changedFiles.length > 0 || deletedFiles.length > 0, kustomizationChanged, codeAgentRuntimeChanged, changedFiles, deletedFiles, }; } function patchCodeAgentRuntimeWorkloads() { const runtime = overlay?.codeAgentRuntime; if (!runtime?.enabled || !runtime.kafkaEventBridge) return false; const kafka = runtime.kafkaEventBridge; let changed = false; for (const file of listYamlFiles(runtimeDir)) { const documents = parseStructuredDocuments(readFileSync(file, "utf8"), file); let fileChanged = false; for (const document of documents.values) { 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 containers = item?.spec?.template?.spec?.containers; if (!Array.isArray(containers)) continue; for (const container of containers) { if (!Array.isArray(container?.env)) continue; if (workloadName === "hwlab-cloud-api" && container.name === "hwlab-cloud-api") { fileChanged = patchCloudApiKafkaEnv(container, kafka) || fileChanged; } } } } if (fileChanged) { writeFileSync(file, serializeStructuredDocuments(documents), "utf8"); changed = true; } } return changed; } function patchCloudApiKafkaEnv(container, kafka) { let changed = false; changed = setEnvValue(container, "HWLAB_KAFKA_ENABLED", String(kafka.enabled)) || changed; changed = setEnvValue(container, "HWLAB_KAFKA_AGENTRUN_EVENT_CONSUME_ENABLED", String(kafka.enabled)) || changed; changed = setEnvValue(container, "HWLAB_KAFKA_PROJECTOR_GROUP_ID", String(kafka.transactionalProjectorConsumerGroupId)) || changed; changed = setEnvValue(container, "HWLAB_KAFKA_HWLAB_EVENT_GROUP_ID", String(kafka.hwlabEventConsumerGroupId)) || changed; changed = patchOptionalEnvGroup(container, kafka.enabled, { HWLAB_KAFKA_PROJECTOR_HEARTBEAT_INTERVAL_MS: kafka.transactionalProjector?.heartbeatIntervalMs, }) || changed; changed = patchOptionalEnvGroup(container, kafka.enabled, { HWLAB_KAFKA_OUTBOX_RELAY_INTERVAL_MS: kafka.projectionOutboxRelay?.intervalMs, HWLAB_KAFKA_OUTBOX_RELAY_BATCH_SIZE: kafka.projectionOutboxRelay?.batchSize, HWLAB_KAFKA_OUTBOX_RELAY_LEASE_MS: kafka.projectionOutboxRelay?.leaseMs, HWLAB_KAFKA_OUTBOX_RELAY_SEND_TIMEOUT_MS: kafka.projectionOutboxRelay?.sendTimeoutMs, HWLAB_KAFKA_OUTBOX_RELAY_RETRY_BACKOFF_MS: kafka.projectionOutboxRelay?.retryBackoffMs, }) || changed; changed = patchOptionalEnvGroup(container, kafka.enabled, { HWLAB_WORKBENCH_OUTBOX_TAIL_BATCH_SIZE: kafka.projectionRealtime?.outboxTailBatchSize, HWLAB_WORKBENCH_SSE_HEARTBEAT_MS: kafka.projectionRealtime?.sseHeartbeatMs, HWLAB_WORKBENCH_SSE_DRAIN_TIMEOUT_MS: kafka.projectionRealtime?.sseDrainTimeoutMs, }) || changed; return changed; } function patchOptionalEnvGroup(container, enabled, values) { let changed = false; for (const [name, value] of Object.entries(values)) { changed = enabled ? setEnvValue(container, name, String(value)) || changed : removeEnvValue(container, name) || changed; } return changed; } function setEnvValue(container, name, value) { const existing = container.env.find((item) => item?.name === name); if (existing?.value === value && existing.valueFrom === undefined) return false; if (existing) { existing.value = value; delete existing.valueFrom; } else { container.env.push({ name, value }); } return true; } function removeEnvValue(container, name) { const next = container.env.filter((item) => item?.name !== name); if (next.length === container.env.length) return false; container.env = next; return true; } function stripPrometheusOperatorResourcesFromFile(file) { const original = readFileSync(file, "utf8"); const jsonResult = stripPrometheusOperatorResourcesFromJsonFile(file, original); if (jsonResult !== null) return jsonResult; const docs = splitYamlDocuments(original); const nextDocs = docs.filter((doc) => !isPrometheusOperatorDocument(doc)); if (nextDocs.length === docs.length) return "unchanged"; if (nextDocs.length === 0) { unlinkSync(file); return "deleted"; } writeFileSync(file, `${nextDocs.map((doc) => doc.trimEnd()).join("\n---\n")}\n`, "utf8"); return "changed"; } function stripPrometheusOperatorResourcesFromJsonFile(file, text) { const parsed = parseJsonDocument(text); if (parsed === null) return null; const next = stripPrometheusOperatorResourcesFromJsonValue(parsed); if (!next.changed) return "unchanged"; if (next.value === null) { unlinkSync(file); return "deleted"; } writeFileSync(file, `${JSON.stringify(next.value, null, 2)}\n`, "utf8"); return "changed"; } function stripPrometheusOperatorResourcesFromJsonValue(value) { if (isPrometheusOperatorResource(value)) return { changed: true, value: null }; if (isKubernetesList(value)) { const originalItems = Array.isArray(value.items) ? value.items : []; const items = originalItems.filter((item) => !isPrometheusOperatorResource(item)); if (items.length !== originalItems.length) return { changed: true, value: { ...value, items } }; } return { changed: false, value }; } function pruneMissingKustomizationResources() { const file = path.join(runtimeDir, "kustomization.yaml"); if (!existsSync(file)) return false; const original = readFileSync(file, "utf8"); const lines = original.split(/\n/u); const next = []; let changed = false; let inResources = false; let resourcesIndent = 0; for (const line of lines) { const resourcesMatch = line.match(/^(\s*)resources:\s*(?:#.*)?$/u); if (resourcesMatch) { inResources = true; resourcesIndent = resourcesMatch[1].length; next.push(line); continue; } if (inResources && line.trim() !== "" && !line.match(/^\s*-/u) && leadingSpaces(line) <= resourcesIndent) inResources = false; if (inResources) { const item = line.match(/^(\s*)-\s+["']?([^"'#\s]+)["']?\s*(?:#.*)?$/u); if (item && !existsSync(path.resolve(runtimeDir, item[2]))) { changed = true; continue; } } next.push(line); } if (changed) writeFileSync(file, next.join("\n"), "utf8"); return changed; } function splitYamlDocuments(text) { return text.split(/^---[ \t]*(?:#.*)?$/mu).map((doc) => doc.trim()).filter(Boolean); } function isPrometheusOperatorDocument(text) { const api = text.match(/^\s*apiVersion:\s*["']?(monitoring\.coreos\.com\/[^"'\s#]+)["']?\s*(?:#.*)?$/mu); const kind = text.match(/^\s*kind:\s*["']?([^"'\s#]+)["']?\s*(?:#.*)?$/mu); return Boolean(api && kind && prometheusOperatorKinds.has(kind[1])); } 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 { format: "json", values: [json] }; const documents = YAML.parseAllDocuments(text); const errors = documents.flatMap((document) => document.errors); if (errors.length > 0) throw new Error(`invalid YAML in ${file}: ${errors.map((error) => error.message).join("; ")}`); return { format: "yaml", values: documents.map((document) => document.toJS()).filter((document) => document !== null) }; } function serializeStructuredDocuments(documents) { if (documents.format === "json") return `${JSON.stringify(documents.values[0], null, 2)}\n`; return `${documents.values.map((document) => YAML.stringify(document).trimEnd()).join("\n---\n")}\n`; } function leadingSpaces(value) { const match = value.match(/^ */u); return match ? match[0].length : 0; } 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 emit(fields) { console.error(JSON.stringify({ event: "unidesk-runtime-gitops-postprocess", ...fields })); }