v2.12.0

Highlights

• Safer browser startup: occupied debug ports now fail before spawning a browser, with readiness checks preserved.
• Better async evaluation: multi-statement async snippets return an inferred final expression while ambiguous input fails closed.
• Reliable pointer actions: smooth scrolling settles before pointer dispatch, including selectors, refs, and frame-owned targets.
• State-aware automation: strict console baselines, bounded repeat --until-* conditions, and selector/text flow assertions.
• Honest failure propagation: halted nested flows, fail-fast repeats, and DOM/network wait timeouts now exit non-zero with failed-step and recovery handoffs preserved in text and JSON.

Measured Release Gate

• 792/792 Vitest tests passed; lint and the 81-command docs contract passed.
• npm audit --audit-level=high: 0 vulnerabilities.
• Full Edge/CDP live smoke passed.
• Mixed campaign: 10/10 rounds passed across MCP, CLI, Killer Path, large-app stress, and five local real-app profiles.
• Each real-app profile passed 34/34 criteria with no missing probes.
• Fresh proof snapshot: 2.225s average first useful observation, 2.902s average first action evidence, and 1,564 average useful-observation tokens.
• Package gate: 13 files, 210,379-byte dry-run tarball; final tarball contents and SHA-256 verified.

These real-app profiles are safe local fixtures, not claims about external production applications.

Install

Download pi-chrome-cdp-2.12.0.tgz, verify it with the attached checksum, then extract it:

shasum -a 256 -c pi-chrome-cdp-2.12.0.tgz.sha256
mkdir -p chrome-cdp-ex-v2.12.0
tar -xzf pi-chrome-cdp-2.12.0.tgz -C chrome-cdp-ex-v2.12.0 --strip-components=1

This project publishes through GitHub Releases and GitHub Pages. It is not published to the npm registry.

Full changelog: v2.11.0...v2.12.0