cleanup

# Cleanup — ménage VPS Agentik Objectif : libérer de l'espace et garder une doc cohérente, **sans jamais casser un travail en cours ni supprimer du contenu produit ou du canon projet**. ## Règle d'or — JAMAIS de suppression sans deux conditions 1. **Machine au repos** : lancer `scripts/idle-check.sh`. S'il renvoie `BUSY:…` → **STOP**, lister le travail actif, ne rien supprimer. 2. **Validation utilisateur** : pour tout ce qui touche `~/Station`, les caches d'un user, ou de la doc → présenter la liste (chemins + tailles + raison) et attendre l'accord. Les étapes "auto-sûres" (cache Docker/APT/journal) peuvent se faire sans valider chaque item, mais toujours après le garde-fou repos. ## RÈGLE ABSOLUE — jamais de kill sur claude / rmux (opérateur, 2026-08-11) Pendant un cleanup, ne **JAMAIS** kill un process `claude` ni un daemon ou une session rmux vivante — même détachée, même vieille, même à 0% CPU. "Détaché" ≠ "mort" : une session détachée porte des agents en plein travail, un claude à faible CPU attend souvent une réponse API entre deux turns, et tuer le daemon rmux tue TOUTES les sessions d'un coup. Incident fondateur : le 2026-08-11 un cleanup RAM a tué des claude actifs pris pour idle, y compris sa propre session. Fermer une session est un geste de l'**opérateur** (`omega kill <name>`, `rmux kill-server`), jamais du cleanup — même avec un go générique « clean up ». La récupération de RAM se limite à : workers de modèles idle (TTS/STT), dev servers oubliés, stacks Docker prouvées idle (avec accord), caches. `close-sessions.sh` porte ce garde-fou en dur et refuse tout pid claude/rmux. ## Périmètre INTOUCHABLE (ne jamais supprimer) - Tout `~/Station/**` **sauf** des artefacts de build explicitement rebuildables (`target/`, `.next/`, `dist/`) — et encore, seulement avec accord. - Docs canon : `vision/**`, fichiers `*PRD*`, `*feature*`, `*step*`, `Vision/`, `OMEGA.md`, `CLAUDE.md`, `AGENTS.md`, `README*`, `CHANGELOG`, `LICENSE`, `SECURITY.md`, `~/.omega/rules/**`, les **fiches** projet. - Tout dossier avec **beaucoup de `.md`** (>20) = probablement du **contenu produit** (cours, blog, data), PAS de la doc → protéger par défaut, demander. - Sessions / sockets actifs : `claude-*`, `rmux-*`, `tmux-*`, `rx-socketna-*`, `cloudflared`, la worktree d'un build en cours. ## Déroulé 0. **Fermeture des tunnels/mosh détachés** (si demandé) : `scripts/close-sessions.sh` ferme les tunnels cloudflared + serveurs mosh détachés de `vibe`/`lab` — et RIEN d'autre : claude et rmux sont hors périmètre par la Règle absolue ci-dessus (le script refuse ces pids en dur). **Protège toujours** la connexion courante (root) et l'infra (omega-mc, bots, daemons sécurité, tailscale, sshd). Tester d'abord avec `--dry`. 1. **Garde-fou** : `scripts/idle-check.sh`. Si occupé → rapport + stop. 2. **Analyse** : `scripts/analyze.sh` → df, top du `/home` `/tmp` `/var`, `docker system df`. 3. **Purge auto-sûre** : `scripts/safe-clean.sh` → `docker builder prune`, `apt-get clean`, `journalctl --vacuum-size=100M`. (rien de Station, rien de doc.) 4. **Résidu /tmp** : `scripts/tmp-residue.sh list` → présenter candidats (dirs de build/repro/audit, exclut tout ce qui est ouvert/actif). Après accord : `tmp-residue.sh purge`. 5. **Caches user rebuildables** : `scripts/clean-caches.sh` → purge `~/Linux/cache` (Bun, go-build, npm `_cacache`/`_npx`, node-gyp, playwright) pour `vibe`/`lab`. Ne touche ni config, ni data/state, ni Station. 6. **Artefacts de build dans Station** (sur demande) : `scripts/clean-builds.sh [base]` → purge `target/` Rust (à côté d'un `Cargo.toml`), `node_modules`, `.next`. **Rebuildables** mais coût : prochain build/`install` recompile. Garde-fou anti-build + re-teste `omega --version` (preuve non-régression). NE touche pas au code source ni aux binaires installés. 7. **Audit doc** : `scripts/doc-audit.sh <projet>` → classe en PROTECTED / SCRATCH / REVIEW. Présenter la liste SCRATCH pour validation ; ne jamais auto-supprimer. Proposer ensuite la création de `PROGRESS.md` (recap canon) + complétion de `RULES.md`/fiche par projet. ## Notes - Les images Docker et les volumes par-agent ne sont PAS du déchet par défaut (peuvent être réutilisés par OmegaOS) → ne pas purger sans confirmation ciblée. - Toujours afficher l'espace AVANT/APRÈS. - Si un doute → ne pas supprimer, demander.