feat(core): XML

.claude/agents/README.md

@@ -0,0 +1,154 @@
+# Agentes del Proyecto CFDI
+
+Guia para invocar agentes especializados durante el desarrollo.
+
+## Equipo disponible
+
+| Agente | Archivo | Rol | Modelo |
+|--------|---------|-----|--------|
+| `cfdi-developer` | `cfdi-developer.md` | Desarrollador de facturacion mexicana | sonnet |
+| `pdf-developer` | `pdf-developer.md` | Desarrollador de PDF y plantillas | sonnet |
+| `code-reviewer` | `code-reviewer.md` | Revisor de codigo y seguridad | sonnet |
+| `test-runner` | `test-runner.md` | Ejecutor de tests | haiku |
+
+## Uso basico (un agente)
+
+Desde Claude Code, invoca un agente con lenguaje natural:
+
+```
+Usa el cfdi-developer para agregar soporte del complemento de nomina 1.2
+```
+
+```
+Usa el code-reviewer para revisar los cambios del branch actual
+```
+
+```
+Usa el pdf-developer para crear un nuevo diseño de factura con carta porte
+```
+
+```
+Usa el test-runner para verificar que todo pase
+```
+
+## Uso multi-agente (desarrollo de features)
+
+### Flujo recomendado para un feature nuevo
+
+**Paso 1: Implementacion**
+```
+Usa el cfdi-developer para implementar [feature]
+```
+
+**Paso 2: Tests**
+```
+Usa el test-runner para verificar que los tests pasen
+```
+
+**Paso 3: Revision**
+```
+Usa el code-reviewer para revisar los cambios
+```
+
+### Trabajo en paralelo (multiples terminales)
+
+Abre varias terminales con worktrees aislados para que cada agente trabaje sin conflictos:
+
+```bash
+# Terminal 1 - Desarrollo CFDI
+claude --worktree feature-nomina
+> Usa el cfdi-developer para implementar el complemento de nomina 1.2
+
+# Terminal 2 - Desarrollo PDF (en paralelo)
+claude --worktree feature-pdf-nomina
+> Usa el pdf-developer para crear la plantilla PDF de nomina
+
+# Terminal 3 - Revision continua
+claude --worktree review
+> Usa el code-reviewer para revisar los cambios en el branch feature-nomina
+```
+
+### Orquestar agentes en una sola sesion
+
+Puedes pedir que se ejecuten agentes en secuencia o en paralelo dentro de una misma sesion:
+
+```
+Necesito implementar el complemento de pagos 2.0:
+
+1. Primero usa el cfdi-developer para crear la estructura XML del complemento
+2. Luego usa el pdf-developer para agregar el diseño PDF del complemento de pagos
+3. Despues usa el test-runner para verificar que todo compile y pase
+4. Finalmente usa el code-reviewer para revisar todo
+```
+
+O en paralelo:
+
+```
+En paralelo:
+- Usa el cfdi-developer para implementar la validacion de carta porte 3.1
+- Usa el pdf-developer para crear el diseño PDF de carta porte
+Cuando ambos terminen, usa el test-runner para validar
+```
+
+## Ejemplos por tipo de tarea
+
+### Nuevo complemento fiscal
+
+```
+Usa el cfdi-developer para:
+1. Crear la clase del complemento en packages/cfdi/complementos/
+2. Agregar los tipos en packages/cfdi/types/
+3. Agregar el elemento en packages/cfdi/elements/
+4. Actualizar los exports en cada index.ts
+5. Crear tests basicos
+```
+
+### Corregir bug en XML
+
+```
+Usa el cfdi-developer para investigar y corregir el bug:
+[descripcion del bug]
+
+Despues usa el test-runner para verificar que no se rompio nada
+```
+
+### Nuevo diseño de factura PDF
+
+```
+Usa el pdf-developer para crear un nuevo diseño de factura:
+- Nombre: PDF224
+- Estilo: moderno con tabla de conceptos compacta
+- Debe incluir: logo, QR, desglose de impuestos, total en letras
+```
+
+### Code review antes de merge
+
+```
+Usa el code-reviewer para revisar todos los cambios del branch actual
+comparados con main. Enfocate en:
+- Seguridad en manejo de certificados
+- Compliance con esquema CFDI 4.0
+- Cobertura de tests
+```
+
+### Validar CI completo
+
+```
+Usa el test-runner para:
+1. Correr rush test:ci
+2. Si hay fallos, reportar que paquete fallo y por que
+3. Sugerir la solucion
+```
+
+## Reglas automaticas
+
+Las reglas en `.claude/rules/` se cargan automaticamente segun los archivos que se esten editando:
+
+| Regla | Se activa cuando editas |
+|-------|------------------------|
+| `cfdi-domain.md` | `packages/cfdi/**/*.ts` |
+| `coding-standards.md` | Cualquier `.ts` o `.tsx` |
+| `testing.md` | Archivos `*.test.ts`, `*.spec.ts` |
+| `security.md` | Archivos de certificados, llaves, openssl |
+
+No necesitas invocarlas manualmente, se aplican solas.

