Podar reglas obsoletas
Las reglas envejecen: se cambia una librería, se mueve una carpeta, una regla que nadie necesita sigue en cada prompt. La poda encuentra esas reglas en .ingot/rules y quita las que elijas. Siempre empieza como simulación.
Qué cuenta como obsoleto
| Hallazgo | Significado | Acción sugerida |
|---|---|---|
| unused | ningún agente usó la regla en los últimos N días (90 por defecto) | borrar |
| dead globs | sus globs no coinciden con ningún archivo del proyecto | borrar si todos los globs están muertos; si no, quitar los muertos |
| deleted paths | menciona entre comillas invertidas archivos o carpetas que ya no existen | revisar |
| removed deps | nombra paquetes de los que el proyecto ya no depende | borrar si ya no queda ninguno; si no, revisar |
Los paquetes salen de la lista deps: (o requires:) del frontmatter de la regla, de los imports de sus ejemplos de código y de menciones @scope/nombre entre comillas invertidas. Ingot los compara con package.json, requirements.txt, pyproject.toml, go.mod y composer.json.
Los hallazgos de revisión solo se listan; Ingot nunca cambia esas reglas por ti.
Cómo se mide "sin uso"
Cada turno de agente registra qué .ingot/rules estaban en su contexto, en .ingot/.state/rule-hits.json. Esa carpeta se ignora a sí misma en git, así que el uso se queda en tu máquina. La poda marca unused solo cuando tiene al menos N días de datos de uso, y nunca para una regla confirmada hace menos de N días. Hasta entonces, el diálogo indica desde cuándo registra el uso.
Podar en el IDE
Abre la página Rules & MCP, elige la pestaña Rules y pulsa Prune, o ejecuta Prune Stale Rules… desde Find Action.
- Fija Unused for … days.
- Lee los hallazgos de cada regla. Las reglas con acción de borrar o quitar globs vienen marcadas.
- Desmarca lo que quieras conservar y pulsa Apply.
Las reglas borradas desaparecen de .ingot/rules. Cuando solo algunos globs están muertos, la regla se queda y sus globs conservan los vivos. Deshazlo con git checkout -- .ingot/rules.
Desde la terminal
npx @ingotide/cli rules prune # simulación
npx @ingotide/cli rules prune --days 30 # una ventana más corta
npx @ingotide/cli rules prune --apply # borra reglas obsoletas y quita globs muertos
npx @ingotide/cli rules prune --apply --only legacy-api,old-style
| Opción | Significado |
|---|---|
--days <n> | la ventana para unused (90 por defecto) |
--apply | cambia archivos; sin ella no se escribe nada |
--only <lista> | aplica solo a estas reglas (nombres o rutas) |
--json | los hallazgos en JSON |