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

CampoObligatorioReglas
$schemanosi está, debe ser https://www.ingotide.com/schemas/ingot.json
namesíde 2 a 50 letras minúsculas o dígitos, palabras unidas con -; único dentro de tu publicador
publishersítu identificador de publicador (de 3 a 32 caracteres)
displayNamesíel nombre en la tienda, hasta 60 caracteres
versionsíversión semántica como 1.0.0 o 1.1.0-beta.1, sin v
typesítheme, rules, habits, mcp o rex-template (tipos)
descriptionsíuna línea para la tarjeta de la tienda, hasta 200 caracteres
licensesíun id SPDX como MIT o Apache-2.0
repository, homepagenoURLs https://, se muestran en la página de la tienda
keywordsnohasta 10 palabras (de 30 caracteres cada una), para la búsqueda de la tienda
iconno{ "mark": "Re", "color": "#RRGGBB" }: de 1 a 3 caracteres sobre un recuadro de color
enginesno{ "ingot": ">=0.1.0" }: la versión más antigua de Ingot con la que funciona
filesnohasta 50 archivos o carpetas extra para empaquetar (scripts, recursos, código del servidor)
contributessí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

ClaveEntradaArchivos
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:

  1. ingot.json
  2. README.md, CHANGELOG.md y LICENSE (o LICENSE.md, LICENSE.txt) si existen
  3. cada archivo al que apunta una entrada de contributes
  4. 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ímiteValor
Tamaño del paquete (.ingotx)4 MB
Tamaño descomprimido20 MB
Un archivo2 MB
Archivos por paquete200
README mostrado en la tienda50.000 caracteres
Subidas por publicador30 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.