dec-0058

Vista generada de dec-0058: L1 RAM (~256MB, path ~ns) usa política recency-dominante (LRU-ish) con bookkeeping O(1)

ImplementadoSin versión del tren todavía· generada desde docs/decisions/dec-0058-l1-ram-256mb-path-ns.md
track/docsdec-0124track/docs:DC10

Vista generada desde docs/decisions/dec-0058-l1-ram-256mb-path-ns.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 legadar45-L1-recency-policy
Ficherodocs/decisions/dec-0058-l1-ram-256mb-path-ns.md

Enmienda a: r12

Por qué importa (del frontmatter del ADR):

Citado por r46, r47, r48, r60, r61, styx.model.yml, CLAUDE.md; TKT-021 depende de r45 para rescope; r60 §D4 cita 'r45 SYSTEM policy'

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-0058-l1-ram-256mb-path-ns.md, el fichero canónico.

L1 RAM (~256MB, path ~ns) usa política recency-dominante (LRU-ish) con bookkeeping O(1)

L1 RAM (~256MB, path ~ns) usa política recency-dominante (LRU-ish) con bookkeeping O(1)

Por qué pasa gate-3

  • Hard-to-reverse: L1 es hot path ~ns; cambiar de recency-dominante a cost-aware requeriría añadir cálculo de score de regeneración en el path crítico, afectando latencia. La decisión estructura cómo se implementa L1.
  • Surprising sin contexto: Un ingeniero que lea 'L1 RAM LRU' podría asumir que todos los tiers usan la misma política (LRU uniforme o cost-aware uniforme). El split explícito (L1=recency, L2=cost-aware) es NO obvio sin el ADR.
  • Trade-off real: Alternativas explícitamente rechazadas con costes visibles: (1) Score unificado coste×recency en todos los tiers = mete cálculo en hot path L1 sin ganancia (L1 es efímero, miss L1→hit L2 es ~µs); (2) Coste puro (lectura estricta r12) = ignora working-set locality (re_read_rate 0.700 muestra recency con señal real).

Procedencia

Split de docs/decisions/r45-r12-eviction-reconciliation-2026-07-12.md (lock r45-L1-recency-policy) durante PASO 7 (2026-07-16). Ver el fichero padre para el contexto completo del pack original.