refactor(runners): introduce provider plugin framework

[edersonbrilhante]

Description

Introduce a shared runner-provider plugin framework so a provider is enabled once and its webhook, scale-up, scale-down, pool, and runner-resource capabilities are available through one registry facade.

• Move the EC2 provider implementation into the shared runner-providers library.
• Add a single provider configuration and capability registry for webhook and control-plane consumers.
• Add reusable scale-up, scale-down, and pool contract tests that run for every enabled provider lane.
• Add a provider skeleton that documents the interfaces required to implement another lane.

This reduces the number of control-plane and webhook locations that must be changed when adding a runner provider.

Follow-up work

Some tests still need to move to the control-plane package instead of remaining with the EC2 plugin. The affected files contain groups of tests, so this cleanup requires moving individual test cases rather than relocating an entire block or file. It will be handled in a follow-up PR to keep this refactor reviewable.

This is why some EC2 provider tests currently import from ../../../../../../functions/control-plane. Those dependencies should be removed in the follow-up PR.

Test Plan

• Ran the runner-providers:test Nx target.
• Ran the control-plane:test Nx target.
• Ran Prettier checks for the runner-provider library.
• Ran ESLint for the runner-provider library.

Related Issues

Follow-up: #5236.

[github-actions]

Dependency Review

The following issues were found:

• ✅ 0 vulnerable package(s)
• ✅ 0 package(s) with incompatible licenses
• ✅ 0 package(s) with invalid SPDX license definitions
• ⚠️ 5 package(s) with unknown licenses.

See the Details below.

License Issues

lambdas/functions/control-plane/package.json

Package	Version	License	Issue Type
@aws-github-runner/runner-providers		Null	Unknown License

lambdas/functions/webhook/package.json

Package	Version	License	Issue Type
@aws-github-runner/runner-providers		Null	Unknown License

lambdas/libs/runner-providers/package.json

Package	Version	License	Issue Type
@aws-github-runner/aws-powertools-util		Null	Unknown License
@aws-github-runner/aws-ssm-util		Null	Unknown License
@aws-sdk/client-ec2	^3.1009.0	Null	Unknown License

OpenSSF Scorecard

Scorecard details

Package	Version	Score	Details
npm/@aws-github-runner/runner-providers		Unknown	Unknown
npm/@aws-github-runner/runner-providers		Unknown	Unknown
npm/@aws-github-runner/aws-powertools-util		Unknown	Unknown
npm/@aws-github-runner/aws-ssm-util		Unknown	Unknown
npm/@aws-sdk/client-ec2	^3.1009.0	Unknown	Unknown
npm/@octokit/rest	22.0.1	🟢 7.2	Details Check Score Reason Maintained 🟢 10 22 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Code-Review ⚠️ -1 Found no human activity in the last 30 changesets Binary-Artifacts 🟢 10 no binaries found in the repo Security-Policy 🟢 9 security policy file detected Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions Pinned-Dependencies 🟢 6 dependency not pinned by hash detected -- score normalized to 6 CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Branch-Protection ⚠️ -1 internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md Packaging 🟢 10 packaging workflow detected SAST 🟢 10 SAST tool is run on all commits
npm/aws-sdk-client-mock	^4.1.0	Unknown	Unknown
npm/aws-sdk-client-mock-jest	^4.1.0	Unknown	Unknown
npm/moment	2.29.4	🟢 4.5	Details Check Score Reason Maintained 🟢 5 7 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5 Code-Review ⚠️ 1 Found 4/30 approved changesets -- score normalized to 1 Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions Packaging ⚠️ -1 packaging workflow not detected Security-Policy 🟢 10 security policy file detected CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Binary-Artifacts 🟢 10 no binaries found in the repo Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Branch-Protection ⚠️ -1 internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md Fuzzing ⚠️ 0 project is not fuzzed SAST ⚠️ 0 SAST tool is not run on all commits -- score normalized to 0
npm/nock	^14.0.10	Unknown	Unknown
npm/yn	3.1.1	🟢 3.9	Details Check Score Reason Code-Review 🟢 4 Found 12/30 approved changesets -- score normalized to 4 Packaging ⚠️ -1 packaging workflow not detected Security-Policy 🟢 10 security policy file detected Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Binary-Artifacts 🟢 10 no binaries found in the repo Maintained ⚠️ 0 0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Branch-Protection ⚠️ 0 branch protection not enabled on development/release branches Signed-Releases ⚠️ -1 no releases found SAST ⚠️ 0 SAST tool is not run on all commits -- score normalized to 0

Scanned Files

• lambdas/functions/control-plane/package.json
• lambdas/functions/webhook/package.json
• lambdas/libs/runner-providers/package.json