docs: reflejar fin de A2 y actualizar .env.example

Co-authored-by: aider (openrouter/openai/gpt-5) <aider@aider.chat>

.env.example

@@ -18,6 +18,7 @@ NODE_ENV="production"     # production | development | test
 TZ="Europe/Madrid"        # Zona horaria usada para "hoy/mañana" y render de fechas
 WEB_BASE_URL="https://taskbot.server.brobert.net"  # Host público de la web (p.ej. https://wtask.org en producción)
 # DB_PATH="./data/tasks.db"      # Si se define, ignora DATA_DIR y usa esta ruta exacta
+ONBOARDING_FALLBACK_MIN_DIGITS=8     # A2: longitud mínima para conservar números en menciones/tokens; por defecto 8
 
 # Sincronización de grupos (opcional)
 # Intervalo en milisegundos; por defecto 86400000 (24h). En desarrollo puede bajarse (mínimo recomendable 10000ms).

docs/plan-onboarding-usuarios.md

@@ -38,11 +38,14 @@ Fase A1 — Aprendizaje “agresivo” al entrar en grupos (Completada)
     - Si el payload incluye id + jid, rellena alias automáticamente.
 - Mantener activo ContactsService.updateFromWebhook para capturar correlaciones adicionales en los primeros minutos.
 
-Fase A2 — Ajuste clave sin fricción: conservar menciones con números
+Fase A2 — Ajuste clave sin fricción: conservar menciones con números (Completada)
+- Estado: completada (deploy tras commit 8b1af56).
 - En src/services/command.ts, al construir los candidatos a assignees:
   - Si normalizeWhatsAppId(token) produce dígitos y resolveAliasOrNull devuelve null, CONSERVAR ese número (no descartarlo).
   - Asegurar ensureUserExists para esos IDs conservados antes de usarlos.
   - Filtrar CHATBOT_PHONE_NUMBER para evitar autoasignaciones al bot.
+- Métrica: se incrementa onboarding_assign_failures_total con labels {group_id, source, reason} cuando una mención/token no es resoluble ni plausible.
+- Configuración: ONBOARDING_FALLBACK_MIN_DIGITS (por defecto 8) controla la longitud mínima para considerar un número “plausible”.
 - Efecto: reduce drásticamente los fallos de asignación por mención sin necesidad de DM.
 
 Fase A3 — Mensaje único por grupo con wa.me (solo si hace falta)