Versiones y compatibilidad#

mini-format 1.3.3 distribuye el perfil base SPEC 1.1, que mantiene válido todo documento SPEC 1.0, y el toolkit de dominio generado mini-domain/1. La versión del paquete identifica las herramientas; la versión del contrato identifica los datos que puede leer cada parser.

Campos añadidos al final#

En el perfil base, un lector acepta campos finales desconocidos únicamente cuando el prefijo coincide y la cabecera declara v mayor que la versión del contrato. Valida los campos conocidos y descarta la cola desconocida del objeto canónico. Los escapes de la línea siguen teniendo que ser válidos.

Con la misma versión, demasiados campos producen E05. Un cambio del núcleo o un prefijo diferente requiere otro contrato. La compatibilidad no sustituye a una migración entre dominios.

Diagnósticos#

Los errores del perfil base incluyen código, línea, campo y mensaje. Estos identificadores permiten conservar los registros válidos y dirigir el reintento al dato rechazado.

Toolkit generado#

El contrato, el prompt y las herramientas generadas forman una unidad. Reutiliza esa unidad y controla sus versiones junto con tu aplicación. Cuando cambies las muestras, genera y verifica una versión nueva antes de incorporarla al flujo. La guía del toolkit distingue sus capacidades de las del perfil base.

Distribución#

Toolkit ZIP, wheel Python, paquete TypeScript y código fuente. Estas descargas no requieren una cuenta ni acceso a un repositorio privado.

Versions and compatibility#

mini-format 1.3.3 distributes the SPEC 1.1 base profile, which keeps every SPEC 1.0 document valid, and the generated mini-domain/1 domain toolkit. The package version identifies the tools; the contract version identifies the data each parser can read.

Appended fields#

In the base profile, a reader accepts unknown trailing fields only when the prefix matches and the header declares a v higher than the contract version. It validates known fields and leaves the unknown tail out of the canonical object. Line escapes must still be valid.

At the same version, extra fields produce E05. Changing the core or using a different prefix requires another contract. Forward compatibility does not replace a domain migration.

Diagnostics#

Base-profile errors include a code, line, field and message. These identifiers let you preserve valid records and direct retries to the rejected data.

Generated toolkit#

The contract, prompt and generated tools form one unit. Reuse that unit and version it with your application. When samples change, generate and verify a new version before integrating it. The toolkit guide distinguishes its capabilities from those of the base profile.

Distribution#

Toolkit ZIP, Python wheel, TypeScript package and source code. Downloads require neither an account nor access to a private repository.