fix(webdriver-utils): propagate labels onto comparisonData for POA snapshots

[prklm10]

Summary

• POA (Percy on Automate) snapshots silently dropped per-screenshot labels — WebdriverUtils.captureScreenshot forwarded sync, testCase, and thTestCaseExecutionId from options onto the returned comparisonData but not labels, so labels never reached percy.upload → sendComparison → createSnapshot (which converts labels to tags on the snapshot POST). The result: POA tags were always empty regardless of SDK input.
• One-line fix at packages/webdriver-utils/src/index.js:42.
• Tests added at three layers to lock the contract end-to-end.

Root cause

packages/webdriver-utils/src/index.js

comparisonData.sync = options.sync;
comparisonData.testCase = options.testCase;
comparisonData.labels = options.labels;            // <- added
comparisonData.thTestCaseExecutionId = options.thTestCaseExecutionId;

Tests

• packages/webdriver-utils/test/index.test.js (new) — 5 specs for WebdriverUtils.captureScreenshot:
  • forwards labels onto comparisonData
  • undefined when not provided
  • does not lose labels when provider response has none
  • works for playwright provider
  • re-throws provider errors
• packages/client/test/client.test.js — sendComparison spec asserts labels: 'qa, smoke,release' becomes tags: [{id: null, name: 'qa'}, ...] on the snapshot POST body.
• packages/core/test/api.test.js — /percy/automateScreenshot spec asserts labels survive percyAutomateRequestHandler and reach percy.upload.

Test plan

• cd packages/webdriver-utils && yarn test — 231/231 pass (incl. 5 new specs)
• cd packages/client && yarn test — new sendComparison labels spec passes (one pre-existing unrelated PAC-proxy test fails on Node URL message format)
• cd packages/core && yarn test — full suite has pre-existing Chromium install failures unrelated to this change; new API spec was added following the existing /automateScreenshot test patterns
• Manual verification: run any POA SDK with labels set and confirm tags are populated on the resulting snapshot in the Percy dashboard

🤖 Generated with Claude Code