feat(annotations): add debug mode with @lytics/kero logger

[prosdev]

Summary

Add structured debug logging to @lytics/playwright-annotations using @lytics/kero for troubleshooting annotation issues.

Changes

• Added @lytics/kero as a dependency - Zero-dependency structured logger with pretty output in dev, JSON in production
• Updated all annotation helpers with debug logging:
  • pushAnnotations
  • pushSuiteAnnotation
  • pushTestAnnotations
  • pushContentstackAnnotations
• Updated documentation with troubleshooting section

Usage

PLAYWRIGHT_ANNOTATIONS_DEBUG=true npx playwright test

Output Example

[10:05:11] DEBUG pushSuiteAnnotation called {"testTitle":"user can view tokens","testSuiteName":"ACCOUNT_SECURITY"}
[10:05:11] DEBUG pushTestAnnotations called {...}
[10:05:11] DEBUG Looking for testSuiteName in existing annotations {"found":true,"testSuiteName":"ACCOUNT_SECURITY"}
[10:05:11] DEBUG Validation result {"valid":true,"errors":[],"warnings":[]}

Why

Teams were having trouble debugging annotation issues (e.g., testSuiteName not being set in beforeEach). This debug mode shows exactly what's happening at each step.

Changeset

Minor version bump for @lytics/playwright-annotations since we added a new dependency.