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 | shlo deja en tu$PATH.straymark update-clilo mantiene al día. - Sin efectos secundarios ocultos.
straymark validatelee archivos;straymark auditproduce 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 validatecorre en local, en pre-commit y en pipelines. No hay un "modo CI" con reglas distintas.
Los once comandos
| Comando | Qué hace |
|---|---|
straymark init [path] | Inicializa StrayMark en un proyecto |
straymark update | Actualiza 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 analyzecalcula la complejidad cognitiva y ciclomática mediantearborist-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.
Navega por los docs con straymark explore
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.



explore distingue los tipos automáticamente.
? muestra todos los atajos agrupados por panel — navigation, metadata, document, general.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