Compare commits

..

2 commits

Author SHA1 Message Date
R.Eugenio
1124b7c740 Añadir /init optimizado (lee NORMAS_ESENCIALES + teamdocs)
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-23 13:28:54 +01:00
36d6d3a699 docs: Añadir disclaimer seguridad TLS
Documentado que la implementación TLS 1.3 es específica para el
protocolo BEP, no es un stack TLS de propósito general, y no ha
sido auditada profesionalmente.

Las primitivas criptográficas (X25519, ChaCha20-Poly1305) sí
provienen de std.crypto de Zig.

Recomendación auditoría Gemini 2025-12-19.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-19 13:55:49 +01:00
3 changed files with 33 additions and 0 deletions

8
.claude/commands/init.md Normal file
View file

@ -0,0 +1,8 @@
Protocolo de inicio - Lee estos archivos EN PARALELO:
1. CLAUDE.md (contexto de este proyecto específico)
2. /mnt/cello2/arno/re/recode/teamdocs/NORMAS_ESENCIALES.md (normas de trabajo, rutas, compilación)
3. /mnt/cello2/arno/re/recode/teamdocs/LAST_UPDATE.md (cambios recientes del equipo)
4. /mnt/cello2/arno/re/recode/teamdocs/agenda/2025-12_diciembre.md (trabajo del mes)
Después de leer, confirma brevemente qué sabes del proyecto y pregunta en qué puedes ayudar.

5
.gitignore vendored
View file

@ -15,3 +15,8 @@ Thumbs.db
# Test artifacts # Test artifacts
/tmp/ /tmp/
# Claude Code settings (ignorar), pero commands se versionan
.claude/settings*.json
.claude/*.json
!.claude/commands/

View file

@ -6,6 +6,26 @@ Librería Zig para comunicación P2P segura entre instancias de Simifactu.
Permite intercambio directo de documentos (facturas, certificados) entre empresas Permite intercambio directo de documentos (facturas, certificados) entre empresas
sin necesidad de email ni servicios cloud. sin necesidad de email ni servicios cloud.
## Disclaimer de Seguridad (TLS)
⚠️ **Implementación TLS específica**: Esta librería incluye una implementación
de TLS 1.3 escrita en Zig puro, optimizada para el protocolo BEP (Block Exchange
Protocol) de Syncthing.
**Importante:**
- **NO es un stack TLS de propósito general** - está diseñado específicamente
para este protocolo P2P
- **NO ha sido auditado profesionalmente** - no debe usarse como reemplazo de
OpenSSL, BearSSL u otras librerías TLS establecidas
- Las primitivas criptográficas subyacentes (X25519, ChaCha20-Poly1305) sí
provienen de `std.crypto` de Zig, que es código bien probado
**Uso recomendado:** Para comunicación P2P entre instancias de Simifactu en
redes controladas. Para aplicaciones que requieran TLS auditado, usar librerías
establecidas.
---
## Objetivos ## Objetivos
1. **Seguridad**: E2E cifrado con TLS 1.3 + ChaCha20-Poly1305 1. **Seguridad**: E2E cifrado con TLS 1.3 + ChaCha20-Poly1305