run-e2e-ci

Dispatches filtered E2E and Coin Tester CI workflows on GitHub Actions for a PR branch.

615|491|Updated Jan 4, 2022
One-click install
npx skills add https://github.com/LedgerHQ/ledger-live --skill run-e2e-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-e2e-ci
Source: https://github.com/LedgerHQ/ledger-live/tree/main/.agents/skills/run-e2e-ci
Command: npx skills add https://github.com/LedgerHQ/ledger-live --skill run-e2e-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Desktop and Mobile E2E workflows in the ledger-live repository only run on a schedule or via manual dispatch, so engineers must trigger them deliberately and scope them correctly to avoid slow, expensive full-suite runs that compete for shared on-chain accounts.

Core Features & Use Cases

  • Scoped workflow dispatch: Derives the smallest meaningful test filter from the PR diff (coin module, family, spec, or platform) and dispatches Desktop E2E, Mobile E2E, and Coin Tester workflows via gh workflow run.
  • Filter verification: Checks the run's resolved filtered pattern to confirm the filter matched specs, avoiding wasted runs or desktop failures from zero-match filters.
  • PR reporting: Posts a structured PR comment listing each triggered workflow, its scope, run links, and a rationale for skipped surfaces.
  • Use Case: After modifying libs/coin-modules/coin-solana, dispatch Desktop and Mobile E2E with test_filter=@solana and Coin Tester with chain=solana, then post the run links on the PR.

Quick Start

Run the E2E and Coin Tester CI workflows on my PR branch, scoped to the changes in the diff, and post the run links as a PR comment.

Frequently Asked Questions about run-e2e-ci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trigger E2E tests on a GitHub Actions branch?

Use `gh workflow run <workflow-file> --ref <branch>` with the appropriate inputs, such as `-f test_filter=@solana` for filtered runs. The workflows checkout the commit the ref points to, so the optional branch input field can stay blank.

How do I run only specific E2E tests instead of the full suite?

Derive a filter from the diff, such as `@solana` for one coin module or `@family-evm` for a coin family, and pass it as `test_filter`. Reserve the full suite for cross-cutting changes like build tooling or TypeScript upgrades, and state the rationale in the PR comment.

What inputs does the Mobile E2E workflow require?

The Mobile E2E workflow requires `tests_type` (Android Only, iOS Only, or iOS & Android) and `speculos_device` (nanoS, nanoSP, nanoX, stax, flex, or nanoGen5). Desktop defaults to the Speculos nanoSP device.

Why did my filtered E2E run fail or skip all tests?

A filter matching zero specs causes Mobile test jobs to be skipped and Desktop runs to fail with a 'No tests executed' error. Check the run Summary's resolved filtered pattern, fix the filter, and re-dispatch.

When should I manually dispatch the Coin Tester workflow?

Coin Tester auto-runs on PRs for affected coins, so only dispatch it manually to force a specific chain via `-f chain="evm,solana"` or to re-run it. Omitting the chain input lets it auto-detect affected coins.