rogerdigital/vault-inspector

Vault Inspector

Utilice Vault Inspector como un filtro de calidad de solo lectura para el mantenimiento de bóvedas de Obsidian. La habilidad está diseñada para flujos de trabajo en terminal, CI y bóvedas gestionadas por agentes que necesitan encontrar enlaces rotos, archivos adjuntos huérfanos, notas vacías, enlaces externos, archivos duplicados, desviaciones en tipos de frontmatter, problemas con el uso de etiquetas y archivos grandes.

Reglas de Seguridad

• Trate la CLI como de solo lectura. No modifique, mueva, elimine ni reescriba archivos de la bóveda como parte de esta habilidad.
• No presente --fix como disponible. La CLI actualmente sale con error si se intenta ejecutar una corrección.
• No elimine automáticamente archivos adjuntos huérfanos, candidatos duplicados ni archivos grandes. Resuma la evidencia y recomiende una revisión manual.
• No trate title, message, generatedAt ni durationMs como identificadores de automatización estables.
• Utilice campos estables para la automatización: schemaVersion, toolVersion, summary, scannerId, severity, primaryPath, relatedPaths, evidence, fingerprint, fixAction, isNew y summary.newIssues.
• Mantenga el progreso del escaneo en stderr con --progress; mantenga stdout legible por máquina.

Cuándo Ejecutarlo

Ejecute Vault Inspector:

• antes de reorganizar, publicar, exportar o archivar una bóveda;
• después de cambios en notas generadas o gestionadas por agentes;
• antes y después de ediciones masivas de enlaces, etiquetas, frontmatter o archivos adjuntos;
• en CI cuando un repositorio de bóveda o de documentación generada necesite comprobaciones de regresión;
• cuando un usuario solicite análisis de higiene de la bóveda, enlaces rotos, archivos huérfanos, archivos duplicados o archivos grandes.

Comandos Básicos

Desde dentro de una bóveda:

vinspect . --format json

Para uso puntual sin instalación global:

npx vault-inspector /ruta/a/la/boveda --format json

Escribir un informe legible:

vinspect . --format markdown --output report.md

Ejecutar escáneres seleccionados:

vinspect . --scanner broken-links,empty-notes,large-files --format json

Ejecutar el escáner de enlaces externos (opt-in) solo cuando las comprobaciones de red sean aceptables:

vinspect . --scanner external-links --format json

Mostrar progreso sin corromper stdout:

vinspect . --format json --progress

Flujo de Trabajo con Línea Base

Crear una línea base:

vinspect . --format json --output .vault-inspector-baseline.json --fail-on none

Fallar solo con nuevos hallazgos:

vinspect . --baseline .vault-inspector-baseline.json --fail-on new --format json

Cuando se utiliza una línea base, inspeccione summary.newIssues y el campo isNew de cada problema. Reporte los problemas nuevos antes que los problemas conocidos existentes.

Códigos de Salida

• 0: el escaneo se completó y no superó el umbral configurado con --fail-on.
• 1: el escaneo se completó y superó el umbral configurado con --fail-on.
• 2: uso inválido de la CLI o error en la configuración del escaneo.

Si el código de salida es 2, reporte el error de la CLI y no interprete stdout como un resultado de escaneo exitoso.

Interpretación de Resultados

Priorice los hallazgos en este orden:

1. Problemas de severidad error como enlaces rotos y enlaces a archivos adjuntos faltantes.
2. Hallazgos de severidad warning, incluyendo encabezados faltantes, archivos grandes, archivos duplicados confirmados y archivos adjuntos huérfanos antiguos.
3. Hallazgos de severidad info, incluyendo etiquetas de bajo uso, comprobaciones externas omitidas o con tiempo de espera agotado, archivos adjuntos huérfanos recientes y candidatos duplicados.

Para cada resumen, incluya:

• número total de problemas;
• recuentos por severidad;
• escáneres ejecutados;
• problemas de alta confianza primero;
• rutas de archivo y evidencia necesaria para la revisión manual;
• recuentos de problemas nuevos de la línea base cuando estén disponibles.

Evite exagerar la certeza. Los archivos adjuntos huérfanos y los candidatos duplicados pueden ser falsos positivos cuando los archivos son referenciados por CSS, Canvas, Dataview, pipelines de publicación o herramientas externas.

Respuesta Sugerida del Agente

Utilice esta estructura al reportar los resultados del escaneo:

Vault Inspector encontró <N> problema(s): <E> error(es), <W> advertencia(s), <I> info.

Hallazgos de mayor prioridad:
- [<severidad>] <scannerId>: <primaryPath> - <breve explicación basada en evidencia>

Notas:
- <nota sobre línea base/problema nuevo si corresponde>
- <advertencia de revisión manual para candidatos huérfanos/duplicados si corresponde>

Si el escaneo pasa, indique el comando ejecutado y los recuentos relevantes de cero. No afirme que la bóveda es perfecta; diga que Vault Inspector no encontró problemas que coincidan con los escáneres y filtros seleccionados.