Repository Public
1# Changelog23Format : une section par version, regroupée par phase de construction. Les identifiants entre parenthèses sont les4commits du dépôt. Les faits de déploiement ne figurent pas dans le dépôt : ils ont été observés par le responsable5du déploiement et sont marqués **[prod]**.67## 0.1.0 — 2026-11-1889Première version. Dépôt au commit `45f0d03`. État détaillé, preuves et lacunes : [docs/ACCEPTANCE.md](docs/ACCEPTANCE.md).1011### Phase 0 — Relevé et fondations1213- Relevé en lecture seule de l'infrastructure réelle (28 Macs observés sur 29, une passerelle Linux), sorties14 brutes dans `docs/recon/`, synthèse dans `docs/REAL-INFRASTRUCTURE-INVENTORY.md` (`0b3cf49`).15- `docs/DESIGN-BRIEF.md` : composants, identité, actions, protocole agent, télémétrie, flux temps réel.16- Schéma PostgreSQL initial et fondations Go partagées (configuration, base, HTTP, audit, autorisations).17- Décisions d'architecture 0001 à 0009 et CI locale (`Makefile`, `make ci`) (`2834e74`).1819### Phase 1 — Identité2021- Passkeys WebAuthn (vérification de l'utilisateur obligatoire, identifiants découvrables), sessions opaques22 (cookie pour le web, jetons d'accès et de rafraîchissement rotatifs pour les apps natives), step-up, invitations à23 usage unique, récupération hors bande, tests d'abus (`58cc60c`).2425### Phase 2 — Contrat et API2627- Contrat OpenAPI 3.1 de 132 opérations et jetons de design partagés (`186057e`).28- `control-api` : serveur strict généré, table de sécurité par opération appliquée centralement, handlers29 d'identité, flux SSE durable, `mccctl`, tests de sécurité HTTP (`d9c29a1`).30- Côté lecture et administration : cluster, nœuds, métriques, services, modèles, réseau, stockage, tableaux de31 bord, recherche, activité, utilisateurs, octrois, agents, réglages (`8ca36ec`).3233### Phase 3 — Agent et ingestion3435- `mcc-agent` (collecte sans root, tampon hors ligne, politique locale, exécution sans shell), `telemetry-ingest`36 (enrôlement, rapports idempotents, transport des commandes, agrégats, rétention), AC privée, empaquetage launchd37 et systemd, `docs/AGENT-PROTOCOL.md`, relevé pilote local `docs/pilot/2026-11-18/` (`282fea8`).38- Constat mesuré sur m4ml : macOS bloque les connexions LAN d'un binaire lancé par launchd. Le transport par39 défaut devient la requête HTTPS signée relayée par `control-api` ; amendement de l'ADR 0004 (`70be15a`).4041### Phase 4 — Plan des opérations4243- Actions typées, orchestrateur durable (une commande au plus par action, issue inconnue explicite), jobs, moteur44 d'alertes et 12 règles intégrées, notifications (fournisseur APNs), calendrier d'entretien et notes, API d'audit45 avec export signé (`d7a4e0f`, fusion `a799881`).46- Sauvegardes chiffrées AES-256-GCM en flux, vérification, restauration dans une base vide, test de restauration47 (`50f9f1c`).4849### Phase 5 — Intégration5051- Alignement de l'API de lecture sur le stockage de l'ingestion, horodatages en UTC, relais configuré52 (`26d9518`).53- Paramètres des commandes tels que l'agent les décode, capacités des jobs, valeurs imbriquées dans les alertes ;54 essai de bout en bout avec les vrais binaires `tests/e2e/local-stack.sh` (`365d278`).55- Corrections : nettoyage des lignes expirées, outil de connexion de développement (`732d09f`).5657### Phase 6 — Application web5859- Next.js 16 : tous les écrans, système de design propre, français et anglais, thèmes sombre et clair, CSP à60 nonce, client SSE, suite Playwright et tests d'accessibilité (`5c55049`).6162### Phase 7 — Déploiement6364- Manifeste de production, cibles de livraison, correction de la copie hors hôte des sauvegardes (`4e2709c`).65- `mccctl enroll-token` et `register-node` ; lanceur `scripts/mccctl` (`b2531f7`, `a112d5b`).66- Script de déploiement des agents (`2305790`) ; processus web (`d9537b5`, `45f0d03`).67- **[prod]** En service sur `https://clustr.spboucher.ai` (nœud hôte M4M64c, PostgreSQL 17, cinq processus PM2).68 Vérifiés : santé, version et AASA publics, HSTS et en-têtes, CSP à nonce, options WebAuthn, refus des requêtes69 inter-origines et des requêtes d'agent non signées, première sauvegarde chiffrée copiée sur un second nœud,70 `restore-test` et `audit-verify`.71- **[prod]** Agents : pilote sur m4ml puis déploiement progressif ; 28 Macs et la passerelle Linux rapportent ; un72 portable éteint inscrit manuellement. Politique en lecture seule partout. Premières alertes réelles (disques,73 swap).7475### Phase 8 — Documentation7677- `docs/ARCHITECTURE.md`, `SECURITY.md`, `OPERATIONS.md`, `API.md`, `ACCEPTANCE.md`, `MANDATE.md`, `README.md`,78 ce fichier ; ADR 0010 (au plus une commande par action) consignée d'après l'implémentation ;79 `docs/INTEGRATION-TODO.md` réduit à ce qui reste ouvert.8081### Connu, non fait ou non vérifié8283- Aucun compte owner en production : aucun parcours authentifié exercé par une personne.84- `go test ./...` : `TestJobRunsToSuccess` était en échec sur une assertion périmée à `45f0d03` — corrigé au commit suivant (suite verte).85- Charges utiles de plusieurs événements SSE et certains codes d'erreur différents du contrat86 ([docs/API.md §8](docs/API.md#8-écarts-connus-entre-contrat-et-implémentation)).87- Réglages de rétention modifiables dans l'interface mais non lus par l'ingestion.88- Notifications push inactives (aucune clé APNs) ; température et puissance non mesurées (agent sans root).89- `deploy.release` et `system.update.schedule` désactivés ; `model.server.*` non implémentés par l'agent ;90 redémarrage et extinction désactivés sur chaque agent ; terminal d'administration non livré (ADR 0008).91- Pas de réplication de la base ; pas de CI hébergée ; pas d'audit de sécurité indépendant ; Safari, Firefox et92 authentificateurs de plateforme réels non exercés ; `go test -race` non exécuté sur l'ingestion et l'agent.93- Applications macOS et iOS : voir [docs/APPLE-APPS.md](docs/APPLE-APPS.md).94