Refactor python-cli-hexagonal per modularity review findings

[deimagjas]

Contexto

Implementa las cuatro observaciones del modularity review (2026-05-29) sobre la plantilla python-cli-hexagonal. El review encontró que la plantilla es sólida como ports & adapters, pero que sus patrones por defecto empujaban a los adopters hacia acoplamiento desbalanceado al crecer.

Cambios

• Dominio en capas (estilo Bancolombia) — domain/model/<feature>/ contiene el modelo + su gateway (puerto); domain/usecase/<feature>/ contiene el caso de uso puro + sus errores. Resuelve la baja cohesión de los antiguos archivos planos (models.py/ports.py/use_cases.py).
• Use cases puros — greet(request) -> Greeting ya no entrega IO; la entrega por el puerto ocurre en el entrypoint/.
• Composition root único — wiring.build_dependencies() construye un contenedor Dependencies una sola vez en el callback raíz de cli.py, inyectado vía ctx.obj. Los comandos ya no construyen dependencias.
• Type checking con ty — verifica que los adapters satisfacen estructuralmente el Protocol de su gateway (pre-commit + CI). Cierra el hueco donde un cambio de firma de un puerto pasaba lint/tests y solo fallaba en runtime.

tach.toml ahora fuerza el flujo usecase → model → kernel compartido. README y CLAUDE.md actualizados (arquitectura, receta para añadir comandos, invariantes).

Verificación

app greet --name Mundo   → "Hola, Mundo!"  exit 0
app greet --name "   "   → "Error: ..."     exit 1
pytest                   → 6 passed
ty check                 → All checks passed!
ruff check / format      → clean
tach check               → All modules validated!
uv build                 → wheel + sdist OK

Comprobación del contrato (prueba de la observación #1): renombrar GreeterPort.deliver hace que ty check falle en el sitio de uso y en wiring.py (ConsoleGreeter no asignable al protocolo) — algo que antes pasaba CI en silencio.

🤖 Generated with Claude Code

[deimagjas]

Comentarios atendidos en e509bcd:

• modularity-review.html → eliminar: archivo borrado del PR (se conserva la versión .md, que se renderiza en GitHub).
• Dependencies → usar pydantic: wiring.Dependencies ahora es un BaseModel inmutable (frozen=True, arbitrary_types_allowed=True) en lugar de dataclass. Estamos en el entrypoint/, donde se permiten dependencias externas. Como bonus valida en construcción que cada puerto inyectado cumpla su Protocol: un adapter incorrecto se rechaza en el composition root. Para habilitar esa validación por isinstance, GreeterPort se marcó @runtime_checkable (la verificación estática estructural la sigue haciendo ty). Añadí pydantic>=2.0 como dependencia de runtime y tests/unit/test_wiring.py.

Verificación: pytest (9 passed), ty check, ruff, tach y uv build en verde.

Nota: tu review sigue en estado Pending (los comentarios son borradores). No puedo marcar los hilos como Resolved hasta que envíes el review desde GitHub; una vez enviado, puedo resolverlos.