Zedazo
Tu agenda, pasada por el zedazo fino.
Criba, normaliza, clasifica y deduplica contactos VCF exportados desde ProtonMail, Google Contacts o Apple iCloud.
Limpia tus contactos VCF exportados desde ProtonMail, Google Contacts o Apple iCloud aplicando reglas deterministas de clasificación (C2-C6) y eliminación (E1-E3), deduplicación con cierre transitivo, y normalización de nombres y teléfonos.
Antes:
vcf-cribador. Migración: ver CHANGELOG 0.2.0 y ADR-0014.
Quick start
# Instalar
# Cribar un archivo (conservados → limpio.vcf, trazabilidad → auditoría.tsv)
# Solo auditar sin modificar
# Estadísticas
# Exportar a CSV o JSON
Configuración
Opcional: crea un archivo TOML para personalizar el cribado.
# zedazo.toml
[]
= "+34" # prefijo telefónico por defecto
= false # false = añade a los defaults, true = reemplaza
= [ # dominios de email que NUNCA se eliminan
"@example.org",
"@admin.gob.es"
]
= [ # palabras clave adicionales para detección de spam
"pharma",
"jackpot"
]
[]
= false # false = añade a las reglas por defecto, true = reemplaza
[[]]
= "(?i)rob[óo]tica|maker"
= "TEC"
= "TEC-HW"
= "HW-MAKER"
La sección [cribado] sigue aceptándose con un warning de deprecación.
Pipeline
VCF ──→ Parse ──→ Normalize ──→ Classify ──→ Screen ──→ Dedup ──→ Write
4.0/3.0 unfold FN · TEL · ORG 16 categorías C2-C6 Union-Find VCF
unescape E.164 · N7 N1 + N2 E1-E3 cierre TSV
grouped transitivo CSV/JSON
| Etapa | Descripción |
|---|---|
| Parse | RFC 6350 §3.2 (unfold), §3.4 (escape). Propiedades agrupadas (ITEM1.EMAIL). Compatibilidad v3 → v4. |
| Normalize | N1-N7: capitalización de nombres, extracción de títulos, cargos, partículas. T1-T4: E.164 + tipos T4. |
| Classify | Taxonomía N1/N2/N3: PROF, INST, FIN, FORM, TEC, HOST, TRAN, INMO, SERV, ASOC, SALUD, etc. |
| Screen | C2-C6: conservar por categoría. E1-E3: eliminar huérfanos, spam, email-only. |
| Dedup | Union-Find con cierre transitivo. Coincidencia por TEL exacto, EMAIL fuzzy, FN fuzzy. |
| Write | VCF 4.0 con folding 75 octetos. ADR y tipos T4 preservados. TSV de trazabilidad. CSV/JSON export. |
Ejemplo real
$ zedazo cribar contacts-2025.vcf -o limpio.vcf -a audit.tsv
=== Estadísticas de cribado ===
Total entrada: 475
Conservados: 221
Eliminados: 254
Fusionados: 0
Cuarentena: 0
Needs Review: 1
Por categoría:
FIN-CRYPTO: 3 FIN-FINTEC: 5 INST-AUT: 7
PROF-JUD: 3 PROF-NOT: 2 PROF-COL: 4
TEC-COM: 3 SALUD-SOC: 2 ...
Arquitectura
src/
├── domain/ Reglas de negocio puras
│ ├── contact.rs Entidad Contact, StructuredName, CategorySet, Address
│ ├── screening.rs Motor de cribado C2-E3, DecisionTrace
│ ├── classification.rs Clasificación N1/N2/N3 por regex
│ ├── normalization.rs FN/TEL/ORG/ADR normalization
│ ├── audit.rs Modelo de trazas de auditoría
│ └── verification.rs Verificación de invariantes de dominio
│ ├── identity.rs Dedup Union-Find
│ └── rules.rs Reglas de clasificación
├── application/ Casos de uso
│ ├── cribar.rs Pipeline completo
│ ├── audit.rs Auditoría standalone
│ └── stats.rs Estadísticas (texto/JSON/Markdown)
├── infrastructure/ Adaptadores
│ ├── parser.rs VCF parser (nom)
│ ├── writer.rs VCF writer RFC 6350
│ ├── tsv_writer.rs Auditoría TSV
│ ├── csv_writer.rs Export CSV
│ ├── json_writer.rs Export JSON
│ ├── encoding.rs ISO-8859-1 → UTF-8
│ ├── source.rs Detección Proton/Google/Apple
│ ├── v3_compat.rs vCard 3.0 → 4.0
│ └── config.rs Configuración TOML
└── interfaces/ CLI (clap derive)
Documentación
| Documento | Contenido |
|---|---|
SPECS.md |
Especificación, invariantes, criterios de aceptación |
ARCHITECTURE.md |
Clean Architecture, CI/CD, capas |
ROADMAP.md |
Hitos y criterios de salida |
DECISIONS.md |
ADR con IDs estables |
AGENTS.md |
Contrato para agentes de código |
docs/domain.md |
Lenguaje ubicuo, entidades, rules |
docs/implementation-guide.md |
Guía de implementación (histórico MVP) |
docs/test-plan.md |
Estrategia de testing, fixtures |
docs/events.md |
Comandos, eventos |
Desarrollo
Ver CONTRIBUTING.md para la guía de contribución.
Seguridad
Reporta vulnerabilidades de forma privada. Ver SECURITY.md.
Ejecutamos cargo audit semanalmente vía GitHub Actions.
Licencia
MIT OR Apache-2.0 · Ver LICENSE-MIT y LICENSE-APACHE.