Command Notes — Yalabeena E2E Control

E2E Runs

List available suites

Reads the same catalog used by the pipeline GUI.

scripts/test/list.sh

Fast API smoke

Quick non-desktop sanity check.

scripts/test/run.sh smoke

Auth API

Authentication API coverage without MailHog UI.

scripts/test/run.sh auth-api

Auth + MailHog

Email-token flows with MailHog enabled.

scripts/test/run.sh auth-mailhog

Full API / non-desktop

All non-desktop tests with MailHog.

scripts/test/run.sh full-api

Everything

Complete collection with MailHog and provider callbacks enabled, without marker filtering.

scripts/test/run.sh --everything

Full desktop E2E

Runs non-desktop first, then the visible Flutter desktop suite.

scripts/test/run.sh desktop-full

Observed desktop E2E

Adds a visible pause after each GUI action. Leave unset for full speed.

YALABEENA_E2E_OBSERVER_DELAY_MS=250 scripts/test/run.sh desktop-full

Journey only

Runs only the independent visible two-client journey.

scripts/test/run.sh journey

Android host preflight

Installs/checks Java, Android SDK, platform-tools, emulator, and the E2E AVD.

FRONTEND_PLATFORM=android scripts/ci/preflight_host.sh

Android desktop E2E

Starts the prepared Android device/emulator, then runs the complete catalog against Android.

FRONTEND_PLATFORM=android scripts/test/run.sh everything

Release Flow

Suggest next RC

Prints the next release-candidate tag from local tags.

scripts/release/suggest_next_rc.sh

Create local RC tags

Tags the parent repo and pinned backend/frontend/E2E submodule commits, then builds selected local targets.

scripts/release/create_release.sh --rc v1.2.3-rc.1 --targets web,linux,android

Promote RC to official release

Retags the tested RC commit set as a stable release.

scripts/release/create_release.sh --promote-rc v1.2.3-rc.1 --stable v1.2.3

Publish tags

Add --push when you intentionally want to publish tags to remotes.

scripts/release/create_release.sh --stable v1.2.3 --ref main --push

Build one target

Target dispatcher used by CI. Set RELEASE_OUTPUT_DIR to place packages in the runner package store.

RELEASE_TAG=v1.2.3 RELEASE_OUTPUT_DIR=/home/wael/workspace/gitlab-runner-user/release-packages/v1.2.3/android scripts/release/build_target.sh android

Serve runner packages

Starts the local package browser used by the Release Center downloads.

scripts/release/serve_packages.sh

Reports

Local runs keep reports under the run directory, usually e2e-state/run/**/runner/reports/. In CI, open Run history and use the report buttons on each E2E job row.