feat: Upgrade eversale for pip install with full CLI flag propagation

[codegen-sh]

Summary

Complete upgrade of the eversale system to be fully operational via pip install -e . with proper CLI commands. All changes have been tested end-to-end with real Z.AI API calls.

What This PR Does

1. Enhanced CLI Entry Point (eversale_cli.py)

• Robust flag parsing: --ultimate, --headless, --debug, --max-steps N
• Environment variable propagation — flags are set as env vars (EVERSALE_HEADLESS=1, etc.) so downstream scripts receive them after sys.argv reconstruction
• Clean help text and version display

2. Fixed Flag Propagation (Root Cause Fix)

Problem: CLI stripped flags from sys.argv and set env vars, but downstream scripts only read sys.argv → flags were silently dropped.

Fix in run_simple.py: After parse_args(), check env vars and override:

if os.environ.get("EVERSALE_HEADLESS") == "1":
    args.headless = True

Fix in mcp_client.py: Read env var at MCPClient init:

_env_headless = os.environ.get("EVERSALE_HEADLESS")
self._headless_override = True if _env_headless == "1" else None

3. Playwright Accessibility API Compatibility (a11y_compat.py)

• 218-line compatibility module with CDP fallback chain
• Handles Playwright 1.47+ removal of page.accessibility.snapshot()
• Applied across 9 files (a11y_browser, accessibility_element_finder, cdp_browser_connector, coordinate_targeting, dom_first_browser, playwright_direct, run_simple, run_ultimate)

4. No WSL Paths

• Verified zero /mnt/c/ paths — works natively on Windows

CLI Usage

eversale "Task"                       # Simple mode (accessibility-first agent)
eversale --ultimate "Complex task"    # Full orchestration engine
eversale --headless "Task"            # Headless browser mode
eversale --version                    # Show version
eversale --help                       # Show help

Test Results (Z.AI glm-5 model)

Test	Mode	Result	Time
eversale --headless "say hello"	Simple	✅ SUCCESS	18.5s
eversale --ultimate --headless "say hello"	Ultimate	✅ SUCCESS	14s
eversale --headless "navigate to google.com and tell me the page title"	Simple	✅ SUCCESS (2 steps)	21.5s
eversale --ultimate --headless "navigate to google.com and tell me the page title"	Ultimate	✅ SUCCESS (full page analysis)	92s
eversale --version	CLI	✅ Eversale CLI v2.1.218	instant
eversale --help	CLI	✅ Full help text	instant
pip install -e .	Install	✅ Success	—

Files Changed (11 files, +353/-17 lines)

File	Change
eversale_cli.py	Enhanced CLI with flag parsing + env var propagation
engine/run_simple.py	Env var reading after argparse
engine/run_ultimate.py	Minor import fix
engine/agent/mcp_client.py	Env var reading at init for headless
engine/agent/a11y_compat.py	NEW — Accessibility API compatibility module
engine/agent/a11y_browser.py	Use a11y_compat instead of deprecated API
engine/agent/accessibility_element_finder.py	Use a11y_compat
engine/agent/cdp_browser_connector.py	Use a11y_compat
engine/agent/coordinate_targeting.py	Use a11y_compat
engine/agent/dom_first_browser.py	Use a11y_compat
engine/agent/playwright_direct.py	Use a11y_compat

---

💻 View my work • 👤 Initiated by @Zeeeepa • About Codegen
⛔ Remove Codegen from PR • 🚫 Ban action checks

---

Summary by cubic

Upgrade eversale to install via pip install -e . and run through a new CLI with reliable flag propagation, plus add a playwright accessibility compatibility layer for versions 1.47+.

• New Features

  • New eversale CLI with --ultimate, --headless, --debug, --max-steps.
  • Flags propagate via env vars (EVERSALE_HEADLESS, EVERSALE_DEBUG, EVERSALE_MAX_STEPS) so downstream scripts receive them; run_simple, run_ultimate, and MCPClient read these.
  • Added a11y_compat.py using CDP (Accessibility.getFullAXTree) with fallbacks; replaced deprecated page.accessibility.snapshot() across the codebase.
  • CLI sets EVERSALE_HOME/EVERSALE_ENGINE_DIR and chdirs to resolve relative paths; verified native Windows operation.

• Bug Fixes

  • Fixed lost CLI flags caused by sys.argv stripping by reading env overrides in run_simple/run_ultimate.
  • Restored accessibility snapshots on playwright ≥1.47 via compatibility layer.
  • Removed WSL-style /mnt/c/ paths to prevent path issues on Windows.

^{Written for commit 2de549a. Summary will update on new commits.}