doc: CLAUDE.md v2.1 (tout autoriser, reprise, actions admin)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2 changed files +4 −3
modified
CLAUDE.md
+4 −3
@@ -5,9 +5,10 @@ Console d'administration du Groupe KA : app chat mobile-first qui pilote le **vr | ||
| 5 | 5 | ## Exigences non négociables |
| 6 | 6 | |
| 7 | 7 | 1. **Vrai Claude Code, jamais l'API Messages.** Le backend lance le binaire `claude` (headless : `claude -p --output-format stream-json --verbose --include-partial-messages`), avec `cwd` = le repo de l'app choisie. Chaque app KA s'exécute **sur son nœud de déploiement** (via SSH pour les nœuds distants) — le repo de prod est la seule source de vérité, aucun clone. Tous les événements du stream (texte, thinking, tool_use, tool_result, result) sont relayés et rendus comme dans le terminal (diffs colorés, blocs outils repliables, coût/tokens). |
| 8 | −2. **Options Claude Code dans l'UI** : modèle par session (Opus/Sonnet/Haiku, `--model`), mode de permissions (`default` avec cartes Autoriser/Refuser/Toujours, `acceptEdits`, `plan`, bypass derrière confirmation), choix du projet/cwd, `/clear` `/compact` `/cost` `/resume`, affichage live du modèle actif, session ID, coût cumulé, tokens de contexte. | |
| 9 | −3. **Sessions détachées** : le process claude ne dépend JAMAIS du WebSocket. Transcript JSONL persisté par conversation ; à la reconnexion l'app rejoue l'historique manqué puis reprend le live. États : en cours / en attente de permission / inactive. Reconnexion auto avec backoff + indicateur. Notifications in-app quand une tâche se termine ou attend une permission. | |
| 10 | −4. **Écosystème** : health checks HTTPS toutes les 45 s des 13 sites KA depuis M3U96a (latence, code, SSL), sweep des nœuds toutes les 5 min (charge/RAM/disque + PM2 cpu/mem/status + dernier commit), historique SQLite (`data/eco.sqlite`, rétention 35 j), incidents (2 échecs consécutifs → alerte, rétablissement → alerte verte), uptime 24h/7j/30j, moy/p95, sparklines + graphique 24 h + barres d'uptime 14 j, push temps réel via le même WebSocket. | |
| 8 | +2. **Options Claude Code dans l'UI** : modèle par session (**Fable 5 défaut**, Opus 5, Sonnet 5, Haiku, `--model`), mode de permissions (`default` avec cartes **Autoriser / Toujours (cet outil) / Tout autoriser / Refuser**, `acceptEdits`, `plan`, bypass derrière confirmation), choix du projet/cwd, `/clear` `/compact` `/cost` `/resume`, affichage live du modèle actif, session ID, coût cumulé, tokens de contexte (+ %), file d'attente de message, chrono d'exécution, copie des blocs de code. | |
| 9 | + - **« Tout autoriser »** = `autoAllowAll` sur la conversation : le serveur approuve TOUTES les permissions suivantes jusqu'à la fin — la tâche va au bout sans jamais réattendre l'utilisateur (testé : write auto-approuvé, 0 carte). C'est l'exigence « si on coche tout autoriser, ça finit vraiment la tâche ». | |
| 10 | +3. **Sessions détachées + reprise durcie** : le process claude ne dépend JAMAIS du WebSocket. Transcript JSONL persisté ; à la reconnexion l'app rejoue l'historique manqué puis reprend le live. **Reprise auto** : l'app rouvre la dernière conversation au lancement (`lastChatId`) et **force la reconnexion + resync au retour au premier plan** (`visibilitychange`/`online`, iOS coupe le WS à l'écran verrouillé). États : en cours / en attente de permission / inactive. Reconnexion auto backoff + indicateur. Notifications in-app (fin de tâche, permission attendue). | |
| 11 | +4. **Écosystème** : health checks HTTPS toutes les 45 s des 13 sites KA depuis M3U96a (latence, code, SSL), sweep des nœuds toutes les 5 min (charge/RAM/disque + PM2 cpu/mem/status + dernier commit), historique SQLite (`data/eco.sqlite`, rétention 35 j), incidents (2 échecs consécutifs → alerte, rétablissement → alerte verte), uptime 24h/7j/30j, moy/p95, sparklines + graphique 24 h + barres d'uptime 14 j, push temps réel via le même WebSocket. **Santé des 5 nœuds** (barres charge/RAM/disque + apps up), **vue Incidents globale**, et **actions d'admin par site** : redémarrer PM2 (`/api/admin/action`), logs récents (`/api/admin/logs`), git & commits (`/api/admin/commits`) — exécutées localement ou via ssh sur le nœud du site. | |
| 11 | 12 | 5. **Identité Groupe KA** : crème `#F2F1EC`, orange `#F97316` (traits de graphe `#e05f00`), encre `#1a1611`, cartes à bords noirs 2 px + ombres décalées, pills, typo ronde, pastille « Ka ». Header fixe + bottom nav (Chat / Sessions / Écosystème / Réglages) avec safe-areas. Statuts JAMAIS en couleur seule (● ▲ ■ + libellé). |
| 12 | 13 | 6. **Rien de simulé** : tout est branché sur le vrai CLI et les vrais sites. |
| 13 | 14 | |
modified
data/eco.sqlite
+0 −0
Binary file not shown.