# ALTHEIA Cohort Builder 2.5.1

## Propósito

Cohort Builder selecciona perfiles individuales de una única Master Farm 2.5.1 y publica un `altheia_research_collective_1.1`. La versión 2.5 permanece disponible como histórico, pero no participa en la cadena canónica 2.5.1.

## Identidad de entrada

La granja debe declarar:

- `dimension_identity: canonical_dimension_id`;
- Sector Pack 1.1 y Brand Pack 1.1 completos;
- `semantic_hash`, `measurement_hash`, `assignment_hash` y `sector_pack_hash`;
- 45 dimensiones canónicas únicas y su linaje Dxx → `canonical_dimension_id`;
- una extensión `altheia.dimension_trace` coherente en cada perfil.

Una diferencia en cualquiera de las huellas, el Brand Pack o el linaje bloquea la carga. Dxx se conserva exclusivamente como dirección física compatible dentro del perfil.

## Selección

La estrategia `balanced_diversity` calcula la distancia en dos capas:

1. 70 % sobre las 45 capacidades identificadas por `canonical_dimension_id`.
2. 30 % sobre las familias declaradas mediante `question_applicability.research_intents` del Sector Pack.

Esta distancia dimensional representa el 55 % de la diversidad total. El 45 % restante conserva el contexto categórico, las ofertas y los canales del algoritmo 2.5. La selección sigue siendo determinista para una misma granja, diseño y semilla.

`natural_distribution` no optimiza diversidad. `directed` aplica filtros, cuotas y perfiles fijados antes de ejecutar el mismo equilibrado canónico sobre la población viable.

### Filtro guiado de arquetipos

`design.guided_filters.archetype_ids` conserva una lista sin duplicados de IDs de arquetipo. Cuando contiene valores, un perfil es elegible si su asignación principal —la de mayor `confidence` o `score`— coincide con cualquiera de los IDs seleccionados. Este criterio se combina mediante AND con los rangos guiados, la tenencia de ofertas, la elegibilidad de calidad y los filtros avanzados.

La interfaz calcula la representación sobre el total de perfiles de la Master Farm y muestra para cada arquetipo principal su porcentaje, `n`, dominio, subdominio, confianza media y señales de evidencia disponibles. Una lista vacía mantiene el comportamiento anterior y no filtra por arquetipo.

## Salida 1.1

El bloque `source` conserva los packs completos, las cuatro huellas, la identidad dimensional, el modelo canónico compilado y la huella de la granja. `coverage.dimensions` publica tanto Dxx como el ID canónico, el alcance y sus familias; `coverage.families` resume la cobertura por intención de investigación.

El contrato se valida con `schemas/altheia_research_collective_1.1.schema.json` y `altheia_collective_validator_1.1`.

## Compatibilidad aguas abajo

Los módulos históricos que exijan `altheia_research_collective_1.0` no deben aceptar silenciosamente un colectivo 1.1. La suite activa 2.5.1 ya incorpora las nuevas huellas, el modelo canónico y Banca 1.2; los contratos 1.0 quedan solo para reproducción histórica.