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

GateHerramientaCuándo
make security-secretsgitleaks ghcr.io/gitleaks/gitleaks:v8.30.1Árbol de trabajo. También en CI, como binario con checksum, sobre el historial
make security-depspnpm audit --audit-level=highDentro de make check
make security-sastSemgrep público, reglas p/typescript y p/javascriptDentro 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 check incluye audit y Semgrep, además de typecheck, lint, format y test.
  • make security-secrets descarga gitleaks. El primer make check descarga Semgrep.

Referencias