docs(clay-ads): add beta note for Growth plans with Audience Ads V2 entitlement

[george-dilthey]

What changed
Updated docs/clay-ads.md to add a beta note in the plan availability section: Growth workspaces with Audience Ads V2 enabled can create additional Audience Ads for people lists beyond the 1 included sync, while company list syncs remain limited to 1 per workspace.

Why
A code change deployed July 13, 2026 (clay-run/clay-base 8b12379...bee4969) updated the Audience Ads entitlement logic. The new useAdsEntitlement.ts hook allows Growth workspaces with the enable-ads-v2 Eppo flag enabled to access Audience Ads for people lists beyond their 1 included ad sync limit — company list syncs remain gated at 1. Previously, Growth plans were only entitled via the separate AdsAudienceEntitlement flag (an escape hatch for non-standard plans). This deploy adds a formal plan-based entitlement path for Growth + AdsV2.

The verifier sub-agent confirmed the entitlement formula at clay-base/apps/frontend/src/hooks/ad-syncs/useAdsEntitlement.ts:20-21 (isEnterprise || (isGrowth && isAdsAudiencesV2Enabled) || isAdsAudienceEntitlementFlagEnabled) and returned BETA — the flag defaults false, was in internal beta as of July 8, and Eppo controls actual Growth rollout. Beta framing is applied per the BETA verdict.

Source link(s)

• Deploy compare: https://github.com/clay-run/clay-base/compare/8b123793de69bb4fb8112cbe3763fcb26b792f90...bee49691239b0f98f736fbbcbab43fb3184b54a3
• Workflow run: https://github.com/clay-run/clay-base/actions/runs/29255939927
• Code evidence: clay-base/apps/frontend/src/hooks/ad-syncs/useAdsEntitlement.ts:20-21
• Slack (AdsV2 internal beta context, July 8): https://clay-hq.slack.com/archives/C08RWUQPPLN/p1783523387105319

Uncertainties
The enable-ads-v2 flag defaults to false and was in an internal-only beta as of July 8 (workspace 4515 only). The Eppo dashboard controls which Growth workspaces have it enabled — no confirmed broader customer rollout at time of write. The verifier returned BETA (not INTERNAL), so documenting with beta framing is appropriate, but actual customer exposure is limited until the flag is enabled more broadly.

Related observations

• PR docs(clay-ads): broaden beta note from Sync panel to Clay Ads feature #1504 is also open on docs/clay-ads.md and adds a general note that Clay Ads is in beta rollout for Growth and Enterprise workspaces. That note is broader than this change; a reviewer should reconcile the two at merge time to avoid redundancy. This PR's addition is materially distinct — it documents the specific new AdsV2 capability (additional people-list Audience Ads for Growth beyond the 1 included sync) rather than the general availability status.
• The same deploy also renames the ad sync UI label from "Ad Sync" to "Legacy Ad Sync" for AdsV2 workspaces — only visible to those workspaces, no separate doc entry needed.
• The page-size bump for account agents (500→1000, commit 1f9e6f04) is a backend Clickhouse performance optimization with no customer-visible behavior change. No docs needed.
• Other commits in this deploy (task def updates, Anthropic key removal, test cleanup) are infrastructure/internal-only. No docs needed.

Confidence: medium

Closes DOC-1104

[linear-code]

DOC-1104