internal/

Package codegen renders every generator-owned file kind (session, field-identifier constants, model, collection, internal store/record adapters) plus the one-time developer-owned extension file, from a GenerationPlan.

Package config decodes and validates the plugin's `options` block: schema version gating, bounded-context/model/field structural validation, and order-preserving decode of the declaration-ordered `models` and `fields` objects.

Package contract validates each configured lifecycle operation against sqlc query metadata: the required command (:one, :execrows, ...), whether insert/update return the full persisted row via RETURNING, and whether a query's parameters and result columns can hydrate the fields it needs to.

Package diagnostics defines the Diagnostic type, severity levels, and the deterministic sort/format rules used to report configuration and generation problems across every validation stage of the pipeline.

Package generate is the thin orchestrator chaining internal/config -> internal/plan -> internal/codegen into the plugin's full request/response cycle, and the FR-017 atomicity check that decides whether any output is emitted at all for a given run.

Package mapping resolves each field's underlying database column and sqlc query result column, either from an explicit override or by exactly one unambiguous automatic match; ambiguous or missing matches are reported as diagnostics rather than guessed.

Package plan builds the deterministic, order-preserved GenerationPlan (contexts -> models -> fields -> operations) from validated configuration, resolved field mappings, and contract-validated operations.

Package relation validates the relation graph declared across a bounded context's models: target/inverse resolution and kind compatibility, per-kind query command/cardinality requirements, and scope parameter/type/name-collision compatibility.