From 5a222a717c594e4409a1db637a4c88cd90702de5 Mon Sep 17 00:00:00 2001 From: Brad Stein Date: Tue, 19 May 2026 21:16:53 -0300 Subject: [PATCH] ci(lesavka): document headless gate toggle --- docs/operational-env.md | 1 + scripts/ci/headless_run.sh | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/operational-env.md b/docs/operational-env.md index a1c1f31..5da010a 100644 --- a/docs/operational-env.md +++ b/docs/operational-env.md @@ -87,6 +87,7 @@ from `LESAVKA_CLIENT_PKI_SSH_SOURCE` over SSH. Runtime clients require the insta | `PROBE_EVENT_WIDTH_CODES` | manual client-to-RCT transport probe identity sequence; defaults to unique codes `1..16` so final RCT observations can be joined to client-origin timeline events after startup drops | | `LESAVKA_CLIENT_RELAYCTL_BIN_SRC` | test/build contract variable; not runtime operator config | | `LESAVKA_CLIENT_VIDEO_SUPPORT_SRC` | test/build contract variable; not runtime operator config | +| `LESAVKA_CI_HEADLESS_GTK` | CI toggle for wrapping GUI-adjacent gates in a virtual display on headless agents; set to `0` only when a real display is already available | | `LESAVKA_CI_PROFILE` | Jenkins/CI profile selector; `safe` runs non-disruptive gates, `daily` wraps primary-branch daily gates, and `lab` is reserved for isolated bare-metal probes | | `LESAVKA_COVERAGE_ENFORCE` | CI quality-gate toggle; when enabled, below-target coverage fails the Jenkins run instead of publishing observe-mode coverage telemetry | | `LESAVKA_CLIPBOARD_CHORD` | input routing/clipboard override | diff --git a/scripts/ci/headless_run.sh b/scripts/ci/headless_run.sh index a422709..96208b5 100755 --- a/scripts/ci/headless_run.sh +++ b/scripts/ci/headless_run.sh @@ -1,5 +1,6 @@ #!/usr/bin/env bash # Run GUI-adjacent CI commands safely on headless Jenkins agents. +set -euo pipefail lesavka_ci_run_headless() { local cmd=("$@")