Security baseline
Secrets, CI gates and by-design controls (ADR-033).
Source: docs/adr/ADR-033-security-baseline-by-design.md
ADR-033: Security baseline by design
Estado
Accepted — pedido el 2026-11-11 al portar el baseline de SemillaAgentes.
Fecha
2026-11-11
Contexto
En SemillaAgentes este contrato es el ADR-019. Aquí el ADR-019 ya es NestJS, así que el baseline vive en este número.
ADR-015 prohíbe secretos en git. Con el stack Accepted hace falta, además, un audit de dependencias y un SAST básico. Si no, el scaffold puede salir con un aviso alto o con un patrón peligroso sin dueño.
make doctor en este repo sí exige Docker (ADR-027), a diferencia de la semilla.
Decisión
1. El control es parte de terminado
Un cambio que introduce un secreto, un workflow inseguro, una dependencia con aviso alto o crítico sin excepción, o código sensible que rompe DOC-016, no está terminado. Nadie desactiva el gate para saltárselo.
2. Checklist vivo
La lista operativa es DOC-016. Cubre secretos, código sensible, CI, dependencias y SAST. Un hallazgo se corrige en todos los artefactos del mismo tipo.
3. Gates
| Gate | Herramienta | Cuándo |
|---|---|---|
make security-secrets | gitleaks ghcr.io/gitleaks/gitleaks:v8.30.1 | Árbol de trabajo. También en CI, como binario con checksum, sobre el historial |
make security-deps | pnpm audit --audit-level=high | Dentro de make check |
make security-sast | Semgrep público, reglas p/typescript y p/javascript | Dentro de make check |
No se usa un registro privado. Si no hay Docker, secretos y SAST fallan y lo dicen.
4. Excepciones
Solo por arquitectura o funcionamiento. Llevan motivo, alternativa evaluada y fecha de revisión. «No se demostró explotación» no alcanza.
La contraseña logiccore de .env.example, .env.docker.example y del Compose es el default local de Postgres, el mismo tipo de valor que usan FoodHub y constructora. No es una credencial de un entorno real. Revisión: 2026-12-11, o antes si el proyecto sale de la máquina de desarrollo.
deepmerge@4.3.1, arrastrado por @nestjs/cli a través de fork-ts-checker-webpack-plugin, tiene un aviso bajo (GHSA-gcqx-w48m-w2h4) y el advisory no publica versión parcheada. No entra en el runtime de la API: es el CLI de desarrollo. Revisión: 2026-12-11, o cuando una versión de Nest CLI deje de arrastrarlo.
5. Agentes
Contrato: .specify/memory/security.md. Regla .cursor/rules/seed-security.mdc con alwaysApply. Rol: agents/security/AGENT.md. Ningún agente imprime credenciales.
Consecuencias
make checkincluye audit y Semgrep, además de typecheck, lint, format y test.make security-secretsdescarga gitleaks. El primermake checkdescarga Semgrep.