Repository navigation
KeyTrail 1.0 defines the supported 1.x API and report compatibility contract for Playwright keyboard journeys: dialogs, tabs and form errors.
Complete observations now use guarded live query grouping. Every original locator still resolves afresh; changed membership or DOM mutations trigger a fresh fallback read. The eight additional complete-read regressions and strict report validation preserve the 100 ms observation bound and zero retries.
Install the verified release with:
npm install --save-dev --save-exact keytrail@1.0.0 @playwright/test@1.64.1Validation:
- Ten final sequential rounds: 1,880 checks; separate four-worker comparison: 188 checks. All eleven raw reports were independently validated, with 1,771 distinct journey IDs and no retries/skips. Maximum passing observation gap: 47.7 ms, below the unchanged 100 ms limit.
- 108/108 equivalent-work benchmark checks, five warmups and thirty alternating pairs per workload. Median paired overhead: 2.4% dialog / 5.7% manual tabs / 0.7% form errors. Both overhead calculations meet the 20% criterion. These synthetic measurements do not imply a general speed advantage.
- 52/52 CI guard controls, 48 unit tests and 30 script checks. Linux and three sequential macOS 15 ARM allocations pass the full suite and package consumers.
- The exact release archive passes ESM/CJS, TypeScript and clean vanilla/React portal consumers, including an intentional failed journey with HTML/JUnit evidence.
The API, defaults, schema 1 and ruleset 0.4.0 remain compatible. Supported baseline: Node 24, Playwright 1.64.1 and its Chromium on Linux/macOS ARM. Keep the application lockfile and run native/journey regressions when upgrading.
KeyTrail verifies the supplied contracts. It does not certify accessibility or replace assistive-technology checks and manual testing. Earlier failed benchmark attempts remain excluded; historical releases and the beta channel are retained.
See the attached verification records, raw evidence archive and SHA256SUMS. The qualification source is d43e235; the release source includes its final evidence and publication preparation. Registry readback and installation are recorded separately.
Published to npm under latest; beta remains 0.1.0-beta.2. The downloaded npm archive matches the qualified 549,575-byte archive byte for byte, with verified SHA-512 integrity and SHA-256 92d57d16e32d137cf3444e57e2ddf9d37614ba603a4a9dc19254a1daf16db97d. The registry-version vanilla installation and downloaded-archive React installation pass ESM/CJS, types, browser examples and the negative HTML/JUnit control.
Final main CI passed all four jobs at 2e6ed6514124e2ee1f6cd8f16da14ce8d0508e81. All four raw reports were also validated (752 checks, 644 distinct journey IDs). The source tag and published archive are immutable; publication-status documentation follows separately on main.