feat(orm): modelos POO con anotaciones tipadas (Fase 1.5)

[ShibaRoPinoo]

Resumen

ORM ligero sobre el QueryBuilder de #6. Estilo híbrido: las anotaciones Python dan el tipo, fields.X(...) añade metadata extra cuando hace falta.

class User(Model):
    __table__ = \"users\"
    id: int = fields.PrimaryKey()
    name: str
    email: str = fields.String(unique=True)
    age: int | None = None
    settings: dict = fields.Json(default_factory=dict)
    created_at: datetime = fields.DateTime(default_now=True)

shiba.set_default_connection(cx)
User.create_table()
user = User(name=\"John\"); user.save()
User.find(1)
User.where(\"age\", \">\", 18).get()  # → list[User]

Highlights

• shiba/orm/fields.py con 12 subclases (PrimaryKey, String, Integer, Boolean, Json, DateTime, DecimalField, Enum, ForeignKey, ...) y motor de inferencia que entiende T | None, dict, list, builtins y datetime.
• Model con metaclass que lee anotaciones por MRO con inspect.get_annotations(eval_str=True) — soporta from __future__ import annotations.
• ModelQuery[T] que delega al QueryBuilder y hidrata cada fila al modelo.
• Conexión inyectable: global (set_default_connection(cx)) o por clase (__db__).
• ErrorCode.raise_ ahora se tipa como NoReturn.

Test plan

• 16 tests nuevos cubren inferencia, save (INSERT con LAST_INSERT_ID + UPDATE), delete, find, where + order_by con hidratación, JSON roundtrip, create_table DDL, validación de PK obligatoria y kwargs desconocidos
• Total 100/100. ruff y mypy --strict limpios
• Smoke contra MySQL real → llega con el PR de Testcontainers

Apilado sobre #6. Mergear después de #5 y #6.

🤖 Generated with Claude Code