dec-0038

Vista generada de dec-0038: Principio de harvest selectivo

ImplementadoSin versión del tren todavía· generada desde docs/decisions/dec-0038-principio-harvest-selectivo.md
track/docsdec-0124track/docs:DC10

Vista generada desde docs/decisions/dec-0038-principio-harvest-selectivo.md. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere. El estado aquí es el del model: si discrepa con otra página, manda el model.

CampoValor
EstadoLOCKED (migrado de un rNN por gate-3: el fichero no declara estado)
Referencia legadar29-D2
Ficherodocs/decisions/dec-0038-principio-harvest-selectivo.md

Por qué importa (del frontmatter del ADR):

roadmap.spec.yml goal de F-DOMAIN-MEDIA (línea ~380): 'cosechado ~tal cual con tests portados como golden' — cita textual directa del principio, no implícita.

Nodos del roadmap que lo citan en refs: ninguno.

Páginas de la documentación que lo citan: ninguna todavía.

Texto del ADR

Leído de docs/decisions/dec-0038-principio-harvest-selectivo.md, el fichero canónico.

Principio de harvest selectivo

Principio de harvest selectivo: core/stream+identify se cosechan ~tal cual (tests portados 1:1 como oráculo golden), service/* se reescribe tras interface, cli/ se hace nueva — ni copia verbatim ni rewrite total.

Por qué pasa gate-3

  • Hard-to-reverse: Una vez cosechado e integrado, revertir a mediakit original requeriría descartar código adaptado. La decisión de cómo cosechar es estructural.
  • Surprising sin contexto: Un ingeniero podría asumir copia verbatim (dogmática) o rewrite desde cero (pride). El principio 'maximum reuse, selective rewrite' es un balance específico no inferible.
  • Trade-off real: Tres alternativas evaluadas: (1) copia verbatim de todo, (2) rewrite desde cero, (3) harvest selectivo. Waxin pickó (3) con rationale claro: preservar tests como oráculo golden.

Procedencia

Split de docs/decisions/r29-mediakit-harvest-2026-06-21.md (lock r29-D2) durante PASO 7 (2026-07-16). Ver el fichero padre para el contexto completo del pack original.

dec-0037

Vista generada de dec-0037: Fold-split sin fase nueva

dec-0039

Vista generada de dec-0039: Spawn ffprobe/ffmpeg sigue siendo v1 sancionada (r07) pero la migración a FFI/libav es prioritaria, no deuda diferida indefinidamente; el interface MediaProbe/StreamExtractor se diseña desde día 1 pensando en el swap.

Texto del ADR
Principio de harvest selectivo
Por qué pasa gate-3
Procedencia