Devops Run Client

Launching the Qt client, detached so the terminal stays free; colour keeps parallel runs apart (the instance name is always the environment's own label — not overridable). Whenever there's a UI test scenario to run through, always launch (or restart) with --open-scenario pointing at it — never make the user navigate to Scenario Runner and open the file by hand.

1. Launch:

   ./projects/ores.compass/compass.sh client start --colour <colour>
   

2. Launch with a test scenario pre-loaded — whenever there's UI testing to do, always supply this instead of a bare launch. --open-scenario must be an absolute path — the client's working directory is not the repo root, so a relative path (even one that's correct from your own shell) fails with a filesystem error:

   ./projects/ores.compass/compass.sh client start --colour <colour> --open-scenario /absolute/path/to/scenario_*.org
   

   Opens the Scenario Runner (System > Testing) with that test_scenario doc already loaded, so the tester can start working through steps immediately instead of using Scenario Runner's own Open button.

3. Ensure the system is actually ready before opening the client — confirm/recreate the database and provision it yourself (see How do I ready up an environment?), recorded in the scenario's own * Before you start section, not left for the tester to sort out. Never hand the tester a scenario against a system you haven't already verified is in the right state.
4. Always include a connect/login step in the scenario itself — every test_scenario doc opened this way must have, as its first = Steps= entry* (not just prose in * Context, which the Scenario Runner panel doesn't track pass/fail for), a step naming the specific persona to log in as: the exact account and its password (e.g. tenant_admin@acme_corporation / Secure-Password-123). This step is pure tester mechanics — it assumes the readiness work from step 3 above, not a conditional the tester has to evaluate. Never leave the tester to guess credentials.

5. Stop (pass the same --colour the instance was started with):

   ./projects/ores.compass/compass.sh client stop --colour <colour>