Summary

• carry canonical browser environments through standalone probes, authored actions, adaptive exploration, and scenarios via the shared Playwright environment adapter
• give probe-plus-action scenarios one owned context/page so init scripts, storage, auth cookies, permissions, and page state survive phase collection
• resolve once and create an independently configured context for every multi-actor participant, with actor-level observed evidence and isolation
• bind adaptive state, oracle findings, minimized replay, and replay identity to the canonical requested environment digest
• validate inline and @path environments without bypassing existing steps/scenario validation, preserve scenario-over-argument precedence, and reject unknown profiles

Root cause and ownership boundary

wordpress.browser-probe, wordpress.browser-actions, scenarios, and multi-actor scenarios previously owned separate context construction paths. Scenario probe and action phases launched independent browsers, action viewport changes happened after context creation, and multi-actor scenarios always used plain contexts. This lost geolocation/device state and also lost scripts, cookies, storage, permissions, and page state between scenario phases.

The Playwright environment adapter now owns context creation for probes, actions, shared scenarios, matrices, and actors. A scenario that needs both probe collection and actions creates one session and lends the same page to both runners without transferring ownership. Multi-actor runs reuse one resolved environment definition but create and close an isolated context per actor.

Evidence

Action/scenario artifacts now separate:

• requested: canonical caller declaration
• resolved: provider-resolved configuration
• observed: browser-observed viewport, touch, user agent, locale/timezone, online state, permission, and granted coordinates
• unsupported and inconclusive: dimensions that cannot be applied or independently observed

Adaptive contracts, state digests, finding fingerprints, result replay, and per-finding replay include the canonical environment and digest.

Tests

• npm run build
• npm run test:browser-actions-environment
• npm run test:browser-environment-matrix
• npm run test:browser-scenarios
• npx tsx tests/recipe-validation-descriptors.test.ts
• npm run test:fixture-auth-storage-state
• npm run test:browser-preview-routing
• npm run test:public-api-contract
• npm run test:wordpress-runtime-actions
• targeted adaptive replay/finding tests via --test-name-pattern

Coverage includes probe/action state continuity under performance collection and pre-page scripts, routed granted/denied/prompt geolocation, auth and storage state, scenario precedence and unknown profiles, malformed JSON validation, valid/invalid/missing @path environments, run isolation, per-actor environment/isolation, unsupported evidence, and environment-bound adaptive identity.

npm run check still reaches the unrelated main-branch registry failure tracked in #1745. The full adaptive umbrella has a pre-existing fixed-delay cancellation race now tracked in #2104; all adaptive replay/finding tests affected by this PR pass.

Compatibility

Existing recipes remain valid. Legacy viewport, profile/device, auth, storage state, and routed preview controls continue to work. Scenario declarations retain precedence over command arguments. Unsupported multi-actor shared pre-page/auth/storage controls now fail before actor launch instead of being ignored. No changelog or version strings were modified.

Fixes #2091

Latest re-review fixes

• load and validate file-backed steps-json and scenario-json relative to the recipe directory, including evaluate-capability policy derivation
• execute scenario steps-json=@path instead of silently dropping it
• treat nested adaptive environment as authoritative and reject conflicting outer declarations
• verify cookie, localStorage, and imported storage-state isolation across consecutive scenario contexts
• rebase onto current origin/main, including Fix canonical routed preview origins #2098 preview routing/readiness changes

Final path-consistency fix

• canonicalize recipe-local file-backed browser payload arguments to absolute paths in recipeExecutionSpec
• prove validation, evaluate-policy derivation, dry-run planning, and runtime execution use the same files from a different process CWD
• cover valid and malformed action steps-json, scenario objects, and scenario steps-json