test: enforce generated model contracts

[kriptoburak]

Summary

• discover every generated JSON model, request params builder, and enum on the compiled classpath
• verify missing, invalid, unknown, fully populated, copy, equality, and JSON round-trip behavior
• exercise recursive validation and builder contracts without changing runtime code or public APIs

OpenSSF Evidence

The generated-inclusive JaCoCo report now measures:

• 94.05% line coverage (85,823 of 91,257)
• 92.81% branch coverage (22,231 of 23,952)

The maintained-source report remains above policy:

• 90.83% line coverage
• 81.54% branch coverage

Verification

• ./scripts/lint
• ./scripts/test --rerun-tasks (1,346 tests, 0 failures, 0 errors, 0 skipped)
• ./scripts/coverage --rerun-tasks
• ./scripts/audit (license policy and OSV scan)
• uvx reuse lint (REUSE 3.3 compliant)
• ./scripts/check-reproducible (15 byte-identical Maven artifacts)

Review Notes

This test-only change protects generated SDK contracts across future OpenAPI regenerations. Another human must review this nontrivial maintainer-authored change before merge.

Note

Add contract test suite for generated API models, params, and enums

• Adds GeneratedModelContractTest.kt, a JUnit test class that scans compiled classes under com.x_twitter_scraper.api.models at test runtime.
• Verifies builder, JsonField, additionalProperties, equality/hashCode/toString, and validation contracts for generated models; checks builder/getter behavior for params; and asserts correct known/unknown/invalid semantics for enum wrappers.
• Enforces minimum class-count floors so the build fails if generated output drops below expected counts.

^{Macroscope summarized 9ac4a2d.}

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.

[furkanerday]

Reviewed the complete diff, description, discussion, repository policies, public contracts, relevant tests, required checks, and commit sign-offs at 9ac4a2d. All required checks pass, no unresolved threads remain, and I found no blocking issue.