# Guía de Estilo de Mensajes para WhatsApp (Help v2)

Objetivo: mensajes claros, consistentes y resistentes a cambios menores de copy.

Principios
- Responder por DM: incluso si el comando viene de un grupo, las respuestas al usuario llegan por privado. Nota: en modo gating estricto (GROUP_GATING_MODE='enforce') el bot puede no responder en grupos no permitidos.
- Estructura visual reconocible:
  - Secciones en negrita y MAYÚSCULAS: `*COMANDOS BÁSICOS*`.
  - Comandos e IDs en monoespaciado (backticks).
  - Listas con “- ” por línea.
  - Notas en cursiva.
- Brevedad y accionabilidad: priorizar ejemplos cortos y CTAs (“Prueba `t ayuda`”, “Envía `t web`”).
- Estabilidad para tests: evitar asserts por igualdad exacta; preferir substrings semánticos.

Componentes de formato
- Encabezados de sección:
  - Patrón: `*${TÍTULO EN MAYÚSCULAS}*`
  - Ej.: `*COMANDOS BÁSICOS*`
- Comandos:
  - Siempre en backticks: `` `t ver mis` ``
- IDs:
  - Mostrar con 4 dígitos entre backticks: `` `0026` `` (usar `codeId()`).
- Fechas:
  - Mostrar como `DD/MM`, precedidas de icono si aplica (ej.: `⚠️` si vencida). Usar `formatDDMM()`.
- Notas:
  - En cursiva: `_Este grupo no está activo._`
- Bullets:
  - “- ” al inicio de cada línea. Evitar listas demasiado largas (>10).

Emojis recurrentes
- ⚠️ Advertencia (vencida, no encontrado, truncado).
- ✅ Confirmación genérica.
- 📅 Fecha (según `ICONS.date`).
- 👤 / 👥 Responsables (uno o varios).
- ➕ Crear, ✔️ Completar, 🧲/✋ Tomar/Soltar (según `ICONS` disponibles).
- Evitar exceso: 1–2 por línea como máximo.

Patrones comunes
- Confirmación de creación:
  - Línea 1: icono + ID + descripción
  - Línea 2: fecha (si existe)
  - Línea 3: responsable(s) o “sin responsable”
- Listados:
  - Título (nombre de grupo o `Tus tareas`)
  - Bullets de items con: ID, descripción, fecha (con `⚠️` si vencida), responsable
  - Sufijo “... y N más” si aplica
- Ayuda rápida:
  - Secciones: “COMANDOS BÁSICOS”, “LISTADOS”, “ACCESO WEB”
  - Bullets con ejemplos: `` `t n ...` ``, `` `t ver mis|grupo|todos|sin` ``, `` `t x 26` ``, `` `t tomar 12` ``, `` `t alarma ...` ``, `` `t web` ``

Localización
- Todo copy en español. Evitar fugas de claves internas en inglés (ej. “weekly”).
- En recordatorios, exponer etiquetas en español:
  - daily → “diario”
  - weekdays → “laborables (lunes a viernes)”
  - weekly → “semanal (lunes)”
  - off → “apagado”
- Si por compatibilidad se aceptan términos en inglés como input, la respuesta debe mantener español.

Buenas prácticas
- Evitar párrafos largos; preferir 1–3 líneas por bloque.
- Los mensajes de 'Uso:' llevan el prefijo ℹ️.
- Incluir uso cuando falten argumentos:  
  - Ej.: `ℹ️ Uso: \`t tomar 26\` o múltiples: \`t tomar 12 19 50\` o \`t tomar 12,19,50\` (máx. 10)`
- Mensajes de error claros y accionables: “No puedes tomar esta tarea… Pide acceso a un admin si crees que es un error.”
- En listados, omitir líneas en blanco finales.

Para tests
- Preferir asserts de “contiene” con fragmentos estables (IDs en backticks, comandos en backticks, nombres de secciones).
- Si hace falta, crear helper `stripFormatting` que quite `*`, `_` y `` ` `` para comparar texto plano.

Ejemplos

Ayuda rápida
```
*COMANDOS BÁSICOS*
- `t n Descripción 2025-11-05 @Ana`
- `t ver` (en grupo) · `t ver mis` (DM) · `t ver todos`
- `t x 26` · `t tomar 12`
- `t alarma diario|l-v|semanal|off [HH:MM]`
- `t web`
_El bot responde por DM, incluso si escribes desde un grupo._
```

Confirmación de completar (ya estaba)
```
ℹ️ `0026` ya estaba completada — Preparar informe — 📅 05/11
```

Listado de “sin responsable”
```
Nombre del Grupo — Sin responsable
- `0142` Revisión de PR — 📅 12/03
- `0185` Montar demo — ⚠️ 📅 09/03
... y 3 más
```
