Herramienta `mini`#

Se instala con el paquete Python. Ejecuta mini en una terminal para abrir el asistente: crea un toolkit desde un archivo de datos o definiendo campos, y recibe una GUIA.md en la carpeta generada. También puedes crear tu propio contrato con mini build o mini from-schema. Las familias de muestra son opcionales; si las descargas, escribe --forks DIR antes del comando, por ejemplo mini --forks forks validate respuesta.mini.

Comando	Qué hace
`mini setup` / `mini init`	Asistente para construir tu toolkit propio desde datos o campos.
`mini integrate PROYECTO --bundle .mini [--apply]`	Localiza la llamada a IA, prepara una guía y conecta código Python compatible con copia.
`mini forks`	Lista las familias del registro.
`mini validate ARCHIVO`	Validación estricta; sale con 1 si hay errores.
`mini diagnose ARCHIVO`	Validación tolerante; imprime un informe JSON con errores y líneas a regenerar.
`mini to-json ARCHIVO`	`.mini` → JSON canónico.
`mini from-json ARCHIVO -p PREFIJO`	JSON canónico → `.mini`.
`mini build MUESTRA.json [OTRAS.json] --prefix PREFIJO --out .mini`	Genera el toolkit de dominio desde muestras JSON.
`mini prompt PREFIJO --lang es`	Bloque de especificación para el prompt del modelo.
`mini tokens ARCHIVO --enc o200k_base`	Tokens y bytes, declarando el tokenizador.
`mini check-forks`	Comprueba los cinco invariantes y la ida y vuelta de los fixtures.
`mini new-fork PREFIJO --from PADRE --add "campo:tipo"`	Crea una familia nueva a partir de otra.
`mini from-schema ESQUEMA.json -p PREFIJO`	JSON Schema (o `--pydantic modulo:Modelo`) → contrato `.mini`.
`mini to-schema PREFIJO`	Contrato → JSON Schema con anotaciones `x-mini`.
`mini bench ARCHIVO --enc o200k_base`	Tokens y bytes en .mini, JSON, YAML, CSV y TOON, con el ahorro frente a JSON compacto.
`mini repair ARCHIVO --contract contract.json`	Reparación segura de una respuesta de un toolkit de dominio, sin inventar datos.

mini from-schema ticket.schema.json -p tk --out contrato.json
mini validate respuesta.mini --contract contrato.json
mini diagnose respuesta.mini --contract contrato.json | jq '.errors'
mini prompt --contract contrato.json --lang es > prompt_sistema.txt
# Con el ZIP opcional extraído: mini --forks forks check-forks

`mini` tool#

Installed with the Python package. Run mini in a terminal to start the interactive guide: build a toolkit from a data file or define fields, then follow the generated GUIA.md. You can also build your own contract with mini build or mini from-schema. The sample families are optional; after downloading them, put --forks DIR before the command, for example mini --forks forks validate response.mini.

Command	What it does
`mini setup` / `mini init`	Interactive guide to build your toolkit from data or fields.
`mini integrate PROJECT --bundle .mini [--apply]`	Locate the AI call, prepare a guide and connect supported Python with a backup.
`mini forks`	Lists the registry families.
`mini validate FILE`	Strict validation; exits 1 on errors.
`mini diagnose FILE`	Lenient validation; prints a JSON report with errors and lines to regenerate.
`mini to-json FILE`	`.mini` → canonical JSON.
`mini from-json FILE -p PREFIX`	Canonical JSON → `.mini`.
`mini build SAMPLE.json [OTHERS.json] --prefix PREFIX --out .mini`	Generates the domain toolkit from JSON samples.
`mini prompt PREFIX --lang es`	Specification block for the model prompt.
`mini tokens FILE --enc o200k_base`	Tokens and bytes, declaring the tokenizer.
`mini check-forks`	Checks the five invariants and fixture round-trips.
`mini new-fork PREFIX --from PARENT --add "field:type"`	Creates a new family from another.
`mini from-schema SCHEMA.json -p PREFIX`	JSON Schema (or `--pydantic module:Model`) → `.mini` contract.
`mini to-schema PREFIX`	Contract → JSON Schema with `x-mini` annotations.
`mini bench FILE --enc o200k_base`	Tokens and bytes in .mini, JSON, YAML, CSV and TOON, with the saving versus compact JSON.
`mini repair FILE --contract contract.json`	Safe repair of a domain-toolkit response, without guessing data.

mini from-schema ticket.schema.json -p tk --out contract.json
mini validate response.mini --contract contract.json
mini diagnose response.mini --contract contract.json | jq '.errors'
mini prompt --contract contract.json --lang en > system_prompt.txt
# With the optional ZIP extracted: mini --forks forks check-forks

Herramienta mini#

mini tool#

Herramienta `mini`#

`mini` tool#