[GEMINI-HARDEN-06] Add a common CLI safety/test harness for the scripts/ suite #438

Open
opened 2026-04-09 14:32:41 +00:00 by Timmy · 0 comments
Owner

Parent epic: #432

Why
PR #418 merged 12 standalone operational scripts, but their operator contracts are inconsistent. The clearest example is self_healing.py --help causing live behavior. The suite needs a shared CLI/test standard before more automation is built on top of it.

Acceptance criteria

  • Define a common contract for scripts/*.py covering --help, exit codes, dry-run behavior, timeouts, and mutating vs observational commands.
  • Automated smoke tests verify every script's --help path is side-effect free.
  • Add fixture/mock-based integration tests for dispatch, telemetry, webhook, provisioning, and self-healing safe paths.
  • scripts/README.md clearly marks which tools are observational, mutating, or bootstrap-only.
  • The default test path for the suite is safe to run in CI without contacting the live fleet.

Related

Parent epic: #432 Why PR #418 merged 12 standalone operational scripts, but their operator contracts are inconsistent. The clearest example is `self_healing.py --help` causing live behavior. The suite needs a shared CLI/test standard before more automation is built on top of it. Acceptance criteria - Define a common contract for `scripts/*.py` covering `--help`, exit codes, dry-run behavior, timeouts, and mutating vs observational commands. - Automated smoke tests verify every script's `--help` path is side-effect free. - Add fixture/mock-based integration tests for dispatch, telemetry, webhook, provisioning, and self-healing safe paths. - `scripts/README.md` clearly marks which tools are observational, mutating, or bootstrap-only. - The default test path for the suite is safe to run in CI without contacting the live fleet. Related - #432 - PR #418 - PR #430
Timmy added the enhancement label 2026-04-09 14:32:41 +00:00
bezalel was assigned by Timmy 2026-04-09 14:45:22 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-config#438