test(cdc): bind EnvUtils public documentation

[seonghobae]

Purpose

Advance #229 test-first. Public CDC deployment helper EnvUtils defines optional/default and required environment-variable behavior but protected source exposed that contract without beginner-readable public Javadocs. This bounded candidate changes only EnvUtils Javadocs plus the literal-source documentation assertion that drove the original RED.

Exact current identity

• protected/live base: develop@c2511f6b9d716ef9ab8de60a91fffd826714a4c5;
• branch: quality/cdc-envutils-docs-tests-622e5e6;
• test-only RED head: ad2aa69b2bc8dcbde5778381b8e5557847b0f2d0;
• prior GREEN source head: d67b56d8a32114cece071193dcd632800b97f885;
• exact current source head: 100bc8dc56505fb00691c89ee8af22fd72ab5d4c;
• Draft / mergeable: true / true;
• formal reviews on current head: none.

The current head is a non-forced two-parent refresh merge whose parents are the prior source head and exact protected develop@c2511f6b9d716ef9ab8de60a91fffd826714a4c5. The merge-base is now the live protected tip, and the PR diff remains exactly the two intended EnvUtils source/test files (41 additions, zero deletions). The one protected-base commit incorporated by the refresh changes only CdcEngineHealthIndicator source/tests, so no file conflict or behavior selection was required.

Historical RED and GREEN

CI 31378006409, macOS job 93421540601, checked out synthetic merge 6680eb7b541ee231c84bcdad05534a5aa8fc4608 from the test-only head. Production and tests compiled; CDC then failed exactly EnvUtilsTest.publicEnvironmentApiHasBeginnerReadableJavadoc, while existing behavior assertions remained green. This is valid historical RED at the intended public-documentation boundary.

Prior GREEN d67b56d8a32114cece071193dcd632800b97f885 documented optional/default and required fail-closed semantics without changing lookup logic, blank handling, return values, exception type/message, environment variable names or credential paths. Its historical workflow aggregates were green, but that evidence does not transfer to the refreshed head.

Current validation boundary

Current-head workflows were retriggered by the non-destructive refresh. Dependency Review is already terminal-success; CI, SBOM, Semgrep and Security Scan are still current-head evidence only when they reach terminal state. Pending/queued/skipped-required/synthetic-only/predecessor-head results do not pass their gate. The inherited selected-bundle JaCoCo 0 classes false-green remains separately owned by #162/#164, repository-wide coverage by #205, complete Maven vulnerability materialization by #196, and literal-source workflow controls by #121.

Keep Draft. Merge requires unchanged exact-head accepted evidence, zero valid unresolved findings and qualifying independent non-author formal approval; no historical or synthetic evidence transfers.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 7410c890-c29e-4cc7-bfb1-7da0295d1874

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[seonghobae]

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.