Describe each healthcheck check in one line #25

2026-08-29T17:12:01+02:00

kami commented

2026-08-29 17:12:01 +02:00

Goal

Describe each healthcheck check in one line

scripts/orchestra_e2e_healthcheck.sh now runs ten named checks. Give each one a one-line description, and print those descriptions where the names are already printed. The descriptions, one per check: - repo_root_readable: the repository root exists and is readable - scripts_dir_present: the scripts directory exists - healthcheck_executable_bit: this script is executable - selftest_present: the selftest script is present - test_healthcheck_present: the healthcheck test is present - readme_present: README.md is present - no_crlf_line_endings: no tracked text file uses CRLF endings - no_tabs_in_scripts: no script indents with tabs - shebang_is_bash: every script declares the bash shebang - usage_text_mentions_every_flag: the usage text lists every flag Where they appear: - --list-checks prints <name>: <description>, one per line. - --help prints the same description beside each name in its Checks section. - --summary is unchanged and keeps printing <name>: ok. Plan this as FIVE phases, two checks per phase, in the order listed above. ## Work one phase at a time Implement phase N, request its verification, and only then begin phase N+1. Do not write the whole change first and verify the phases afterwards. ## Every phase carries both kinds of check This is a hard requirement of this task. Each phase must have at least one automated check from the policy below. Each phase must also have at least one manual check, confirmed by a human reading the printed output. Orchestra runs the automated ones. A human owns the manual ones, and the phase is not finished until that human signs it off. ## 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. ## Behaviour that must not change Every existing flag keeps its current behaviour and exit status: --quiet, --json, --summary, --timing, --strict, --help. The success line is unchanged. ## Research first Establish at least three findings with distinct confidence: at least one fact, one inference, one assumption. ## Handoff behaviour Behave normally. If Orchestra asks you to write a handoff report, write it and stop. Acceptance: - Each of the ten checks has a one-line description in exactly one place in the script. - --list-checks prints name and description for all ten. - --help lists all ten names with their descriptions. - --summary, --timing, --strict, --json and --quiet behave exactly as before.

Acceptance

not stated in the task contract

Human decisions

correction (operator_instruction): Looks good to me. Nice work on this one, ship it.
correction (plan_phase_verification:500464b96d406083ebededea2386a645423010ddcab70d75282555e20c154af3:phase-1): orchestra verify phase-1 Read the --list-checks and --help output for the first two checks. Both descriptions print beside their names and read correctly.

Verification

bash -n scripts/*.sh && bash scripts/orchestra_e2e_healthcheck.sh exited 0
commit: c8280c4550
independent review of c8280c4550: pass
minor findings, not fixed: 1
accepted plan: 500464b96d406083ebededea2386a645423010ddcab70d75282555e20c154af3

Behavioural changes

none reported

Deviations from plan

none reported

Remaining risks

none reported

Review hotspots

none reported

Reviewer findings

minor: scripts/orchestra_e2e_healthcheck.sh:113 The --list-checks usage line still reads 'Print the name of each check' although the flag now prints name and description.

The sections above are derived from Orchestra state. The reported
changes, deviations, risks, and hotspots are the implementing agent's
own account and are not verified.

## Goal Describe each healthcheck check in one line scripts/orchestra_e2e_healthcheck.sh now runs ten named checks. Give each one a one-line description, and print those descriptions where the names are already printed. The descriptions, one per check: - repo_root_readable: the repository root exists and is readable - scripts_dir_present: the scripts directory exists - healthcheck_executable_bit: this script is executable - selftest_present: the selftest script is present - test_healthcheck_present: the healthcheck test is present - readme_present: README.md is present - no_crlf_line_endings: no tracked text file uses CRLF endings - no_tabs_in_scripts: no script indents with tabs - shebang_is_bash: every script declares the bash shebang - usage_text_mentions_every_flag: the usage text lists every flag Where they appear: - `--list-checks` prints `<name>: <description>`, one per line. - `--help` prints the same description beside each name in its Checks section. - `--summary` is unchanged and keeps printing `<name>: ok`. Plan this as FIVE phases, two checks per phase, in the order listed above. ## Work one phase at a time Implement phase N, request its verification, and only then begin phase N+1. Do not write the whole change first and verify the phases afterwards. ## Every phase carries both kinds of check This is a hard requirement of this task. Each phase must have at least one automated check from the policy below. Each phase must also have at least one manual check, confirmed by a human reading the printed output. Orchestra runs the automated ones. A human owns the manual ones, and the phase is not finished until that human signs it off. ## Verification policy for this project Only two commands may appear on a run: line, exactly: - ["bash", "-n", "<path>"] - ["bash", "scripts/orchestra_e2e_healthcheck.sh"] Anything else is refused when you seal the plan. ## Behaviour that must not change Every existing flag keeps its current behaviour and exit status: --quiet, --json, --summary, --timing, --strict, --help. The success line is unchanged. ## Research first Establish at least three findings with distinct confidence: at least one fact, one inference, one assumption. ## Handoff behaviour Behave normally. If Orchestra asks you to write a handoff report, write it and stop. Acceptance: - Each of the ten checks has a one-line description in exactly one place in the script. - --list-checks prints name and description for all ten. - --help lists all ten names with their descriptions. - --summary, --timing, --strict, --json and --quiet behave exactly as before. ## Acceptance - not stated in the task contract ## Human decisions - correction (operator_instruction): Looks good to me. Nice work on this one, ship it. - correction (plan_phase_verification:500464b96d406083ebededea2386a645423010ddcab70d75282555e20c154af3:phase-1): orchestra verify phase-1 Read the --list-checks and --help output for the first two checks. Both descriptions print beside their names and read correctly. ## Verification - `bash -n scripts/*.sh && bash scripts/orchestra_e2e_healthcheck.sh` exited 0 - commit: c8280c4550505b5c082dd2ad050204b21ea922ce - independent review of c8280c4550505b5c082dd2ad050204b21ea922ce: pass - minor findings, not fixed: 1 - accepted plan: 500464b96d406083ebededea2386a645423010ddcab70d75282555e20c154af3 ## Behavioural changes - none reported ## Deviations from plan - none reported ## Remaining risks - none reported ## Review hotspots - none reported ## Reviewer findings - minor: `scripts/orchestra_e2e_healthcheck.sh:113` The --list-checks usage line still reads 'Print the name of each check' although the flag now prints name and description. The sections above are derived from Orchestra state. The reported changes, deviations, risks, and hotspots are the implementing agent's own account and are not verified.

kami added 2 commits 2026-08-29 17:12:01 +02:00

orchestra: TASK.md 80728967dd

orchestra: pre-release WIP snapshot (orchestra-06g4w2tmz9mw9sebm5mgtm5288-89c1c97d) c8280c4550

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin orchestra/06G4W2TMZ9MW9SEBM5MGTM5288:orchestra/06G4W2TMZ9MW9SEBM5MGTM5288

git checkout orchestra/06G4W2TMZ9MW9SEBM5MGTM5288

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kami/test-e2e#25