Actualizar el motor

Una modificación legal debe mantener sincronizados código, catálogo, pruebas, changelog y documentación.

Agregar o modificar una actuación

1. Identificar el artículo, inciso y texto normativo.
2. Seleccionar el catálogo correcto en src/data.
3. Definir un ID estable y único.
4. Elegir tipoCalculo.
5. Definir jornales, porcentajes y baseCalculo.
6. Agregar notas cuando la regla requiera contexto.
7. Confirmar que calculateHonorarios puede despachar la categoría.
8. Crear pruebas del caso normal, piso, rol y base derivada cuando apliquen.

No reutilices un ID publicado para una actuación conceptualmente distinta. Si una regla cambia, documentá el impacto en el changelog.

Agregar un servicio extrajudicial

Además del registro en src/data/extrajudiciales.ts:

• ampliar HonorarioExtrajudicialServiceType;
• actualizar ACTUACION_ID_TO_SERVICE_TYPE;
• implementar el caso en calculateHonorariosExtrajudiciales;
• validar los campos condicionales;
• cubrir mínimos, máximos y redondeo;
• documentar el nuevo campo de entrada si lo hubiera.

Validar el paquete

npm run test
npm run typecheck
npm run build

Cada corrección de una regla que haya producido montos incorrectos debe incluir una prueba de regresión con valores esperados explícitos.

Regenerar la referencia

El generador vive en scripts/generate-docs.mjs y lee los módulos ESM de dist. Para generar una copia local:

npm run docs:generate

La salida predeterminada es generated-docs/. Para escribir en otra ubicación, primero construí el paquete y ejecutá Node directamente:

npm run build
node scripts/generate-docs.mjs --out <directorio-de-salida>

Para comprobar que una copia existente está sincronizada:

node scripts/generate-docs.mjs --check --out <directorio-de-salida>

Los archivos generados contienen una advertencia en su cabecera y no deben editarse manualmente.

Actualizar la documentación editorial

Revisá especialmente:

• versión indicada en la portada técnica;
• instalación y requisitos;
• nuevas entradas o propiedades;
• validaciones y alertas;
• ejemplos afectados;
• guía de migración;
• conteos que aún aparezcan fuera de las páginas generadas.

Después ejecutá en el sitio:

npm run docs:build
npm run docs:preview

Publicar

El paquete se publica mediante tags v* después de pasar tests y build. La documentación debe prepararse para la misma versión, revisarse y publicarse por su flujo propio. La automatización futura debería abrir un cambio revisable en el repositorio de documentación, no publicar directamente en producción.