GODRIVER-3659 Add awaitMinPoolSize to clientEntity constructor

[prestonvasquez]

GODRIVER-3659

Summary

Add awaitMinPoolSize to the unified test runner.

Background & Motivation

Warming clients should make CSOT tests less flakey.

[Copilot]

Pull Request Overview

This PR adds support for the awaitMinPoolSize option to the unified test runner's client entity constructor to improve test stability by warming connection pools before tests run.

• Updates supported schema version from 1.22 to 1.26
• Adds awaitMinPoolSize field to entityOptions struct with documentation
• Implements connection pool warming logic that waits for minimum pool size to be reached

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
internal/integration/unified/schema_version.go	Updates supported schema version to 1.26
internal/integration/unified/entity.go	Adds awaitMinPoolSize boolean field to entityOptions
internal/integration/unified/client_entity.go	Implements pool warming functionality and integrates it into client creation

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

The awaitMinimumPoolSize function is called with entity before entity.Client is assigned (line 235). This means the entity doesn't have a valid client when the function tries to check connection events, which could cause the function to behave incorrectly.

Suggested change

	if entityOptions.AwaitMinPoolSize && clientOpts.MinPoolSize != nil && *clientOpts.MinPoolSize > 0 {
	if err := awaitMinimumPoolSize(ctx, entity, *clientOpts.MinPoolSize); err != nil {
	return nil, err
	}
	}
	entity.Client = client
	entity.Client = client
	if entityOptions.AwaitMinPoolSize && clientOpts.MinPoolSize != nil && *clientOpts.MinPoolSize > 0 {
	if err := awaitMinimumPoolSize(ctx, entity, *clientOpts.MinPoolSize); err != nil {
	return nil, err
	}
	}

[prestonvasquez]

This doesn't matter since the pool event monitor was defined before client construction.

[prestonvasquez]

This branch must await mongodb/specifications#1834 and the subsequent specifications bump before merging.

[mongodb-drivers-pr-bot]

🧪 Performance Results

Commit SHA: be25c6d

The following benchmark tests for version 68c454c96d994a0007fa14a5 had statistically significant changes (i.e., |z-score| > 1.96):

Benchmark	Measurement	% Change	Patch Value	Stable Region	H-Score	Z-Score
BenchmarkSingleFindOneByID	ops_per_second_min	-33.1845	844.8222	Avg: 1264.4110 Med: 1251.6945 Stdev: 181.0055	0.7721	-2.3181
BenchmarkMultiInsertSmallDocument	total_time_seconds	-15.9073	1.0255	Avg: 1.2195 Med: 1.2195 Stdev: 0.0463	0.9156	-4.1895
BenchmarkBSONFlatDocumentDecoding	total_mem_allocs	2.4956	9225641.0000	Avg: 9001010.0000 Med: 8979131.0000 Stdev: 39100.2428	0.9323	5.7450
BenchmarkBSONFlatDocumentDecoding	total_bytes_allocated	2.4926	362709728.0000	Avg: 353888794.6667 Med: 353028584.0000 Stdev: 1533377.7150	0.9325	5.7526

For a comprehensive view of all microbenchmark results for this PR's commit, please check out the Evergreen perf task for this patch.

[mongodb-drivers-pr-bot]

API Change Report

No changes found!

[matthewdale]

Looks good! 👍