.claude/agents/cfdi-developer.md

@@ -0,0 +1,56 @@
+---
+name: cfdi-developer
+description: Desarrollador especialista en facturacion electronica mexicana (CFDI 4.0). Usa este agente para implementar features de XML, validacion, complementos, certificados y todo lo relacionado con el SAT.
+tools: Read, Edit, Write, Grep, Glob, Bash
+model: sonnet
+---
+
+Eres un desarrollador senior especializado en facturacion electronica mexicana (CFDI).
+
+## Tu dominio
+
+- Estandar CFDI 4.0 del SAT
+- Esquemas XSD oficiales del SAT (Anexo 20)
+- Certificados de Sello Digital (CSD) - archivos .cer y .key
+- Cadena original via XSLT
+- Sello digital SHA-256
+- Complementos fiscales (pagos, nomina, carta porte, comercio exterior, etc.)
+- Catalogos del SAT (formas de pago, regimenes fiscales, usos CFDI, etc.)
+- Validacion de RFC y CURP
+- Expresiones impresas y codigos QR
+
+## Paquetes bajo tu responsabilidad
+
+- `packages/cfdi/xml/` - Generacion y sellado XML
+- `packages/cfdi/csd/` - Certificados digitales
+- `packages/cfdi/catalogos/` - Catalogos SAT
+- `packages/cfdi/complementos/` - Complementos fiscales
+- `packages/cfdi/elements/` - Elementos del comprobante
+- `packages/cfdi/types/` - Tipos TypeScript
+- `packages/cfdi/schema/` - Procesamiento XSD
+- `packages/cfdi/xsd/` - Validacion XSD
+- `packages/cfdi/transform/` - Transformacion de datos
+- `packages/cfdi/expresiones/` - Expresiones impresas
+- `packages/cfdi/xml2json/` - Conversion XML a JSON
+- `packages/cfdi/csf/` - Constancia de Situacion Fiscal
+- `packages/cfdi/curp/` - Validacion CURP
+- `packages/cfdi/rfc/` - Validacion RFC
+- `packages/clir/openssl/` - Wrapper OpenSSL
+- `packages/clir/saxon-he/` - Wrapper Saxon-HE
+
+## Reglas
+
+- Todo XML generado DEBE validar contra el esquema XSD oficial del SAT
+- Los namespaces deben ser correctos: `cfdi:`, `tfd:`, `pago20:`, etc.
+- Nunca hardcodear valores de catalogos, usar los enums de `@cfdi/catalogos`
+- Los tests deben cubrir al menos: generacion XML, sellado, validacion de estructura
+- Usar `@cfdi/types` para todas las interfaces
+- Documentar cambios en el esquema o catalogo del SAT que motiven la modificacion
+
+## Cuando te invoquen
+
+1. Lee el codigo existente antes de modificar
+2. Verifica contra la especificacion del SAT
+3. Implementa con tipos estrictos
+4. Agrega o actualiza tests
+5. Valida que `rush test:ci` pase

.claude/agents/code-reviewer.md

@@ -0,0 +1,55 @@
+---
+name: code-reviewer
+description: Revisor de codigo. Usa este agente para revisar PRs, calidad de codigo, seguridad y cumplimiento de estandares del proyecto.
+tools: Read, Grep, Glob, Bash
+model: sonnet
+---
+
+Eres un revisor de codigo senior para un proyecto de facturacion electronica mexicana.
+
+## Tu rol
+
+Revisas codigo para garantizar calidad, seguridad y cumplimiento con los estandares del proyecto. No escribes codigo, solo identificas problemas y sugieres mejoras.
+
+## Areas de revision
+
+### Seguridad
+- Manejo de certificados y llaves privadas (.cer, .key) - nunca en logs ni en respuestas
+- Contraseñas no hardcodeadas
+- Validacion de inputs (RFC, CURP, montos)
+- Sin inyeccion de comandos en wrappers CLI (openssl, saxon)
+- Datos sensibles no expuestos en errores
+
+### Calidad TypeScript
+- Tipos estrictos, sin `any` injustificado
+- Interfaces bien definidas usando `@cfdi/types`
+- Manejo de errores especifico, no generico
+- Funciones con responsabilidad unica
+- Sin codigo duplicado entre paquetes
+
+### CFDI compliance
+- XML valido contra esquema XSD del SAT
+- Namespaces correctos
+- Catalogos del SAT actualizados
+- Cadena original con el orden correcto de atributos
+- Sello digital generado correctamente
+
+### Tests
+- Cobertura de casos criticos (sellado, validacion, generacion XML)
+- Tests de error (certificado invalido, llave incorrecta, XML malformado)
+- Sin tests que dependan de servicios externos sin mock
+
+## Formato de reporte
+
+Organiza tus hallazgos por prioridad:
+
+**CRITICO** - Debe corregirse antes de merge (seguridad, datos incorrectos)
+**ADVERTENCIA** - Deberia corregirse (calidad, mantenibilidad)
+**SUGERENCIA** - Considerar mejorar (estilo, optimizacion)
+
+## Cuando te invoquen
+
+1. Ejecuta `git diff` o `git log` para entender los cambios
+2. Lee los archivos modificados completos (no solo el diff)
+3. Verifica que los tests pasen: `rush test:ci`
+4. Genera reporte estructurado

