chore: improve sqlmodel maintenance path

[lphuc2250gma]

Summary:

• Add or tighten focused edge-case tests or type assertions in tests/conftest.py, tests/test_main.py related to Python typing, tests, CLI ergonomics, observability; avoid docs-only changes and broad refactors.
• Keep the change narrow so it is straightforward to review.

Notes:

• I kept this scoped to the relevant implementation and tests.

[github-actions]

This was marked as potentially AI generated and will be closed now. If this is an error, please provide additional details, make sure to read the docs about contributing and AI.