# Contributor handoff — cypress-io/cypress

> Canonical page: https://codevetter.com/unpack/cypress/agent-handoff

# Contributor handoff — cypress-io/cypress

Scanned commit 7d987f04740f8f5388ac3116e8ef7957373ead14 (2026-10-02). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Tests and CI were inspected, not executed, and no repository files were changed. Future implementation work should start from package-local guidance and identify the runtime, generated artifacts, and test runner before editing. The highest-value boundaries to preserve are shared interception state, session identity/persistence, user-Node configuration execution, and public CLI/module compatibility. This is a bounded investigation rather than exhaustive inventory or verification.
- Read root/package AGENTS.md and the appropriate guides before implementation; package documentation supplies architecture and runner details, and canonical multi-step workflows belong in guides. — [AGENTS.md#L16-27](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/AGENTS.md#L16-L27) [packages/server/AGENTS.md#L38-62](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/server/AGENTS.md#L38-L62) [packages/data-context/AGENTS.md#L26-51](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/data-context/AGENTS.md#L26-L51)
- Use Yarn 1 and existing workspace scripts; avoid root yarn test --scope for narrowing because its hardcoded Lerna scopes broaden the run. — [AGENTS.md#L29-34](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/AGENTS.md#L29-L34) [AGENTS.md#L54-73](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/AGENTS.md#L54-L73) [package.json#L60-70](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/package.json#L60-L70)
- Identify the runtime before using APIs: CLI/config-child support follows cli engines, the main process follows Electron, and browser bundles have a separate browser floor. — [AGENTS.md#L260-269](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/AGENTS.md#L260-L269) [cli/package.json#L125-127](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/cli/package.json#L125-L127) [packages/data-context/src/data/ProjectConfigIpc.ts#L319-324](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/data-context/src/data/ProjectConfigIpc.ts#L319-L324)
- New code and fixtures use TypeScript and ESLint conventions; preserve single quotes, no semicolons, two-space indentation, type-only imports, and documented skip reasons. — [AGENTS.md#L215-233](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/AGENTS.md#L215-L233)
- Edit CT adapter sources under npm rather than copied cli artifacts; regenerate Nexus/schema outputs through data-context build, and rebuild the shared session contract before CLI consumers pick up changes. — [cli/AGENTS.md#L63-70](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/cli/AGENTS.md#L63-L70) [packages/data-context/AGENTS.md#L44-50](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/data-context/AGENTS.md#L44-L50) [packages/cypress-sessions/AGENTS.md#L36-42](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/cypress-sessions/AGENTS.md#L36-L42)
- For execution-authorized validation, target CLI Vitest files with yarn workspace cypress test-unit -- <spec>, server Mocha with test-unit-mocha, server Vitest with test-unit-vitest, and data-context Jest with test-unit -- <spec>; then run relevant check-ts/lint scripts. These commands were inspected, not run in this audit. — [cli/package.json#L12-23](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/cli/package.json#L12-L23) [packages/server/AGENTS.md#L11-25](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/server/AGENTS.md#L11-L25) [packages/data-context/package.json#L12-19](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/data-context/package.json#L12-L19) [package.json#L26-26](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/package.json#L26-L26)
- Keep platform-dependent CLI tests host-independent: mock both os.arch and the arch package, avoid regenerating canonical snapshots to hide host drift, and account for util._cachedArch singleton state. — [cli/AGENTS.md#L50-61](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/cli/AGENTS.md#L50-L61)
- Interception edits require both browser-CDP and forceHttp1 validation plans; preserve the server-owned state across browser switches, and treat contributor CI approval/parameter filters as execution conditions rather than proof that all suites ran. — [packages/server/lib/server-base.ts#L434-437](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/packages/server/lib/server-base.ts#L434-L437) [.circleci/src/pipeline/workflows/pull-request.yml#L39-105](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/.circleci/src/pipeline/workflows/pull-request.yml#L39-L105) [.circleci/src/pipeline/workflows/pull-request.yml#L327-345](https://github.com/cypress-io/cypress/blob/7d987f04740f8f5388ac3116e8ef7957373ead14/.circleci/src/pipeline/workflows/pull-request.yml#L327-L345)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)