LOGIC OR NOT — Extraer datos a una tabla
Governing Payload — v0.1.2-CANDIDATE
Canonical Product Key: SP-GEN:P060
Governance Class: GOV-ARTIFACT
Modifiers: TOOL_REQUIRED | DATA_DEPENDENT


PURPOSE
Transformar información observable de una fuente en una tabla trazable, preservando valor bruto, normalización, derivaciones y estados de ausencia sin inventar celdas.


BOUNDARY
P060 extrae/normaliza datos. No interpreta causalidad, no evalúa alternativas y no convierte un cálculo derivado en dato observado. P061 compara alternativas sobre datos ya suficientemente definidos.


GOVERNED OBJECT
Source-to-table extraction = source records + schema + field/cell observations + raw values + normalized/derived values + transformation provenance + missing/ambiguity states.


VALUE STATES
OBSERVED_VALUE | MISSING_IN_SOURCE | UNREADABLE | AMBIGUOUS | NOT_APPLICABLE | NOT_OBSERVABLE | UNKNOWN.


TRANSFORMATION STATES
NONE | NORMALIZED | DERIVED.
- NORMALIZED conserva raw_value y documenta unit/type/date mapping.
- DERIVED requiere fórmula/regla/basis y nunca se presenta como valor extraído.
- Si la normalización no es unívoca, mantener AMBIGUOUS/UNKNOWN.


PRIMARY FRAME
Definir schema → identificar fuentes observables → extraer raw values + locators → asignar value_state → normalizar sólo con basis suficiente → calcular DERIVED sólo si solicitado/útil → validar filas/campos → preservar missing/ambigüedad → renderizar tabla/archivo.


TRACEABILITY
Cada valor no vacío debe permitir rastrear source_ref + source_location o derivation basis. En fuentes mixtas, conservar source por registro/celda cuando sea material.


INVARIANTS
- No adivinar celdas.
- Vacío no equivale a cero.
- MISSING_IN_SOURCE ≠ NOT_OBSERVABLE ≠ NOT_APPLICABLE.
- Normalización no borra raw_value.
- DERIVED no se etiqueta como OBSERVED_VALUE.
- No convertir texto ambiguo en tipo/unidad exactos sin basis.
- Si no puede inspeccionarse la fuente, no simular extracción.
- Archivo real sólo mediante superficie capaz; referencia real requerida.


OUTPUT
Source-to-Table Schema v0.1.2. Mostrar raw/normalized/derived provenance cuando sea material; la vista de usuario puede ocultar columnas técnicas sólo si siguen recuperables.