agenthub/docs/J10-BLOCAGE.md

J10 — Blocage Tests Live

Date: 2026-04-30
Status: Bloqué en attente environnement de test

Livrables Code — ✅ 100% Terminés

Tous les artefacts J10 ont été créés et validés :

1. ✅ scripts/bootstrap.sh (syntaxe validée, 10 étapes vérifiées)
2. ✅ docs/RUNBOOK-lan.md (runbook complet 8 sections)
3. ✅ docs/J10-VERIFICATION.md (procédures de test)
4. ✅ Feature flag FEATURE_MESSAGING_ENABLED (implémenté + documenté)
5. ✅ test/smoke-lan-2-agents.sh (script automatisé pour setup 2 agents)
6. ✅ Commit 1b91e58 + nouveau script de test

Reste à Exécuter — Tests Live

Blocage Actuel

Environnement de test indisponible — ni Multipass ni Docker ne sont disponibles dans l'environnement Paperclip actuel pour exécuter :

1. Bootstrap Ubuntu from scratch
2. Test 2 agents WebSocket en conditions réelles
3. Capture screenshots/curl traces

Options de Déblocage

Option 1: Serveur Ubuntu LAN Barodine (cible Phase 1)

Accès SSH au serveur Ubuntu LAN founder permettrait d'exécuter :

# Sur le serveur Ubuntu
sudo bash -c "$(curl -fsSL https://forgejo.barodine.net/barodine/agenthub/raw/branch/main/scripts/bootstrap.sh)"

# Depuis poste LAN
./test/smoke-lan-2-agents.sh <lan-ip>
# Puis test WebSocket manuel avec 2 clients

Durée estimée: < 1h avec serveur prêt

Option 2: VM Multipass locale

Si Multipass est installé sur machine du founder :

# Sur machine avec Multipass
multipass launch --name agenthub-test --disk 20G --memory 4G ubuntu-22.04
multipass exec agenthub-test -- sudo bash -c "$(curl -fsSL <bootstrap-url>)"

# Obtenir IP VM
VM_IP=$(multipass info agenthub-test | grep IPv4 | awk '{print $2}')

# Test depuis host
./test/smoke-lan-2-agents.sh $VM_IP

Durée estimée: < 30 min

Option 3: Docker local (development)

Si Docker Desktop/Engine disponible :

cd agenthub
docker compose -f compose.dev.yml up -d

# Test sur localhost
./test/smoke-lan-2-agents.sh localhost

Durée estimée: < 15 min
Limite: Teste compose.dev.yml, pas bootstrap.sh ni UFW

Option 4: Délégation à humain

Fournir les instructions et scripts aux founders pour qu'ils exécutent manuellement sur leur infrastructure.

Durée estimée: Dépend de disponibilité founders

Artefacts Prêts pour Test

1. Bootstrap Script

Fichier: scripts/bootstrap.sh
Usage:

# Sur Ubuntu 22.04/24.04 LTS avec root/sudo
sudo bash scripts/bootstrap.sh

Validation effectuée:

• ✅ Syntaxe bash validée (bash -n)
• ✅ 10 étapes présentes et numérotées
• ✅ Permissions 755
• ✅ Idempotence design (conditions if pour skip existing)

2. Test Script 2 Agents

Fichier: test/smoke-lan-2-agents.sh
Usage:

# Prépare 2 agents + 1 room, affiche URLs WebSocket
./test/smoke-lan-2-agents.sh <lan-ip-or-localhost>

Output: Credentials JSON dans /tmp/agenthub-smoke-test-creds.json

Flow de test:

1. Health check
2. Créer Agent 1 + Agent 2
3. Générer API tokens
4. Échanger pour JWTs
5. Créer room de test
6. Afficher instructions WebSocket
7. Vérifier endpoint historique messages

Test manuel WebSocket requis après:

• Connecter 2 clients aux URLs affichées
• Join room
• Envoyer message Agent 1 → Agent 2
• Vérifier réception temps réel
• Vérifier persistance en DB

3. Runbooks

Fichier: docs/RUNBOOK-lan.md
Sections prêtes:

• Initial setup (bootstrap)
• UFW firewall (22/tcp + 3000/tcp LAN-only)
• Operations (start/stop/logs/update)
• Backup/restore
• Rollback (feature flag + version)
• Monitoring (healthz/readyz/metrics)
• Troubleshooting

Fichier: docs/J10-VERIFICATION.md
Checklist de test complète: 5 phases

Done Criteria Mapping

Critère (BARAAA-28)	Status	Blocage
bootstrap.sh rejoué de zéro Ubuntu → stack < 15 min	⏸️ Prêt	Pas d'Ubuntu disponible
2 agents Paperclip échangent message persisté LAN	⏸️ Prêt	Pas de serveur qui tourne
Message retrouvé historique après reconnexion	⏸️ Prêt	Pas de serveur qui tourne
RUNBOOK-lan.md couvre setup/deploy/restore/rollback	✅ Done	-
UFW rules documentées	✅ Done	-
Feature flag messaging.enabled	✅ Done	-
Screenshot/curl trace LAN attaché issue	⏸️ Prêt	Pas de serveur qui tourne
Démo founder live LAN Barodine	⏸️ Prêt	Attente serveur founder

Statuts:

• ✅ Done — Livrable code terminé et validé
• ⏸️ Prêt — Script/doc prêt, attente exécution sur infra

Recommandation

Créer child issue pour l'exécution des tests avec assignation à un agent ayant accès à l'infrastructure Ubuntu/Docker, ou délégation aux founders humains.

Alternative immédiate: Si un founder a Docker Desktop, Option 3 permet de valider rapidement le flow complet (sauf bootstrap.sh et UFW).

Contact Points

Unblock owner: Founders Barodine (accès serveur Ubuntu LAN ou Multipass/Docker local)

Unblock action: Fournir accès SSH au serveur Ubuntu LAN, ou confirmer disponibilité Multipass/Docker Desktop pour test local.

Fallback minimal: Exécuter compose.dev.yml localement + test script, attacher traces à BARAAA-28, noter divergence avec bootstrap LAN dans commentaires.

---

Next: Attente réponse founders sur disponibilité infrastructure de test.