Skip to main content
Version: 1.x

Changelog

[1.3.0] - 2026-04-08​

Features​

  • telemetry: full OpenTelemetry tracing and metrics integration (OTLP, Jaeger, Azure Monitor)
  • telemetry: OTelReporter Playwright reporter emits spans for test lifecycle (test.run, step-level spans)
  • telemetry: meter worker-scoped fixture for metric counters and histograms
  • telemetry: Playwright live tracing correlation via OTel traceId
  • telemetry: dynamic import of OTel dependencies — zero overhead when disabled
  • config: 6 new PRAMAN_TELEMETRY_* env vars (exporter, protocol, metrics, batchTimeout, maxQueueSize, connectionString)
  • config: Zod refine validation — endpoint or connectionString required when telemetry enabled
  • errors: TelemetryError class with 5 error codes (ERR_TELEMETRY_INIT_FAILED, ERR_TELEMETRY_PEER_DEP_MISSING, ERR_TELEMETRY_EXPORTER_FAILED, ERR_TELEMETRY_SHUTDOWN_FAILED, ERR_TELEMETRY_METRICS_INIT_FAILED)
  • docs: new Telemetry Setup Guide (docs/guides/telemetry.md)
  • docs: docker-compose.otel.yml for local Jaeger development

Breaking Changes​

  • None — openTelemetry: false (default) behavior unchanged

[1.2.0] - 2026-04-01​

Features​

  • deps: upgrade Playwright to 1.59.0, add feature flags for screencast, ariaSnapshotDepth, setStorageState, locatorNormalize, urlPatternMatcher
  • deps: upgrade TypeScript 5.9.3 → 6.0.2, add TS 5.9/6.0 compat CI matrix
  • deps: raise minimum Node.js to 22, drop EOL Node 20
  • selectors: unify UI5 selector engine with fontoxpath + css-selector-parser; add :not(), :labeled(), positional and sibling selectors
  • cli: implement interactive inspect command for live UI5 control discovery
  • cli: add config command to display resolved configuration
  • cli: add init-agents command for lightweight IDE-specific agent installation
  • config: add nested env var support for auth, ai, telemetry, odataTracing
  • errors: add docs URL to error messages, JSON, and AI context
  • core: add extension system and matcher registry
  • ci: add Playwright canary (next) to integration matrix
  • docs: 100% TSDoc coverage — zero TypeDoc warnings

Bug Fixes​

  • deps: resolve all npm audit vulnerabilities (0 remaining)
  • deps: resolve docs vulnerabilities (0 remaining)
  • selectors: preserve array types, align area node name, handle negative nth-child
  • selectors: fix ui5:property() type fidelity, error surfacing, and tree builder gaps
  • ci: remove export validation from ts-compat job
  • ci: skip DTS in ts-compat job for TS 5.9
  • ci: add missing commit scopes (deps, release, adapter)
  • ci: handle corrupted npm on macOS ARM64 runners
  • ci: regenerate lockfile and fix docs broken links
  • docs: fix documentation accuracy — eliminate fictional APIs across 42 files

Breaking Changes​

  • The enableXpathEngine configuration field has been removed. The unified selector engine handles all selector styles automatically.
  • Minimum Node.js version raised from 20 to 22.

[1.0.1] - 2026-02-23​

Added​

  • LICENSE copyright holder updated
  • NOTICE file for Apache 2.0 attribution
  • SECURITY.md vulnerability disclosure policy
  • Package metadata improvements (author, files)

1.0.0 (2026-02-16)​

Breaking Changes​

  • Build output now includes CJS alongside ESM

Features​

  • eslint: add comprehensive best practices configuration (ea794d6)
  • multi-OS, multi-IDE, dual ESM+CJS build, AI agents support (860d52c)

Bug Fixes​

  • ci: add docs-check job, security eslint, sbom step, fix defineConfig export (8d8a74c)
  • ci: resolve all GitHub Actions workflow failures (5c3f212)
  • ci: set coverage thresholds to 0% for initial release (5b35d37)
  • ci: update husky hooks to use tsx instead of deleted bash script (bee1620)

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Automated via release-please from Conventional Commits.