# Contributor handoff — SeaQL/sea-orm

> Canonical page: https://codevetter.com/unpack/sea-orm/agent-handoff

# Contributor handoff — SeaQL/sea-orm

Scanned commit db40a19a7bde7be8e1c4b346b1b70d72e87f0245 (2026-09-27). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Begin with manifests, the library exports, and the exact feature-specific implementation involved in the task. Tests and CI were inspected, not executed, and this bounded brief supplies no passing validation result. Future authorized edits should respect generation boundaries, isolated database targets, and distinct contracts for schema sync, nested persistence, and authorization.
- Read Cargo.toml, src/lib.rs, CLAUDE.md, and CONTRIBUTING.md first: the repository explicitly documents SeaORM 2.0 model relations, typed COLUMN access, builder-style ActiveModels, and changed raw execution APIs. — [Cargo.toml#L4-L16](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/Cargo.toml#L4-L16) [src/lib.rs#L689-L728](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/lib.rs#L689-L728) [CLAUDE.md#L14-L16](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/CLAUDE.md#L14-L16) [CLAUDE.md#L200-L212](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/CLAUDE.md#L200-L212)
- Choose package-specific checks: CONTRIBUTING documents cargo test --workspace and a separate CLI manifest command; CI additionally defines separate migration checks. These commands were inspected, not executed, and require separate execution authorization in a read-only investigation. — [CONTRIBUTING.md#L35-L50](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/CONTRIBUTING.md#L35-L50) [.github/workflows/rust.yml#L117-L120](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/.github/workflows/rust.yml#L117-L120) [.github/workflows/rust.yml#L187-L207](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/.github/workflows/rust.yml#L187-L207) [.github/workflows/rust.yml#L331-L334](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/.github/workflows/rust.yml#L331-L334)
- For live database validation, select the appropriate driver/runtime features and an isolated target: documented integration commands depend on DATABASE_URL, and common setup issues DROP DATABASE and CREATE DATABASE statements. — [CONTRIBUTING.md#L52-L68](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/CONTRIBUTING.md#L52-L68) [tests/common/setup/mod.rs#L12-L54](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/tests/common/setup/mod.rs#L12-L54) [sea-orm-migration/tests/main.rs#L139-L175](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-migration/tests/main.rs#L139-L175)
- Before modifying persistence, read ActiveModelTrait together with insert execution and generated ActiveModelEx actions; preserve primary-key branching, lifecycle hooks, RETURNING fallback lookup, and relation-before/after transaction ordering. — [src/entity/active_model.rs#L225-L235](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/entity/active_model.rs#L225-L235) [src/entity/active_model.rs#L375-L403](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/entity/active_model.rs#L375-L403) [src/executor/insert.rs#L500-L536](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/executor/insert.rs#L500-L536) [sea-orm-macros/src/derives/active_model_ex.rs#L744-L793](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-macros/src/derives/active_model_ex.rs#L744-L793)
- Treat generation fixtures as behavior specifications: writer tests compare expected token streams, rustfmt excludes tests_cfg, and experimental regeneration preservation has exclusions and fallback writes that must be reviewed before use. — [sea-orm-codegen/src/entity/writer.rs#L1991-L2039](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-codegen/src/entity/writer.rs#L1991-L2039) [.rustfmt.toml#L1-L6](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/.rustfmt.toml#L1-L6) [sea-orm-cli/src/commands/generate.rs#L385-L436](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-cli/src/commands/generate.rs#L385-L436)
- Check synchronous parity for shared ORM changes, but do not casually run make-sync.sh: the script deletes mirror trees and transforms async source/tests, and sea-orm-sync has a separate workspace and dependency boundary. — [build-tools/make-sync.sh#L23-L50](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/build-tools/make-sync.sh#L23-L50) [sea-orm-sync/Cargo.toml#L1-L16](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-sync/Cargo.toml#L1-L16) [sea-orm-sync/Cargo.toml#L57-L75](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/sea-orm-sync/Cargo.toml#L57-L75)
- Preserve capability limits: schema sync adds missing objects and leaves mismatches untouched, nested relation mutation is experimental, Replace can delete omitted children, and restricted connections reject raw SQL while auditing structured statements. — [src/schema/builder.rs#L77-L87](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/schema/builder.rs#L77-L87) [src/entity/active_model_ex.rs#L43-L61](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/entity/active_model_ex.rs#L43-L61) [src/database/restricted_connection.rs#L54-L90](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/database/restricted_connection.rs#L54-L90) [src/database/restricted_connection.rs#L526-L557](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/src/database/restricted_connection.rs#L526-L557)
- Review example behavior before reusing it in applications: Actix handlers unwrap query parsing and expect database success, and Rocket run_migrations discards migration errors. Example compilation or generic CI definitions do not establish request-path correctness or successful startup migrations. — [examples/actix_example/api/src/lib.rs#L37-L50](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/examples/actix_example/api/src/lib.rs#L37-L50) [examples/actix_example/api/src/lib.rs#L74-L85](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/examples/actix_example/api/src/lib.rs#L74-L85) [examples/rocket_okapi_example/api/src/lib.rs#L27-L30](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/examples/rocket_okapi_example/api/src/lib.rs#L27-L30) [.github/workflows/rust.yml#L252-L264](https://github.com/SeaQL/sea-orm/blob/db40a19a7bde7be8e1c4b346b1b70d72e87f0245/.github/workflows/rust.yml#L252-L264)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)