Changelog¶

Historial de versiones del proyecto (formato Keep a Changelog).

[No publicado]¶

Sitio de documentación con MkDocs Material + mkdocstrings: referencia API auto-generada de los 4 módulos, guías, changelog integrado y aviso legal como snippet reutilizable. Despliegue a GitHub Pages vía .github/workflows/docs.yml (build --strict). Extra [docs] en pyproject.toml y URL Documentation en los metadatos.
Galería de ejemplos examples/ (6 scripts ejecutables: cálculo básico, tasa secundaria, tabla API personalizada, ingesta CSV/JSON, manejo de errores y serialización JSON) con test anti-drift (tests/test_ejemplos.py) que verifica su salida en cada commit.
Documentación completada: docs/quickstart.md (instalación, primer cálculo, lectura del resultado campo a campo) y docs/contributing.md (calidad, convenciones y proceso de PR).

Endurecido el pipeline CI/CD: todas las GitHub Actions ancladas a SHA de commit (antes tags mutables; pypa/gh-action-pypi-publish apuntaba a la rama release/v1), permisos contents: read de mínimo privilegio en ci.yml/release.yml y versiones exactas fijadas para build y twine en el job que produce el artefacto publicado.
Cadena de suministro reproducible: lockfile uv.lock con hashes SHA256, instalación de dependencias en CI vía uv sync --locked, nuevo job audit con pip-audit --strict sobre las dependencias exportadas del lockfile y .github/dependabot.yml (ecosistemas pip y github-actions).
Validación fail-fast de gravedad_api: se rechazan valores no finitos (Infinity/NaN, aceptados antes por json.loads) y fuera del rango físico (0, 80]; previamente un crudo con gravedad infinita producía una liquidación silenciosa. Cubierto por tests negativos vía dict y JSON.

FluidoCrudo: validación física (BS&W, gravedad API) y cálculo de volumen neto.
TasaLegal: tasas de regalía ordinaria (20 %, art. 42 LOH), banda secundaria (30 %, art. 43 LOH) y extrapesado (10 %, Faja Petrolífera del Orinoco).
TablaAjusteApi: factores de ajuste API configurables (tabla oficial referencial).
MotorRegalias: orden de liquidación inalterable (impurezas → precio ajustado → ingreso bruto → regalía) con aritmética Decimal.
Adaptadores CSV/JSON (ingesta.py) y marcador py.typed.