SPB Git

Repository Public

CHANGELOG.md 5.9 KB

# Changelog

Format : une section par version, regroupée par phase de construction. Les identifiants entre parenthèses sont les commits du dépôt. Les faits de déploiement ne figurent pas dans le dépôt : ils ont été observés par le responsable du déploiement et sont marqués [prod].

# 0.1.0 — 2026-11-18

Première version. Dépôt au commit 45f0d03. État détaillé, preuves et lacunes : docs/ACCEPTANCE.md.

# Phase 0 — Relevé et fondations

  • Relevé en lecture seule de l'infrastructure réelle (28 Macs observés sur 29, une passerelle Linux), sorties brutes dans docs/recon/, synthèse dans docs/REAL-INFRASTRUCTURE-INVENTORY.md (0b3cf49).
  • docs/DESIGN-BRIEF.md : composants, identité, actions, protocole agent, télémétrie, flux temps réel.
  • Schéma PostgreSQL initial et fondations Go partagées (configuration, base, HTTP, audit, autorisations).
  • Décisions d'architecture 0001 à 0009 et CI locale (Makefile, make ci) (2834e74).

# Phase 1 — Identité

  • Passkeys WebAuthn (vérification de l'utilisateur obligatoire, identifiants découvrables), sessions opaques (cookie pour le web, jetons d'accès et de rafraîchissement rotatifs pour les apps natives), step-up, invitations à usage unique, récupération hors bande, tests d'abus (58cc60c).

# Phase 2 — Contrat et API

  • Contrat OpenAPI 3.1 de 132 opérations et jetons de design partagés (186057e).
  • control-api : serveur strict généré, table de sécurité par opération appliquée centralement, handlers d'identité, flux SSE durable, mccctl, tests de sécurité HTTP (d9c29a1).
  • Côté lecture et administration : cluster, nœuds, métriques, services, modèles, réseau, stockage, tableaux de bord, recherche, activité, utilisateurs, octrois, agents, réglages (8ca36ec).

# Phase 3 — Agent et ingestion

  • mcc-agent (collecte sans root, tampon hors ligne, politique locale, exécution sans shell), telemetry-ingest (enrôlement, rapports idempotents, transport des commandes, agrégats, rétention), AC privée, empaquetage launchd et systemd, docs/AGENT-PROTOCOL.md, relevé pilote local docs/pilot/2026-11-18/ (282fea8).
  • Constat mesuré sur m4ml : macOS bloque les connexions LAN d'un binaire lancé par launchd. Le transport par défaut devient la requête HTTPS signée relayée par control-api ; amendement de l'ADR 0004 (70be15a).

# Phase 4 — Plan des opérations

  • Actions typées, orchestrateur durable (une commande au plus par action, issue inconnue explicite), jobs, moteur d'alertes et 12 règles intégrées, notifications (fournisseur APNs), calendrier d'entretien et notes, API d'audit avec export signé (d7a4e0f, fusion a799881).
  • Sauvegardes chiffrées AES-256-GCM en flux, vérification, restauration dans une base vide, test de restauration (50f9f1c).

# Phase 5 — Intégration

  • Alignement de l'API de lecture sur le stockage de l'ingestion, horodatages en UTC, relais configuré (26d9518).
  • Paramètres des commandes tels que l'agent les décode, capacités des jobs, valeurs imbriquées dans les alertes ; essai de bout en bout avec les vrais binaires tests/e2e/local-stack.sh (365d278).
  • Corrections : nettoyage des lignes expirées, outil de connexion de développement (732d09f).

# Phase 6 — Application web

  • Next.js 16 : tous les écrans, système de design propre, français et anglais, thèmes sombre et clair, CSP à nonce, client SSE, suite Playwright et tests d'accessibilité (5c55049).

# Phase 7 — Déploiement

  • Manifeste de production, cibles de livraison, correction de la copie hors hôte des sauvegardes (4e2709c).
  • mccctl enroll-token et register-node ; lanceur scripts/mccctl (b2531f7, a112d5b).
  • Script de déploiement des agents (2305790) ; processus web (d9537b5, 45f0d03).
  • [prod] En service sur https://clustr.spboucher.ai (nœud hôte M4M64c, PostgreSQL 17, cinq processus PM2). Vérifiés : santé, version et AASA publics, HSTS et en-têtes, CSP à nonce, options WebAuthn, refus des requêtes inter-origines et des requêtes d'agent non signées, première sauvegarde chiffrée copiée sur un second nœud, restore-test et audit-verify.
  • [prod] Agents : pilote sur m4ml puis déploiement progressif ; 28 Macs et la passerelle Linux rapportent ; un portable éteint inscrit manuellement. Politique en lecture seule partout. Premières alertes réelles (disques, swap).

# Phase 8 — Documentation

  • docs/ARCHITECTURE.md, SECURITY.md, OPERATIONS.md, API.md, ACCEPTANCE.md, MANDATE.md, README.md, ce fichier ; ADR 0010 (au plus une commande par action) consignée d'après l'implémentation ; docs/INTEGRATION-TODO.md réduit à ce qui reste ouvert.

# Connu, non fait ou non vérifié

  • Aucun compte owner en production : aucun parcours authentifié exercé par une personne.
  • go test ./... : TestJobRunsToSuccess était en échec sur une assertion périmée à 45f0d03 — corrigé au commit suivant (suite verte).
  • Charges utiles de plusieurs événements SSE et certains codes d'erreur différents du contrat (docs/API.md §8).
  • Réglages de rétention modifiables dans l'interface mais non lus par l'ingestion.
  • Notifications push inactives (aucune clé APNs) ; température et puissance non mesurées (agent sans root).
  • deploy.release et system.update.schedule désactivés ; model.server.* non implémentés par l'agent ; redémarrage et extinction désactivés sur chaque agent ; terminal d'administration non livré (ADR 0008).
  • Pas de réplication de la base ; pas de CI hébergée ; pas d'audit de sécurité indépendant ; Safari, Firefox et authentificateurs de plateforme réels non exercés ; go test -race non exécuté sur l'ingestion et l'agent.
  • Applications macOS et iOS : voir docs/APPLE-APPS.md.
Files main
Menu

Theme