CodeVetter · Repo Unpack · Behavior traces

cypress-io/cypress

Scanned commit 7d987f0474 dated 2026-10-02 — last upstream commit. Generated by codevetter codevetter 1.15.0 on 2026-10-02. Deep analysis by cli:codex via the codex CLI on 2026-10-02 (843s). Source inspection; upstream code and tests were not executed.

Three concrete flows were followed across their relevant files: test-run startup/results, interception registration through response completion, and interactive-session persistence through CLI attachment. The traces below retain important branches such as dev verification bypass, recording delegation, static-response termination, and browser-readiness filtering. A supplementary startup trace explains how the interactive window becomes available.

Run entry: bin/cypress.ts → CLI.init() → run command action → runModule.start() → processRunOptions() → spawnStart(); non-dev execution awaits binary verify.start(), while dev execution bypasses it.
cli/lib/bin/cypress.ts#L1-5 cli/lib/cli.ts#L506-515 cli/lib/exec/run.ts#L179-212
Run initialization: cypress.start() parses argv and selects run for runProject → startInMode() → runElectron() → modes factory → setCtx(makeDataContext()) and initializeMode() → modes/run.run() awaits loading and calls ready().
packages/server/lib/cypress.ts#L141-158 packages/server/lib/cypress.ts#L193-209 packages/server/lib/modes/index.ts#L26-40 packages/server/lib/modes/run.ts#L1298-1325
Run completion: ready() discovers browsers and opens the project, validates recording parameters, and handles empty specs; runAllSpecs() calls runSpecs(), which invokes before:run → iterateThroughSpecs/runEachSpec → runSpec() → after:run → writeOutput(). Recording delegates through createRunAndRecordSpecs; POSIX mode collapses failure counts except reserved code 112.
packages/server/lib/modes/run.ts#L1146-1163 packages/server/lib/modes/run.ts#L1186-1203 packages/server/lib/modes/run.ts#L951-998 packages/server/lib/cypress.ts#L261-286
Intercept registration: addCommand() installs intercept → getMatcherOptions() → validateRouteMatcherOptions() → addRoute() → emitNetEvent('route:added') via Cypress.backend('net', ...) → onNetStubbingEvent() → onRouteAdded().
packages/driver/src/cy/net-stubbing/add-command.ts#L304-315 packages/driver/src/cy/net-stubbing/add-command.ts#L216-239 packages/driver/src/cy/net-stubbing/events/index.ts#L49-55 packages/net-stubbing/lib/server/driver-events.ts#L111-124
Intercept request: SetMatchingRoutes() applies dev-server/preflight conditions and core.matchRoutes() → InterceptRequest() → core.handleRequest() → handleInterceptRequest() creates and registers InterceptedRequest → ensureBody() → addDefaultSubscriptions() → before:request handlers → merge changes → end() if responseSent, otherwise continueRequest().
packages/net-stubbing/lib/server/middleware/request.ts#L15-58 packages/network-interception/lib/core/network-interception-core.ts#L59-60 packages/net-stubbing/lib/server/handle-intercept-request.ts#L31-48 packages/net-stubbing/lib/server/handle-intercept-request.ts#L93-139
Intercept response: handleInterceptResponse() bypasses unmatched requests, obtains a plain-text/binary body, invokes before:response → response:callback → response subscriptions, merges response/header changes, and continues with getBodyStream(); response finish emits after:response and removes the request from server state.
packages/net-stubbing/lib/server/handle-intercept-response.ts#L22-55 packages/net-stubbing/lib/server/handle-intercept-response.ts#L67-83 packages/net-stubbing/lib/server/handle-intercept-request.ts#L54-65
Session lifecycle: ProjectBase registers an open-mode session → addSession() creates UUID identity → persist() serializes writes and renames a temporary JSON file → CLI readLiveSessions() validates records/reaps dead PIDs → verifySessionRecord() checks the session echo and CDP /json/version → resolveSession() filters ready supported sessions → CDP attachment probes page targets for the tap binding.
packages/server/lib/project-base.ts#L268-274 packages/server/lib/cypress-sessions.ts#L25-61 cli/lib/cypress-sessions/index.ts#L109-168 cli/lib/tap/tap-connection.ts#L92-148 cli/lib/cypress-sessions/store.ts#L47-82 cli/lib/cypress-sessions/store.ts#L100-118 cli/lib/cypress-sessions/liveness.ts#L26-77
Interactive startup: modes factory starts initializeMode() → interactive.run() concurrently awaits app.whenReady() and makeGraphQLServer() → ready() loads saved state and opens the desktop window → optional 'Cypress is ready' sentinel lets detached CLI spawning destroy streams, unref the child, and resolve.
packages/server/lib/modes/index.ts#L26-45 packages/server/lib/modes/interactive.ts#L138-159 packages/server/lib/modes/interactive.ts#L162-204 cli/lib/exec/spawn.ts#L208-224