From 0312dd9871a987a69d5042ce9c317702f58193a5 Mon Sep 17 00:00:00 2001 From: kami Date: Sat, 29 Aug 2026 19:49:37 +0400 Subject: [PATCH 1/2] orchestra: TASK.md --- TASK.md | 37 +++++++++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 10 deletions(-) diff --git a/TASK.md b/TASK.md index c450007..4bfc1d8 100644 --- a/TASK.md +++ b/TASK.md @@ -1,25 +1,42 @@ -# Task 06G4M6HF1Z3EREX1X3NEKSHP24 +# Task 06G4WDJ06G7FK00QF73Z9DDBT4 -Name the healthcheck success message once +Sort the check names in --list-checks - Project: test-e2e -- Source: burnin/run14-a +- Source: gitea:test-e2e/27 - Priority: 0 ## Instructions -scripts/orchestra_e2e_healthcheck.sh spells its success message inline. Give it a single named constant beside the existing VERSION constant and use that constant everywhere the message is printed. +`--list-checks` prints the ten check names in the order they run. Add a `--sorted` modifier that prints them in alphabetical order instead, leaving run order untouched. -Behaviour must not change. The plain run, --quiet and --help keep their current output and exit statuses, and scripts/test_healthcheck.sh keeps passing. +Plan this as THREE phases: + +1. A helper that returns the check names in alphabetical order, with no caller yet. +2. `--sorted` accepted alongside `--list-checks`, using that helper. Alone, `--sorted` changes nothing. +3. The usage text in `--help`, and assertions in scripts/test_healthcheck.sh for both orders. + +## Work one phase at a time + +Implement phase N, request its verification, and only then begin phase N+1. + +## Verification policy for this project + +Only two commands may appear on a run: line, exactly: + +- ["bash", "-n", ""] +- ["bash", "scripts/orchestra_e2e_healthcheck.sh"] + +Anything else is refused when you seal the plan. Give every phase at least one automated check from that list and at least one manual check. ## Research first -Establish at least three findings with distinct confidence: at least one `fact`, one `inference`, one `assumption`. +Establish at least three findings with distinct confidence: at least one fact, one inference, one assumption. - -## Quality gate - -bash -n scripts/*.sh && bash scripts/orchestra_e2e_healthcheck.sh +Acceptance: +- `--list-checks --sorted` prints the ten names alphabetically. +- `--list-checks` alone keeps run order. +- Every other flag is unchanged. ## Completion -- 2.52.0 From 49635d38e69ffb862ef3557588f4363d443b1f03 Mon Sep 17 00:00:00 2001 From: kami Date: Sat, 29 Aug 2026 20:09:03 +0400 Subject: [PATCH 2/2] orchestra: pre-release WIP snapshot (orchestra-06g4wdj06g7fk00qf73z9ddbt4-920248b2) --- scripts/orchestra_e2e_healthcheck.sh | 28 ++++++++++++++++++++++------ scripts/test_healthcheck.sh | 12 +++++++++++- 2 files changed, 33 insertions(+), 7 deletions(-) diff --git a/scripts/orchestra_e2e_healthcheck.sh b/scripts/orchestra_e2e_healthcheck.sh index f6fa7ee..a500c6e 100755 --- a/scripts/orchestra_e2e_healthcheck.sh +++ b/scripts/orchestra_e2e_healthcheck.sh @@ -76,7 +76,7 @@ emit() { # usage : the --help body. Also the source check_usage_text_mentions_every_flag # reads, so the flag list has exactly one home. usage() { - emit "$1" 'Usage: %s [--quiet] [--json] [--summary] [--timing] [--strict] [--list-checks]\n\n' "${0##*/}" + emit "$1" 'Usage: %s [--quiet] [--json] [--summary] [--timing] [--strict] [--list-checks] [--sorted]\n\n' "${0##*/}" emit "$1" 'Healthcheck script for Orchestra E2E tests.\n' emit "$1" 'Exits 0 with a success message if all checks pass.\n' emit "$1" ' --quiet Suppress the success message; still exits 0.\n' @@ -86,6 +86,7 @@ usage() { emit "$1" ' --timing Print elapsed milliseconds for the run.\n' emit "$1" ' --strict Reject an unrecognised flag: exits 2.\n' emit "$1" ' --list-checks Print the name of each check; exits 0.\n' + emit "$1" ' --sorted With --list-checks, list the names alphabetically.\n' emit "$1" '\nChecks:\n' local name for name in $CHECKS; do @@ -94,6 +95,12 @@ usage() { emit "$1" '\nVersion: %s\n' "$VERSION" } +# sorted_checks: the check names, one per line, in alphabetical order. +# LC_ALL=C keeps the order fixed if a name with a digit or capital is added. +sorted_checks() { + printf '%s\n' $CHECKS | LC_ALL=C sort +} + main() { local start_us start_us=$(now_us) @@ -103,16 +110,16 @@ main() { local timing= local strict= local unknown= + local list= + local sorted= for arg in "$@"; do if [ "$arg" = --help ]; then usage text exit 0 elif [ "$arg" = --list-checks ]; then - local listed - for listed in $CHECKS; do - emit text '%s\n' "$listed" - done - exit 0 + list=1 + elif [ "$arg" = --sorted ]; then + sorted=1 elif [ "$arg" = --quiet ]; then quiet=1 elif [ "$arg" = --json ]; then @@ -128,6 +135,15 @@ main() { fi done + if [ -n "$list" ]; then + if [ -n "$sorted" ]; then + sorted_checks + else + printf '%s\n' $CHECKS + fi + exit 0 + fi + if [ -n "$strict" ] && [ -n "$unknown" ]; then printf 'unknown flag: %s\n' "$unknown" >&2 exit 2 diff --git a/scripts/test_healthcheck.sh b/scripts/test_healthcheck.sh index 3b7cfea..68330e1 100755 --- a/scripts/test_healthcheck.sh +++ b/scripts/test_healthcheck.sh @@ -7,7 +7,7 @@ NAMES='repo_root_readable scripts_dir_present healthcheck_executable_bit selftest_present test_healthcheck_present readme_present no_crlf_line_endings no_tabs_in_scripts shebang_is_bash usage_text_mentions_every_flag' -USAGE="$(printf 'Usage: orchestra_e2e_healthcheck.sh [--quiet] [--json] [--summary] [--timing] [--strict] [--list-checks]\n\nHealthcheck script for Orchestra E2E tests.\nExits 0 with a success message if all checks pass.\n --quiet Suppress the success message; still exits 0.\n --json Print a single-line JSON result; still exits 0.\n --help Print this usage text and exit 0.\n --summary Print one line per check before the success message.\n --timing Print elapsed milliseconds for the run.\n --strict Reject an unrecognised flag: exits 2.\n --list-checks Print the name of each check; exits 0.\n\nChecks:\n repo_root_readable\n scripts_dir_present\n healthcheck_executable_bit\n selftest_present\n test_healthcheck_present\n readme_present\n no_crlf_line_endings\n no_tabs_in_scripts\n shebang_is_bash\n usage_text_mentions_every_flag\n\nVersion: 1.0.0')" +USAGE="$(printf 'Usage: orchestra_e2e_healthcheck.sh [--quiet] [--json] [--summary] [--timing] [--strict] [--list-checks] [--sorted]\n\nHealthcheck script for Orchestra E2E tests.\nExits 0 with a success message if all checks pass.\n --quiet Suppress the success message; still exits 0.\n --json Print a single-line JSON result; still exits 0.\n --help Print this usage text and exit 0.\n --summary Print one line per check before the success message.\n --timing Print elapsed milliseconds for the run.\n --strict Reject an unrecognised flag: exits 2.\n --list-checks Print the name of each check; exits 0.\n --sorted With --list-checks, list the names alphabetically.\n\nChecks:\n repo_root_readable\n scripts_dir_present\n healthcheck_executable_bit\n selftest_present\n test_healthcheck_present\n readme_present\n no_crlf_line_endings\n no_tabs_in_scripts\n shebang_is_bash\n usage_text_mentions_every_flag\n\nVersion: 1.0.0')" fails=0 check() { # check