feat: add gh workflows setup

[Hweinstock]

built on #1747.
Direct port of AlexanderRichey/agentcore-cli#5.

Problem

The refactor is missing CI and a pattern for GH workflows. There are no automated checks on PRs, or on merge to main.

The existing CLI does not have a consistent pattern for workflows, which results in a large amount of duplication. Ex. e2e-tests logic duplicated across push-pr, and release duplicates much of release main.

Solution

• Organize workflows into a hierarchy of orchestrators and jobs (see README for more info). At a high level, jobs are re-usable logic and orchestrators are the wiring up of jobs (ex. CI, release, etc.).
• add simple CI with unit tests, lint, format, build checks, typechecks, and audit.
• coverage manged by CodeCov. (also has flaky test support https://about.codecov.io/blog/find-failing-and-flaky-tests-with-codecov-test-analytics/).

Testing

Running commands locally I can confirm all pass except test and typecheck (which are also failing upstream).

Notes

• sharding is left as a follow-up, but confirmed the existing pattern in the CLI is supported in bun.

Future Work

• potentially add hooks on workflows that posts CWL metrics. We can then leverage this for ticketing (for canary failures or CI failures on main) and dashboards to track health over time. (depends if migrating to codebuild gives us this for free)

[Hweinstock]

See #1745 (comment) for more info on CI.

[Hweinstock]

Note: CI is failing before these changes.
typecheck issues pre-existing on main.

bun build ./src/index.ts --target node --outdir ./dist --minify
7 | import devtools from 'react-devtools-core';
                         ^
error: Could not resolve: "react-devtools-core". Maybe you need to "bun install"?
    at /home/runner/work/agentcore-cli/agentcore-cli/node_modules/ink/build/devtools.js:7:22
error: script "build" exited with code 1

Existing issue due to react-devtools-core missing from dev deps.

Run bun run build
$ bun build ./src/index.ts --target node --outdir ./dist --minify
7 | import devtools from 'react-devtools-core';
                         ^
error: Could not resolve: "react-devtools-core". Maybe you need to "bun install"?
    at /home/runner/work/agentcore-cli/agentcore-cli/node_modules/ink/build/devtools.js:7:22
error: script "build" exited with code 1

Existing issue due to missing default. see https://typicode.github.io/husky/how-to.html#ci-server-and-docker.

[Hweinstock]

Two issues for follow-up since they are OOS of this PR:

• Typecheck is failing due to some undefined checks in the TUI code: ci: typecheck fails on refactor branch. #1750
• Windows tests are failing due to some issues reading the golden files: ci: unit tests fail on windows for refactor branch. #1751

[codecov-commenter]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

[Hweinstock]

Failing typecheck is fixed in #1756.

[notgitika]

Thanks for the explanation on why the workflows are failing.

I have a question, why are these workflows back to using GH based runners ubuntu-latest and not the codebuild ones introduced in #1715

is this intentional? is there a plan to switch it back to the codebuild ones once merged to main? if so, please add a backlog comment here

[notgitika]

thanks for creating the issue. LGTM!

[Hweinstock]

Ahh good callout, I didn't realize we were already fully on codebuild. I mostly setup with GH actions for simplicity, and to get something running quickly.

Since CI currently doesn't exist on this branch and I've got some changes based on this here, I think I'm going to merge and take this as a fast follow. I created a issue and assigned it to myself here: #1772