Refactor code structure for improved readability and maintainability

dev-scripts/new-agent.sh

@@ -23,6 +23,7 @@ need_arg "${1:-}"
 ID="$1"
 DISPLAYNAME="${2:-$ID}"
 PACKAGE="$(echo "$ID" | tr '-' '_' | sed 's/_bot//')"  # "monitor-bot" → "monitor"
+NORM="$(normalize_id "$ID")"                            # "monitor-bot" → "MONITOR_BOT"
 DIR="agents/$ID"
 
 [[ -d "$DIR" ]] && fail "Ya existe agents/$ID — ¿ya fue creado?"
@@ -146,14 +147,15 @@ tools:
 matrix:
   homeserver: "${MATRIX_HOMESERVER}"
   user_id: "@$ID:${MATRIX_SERVER_NAME}"
-  access_token_env: MATRIX_TOKEN_$(echo "$ID" | tr '[:lower:]-' '[:upper:]_' | sed 's/_BOT$//')
-  device_id: "$(echo "$ID" | tr '[:lower:]-' '[:upper:]_')01"
+  access_token_env: MATRIX_TOKEN_${NORM}
+  device_id: ""
 
   encryption:
-    enabled: false
+    enabled: true
     store_path: "./agents/${ID}/data/crypto/"
-    pickle_key_env: PICKLE_KEY_$(echo "$ID" | tr '[:lower:]-' '[:upper:]_')
+    pickle_key_env: PICKLE_KEY_${NORM}
     trust_mode: tofu
+    recovery_key_env: SSSS_RECOVERY_KEY_${NORM}
 
   rooms:
     listen: []
@@ -386,7 +388,9 @@ else
 fi
 
 echo ""
-echo -e "${YLW}Queda 1 paso:${RST} registrar el bot en Matrix y añadir su token a .env:"
+echo -e "${YLW}Quedan 3 pasos:${RST}"
 echo ""
-echo -e "  ${DIM}./dev-scripts/register.sh $ID \"$DISPLAYNAME\"${RST}"
+echo -e "  ${DIM}1. ./dev-scripts/register.sh $ID \"$DISPLAYNAME\"${RST}   # registra en Matrix + genera token, password, pickle key"
+echo -e "  ${DIM}2. ./dev-scripts/verify.sh $ID${RST}                     # genera cross-signing keys + verifica device"
+echo -e "  ${DIM}3. ./dev-scripts/start.sh $ID${RST}                      # arranca el agente"
 echo ""