Saltar al contenido principal

Un CLI que hace el trabajo

straymark es un único binario de Rust con once subcomandos que operan sobre tu repo: scaffolding, validación, auditoría, análisis de complejidad, generación de reportes de compliance. Salidas deterministas que puedes pipear a grep, jq o CI.

Por qué importa

  • Una ruta de instalación, una ruta de upgrade. Sin cacería de runtimes de lenguaje, sin capa de Docker, sin orquestación. curl -fsSL .../install.sh | sh lo deja en tu $PATH. straymark update-cli lo mantiene al día.
  • Sin efectos secundarios ocultos. straymark validate lee archivos; straymark audit produce un reporte en markdown. Ninguno de los subcomandos llama a APIs externas ni modifica el estado de git sin que lo pidas. Seguro de cablear en pre-commit y CI.
  • El CLI es el contrato. El mismo straymark validate corre en local, en pre-commit y en pipelines. No hay un "modo CI" con reglas distintas.

Los once comandos

ComandoQué hace
straymark init [path]Inicializa StrayMark en un proyecto
straymark updateActualiza framework y CLI
straymark status [path]Muestra la salud de la instalación y stats de documentación
straymark repair [path]Restaura directorios y archivos faltantes del framework
straymark validate [path] [--staged]Valida documentos por compliance y corrección
straymark new [-t type] [--title]Crea un nuevo documento desde una plantilla
straymark compliance [path]Verifica compliance regulatorio (EU AI Act, ISO 42001, NIST, ...)
straymark metrics [path]Muestra métricas de gobernanza y estadísticas documentales
straymark analyze [path]Analiza la complejidad del código (cognitiva + ciclomática)
straymark audit [path]Genera reportes de auditoría con línea temporal y trazabilidad
straymark explore [path]Navegador interactivo TUI de la documentación

Todos los comandos respetan --json donde tiene sentido, así la salida es procesable por máquina.

Impulsado por arborist-metrics: straymark analyze calcula la complejidad cognitiva y ciclomática mediante arborist-metrics — nuestra librería Rust open source para métricas de código multi-lenguaje, también desarrollada por StrangeDaysTech S.A.S. de C.V.

straymark explore abre una interfaz de terminal interactiva sobre .straymark/: una TUI de tres paneles con el árbol de documentación, la metadata por documento y el markdown renderizado — controlada por teclado, sin daemon, sin dependencia extra. Las capturas debajo son de Sentinel, el proyecto que valida el framework empíricamente, con 131 documentos indexados.

Hecho para pipear

# Encontrar cada TDE abierto ordenado por impacto:
straymark metrics --json | jq '.tde[] | select(.status=="identified") | .id'

# Fallar CI si algún Charter de alto riesgo no tiene AILOG:
straymark validate --staged || exit 1

# Diferencia de complejidad entre dos commits:
straymark analyze --since HEAD~10

Aprende más