From 14654d6cab63ba15fd6e94289ac0e48b13815a03 Mon Sep 17 00:00:00 2001 From: kami Date: Fri, 28 Aug 2026 14:26:29 +0400 Subject: [PATCH 1/3] orchestra: TASK.md --- TASK.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 54 insertions(+), 4 deletions(-) diff --git a/TASK.md b/TASK.md index 87184e3..1ce3b8e 100644 --- a/TASK.md +++ b/TASK.md @@ -1,14 +1,64 @@ -# Task 06G4E6F69AKP2PA00S28D7ASBC +# Task 06G4FT0MB733H2ZCZ237WFHFD8 -Add a --quiet flag to the healthcheck script +Give the healthcheck a self-test and a machine-readable mode - Project: test-e2e -- Source: gitea:test-e2e/7 +- Source: gitea:test-e2e/10 - Priority: 0 ## Instructions -scripts/orchestra_e2e_healthcheck.sh already handles --help. Add a --quiet flag alongside it that suppresses the success line and still exits 0. Leave the default behaviour and the --help output unchanged. +Three pieces of work, in order. Plan them as exactly three phases in that order. + +## Phase 1 — a self-test for the healthcheck + +New file `scripts/orchestra_e2e_selftest.sh`, executable, `#!/usr/bin/env bash`. + +It runs `scripts/orchestra_e2e_healthcheck.sh`, then asserts: + +- exit status is 0 +- stdout contains `OK` + +On failure it prints which assertion failed and exits 1. On success it prints `selftest: ok` and exits 0. + +Verification for this phase is automated only. The one check is: + + - run: ["bash", "-n", "scripts/orchestra_e2e_selftest.sh"] + +Do not add a manual step to this phase. + +## Phase 2 — `--json` on the healthcheck + +`scripts/orchestra_e2e_healthcheck.sh --json` prints exactly one line: + + {"status":"ok","checks":1} + +and exits 0. Without `--json` the existing human output is unchanged, and `--help` keeps working. `--json` and `--help` together behave as `--help`. + +Verification for this phase must include both an automated check and a manual step. The JSON shape is a judgement a human confirms by reading it, so state the manual step as the exact command a human runs and the exact line they should see. + +## Phase 3 — teach the self-test about `--json` + +Extend `scripts/orchestra_e2e_selftest.sh` to run the healthcheck twice: once plain and once with `--json`. Assert the plain run still contains `OK`, and assert the `--json` run prints one line beginning with `{"status":`. + +Verification for this phase is automated only: + + - run: ["bash", "-n", "scripts/orchestra_e2e_selftest.sh"] + - run: ["bash", "scripts/orchestra_e2e_healthcheck.sh"] + +## Constraints + +The project's verification policy allows exactly two command shapes: + + ["bash", "-n", ""] + ["bash", "scripts/orchestra_e2e_healthcheck.sh"] + +A `run:` line outside those is refused when the plan seals, not later. + +## Research first + +Before planning, establish at least three findings and label their confidence honestly: at least one `fact`, one `inference`, and one `assumption`. The plan must cite at least two of them in References. + ## Completion -- 2.52.0 From 56d9b9acdd59ad3c7d9882ce6186d4304b9fb08b Mon Sep 17 00:00:00 2001 From: kami Date: Fri, 28 Aug 2026 14:32:34 +0400 Subject: [PATCH 2/3] orchestra: pre-release WIP snapshot (orchestra-06g4ft0mb733h2zcz237wfhfd8-b318f8b5) --- scripts/orchestra_e2e_healthcheck.sh | 8 +++++++ scripts/orchestra_e2e_selftest.sh | 34 ++++++++++++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100755 scripts/orchestra_e2e_selftest.sh diff --git a/scripts/orchestra_e2e_healthcheck.sh b/scripts/orchestra_e2e_healthcheck.sh index 5ebab4c..45536f2 100755 --- a/scripts/orchestra_e2e_healthcheck.sh +++ b/scripts/orchestra_e2e_healthcheck.sh @@ -2,6 +2,7 @@ main() { local quiet= + local json= for arg in "$@"; do if [ "$arg" = --help ]; then printf 'Usage: %s [--quiet]\n\n' "${0##*/}" @@ -11,9 +12,16 @@ main() { exit 0 elif [ "$arg" = --quiet ]; then quiet=1 + elif [ "$arg" = --json ]; then + json=1 fi done + if [ -n "$json" ]; then + printf '{"status":"ok","checks":1}\n' + exit 0 + fi + [ -n "$quiet" ] || printf 'OK - all healthchecks passed\n' exit 0 } diff --git a/scripts/orchestra_e2e_selftest.sh b/scripts/orchestra_e2e_selftest.sh new file mode 100755 index 0000000..10c4687 --- /dev/null +++ b/scripts/orchestra_e2e_selftest.sh @@ -0,0 +1,34 @@ +#!/usr/bin/env bash +# Self-test for the Orchestra E2E healthcheck. + +here=$(cd "$(dirname "$0")" && pwd) +healthcheck="$here/orchestra_e2e_healthcheck.sh" + +fail() { + printf 'selftest: FAILED %s\n' "$1" >&2 + exit 1 +} + +# plain run +out=$(bash "$healthcheck") +status=$? + +[ "$status" -eq 0 ] || fail "plain run exit status: want 0, got $status" +case "$out" in + *OK*) ;; + *) fail "plain run stdout contains OK: got '$out'" ;; +esac + +# --json run +jout=$(bash "$healthcheck" --json) +jstatus=$? + +[ "$jstatus" -eq 0 ] || fail "--json run exit status: want 0, got $jstatus" +jlines=$(printf '%s\n' "$jout" | wc -l) +[ "$jlines" -eq 1 ] || fail "--json run line count: want 1, got $jlines" +case "$jout" in + '{"status":'*) ;; + *) fail "--json run stdout prefix: want {\"status\": got '$jout'" ;; +esac + +printf 'selftest: ok\n' -- 2.52.0 From ba0e891348a5e2961e8b24def5dc6f31a0fda2b0 Mon Sep 17 00:00:00 2001 From: kami Date: Fri, 28 Aug 2026 14:37:09 +0400 Subject: [PATCH 3/3] orchestra: pre-release WIP snapshot (orchestra-06g4ft0mb733h2zcz237wfhfd8-b318f8b5) --- scripts/orchestra_e2e_selftest.sh | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/scripts/orchestra_e2e_selftest.sh b/scripts/orchestra_e2e_selftest.sh index 10c4687..f99d410 100755 --- a/scripts/orchestra_e2e_selftest.sh +++ b/scripts/orchestra_e2e_selftest.sh @@ -4,8 +4,11 @@ here=$(cd "$(dirname "$0")" && pwd) healthcheck="$here/orchestra_e2e_healthcheck.sh" +# fail : always echo what the healthcheck printed, +# so a red run is diagnosable without rerunning it by hand. fail() { printf 'selftest: FAILED %s\n' "$1" >&2 + printf 'selftest: healthcheck stdout was:\n%s\n' "$2" >&2 exit 1 } @@ -13,22 +16,22 @@ fail() { out=$(bash "$healthcheck") status=$? -[ "$status" -eq 0 ] || fail "plain run exit status: want 0, got $status" +[ "$status" -eq 0 ] || fail "plain run exit status: want 0, got $status" "$out" case "$out" in *OK*) ;; - *) fail "plain run stdout contains OK: got '$out'" ;; + *) fail "plain run stdout contains OK" "$out" ;; esac # --json run jout=$(bash "$healthcheck" --json) jstatus=$? -[ "$jstatus" -eq 0 ] || fail "--json run exit status: want 0, got $jstatus" +[ "$jstatus" -eq 0 ] || fail "--json run exit status: want 0, got $jstatus" "$jout" jlines=$(printf '%s\n' "$jout" | wc -l) -[ "$jlines" -eq 1 ] || fail "--json run line count: want 1, got $jlines" +[ "$jlines" -eq 1 ] || fail "--json run line count: want 1, got $jlines" "$jout" case "$jout" in '{"status":'*) ;; - *) fail "--json run stdout prefix: want {\"status\": got '$jout'" ;; + *) fail '--json run stdout prefix: want {"status":' "$jout" ;; esac printf 'selftest: ok\n' -- 2.52.0