Sobre el proyecto

Assura es una herramienta de validación de línea de comandos para proyectos de software, escrita en Rust y distribuida bajo una licencia dual MIT / Apache-2.0. Su objetivo declarado es detectar la deriva del proyecto mientras el arreglo aún es pequeño, ofreciendo lo que denomina una capa de señal local rápida para la estructura del repositorio, nombres, límites de archivos y secciones, Markdown, referencias, presión de cambios en ramas y worktree, y políticas específicas del proyecto. El proyecto enmarca su flujo de trabajo como "Onboard once. Review while working. Explain when needed. Check before merge", separando Review (descrito como el radar) de Check (descrito como la puerta). Las capacidades descritas en el README incluyen la validación a nivel de proyecto de nombres, ubicación, rutas requeridas o prohibidas, límites de archivos e hijos, Markdown, referencias y límites de salida generada dentro de una política local; una revisión compacta del proyecto que muestra verificaciones configuradas, capacidades inactivas, cambios en ramas/worktree, directorios activos y acciones siguientes clasificadas; salida en formatos de texto, JSON, YAML, advice, status y agent con contexto específico de la regla; incorporación lista para agentes que establece una línea base e instala orientación local del proyecto; capas de políticas reutilizables que comienzan siendo agnósticas al lenguaje y añaden reglas de lenguaje o dominio donde sea necesario; migración de la configuración compatible de LS-Lint 2.3; evidencia de rendimiento en frío y en caliente; y validación local continua que mantiene una política preparada activa, agrupa ráfagas de edición e informa sobre el alcance de la cobertura. La instalación se ofrece a través de un instalador de shell público, archivos de lanzamiento precompilados para Linux, macOS y Windows (cada uno con assura y un complemento interno assura-full que debe permanecer en el mismo directorio), o una compilación desde el código fuente mediante cargo. Un inicio típico orientado a agentes se muestra como agent onboard, review, explain, watch, check; un inicio mínimo solo de estructura es init seguido de check. La configuración reside en .assura/config.yml, con bloques YAML para convenciones de nomenclatura de archivos y directorios y globs de exclusión. El README indica que el proyecto es pre-1.0: v0.3.0 es la última versión publicada, mientras que Review, Explain, onboarding, event-feedback y los contratos de activación de host gestionado se asignan a una candidata v0.4.0 que solo se puede instalar públicamente después de que la etiqueta pase la puerta de lanzamiento. Una tabla de soporte marca check junto con sus formatos de salida, init/status/migrate/hooks e informes de rendimiento como compatibles en v0.3.0 y la candidata v0.4.0, y marca review, doctor, explain, agent onboard, agent nudge, los comandos del ciclo de vida de integración de agentes, las verificaciones de Markdown/enlaces/referencias/orientación con paquetes de contenido/consulta/contexto locales, y watch/cache/daemon/sessions como superficies de la candidata v0.4.0. assura info, correcciones seguras de Markdown y las familias de políticas de extensiones de primera mano siguen siendo experimentales; los paneles alojados, la reparación amplia automática, la carga remota de complementos, los mercados de complementos y los motores de validación por agente se enumeran explícitamente como superficies de lanzamiento no compatibles. Los lanzamientos se basan en etiquetas: se actualizan la versión y las notas, se pasan las puertas de candidatos a lanzamiento, se envía una etiqueta v* anotada y el flujo de trabajo de lanzamiento compila archivos para Linux, macOS y Windows con sumas de verificación. El desarrollo utiliza comandos cargo xtask por niveles (fast, pr, release-size, release-smoke, release-live, full), y las afirmaciones de rendimiento se rastrean mediante benchmarks de cargo, incluida una comparación con LS-Lint. Los enlaces de documentación cubren el inicio, la configuración, la referencia de CLI/API, la política de soporte, las notas de la versión, la contribución y la seguridad.