feat: add X-CLI-Event header for analytics tracking

[pjcdawkins]

Summary

• Add a custom HTTP header (X-CLI-Event) to all API requests for analytics tracking via Pendo
• Header format: command=<name>; interactive=<bool>
• Example: X-CLI-Event: command=backup:restore; interactive=true
• Works across both Go CLI native commands and legacy PHP CLI commands
• Respects user privacy opt-out settings

Opt-out

Users can disable telemetry via environment variables:

• DO_NOT_TRACK=1 (or true) - standard opt-out
• {PREFIX}DISABLE_TELEMETRY=1 (e.g., UPSUN_CLI_DISABLE_TELEMETRY=1)

Changes

Go CLI

• New EventTransport in internal/auth/event_transport.go that injects X-CLI-Event and User-Agent headers
• New context helpers: WithEventName, WithInteractive, and corresponding getters
• Event name and interactive flag passed via context from the root command
• EVENT_NAME environment variable passed to the legacy PHP CLI
• Respects DO_NOT_TRACK and {PREFIX}DISABLE_TELEMETRY opt-out settings

Legacy PHP CLI

• New EventHeaderMiddleware that adds X-CLI-Event header to Guzzle requests
• New Config::getEventName() and Config::isInteractive() methods
• Middleware registered in Api::getConnectorOptions()
• Respects DO_NOT_TRACK and {PREFIX}DISABLE_TELEMETRY opt-out settings

Header Format

X-CLI-Event: command=<command-name>; interactive=<true|false>

Examples:

• X-CLI-Event: command=backup:restore; interactive=true
• X-CLI-Event: command=project:info; interactive=false

The interactive flag is false when --no-interaction, -y, or --quiet flags are used, or when the {PREFIX}NO_INTERACTION=1 environment variable is set.

Test plan

• Run Go tests: make test
• Run PHP tests: cd legacy && php vendor/bin/phpunit tests/EventHeaderMiddlewareTest.php tests/ConfigTest.php
• Verify header appears in debug output: upsun project:info -vvv 2>&1 | grep -i "x-cli-event"
• Verify opt-out works: DO_NOT_TRACK=1 upsun project:info -vvv 2>&1 | grep -i "x-cli-event" (should show nothing)

🤖 Generated with Claude Code

[pjcdawkins]

we already add User-Agent elsewhere so is this right?