# Diario de Desarrollo - service-monitor

## 2025-12-08 - Sesión 3: Migración Zig 0.15 + SMTP STARTTLS

### Contexto
- Migrar de Zig 0.13 a 0.15.2
- Implementar SMTP con STARTTLS para notificaciones por email

### Migración a Zig 0.15.2

**Cambios requeridos:**

| Componente | Antes (0.13) | Después (0.15) |
|------------|--------------|----------------|
| build.zig | `root_source_file` | `root_module` con `b.createModule()` |
| stdout | `std.io.getStdOut().writer()` | `std.fs.File.stdout().deprecatedWriter()` |
| ArrayList | `std.ArrayList(T).init(alloc)` | `std.array_list.Managed(T).init(alloc)` |
| file.reader() | sin args | requiere buffer, usar `deprecatedReader()` |
| HTTP Client | `client.open()` + `send()` + `wait()` | `client.fetch()` |
| sleep | `std.time.sleep()` | `std.Thread.sleep()` |

**Commits:**
- `f31ce95` - Migración a Zig 0.15.2

### SMTP con STARTTLS

**Problema inicial:**
Se intentó implementar TLS nativo con `std.crypto.tls.Client`, pero la nueva API de I/O
de Zig 0.15 resultó demasiado compleja (cambios en Reader/Writer interfaces).

**Solución adoptada:**
Usar curl como subprocess, igual que para Telegram. Ventajas:
- curl maneja STARTTLS con `--ssl-reqd` transparentemente
- Código mucho más simple y mantenible
- Fiable y probado

**Configuración SMTP (Mailbox.org):**
```
Host: smtp.mailbox.org
Puerto: 587 (STARTTLS)
Usuario: reugenio@mailbox.org
Password: App password (en NOTIFICACIONES.md)
```

**Commits:**
- `4a9d0e6` - SMTP con STARTTLS via curl

### Estado Final del Proyecto

**Todas las funcionalidades implementadas:**
- ✅ Verificación HTTP/HTTPS
- ✅ Verificación TCP
- ✅ Modo watch (loop continuo)
- ✅ Modo daemon (background)
- ✅ Log a archivo
- ✅ Config externo (CSV)
- ✅ Notificación desktop (notify-send)
- ✅ Notificación Telegram (Bot API via curl)
- ✅ Notificación Email (SMTP STARTTLS via curl)

**Estructura final:**
```
service-monitor/
├── build.zig
├── CLAUDE.md
├── services.conf
├── docs/
│   ├── DIARIO_DESARROLLO.md
│   └── PROYECTO_COMPLETO.md
└── src/
    ├── main.zig      # Entry point + CLI
    ├── http.zig      # Cliente HTTP (fetch API)
    ├── tcp.zig       # Verificación TCP
    ├── config.zig    # Parser CSV
    ├── notify.zig    # notify-send
    ├── daemon.zig    # fork + setsid
    ├── smtp.zig      # SMTP via curl
    └── telegram.zig  # Bot API via curl
```

---

## 2025-12-07 - Sesión 2: Fases 2 y 3

### Implementado
- Modo watch con intervalo configurable
- Modo daemon con fork/setsid
- Log a archivo
- Config externo (services.conf)
- Notificaciones desktop (notify-send)
- Notificaciones Telegram (Bot API)
- SMTP básico (sin STARTTLS)

---

## 2025-12-07 - Sesión 1: Inicio proyecto

### Contexto
- Proyecto nuevo: Monitor de servicios para servidor Hetzner (Simba)
- Lenguaje: Zig 0.13.0
- Objetivo: Herramienta ligera, sin dependencias externas, potencialmente open source

### Implementado - Fase 1 Básica

**Estructura creada:**
```
service-monitor/
├── build.zig         # Sistema build Zig
├── CLAUDE.md         # Especificación proyecto
├── docs/             # Documentación
│   └── DIARIO_DESARROLLO.md
└── src/
    ├── main.zig      # Entry point + output terminal
    ├── http.zig      # Verificación HTTP/HTTPS (std.http.Client)
    ├── tcp.zig       # Verificación TCP (std.net)
    └── config.zig    # Lista servicios hardcoded
```

**Servicios configurados:**
1. Forgejo HTTP - https://git.reugenio.com
2. Forgejo SSH - git.reugenio.com:2222
3. Simifactu API - https://simifactu.com
4. Mundisofa - https://mundisofa.com
5. Menzuri - https://menzuri.com

**Detalles técnicos Zig 0.13:**
- `std.http.Client.open()` requiere `server_header_buffer` obligatorio
- `std.time.Timer` debe ser `var` (no `const`) para llamar `.read()`
- Output con colores ANSI: `\x1b[32m` verde, `\x1b[31m` rojo, `\x1b[0m` reset

**Normas aplicadas:**
- Doc comments (`///`) en todas las funciones públicas
- Código idiomático Zig (snake_case, error handling explícito)
- Preparado para open source

### Comandos
```bash
zig build           # Compilar
zig build run       # Ejecutar verificación
```

---