[codex] Add end-to-end testing workflow

[rossgalloway]

Summary

• Adds Playwright smoke coverage and GitHub Actions wiring for end-to-end testing.
• Reworks test organization around durable src/test coverage, culling reports, and pre-commit safeguards.
• Expands holdings/portfolio/vault API and UI flows covered by the end-to-end testing branch.
• Adds Human readable HTML tags to main elements to make it easier to browse code in console and for agents to find components in the tree.

Important note: This commit adds a pre-commit script that insists that tests are located in the /src/test/ folder.

This branch supersedes #1153

Test organization and process

This branch moves long-lived frontend/domain tests into a curated src/test/ tree instead of leaving them scattered beside components and hooks. The durable buckets are:

• src/test/math/ for calculations, bigint/share conversions, APY/APR, slippage, valuations, cooldowns, and other independently checkable math.
• src/test/transactions/ for transaction state, overlays, Safe batching, approval/deposit/withdraw behavior, and wallet-flow helpers.
• src/test/api-contracts/ for route contracts, Kong/yDaemon response shapes, selectors, and URL/schema expectations.
• src/test/formatting/ for formatting behavior that has meaningful expected values.
• src/test/vaults/ for durable vault-domain behavior.

Temporary colocated tests are still allowed while building. Before handoff or commit, each touched colocated frontend/domain test should be deliberately handled: move it into src/test/ if it protects durable behavior, convert it into an E2E smoke path if it protects a user-visible flow, or delete it if it only helped build the PR.

The branch adds bun run test:cull as a review aid for touched tests. It reports keep/cull/E2E candidates but does not auto-delete anything. The Husky pre-commit hook now runs scripts/check-test-location.mjs, which blocks staged src/**/*.test.* and src/**/*.spec.* files unless they live under src/test/. API tests, script tests, and Playwright tests keep their own homes under api/, scripts/, and e2e/.

Added end-to-end tests

The PR adds Playwright as the repo-level smoke test layer via e2e/public-smoke.spec.ts, playwright.config.ts, and .github/workflows/e2e.yml. These tests are intentionally small and public-route focused; they are not meant to replace domain unit tests or become component tests.

The initial smoke coverage checks:

• / loads as Yearn and can navigate through the Explore Vaults link.
• /vaults renders the vault search/table surface.
• /portfolio renders without a connected wallet.

The goal is quick confidence that the app boots, public routes render, primary navigation works, and the unauthenticated portfolio path does not blank-screen. Future UI/flow-heavy PRs should add one similarly stable smoke path when they change a critical public workflow.

Playwright smoke coverage in CI

The new .github/workflows/e2e.yml workflow runs on pull_request and workflow_dispatch. It checks out the repo, sets up Node 20 and Bun, installs dependencies with bun install, installs Chromium with bunx playwright install --with-deps chromium, runs bun run test:e2e, and always uploads the Playwright HTML report for 7 days.

playwright.config.ts points at e2e/, runs Desktop Chromium with one worker, retries twice in CI, keeps traces/videos on failure, and starts the app with HOST=127.0.0.1 PORT=3000 bun run dev unless PLAYWRIGHT_BASE_URL is provided.

These are deliberately cheap boot/navigation checks rather than deep behavioral tests. Their job is to catch blank screens, route breaks, and basic public UI regressions.

Validation

• bun run build
• bun run test:e2e

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
yearnfi	Ready	Preview, Comment	May 20, 2026 1:09pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
yearnfi-nextjs	Ignored	Preview	May 20, 2026 1:09pm

[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
• ⚠️ 3 package(s) with unknown licenses.

See the Details below.

License Issues

.github/workflows/e2e.yml

Package	Version	License	Issue Type
actions/checkout	4.*.*	Null	Unknown License
actions/setup-node	4.*.*	Null	Unknown License
actions/upload-artifact	4.*.*	Null	Unknown License

Allowed Licenses:

MIT, Apache-2.0, BSD-3-Clause, BSD-2-Clause, ISC, CC0-1.0, CC-BY-3.0, CC-BY-4.0, Unlicense

OpenSSF Scorecard

Package	Version	Score	Details
actions/actions/checkout	4.*.*	🟢 5.7	Details Check Score Reason Code-Review 🟢 10 all changesets reviewed Maintained ⚠️ 0 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Binary-Artifacts 🟢 10 no binaries found in the repo Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Packaging ⚠️ -1 packaging workflow not detected Pinned-Dependencies 🟢 3 dependency not pinned by hash detected -- score normalized to 3 Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Security-Policy 🟢 9 security policy file detected Branch-Protection 🟢 5 branch protection is not maximal on development and all release branches SAST 🟢 8 SAST tool detected but not run on all commits
actions/actions/setup-node	4.*.*	🟢 5.7	Details Check Score Reason Maintained 🟢 6 8 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 6 Code-Review 🟢 10 all changesets reviewed Binary-Artifacts 🟢 9 binaries present in source code Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Packaging ⚠️ -1 packaging workflow not detected Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Security-Policy 🟢 9 security policy file detected Branch-Protection ⚠️ 1 branch protection is not maximal on development and all release branches SAST 🟢 9 SAST tool is not run on all commits -- score normalized to 9
actions/actions/upload-artifact	4.*.*	🟢 5.6	Details Check Score Reason Maintained 🟢 6 6 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 6 Binary-Artifacts 🟢 10 no binaries found in the repo Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Code-Review 🟢 8 Found 8/9 approved changesets -- score normalized to 8 Packaging ⚠️ -1 packaging workflow not detected CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions Pinned-Dependencies ⚠️ 1 dependency not pinned by hash detected -- score normalized to 1 Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Security-Policy 🟢 9 security policy file detected SAST 🟢 10 SAST tool is run on all commits Branch-Protection ⚠️ 0 branch protection not enabled on development/release branches
npm/@playwright/test	1.60.0	🟢 6.5	Details Check Score Reason Maintained 🟢 10 30 commit(s) out of 30 and 6 issue activity out of 30 found in the last 90 days -- score normalized to 10 Code-Review 🟢 9 GitHub code reviews found for 29 commits out of the last 30 -- score normalized to 9 CII-Best-Practices ⚠️ 0 no badge detected Vulnerabilities 🟢 10 no vulnerabilities detected Signed-Releases ⚠️ -1 no releases found Security-Policy 🟢 10 security policy file detected License 🟢 10 license file detected Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Packaging ⚠️ -1 no published package detected Token-Permissions ⚠️ 0 non read-only tokens detected in GitHub workflows Binary-Artifacts 🟢 6 binaries present in source code Dependency-Update-Tool 🟢 10 update tool detected Fuzzing ⚠️ 0 project is not fuzzed Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 Branch-Protection 🟢 3 branch protection is not maximal on development and all release branches

Scanned Files

• .github/workflows/e2e.yml
• package.json

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​playwright/​test@​1.60.0

View full report