Add browser pool core data source

[IlyaasK]

Summary

• register the read-only kernel_browser_pool data source
• support exact lookup by canonical ID or exact name
• preserve project scoping: data-source override, provider project_id, then API-key binding
• expose only the first durable fields: id, name, project_id, and size
• add generated Registry documentation and focused unit coverage

Why

Existing browser pools can already be imported into the resource when Terraform should manage them. This data source covers the separate read-only case: reference an existing pool without taking ownership of its lifecycle.

The implementation performs one durable SDK GET and verifies that the returned ID or name matches the exact selector. API fields are validated before entering Terraform state.

Intentionally unsupported

• browser/session runtime operations or runtime state
• browser-pool writes through the data source
• resolved profile and extension references
• remaining durable launch, warmup, viewport, and Chrome policy fields
• live acceptance coverage in this first stack slice

Those durable read fields and acceptance coverage land in the following small PRs. No existing resource or data-source behavior changes.

Tests run

• go test -short -timeout=2m ./...
• go test -race -count=1 -short -timeout=2m ./internal/datasources/browserpool
• go vet ./...
• gofmt -l cmd internal
• bash scripts/check-docs.sh
• git diff --check origin/main...HEAD
• Gremlins mutation testing: 23/23 runnable mutants killed, 100% test efficacy and mutator coverage
• targeted semantic mutation testing: 10/10 provider registration, schema, project-scope, and state-assignment mutants killed

Focused tests cover schema and registration, Framework state writes, ID/name lookup, explicit/default/unscoped project selection, unnamed pools, API errors, nil or malformed responses, and selector mismatches.

Acceptance status

Not run in this PR. Live ID/name lookup and project scoping are added to the opt-in acceptance suite at the end of this stack.

Additional quality verification

• Gremlins: 23/23 runnable mutants killed; targeted semantic mutations: 10/10 killed
• browser-pool data-source coverage: 88.2%; maximum CRAP score: 15.0
• Godog stack suite: 7 scenarios / 21 steps passed, including the @pr74 core-state scenario

---

Note

Low Risk
Additive read-only data source with no changes to existing resources or data sources; risk is limited to new lookup behavior and API read validation.

Overview
Introduces kernel_browser_pool as a read-only data source so Terraform can reference an existing browser pool without adopting the resource lifecycle (complementing import on kernel_browser_pool resource).

Lookup uses exact id or name (shared ResolveIDNameSelector pattern), GetBrowserPool, and the same project scoping as other data sources (override → provider project_id → API key binding). Responses are validated and ID/name mismatches against the selector fail the read. State exposes only durable fields: id, name, project_id, and size—no runtime pool/session attributes.

Provider registration and generated docs are updated; unit tests cover schema, reads, project resolution, and error paths.

^{Reviewed by Cursor Bugbot for commit 1dbab8a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 63f8898. Configure here.}