Manifiesto (ingot.json)
Cada extensión tiene un ingot.json en su raíz: quién la publica, su versión y su tipo, qué añade a Ingot y qué archivos entran en el paquete .ingotx. Esta página lista todos los campos y las comprobaciones que hace la tienda.
Añade la línea del esquema y tu editor completará y revisará el archivo mientras escribes:
{ "$schema": "https://www.ingotide.com/schemas/ingot.json" }
Ejemplo
{
"$schema": "https://www.ingotide.com/schemas/ingot.json",
"name": "react-rules",
"publisher": "acme",
"displayName": "React Rules",
"version": "1.2.0",
"type": "rules",
"description": "Convenciones para proyectos React y TypeScript.",
"license": "MIT",
"repository": "https://github.com/acme/react-rules",
"keywords": ["react", "typescript"],
"icon": { "mark": "Re", "color": "#1B2647" },
"engines": { "ingot": ">=0.1.0" },
"contributes": {
"rules": [{ "path": "rules/react.mdc" }],
"commands": [{ "name": "review", "description": "Revisa los archivos abiertos", "path": "commands/review.md" }]
}
}
Campos
| Campo | Obligatorio | Reglas |
|---|---|---|
$schema | no | si está, debe ser https://www.ingotide.com/schemas/ingot.json |
name | sí | de 2 a 50 letras minúsculas o dígitos, palabras unidas con -; único dentro de tu publicador |
publisher | sí | tu identificador de publicador (de 3 a 32 caracteres) |
displayName | sí | el nombre en la tienda, hasta 60 caracteres |
version | sí | versión semántica como 1.0.0 o 1.1.0-beta.1, sin v |
type | sí | theme, rules, habits, mcp o rex-template (tipos) |
description | sí | una línea para la tarjeta de la tienda, hasta 200 caracteres |
license | sí | un id SPDX como MIT o Apache-2.0 |
repository, homepage | no | URLs https://, se muestran en la página de la tienda |
keywords | no | hasta 10 palabras (de 30 caracteres cada una), para la búsqueda de la tienda |
icon | no | { "mark": "Re", "color": "#RRGGBB" }: de 1 a 3 caracteres sobre un recuadro de color |
engines | no | { "ingot": ">=0.1.0" }: la versión más antigua de Ingot con la que funciona |
files | no | hasta 50 archivos o carpetas extra para empaquetar (scripts, recursos, código del servidor) |
contributes | sí | lo que añade la extensión; ver abajo |
El id de la extensión es publisher.name (por ejemplo acme.react-rules); su página en la tienda es /marketplace/acme.react-rules. Se rechazan los campos desconocidos y también downloads, installs, rating, ratings, reviews y stars: la tienda no muestra números que no ha medido.
contributes
| Clave | Entrada | Archivos |
|---|---|---|
themes | { "id", "label", "uiTheme": "dark" o "light", "path" } | .json de tema con colors y/o tokenColors |
rules | { "path" } | .md o .mdc |
habits | { "path" } | .json con id, title, match, rule y threshold opcional |
commands | { "name", "description", "path" } | .md; name se convierte en /name en el chat del agente |
mcpServers | "id": { "command", "args", "env" } o "id": { "url" } | ninguno (pon el código del servidor en files) |
rexTemplates | { "id", "title", "path" } | .md |
La clave de contributes que corresponde al type debe tener al menos una entrada. Los ids y los nombres de comando deben ser únicos dentro del paquete.
Para servidores MCP: command es el programa que se ejecuta, args sus argumentos (${extensionDir} se sustituye por la carpeta de instalación) y env asocia cada nombre de variable en MAYÚSCULAS_CON_GUIONES_BAJOS con una descripción de lo que debe escribir el usuario. Un servidor remoto solo tiene url, que debe ser https://.
Qué entra en el paquete
ingot package incluye:
ingot.jsonREADME.md,CHANGELOG.mdyLICENSE(oLICENSE.md,LICENSE.txt) si existen- cada archivo al que apunta una entrada de
contributes - todo lo que aparece en
files(una carpeta incluye todo su contenido)
No se empaqueta nada más, así que node_modules, .git y tus notas locales quedan fuera. La tienda rechaza un paquete que contenga cualquier otra cosa.
Las rutas deben ser relativas, usar / y quedarse dentro del paquete: sin .., sin / al principio y sin archivos ni carpetas ocultos.
Límites
| Límite | Valor |
|---|---|
Tamaño del paquete (.ingotx) | 4 MB |
| Tamaño descomprimido | 20 MB |
| Un archivo | 2 MB |
| Archivos por paquete | 200 |
| README mostrado en la tienda | 50.000 caracteres |
| Subidas por publicador | 30 por hora |
El formato .ingotx
Un archivo .ingotx es un ZIP estándar con ingot.json en la raíz. Puedes abrirlo con cualquier herramienta de descompresión. La CLI escribe las entradas en un orden fijo y con fechas fijas, así que empaquetar dos veces las mismas fuentes da los mismos bytes y el mismo SHA-256. La tienda vuelve a comprobarlo todo al subir: el manifiesto, cada ruta, el contenido de los archivos y los límites de arriba.