Kill_LIFE/docs/MACHINE_ALIGNMENT_CONTRACT_2026-03-20.md

# Contrat d’alignement inter-machines — Kill_LIFE

Date: `2026-03-20`
Objectif: maintien d’une base commune opérationnelle sur les 4 cibles SSH et la stratégie de répartition de charge.

Ordre de pilotage opérationnel cible:

1. `clems@192.168.0.120` (Tower)
2. `kxkm@kxkm-ai` (KXKM)
3. `cils@100.126.225.111` (CILS, usage non essentiel)
4. Local (`/Users/electron/Documents/Lelectron_rare/Kill_LIFE`)
5. `root@192.168.0.119` (Réserve de reprise)

## État de base (contrôles de référence)

- `git` commit attendu (branche `main`): `bd3f7b99154f86057ba18b9948d940df55722b12`
- Remote attendu: `https://github.com/electron-rare/Kill_LIFE.git`
- Script de maintenance attendu: `tools/repo_state/repo_refresh.sh`
- Port SSH attendu: `22` (toutes machines)
- Source machine-readable associée: `specs/contracts/machine_registry.mesh.json`

## Contrat machine

### Politique de répartition de charge P2P

- Ordre de charge prioritaire de base: `Tower (clems)` -> `KXKM` -> `CILS` -> `local` -> `root`.
- Le scheduler calcule un score `load_ratio = loadavg / CPUs`, puis `score = priorité_base + int(load_ratio * 1000)` et réordonne les hôtes par score croissant.
- `root` reste la cible de reprise si les 3 premiers sont surchargés, hors cas dégradés.
- `root` est strictement maintenu en réserve: il ne remonte pas devant `local` dans le `host_order` tant que `tower-first` fonctionne.
- En surcharge (par défaut `load_ratio > 1.8`), seuls les contrôles critiques (`Kill_LIFE`) sont exécutés.
- `cils` est verrouillé en opération standard (`tower-first`) : seul `Kill_LIFE` est vérifié.
- `cils` en mode `photon-safe` ne reçoit **aucun** précheck applicatif (charge totale zéro, uniquement reachabilité SSH implicite).
- `CILS` reste hôte secondaire (photon): pas d’hébergement de services essentiels persistants; seulement les snapshots critiques (`Kill_LIFE`) sont acceptés en `tower-first`.
- `root` est la réserve de calcul pour reprendre le relais en cas de besoin (pas cible prioritaire).
- `root` reste en réserve de capacité de calcul pour les bascules de charge.
- En cas de doute opérationnel, forcer `--load-profile photon-safe` pour les préchecks.

### Spécification hôtes

- `clems@192.168.0.120`
  - rôle: machine de pilotage / orchestration locale
  - port: `22`
  - path repo: `/home/clems/Kill_LIFE-main`
  - priorité: `1`
  - état cible: Git repo proprement monté, branche `main`, commit cible, `SCRIPT_OK`

- `kxkm@kxkm-ai`
  - rôle: Mac opérateur
  - port: `22`
  - path repo: `/home/kxkm/Kill_LIFE-main`
  - priorité: `2`
  - état cible: Git repo proprement monté, branche `main`, commit cible, `SCRIPT_OK`

- `cils@100.126.225.111`
  - rôle: Mac opérateur secondaire
  - port: `22`
  - path repo: `/Users/cils/Kill_LIFE-main`
  - priorité: `3`
  - état cible: Git repo proprement monté, branche `main`, commit cible, `SCRIPT_OK`
  - contrainte: ne pas y héberger de services persistants critiques; en `tower-first`, précheck non-essentiel verrouillé (`cils-lockdown`) ; en `photon-safe`, aucun précheck applicatif SSH-only.

- `root@192.168.0.119`
  - rôle: serveur système / exécution matérielle
  - port: `22`
  - path repo: `/root/Kill_LIFE-main`
  - priorité: `5`
  - état cible: Git repo proprement monté, branche `main`, commit cible, `SCRIPT_OK`

## Health-check SSH (référence opérationnelle)

- Exécuter depuis la machine pilote:
  - `bash tools/cockpit/ssh_healthcheck.sh --json`
- Sorties attendues:
  - un statut `OK`/`KO` par entrée
  - rôle et port associés à chaque cible
  - cibles SSH résolues depuis `specs/contracts/machine_registry.mesh.json` (`local` exclu automatiquement car port `0`)
  - fichier log horodaté `artifacts/cockpit/ssh_healthcheck_<YYYYMMDD>_<HHMMSS>.log`
- Matrix opérationnelle cible:
  - P1 `clems@192.168.0.120` (`22`) → rôle `Machine de pilotage / orchestration locale`
  - P2 `kxkm@kxkm-ai` (`22`) → rôle `Mac opérateur`
  - P3 `cils@100.126.225.111` (`22`) → rôle `Mac opérateur secondaire`
  - P4 `root@192.168.0.119` (`22`) → rôle `Serveur système / exécution matérielle`

## Check-list de conformité (quotidienne)

1. `bash tools/cockpit/ssh_healthcheck.sh --json`
2. `cd /home/<user>/Kill_LIFE-main && git status --short` (ou équivalent remote via SSH)
3. `bash tools/repo_state/repo_refresh.sh --header-only`
4. Vérifier que `docs/REPO_STATE.md` et `docs/repo_state.json` restent cohérents avec la source de vérité

## Règles de dérive

- Les changements locaux non souhaités sur `Kill_LIFE` sont prohibés hors workflow défini.
- Les références obsolètes de machine/référence doivent être retirées du périmètre opérationnel avant publication.
- En cas de divergence commit:
  - trancher sur la branche/commit cible (standard: `origin/main`)
  - documenter la déviation dans `docs/MACHINE_SYNC_STATUS_2026-03-20.md`
  - réaligner via `git fetch --all --prune && git reset --hard origin/main`

## Routine quotidienne de contrôle

- Exécuter une fois par jour:
  - Machine de pilotage: `bash tools/cockpit/run_alignment_daily.sh --json --mesh-load-profile tower-first`
  - Machines de support: `bash tools/cockpit/run_alignment_daily.sh --skip-healthcheck --skip-mesh --json`
  - Cibles élargies: `clems`, `kxkm`, `cils`, `root`
  - Optionnel: `--purge-days <N>` pour ajuster la rétention des logs (défaut: `14`)
- Optionnel: forcer le mode `photon-safe` sur une exécution spécifique :
  - `bash tools/cockpit/run_alignment_daily.sh --json --skip-healthcheck --mesh-load-profile photon-safe`
- Exemple cron:
  - `05 06 * * * cd /chemin/vers/Kill_LIFE && bash tools/cockpit/run_alignment_daily.sh --json --purge-days 14 >> artifacts/cockpit/cron.out 2>&1`
- Logs:
  - `artifacts/cockpit/machine_alignment_daily_<YYYYMMDD>_<HHMMSS>.log`

## Sortie de dérogation

- Toute machine hors contrat doit être remontée immédiatement avec:
  - machine/port
  - rôle
  - écart constaté
  - preuve de commande
  - ETA de remise en conformité