# NEXT_STEPS.md

## Objetivo
Implementar un sistema de salud automatizado **iterable y testeable** usando Clawdbot (cron + delivery simple), con estado persistente en archivos.

---

## Principios de diseño (para Clawdbot)
1. **Estado en archivos** (JSON/YAML en `data/` y `config/`).
2. **Run único por tick** (`run_once()`), sin loops eternos.
3. **Recordatorios como cron one‑shot** (evitar depender de memoria de sesión).
4. **Simulación fácil** con `NOW=...`.
5. **Idempotencia**: no duplicar recordatorios si ya existen.

---

## Fases

### Fase 1 — MVP funcional (prioridad)
**Qué incluye:**
- Recordatorios de agua + movement breaks según config.
- Sin calendario real ni Xiaomi (por ahora).
- Agendado vía `clawdbot cron` (one‑shots).

**Cambios:**
- `config/health_config.yaml`: agregar templates de horarios.
- `scripts/health_agent.py`: `run_once()` genera próximos recordatorios.
- `scripts/notification_scheduler.py`: ya usa Clawdbot cron.
- Agregar modo `DRY_RUN=1` para imprimir sin agendar.

**Resultado esperado:**
- Notificaciones reales en Telegram vía Clawdbot.
- Test fácil por fecha/hora simulada.

---

### Fase 2 — Adaptación por calendario
**Qué incluye:**
- Aplicar reglas en `calendar_rules.md` (postpone/reduce frecuencia).
- `calendar_adapter.py` devuelve mocks si no hay API real.
- `decision_engine.py` parsea reglas y adapta recordatorios.

---

### Fase 3 — Escalations + síntomas
**Qué incluye:**
- Evaluar `escalation_rules.md`.
- Persistir `data/state.json` con contadores y últimas alertas.
- Alertas inmediatas + resúmenes diarios.

---

## Tests simples
- `NOW="2026-02-17T10:00:00"` para simular ejecución.
- `DRY_RUN=1` imprime acciones sin crear cron.
- Script auxiliar `scripts/test_run.py` (opcional).

---

## Fortalezas / Debilidades Clawdbot (a considerar)
**Fortalezas:**
- Cron confiable y preciso por minuto.
- Delivery directo al chat.
- Sesiones aisladas ideales para background.

**Debilidades:**
- Sin DB nativa → usar JSON/YAML.
- Cron aislado no recuerda contexto → persistir estado.
- Sin UI → mensajes compactos.