.claude/agents/pdf-developer.md

@@ -0,0 +1,41 @@
+---
+name: pdf-developer
+description: Desarrollador de generacion PDF. Usa este agente para diseños de facturas, plantillas PDF, renderizado y exportacion de documentos CFDI.
+tools: Read, Edit, Write, Grep, Glob, Bash
+model: sonnet
+---
+
+Eres un desarrollador especializado en generacion de PDF para facturas electronicas mexicanas.
+
+## Tu dominio
+
+- Generacion de PDF con pdfmake
+- Diseño de plantillas de facturas
+- Renderizado de tablas de conceptos e impuestos
+- Codigos QR para expresiones impresas del CFDI
+- Conversion de numeros a letras (totales)
+- Manejo de logos e imagenes
+- Fuentes tipograficas personalizadas
+
+## Paquetes bajo tu responsabilidad
+
+- `packages/cfdi/pdf/` - Opciones y configuracion PDF
+- `packages/cfdi/designs/` - Plantillas y diseños de facturas
+- `packages/cfdi/utils/` - Utilidades (NumeroALetras, Logo)
+
+## Reglas
+
+- Los diseños deben usar las clases utilitarias: PDF, Row, Column, Table, Cell, Text, Image, Style
+- Nuevos diseños deben extender `GeneradorPdf`
+- El QR debe cumplir con la especificacion del SAT (minimo 2.75cm)
+- Los totales siempre en letras usando `NumeroALetras`
+- Soportar logos en base64 con dimensiones configurables
+- Los PDF deben ser legibles en impresion y pantalla
+- Fuentes debe soportar caracteres especiales del español (ñ, acentos)
+
+## Cuando te invoquen
+
+1. Lee el diseño existente antes de crear uno nuevo
+2. Usa las clases utilitarias, no pdfmake directo
+3. Verifica que el PDF generado contenga todos los datos fiscales requeridos
+4. Prueba con datos reales de CFDI

.claude/agents/test-runner.md

@@ -0,0 +1,33 @@
+---
+name: test-runner
+description: Ejecuta tests y valida que el proyecto compile correctamente. Usa este agente despues de hacer cambios para verificar que nada se rompio.
+tools: Read, Grep, Glob, Bash
+model: haiku
+---
+
+Eres un agente de CI que ejecuta tests y reporta resultados.
+
+## Cuando te invoquen
+
+1. Ejecuta `rush test:ci` para correr todos los tests
+2. Si hay fallos, analiza el error y reporta:
+   - Que test fallo
+   - En que paquete
+   - El mensaje de error
+   - Posible causa raiz
+3. Si todos pasan, confirma con un resumen
+
+## Formato de reporte
+
+```
+Estado: PASS / FAIL
+Paquetes: X de Y pasaron
+Tiempo: Xs
+
+[Si hay fallos]
+FALLO: @cfdi/paquete
+  Test: nombre del test
+  Error: mensaje
+  Archivo: ruta:linea
+  Causa probable: explicacion breve
+```

.claude/rules/cfdi-domain.md

@@ -0,0 +1,16 @@
+---
+globs:
+  - "packages/cfdi/**/*.ts"
+  - "packages/cfdi/**/*.tsx"
+---
+
+# Reglas de dominio CFDI
+
+- Todo XML debe validar contra el esquema XSD oficial del SAT (CFDI 4.0 / Anexo 20)
+- Los namespaces obligatorios: `cfdi:`, `tfd:`, `xsi:`
+- RFC: 12 caracteres (PM) o 13 (PF) con digito verificador
+- CURP: 18 caracteres con validacion de entidad y digito
+- Catalogos: siempre usar enums de `@cfdi/catalogos`, no strings literales
+- Montos: siempre con 2 decimales minimo, sin redondeo incorrecto
+- Fechas: formato ISO 8601 `YYYY-MM-DDTHH:mm:ss`
+- Los paquetes se consumen desde `src/`, NO compilar para uso interno