Run a single named check with --only #26

Open
opened 2026-08-29 17:16:38 +02:00 by claude · 1 comment
Contributor

Give scripts/orchestra_e2e_healthcheck.sh a --only <name> flag that runs a single named check instead of all ten, then prints the usual success line.

Behaviour:

  • --only repo_root_readable runs that check alone and exits 0 when it passes.
  • --only nonsense prints unknown check: nonsense on stderr and exits 2.
  • --only composes with --summary, --json and --quiet, each keeping its current shape over the single result.
  • Without --only, every existing flag behaves exactly as it does today.

Plan this as FIVE phases:

  1. A helper that resolves a name to a check function and reports whether the name is known.
  2. Flag parsing for --only <name>, with the unknown-name refusal and exit 2.
  3. Running the single resolved check and recording its result through the existing results state.
  4. Composition with --summary and --json.
  5. The usage text in --help, and assertions in scripts/test_healthcheck.sh for each behaviour 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.

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:

  • --only <name> runs exactly one check.
  • An unknown name exits 2 with a message on stderr.
  • --only composes with --summary, --json and --quiet.
  • Every existing flag is unchanged when --only is absent.
Give scripts/orchestra_e2e_healthcheck.sh a `--only <name>` flag that runs a single named check instead of all ten, then prints the usual success line. Behaviour: - `--only repo_root_readable` runs that check alone and exits 0 when it passes. - `--only nonsense` prints `unknown check: nonsense` on stderr and exits 2. - `--only` composes with `--summary`, `--json` and `--quiet`, each keeping its current shape over the single result. - Without `--only`, every existing flag behaves exactly as it does today. Plan this as FIVE phases: 1. A helper that resolves a name to a check function and reports whether the name is known. 2. Flag parsing for `--only <name>`, with the unknown-name refusal and exit 2. 3. Running the single resolved check and recording its result through the existing results state. 4. Composition with `--summary` and `--json`. 5. The usage text in `--help`, and assertions in scripts/test_healthcheck.sh for each behaviour 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. ## 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: - `--only <name>` runs exactly one check. - An unknown name exits 2 with a message on stderr. - `--only` composes with `--summary`, `--json` and `--quiet`. - Every existing flag is unchanged when `--only` is absent.
Author
Contributor

orchestra verify phase-1

Read the printed output for this phase and confirmed it by hand.

orchestra verify phase-1 Read the printed output for this phase and confirmed it by hand.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kami/test-e2e#26