feat!: generated request models validate requests before the wire (0.3.0)

[yudelevi]

Why

Bad requests currently fail as server 422s. Every SDK method now takes one generated pydantic request model, so shape errors (missing required field, out-of-range value, unknown enum) raise pydantic.ValidationError locally before any HTTP call. The server stays the authority on cross-field/semantic rules; the client validates shape.

Models are generated from the platform OpenAPI spec rather than mirrored from platform pydantic sources — those import geo, constants, propelauth, litellm and have no shared package.

What changed (0.3.0, breaking)

• scripts/gen_requests.py: walks the @api_route registry, keeps platform names for JSON bodies (FindEmailRequest, ContactFilters, …), synthesizes <Resource><Method>Params for query routes (MatchCompanyParams, DiscoverParams), runs datamodel-code-generator, ruff-formats, --check for drift. Output committed to discolike/_generated/requests.py, re-exported via discolike.requests.
• DiscolikeRequest base: extra="allow" (unknown fields pass through — escape hatch when the SDK lags the platform), to_wire() = exclude_unset so explicit None reaches the wire (LLMProviderUpdateRequest.api_key is required-nullable).
• All 48 SDK routes: client.match.company(MatchCompanyParams(name=...)). Path params and file stay keyword-only. enrich.segment split into segment (GET) / segment_file (POST multipart).
• check_contract.py: request side reads the model off the annotation, bidirectional field diff. CI also runs gen_requests.py --check under the same DEV_SPEC_URL/prod fallback.
• CLI: Typer options unchanged; models built via build_request; pydantic errors exit 2; --param KEY=VALUE rides on extra="allow". append now requires --dataset. --contacts-file rejects empty cells locally.
• 0.3.0 lockstep pins, CHANGELOG, README/CONTRIBUTING/examples updated.

Gates

check	dev spec	prod spec
check_contract.py	pass (48 routes, 10 models)	fail — 26 provider/discogen body mismatches
gen_requests.py --check	up to date	stale (Body_* inline names)

Prod failures are the known platform deploy lag (same gate as #12): the committed models track dev until prod ships DiscoGenProcessRequest, LLMProviderCreateRequest, SearchProviderRequest, etc. Documented in README/CONTRIBUTING so nobody "fixes" it by regenerating from prod.

pytest: 385 passed. ruff, ruff format, ty clean (incl. examples/, scripts/).

Not in this PR

• gen_requests.py drops query params on a route that also has a JSON body (none exist; check_contract would flag one).
• _merge_params lives in discover.py, imported by 8 CLI modules.
• examples/ is outside CI's ty check target set.

Greptile Summary

This breaking 0.3.0 release replaces SDK method keyword arguments with generated Pydantic request models, adding local request validation and consistent serialization before transport.

• Adds OpenAPI-based request-model generation, drift detection, and contract checks.
• Migrates synchronous, asynchronous, and CLI call paths to the generated models.
• Splits domain and file segmentation paths and updates package versions, documentation, examples, and tests.

Confidence Score: 5/5

The PR appears safe to merge based on the reviewed changes, with no concrete actionable defects identified.

The generated request boundary, resource serialization, synchronous and asynchronous paths, CLI validation handling, and contract-generation workflow remain internally consistent, while the notable production-spec fallback and breaking input changes are explicitly documented.

Important Files Changed

Filename	Overview
scripts/gen_requests.py	Generates deterministic Pydantic request models from registered OpenAPI routes and supports committed-artifact drift checks.
packages/discolike/src/discolike/_generated/requests.py	Adds the generated request-model surface with field constraints, enums, required fields, and query/body-specific models.
packages/discolike/src/discolike/_models.py	Introduces the shared request base with allowed extra fields and alias-aware, exclude-unset wire serialization.
packages/discolike/src/discolike/_client.py	Migrates top-level synchronous and asynchronous operations to request-model parameters while preserving resource delegation.
packages/discolike/src/discolike/resources/enrich.py	Migrates append and segmentation serialization and separates GET domain segmentation from multipart file segmentation.
packages/discolike-cli/src/discolike_cli/_output.py	Adds common request construction, Pydantic coercion, and validation-error conversion to the CLI exit-code contract.
scripts/check_contract.py	Extends contract validation to infer request models from route annotations and compare request fields bidirectionally.
.github/workflows/contract.yml	Adds generated-request drift validation using the same development-spec or production-fallback selection as contract checks.

_{Reviews (1): Last reviewed commit: "fix(cli): reject empty cells in --contac..." | Re-trigger Greptile}

Context used (4)

• Knowledge Base — Resource and model foundations
• Knowledge Base — Data service APIs
• Knowledge Base — CLI command execution and output
• Knowledge Base — Contract and release workflows