SPB Git

Repository Public

ACCEPTANCE.md 23.6 KB

# Recette — matrice exigences → preuves

État évalué : commit 45f0d03 (version 0.1.0), déploiement du 2026-11-18.

Origine de la liste d'exigences. Le fichier CLAUDE.md du mandat n'est pas présent à la racine du dépôt. La liste ci-dessous vient donc de docs/DESIGN-BRIEF.md et de la consigne de rédaction de cette documentation, qui reprend les rubriques du mandat (y compris la liste des essais de sécurité de son §9). Voir MANDATE.md.

Statuts.

Statut Sens
Fait, vérifié implémenté ; preuve automatisée dans le dépôt ou observation de production
Fait, partiellement vérifié implémenté ; une partie seulement est prouvée (préciser laquelle manque)
Non fait absent, désactivé ou non livré
Non évalué ici hors du périmètre de ce document

Types de preuve. Test = fonction de test nommée (les tests Go sont sous services/). [prod] = observation faite par le responsable du déploiement le 2026-11-18, non vérifiable depuis ce dépôt. Rejoué = exécuté pendant la rédaction de ce document (2026-11-18, sur le poste de développement).

# 1. État des suites de tests

Suite Résultat Origine du résultat
go test -count=1 ./... (26 paquets avec tests) 25 paquets réussis, 1 en échec : internal/jobs, test TestJobRunsToSuccess (services/internal/jobs/runner_test.go:215), de façon déterministe (4 exécutions) rejoué
go vet ./..., gofmt, tools/gen-api.py --check, packages/ui-tokens/build.mjs --check propres rejoué
Tests unitaires web (pnpm test, Vitest) 172 réussis, 23 fichiers rejoué
Bout en bout avec les vrais binaires (tests/e2e/local-stack.sh) 10 vérifications réussies, E2E OK rejoué
Playwright (apps/web/e2e, authentificateur virtuel, Chromium) 94 tests réussis rapporté par les implémenteurs à la fusion ; non rejoué
Accessibilité (axe, WCAG 2.2 AA) sur les écrans principaux 0 violation rapporté ; non rejoué
go test -race exécuté sur orchestrator, alerts, maintenance, jobs, notify, actions, audit, api, authz, identity, events ; pas sur ingest ni agent rapporté

Mise à jour (même soir, commit suivant 45f0d03) : TestJobRunsToSuccess a été corrigé (assertion alignée sur le format réel des paramètres) et go test -count=1 ./... est de nouveau vert sur les 26 paquets. L'événement SSE node.state émis par l'ingestion porte désormais les champs du contrat (alias, freshness, maintenance, observed_at) en plus de values/availability, node.updated porte change, et les trois binaires sont estampillés de la même version. Les autres écarts listés dans API.md §8 restent ouverts.

Sur l'échec. Le résultat annoncé à la fusion était « tous les paquets verts ». Au commit 45f0d03 ce n'est pas le cas : TestJobRunsToSuccess attend que la commande job.run contienne "target":{…} dans ses paramètres, or le commit 365d278 (« Integration seams fixed (command params…) ») a retiré ce champ de l'enveloppe envoyée à l'agent (services/internal/orchestrator/orchestrator.go, dispatchOne) sans mettre à jour ce test — le test équivalent de l'orchestrateur, lui, a été corrigé dans le même commit. Le job du test s'exécute bien (l'assertion précédente, sur l'état succeeded et le résultat, passe) ; c'est l'assertion sur la forme des paramètres qui est périmée, et les vérifications qui la suivent (usage, progression, événements job.changed) ne sont donc plus exécutées. Conséquence pratique : make ci échoue à l'étape test.

# 2. Exigences fonctionnelles

# Exigence Statut Preuves Écarts restants
F1 Tableau de bord : vue d'ensemble, disponibilité par fraîcheur, capacité avec couverture, tendances, disposition par utilisateur, centre d'opérations Fait, partiellement vérifié Tests TestClusterOverviewCountsOnlyFreshNodes, TestClusterTrends, TestDashboardsArePerUserAndValidated (internal/api) ; Playwright « overview: availability by freshness and capacity with coverage », « dashboard layout persists per user » ; local-stack.sh (« overview coverage counts the reporting node ») ; captures docs/screenshots/web/01-overview.png, 17-operations-centre.png jamais consulté en production par un utilisateur (pas de compte)
F2 Inventaire : nœuds, matériel réel, niveaux de performance nommés, métriques et séries, processus, historique de santé, comparaison, inscription manuelle, retrait Fait, vérifié Tests TestNodeListFiltersSortAndPagination, TestManualNodeRegistrationUpdateAndRetire, TestNodeProcesses, TestNodeMetricsResolutionBucketsGapsAndAvailability, TestNodeHealthHistory, TestSeriesQueriesArePrunedAndIndexDriven, TestEnrollment, TestReportRoundtripAndIdempotence, TestRollupsAndLateData ; docs/pilot/2026-11-18/ ; [prod] 28 Macs + BHS64 rapportent, M4BP36 inscrit hors ligne ; totaux des agents (379 cœurs, 1 032 Go sur 28 Macs) identiques au relevé de phase 0 température et puissance unsupported (agent sans root) ; colonne Linux de METRICS-CATALOG.md non régénérée après le déploiement sur BHS64
F3 Actions : catalogue typé, confirmation, approbation, idempotence, verrous, signature, exécution, sortie, annulation Fait, partiellement vérifié Tests TestActionCatalogEndpoint, TestCreateActionRefusals, TestIdempotency, TestTargetLockAndRelease, TestApprovalFlow, TestActionOutputListAndCancelPermissions, TestScopedDenyGrant, TestActionRateLimit, TestMaintenanceSetThroughAPI (internal/api/ops_actions_test.go) ; 17 tests de internal/orchestrator ; TestCommandsEndToEnd (ingest) ; exécuteur de l'agent (internal/agent/executor) ; local-stack.sh (action diagnostic.run exécutée par un agent réel, rejeu idempotent, une seule commande) aucune action exécutée en production (pas de compte ; politique en lecture seule partout) ; service.start/stop/restart, cache.purge, agent.restart jamais exercés sur un PM2/launchd réel ; deploy.release et system.update.schedule désactivés ; model.server.* non implémentés par l'agent ; redémarrage/extinction désactivés sur chaque agent
F4 Services : découverte PM2 / launchd / systemd / docker, état, historique, service géré, URL publique Fait, partiellement vérifié Tests TestPM2, TestLaunchctlList, TestSystemctl, TestDockerPS (internal/agent/services) ; TestServiceGoneSemanticsAndEvents (ingest) ; TestServicesMappingHistoryAndUpdate (api) ; Playwright « services: catalogue and detail » ; capture 04-services.png actions sur services non exercées sur cibles réelles (voir F3) ; aucun démon Docker en marche dans le cluster (relevé de phase 0) : adaptateur non observé en conditions réelles
F5 Modèles d'IA : serveurs d'inférence observés, santé, modèle, port Fait, partiellement vérifié Tests TestRecognize (internal/agent/services), TestModelsVolumesNasAndBackups (api) ; Playwright « models: request metrics are shown as not instrumented, with the reason » ; [prod] deux serveurs mlx_lm détectés sur M3U96a (ports 8081 et 8083), santé ok débit, latence, file d'attente : non mesurables (mlx_lm.server n'expose rien) et affichés comme tels ; démarrage/arrêt d'un serveur de modèle non fait (type au catalogue, non implémenté par l'agent)
F6 Jobs : modèles déclarés par l'agent, placement, tentatives bornées, dépendances, planifications, annulation Fait, partiellement vérifié Tests TestPlacementUsesRealNodeState, TestRetriesAreBoundedWithBackoff, TestNoRetryAfterUnknownOutcomeOrRefusal, TestCancelAndFreeze, TestDependencies, TestScheduleSingleCatchUp (internal/jobs) ; TestJobsAPI, TestJobSchedulesAPI (api) ; TestJobTemplates (politique de l'agent) TestJobRunsToSuccess en échec (§1) ; aucun modèle de job déclaré en production (politique par défaut) : aucun job réel n'a tourné
F7 Réseau : interfaces, débits, latence et perte, topologie Fait, partiellement vérifié Métriques net.* mesurées (METRICS-CATALOG.md, relevé local) ; TestParsePing ; Playwright « network: topology drawn with an equivalent table » ; test unitaire apps/web/src/features/network/topology.test.ts ; capture 07-network.png pas de test Go dédié aux opérations /network/* repéré par son nom ; topologie non confrontée au réseau réel par une personne
F8 NAS et stockage : volumes, usage, état SMART de base, cibles NAS sondées par les agents, sauvegardes observées Fait, partiellement vérifié Test TestModelsVolumesNasAndBackups ; Playwright « storage: volumes with usage, NAS offline, backup unknown — said honestly » ; capture 08-storage.png état réel des deux NAS en production non relevé pour ce document (l'un était éteint lors de la phase 0) ; capacité et SMART détaillé des NAS non observables
F9 Alertes et incidents : règles (seuil, absence, état de service), hystérésis, silences, suppression en maintenance, acquittement, commentaires, incidents, chronologie, rejeu sur l'historique Fait, vérifié (hors push) 11 tests de internal/alerts/engine_test.go (dont TestStateMachinePendingFiringHysteresisFlapResolve, TestAbsenceRule, TestSilenceAndMaintenanceSuppression, TestDedupUnderConcurrentEvaluators, TestStaleDataIsNotEvaluable, TestReplayOnHistory) ; TestAlertRulesAPI, TestAlertsSilencesIncidentsAPI ; Playwright « alerts: … » ; [prod] alertes réelles levées à partir de données réelles : disque à 99,6 % sur M4M64b (critique), 92 % sur M3U96b, swap > 80 % en attente sur M3U96a notifications push inactives (aucune clé APNs) : le fournisseur est testé contre un faux serveur (internal/notify, 17 tests), jamais contre Apple ; acquittement jamais fait en production
F10 Calendrier d'entretien et notes : fenêtres, récurrence, fuseaux, mode maintenance automatique, silences, export ICS, notes Fait, vérifié (hors production) internal/maintenance : 20 tests (récurrence, ICS, ordonnanceur — dont TestSchedulerRestartsAndMissedWindows, TestSchedulerActivatesAndRevertsOnlyWhatItSet) ; TestMaintenanceWindowsAPI, TestMaintenanceNotesAPI, TestMaintenanceCalendarICS ; Playwright « maintenance: … » (6 tests) ; captures 10-maintenance.png, 19-mobile-maintenance.png aucune fenêtre créée en production
F11 Audit : journal en ajout seul, chaîne de hachage, consultation, vérification, export signé vérifiable hors ligne Fait, vérifié Tests TestChainAppendVerifyAndTamperDetection, TestAuditListingAndVerify, TestAuditExportSignedAndVerifiableOffline, TestAuditVerifyExportCommand ; Playwright « audit: … » (2 tests) ; [prod] mccctl audit-verify OK export jamais produit en production (pas de compte) ; pas d'ancrage externe de la tête de chaîne
F12 Administration : utilisateurs, octrois, agents et jetons d'enrôlement, réglages, état du backend Fait, partiellement vérifié Tests TestUserAdministrationRules, TestPolicyGrantsTakeEffectAndAreValidated, TestEnrollmentTokensAndAgents, TestSettingsAllowlistAndAdminStatus, TestAdminRevokesSessionsDevicesAndPasskeys, TestEveryClusterAndAdminOperationIsImplemented ; captures 13 à 16 réglages retention.*_days et alerts.default_* sans effet (API.md §8, ligne 10) ; aucune opération d'administration faite en production par l'interface
F13 Identité : passkeys seulement, connexion sans nom d'utilisateur, step-up, sessions web et natives, appareils, rôles Fait, partiellement vérifié 14 tests de internal/identity/identity_test.go ; 6 tests de internal/api/identity_http_test.go ; Playwright 01-identity, 03-security ; [prod] options WebAuthn avec rpId=clustr.spboucher.ai, userVerification=required aucun compte owner en production ; authentificateurs de plateforme réels et Safari/Firefox réels non exercés
F14 Invitations : usage unique, durée courte, fragment d'URL, profil, liaison à un compte existant, récupération hors bande Fait, vérifié (hors production) Tests TestInvitationSingleUse, TestSetupAttemptLimit, TestLinkInvitationRequiresTheRightAccountAndStepUp, TestRecoveryIsOutOfBandAndRevokesOldCredentials, TestRolesAndTakeoverProtection, TestHTTPInvitationAbuse ; Playwright 02-invitation (8 tests) le lien d'amorçage n'a pas encore été ouvert par le propriétaire
F15 Agents : sans root, sans écoute, enrôlement, tampon hors ligne, renouvellement, révocation, macOS et Linux Fait, vérifié Tests TestEnrollment, TestRenewal, TestRevocationAndForeignCA, TestOfflineBufferingAndReplay, TestLongPollThroughReverseProxy (ingest) ; internal/agent/* (spool, nonce, journal, policy, executor) ; [prod] pilote m4ml puis déploiement progressif, LaunchAgent partout sauf M2U64 et m4md (LaunchDaemon), BHS64 sous systemd avec utilisateur dédié ; ≈ 0 % CPU, ≈ 25 Mo sur le pilote go test -race non exécuté sur ces paquets ; renouvellement de certificat pas encore survenu en production (certificats de 30 jours émis le 2026-11-18)
F16 Temps réel : flux SSE durable, reprise, resynchronisation, filtrage par permission Fait, partiellement vérifié Tests TestPublishSinceResumeAndResync, TestHTTPEventStream ; Playwright 04-realtime (2 tests) ; tests unitaires apps/web/src/lib/sse.test.ts charges utiles de node.state, action.output, audit.appended, resync différentes du contrat ; le test Playwright de node.state injecte la forme du contrat, pas celle de l'ingestion (API.md §8, lignes 1 à 6)
F17 Sauvegarde et restauration : chiffrée, vérifiée, copie hors hôte, test de restauration Fait, vérifié Tests TestBackupVerifyRestoreRoundTrip, TestEncryptDecryptSizes, TestTamperTruncateWrongKey ; [prod] première sauvegarde créée, vérifiée, copiée sur M3U96b par clé SSH restreinte ; mccctl restore-test OK sur l'hôte restauration sur un autre nœud jamais faite ; restore-test non planifié ; pas de réplication
F18 Terminal d'administration (optionnel dans le mandat) Non fait ADR 0008 : non livré en v1, décision motivée module futur éventuel, derrière un privilège distinct
F19 Déploiement de versions (deploy.release) et mises à jour système (system.update.schedule) Non fait catalogués avec available=false ; refus vérifié par TestCreateActionRefusals (cas « unavailable type ») et TestCatalogConsistency adaptateurs et procédures de retour arrière à spécifier (ADR 0008)

# 3. Essais de sécurité (liste du §9 du mandat)

# Essai Statut Preuves Remarques
S1 Invitation réutilisée Fait, vérifié TestInvitationSingleUse — sous-tests « reuse after exchange », « concurrent exchange has exactly one winner », « completed invitation and its transaction are dead » (internal/identity/identity_test.go) ; TestHTTPInvitationAbuse (internal/api/identity_http_test.go) ; Playwright « reusing the link in another browser is a dead end », « the invitation is completed and cannot be replayed » —
S2 Défi WebAuthn rejoué Fait, vérifié TestChallengeAndAssertionAbuse — « challenge replay », « assertion for another challenge », « a failed attempt burns the challenge », « expired challenge », « phishing origin », « wrong RP ID », « no user verification » ; TestClonedAuthenticatorDetected authentificateur logiciel (internal/identity/vauth), pas un authentificateur réel
S3 Appareil révoqué Fait, vérifié TestHTTPNativeBearerRefreshAndDeviceRevocation, TestAdminRevokesSessionsDevicesAndPasskeys, TestSessionLifetimesAndRevocation ; Playwright « revoking a device signs that device out on its next request » —
S4 Rôle insuffisant Fait, vérifié TestAdministrationIsRefusedToViewersAndOperators, TestHTTPAuthorizationAndStepUp, TestRoleDefaults, TestGrantsCannotEscalate, TestNodePrivateFieldsNeedPermission, TestSearchRespectsPermissionsAndEscapesWildcards ; Playwright « the API itself refuses the viewer », « direct navigation to an admin route shows a 403 naming the permission » —
S5 CSRF Fait, vérifié TestHTTPSetupLoginCookiesAndCSRF, TestBootstrapRegisterLoginAndCSRF ; [prod] POST inter-origine refusé (403) —
S6 Expiration de session Fait, vérifié TestSessionLifetimesAndRevocation (inactivité, durée absolue, révocation), TestStepUp ; Playwright « step-up: an aged session is asked for the passkey and the original request is replayed » le contrat annonce un code session_expired ; le serveur répond unauthenticated
S7 Commande dupliquée Fait, vérifié TestIdempotency, TestTargetLockAndRelease (api) ; TestCrashRestartNeverIssuesASecondCommand, TestTwoInstancesNoDuplicates, TestLeaderRunsOnce (orchestrator) ; TestVerifyAcceptsOnceThenRejectsReplay, TestRememberReplayRestart (agent) ; TestReportRoundtripAndIdempotence (rapports) ; local-stack.sh (« idempotent replay returns the same action », « exactly one command issued ») — rejoué —
S8 Nœud hors ligne Fait, vérifié TestOfflineBufferingAndReplay, TestAbsenceRule, TestStaleDataIsNotEvaluable, TestClusterOverviewCountsOnlyFreshNodes, TestUndeliveredCommandIsAgentUnreachable, TestCreateActionRefusals (refus agent_offline) ; [prod] M4BP36 (éteint) affiché hors ligne —
S9 Agent compromis simulé Fait, partiellement vérifié TestCommandIsolationBetweenAgents (un agent ne voit ni n'agit sur les commandes d'un autre), TestRevocationAndForeignCA, TestSignedRequestRejections, TestSignedRequestCertificateProperties, TestReportValidation ; côté inverse (transport compromis) : TestTamperedCommandIsDetectedByTheAgent, TestVerifyRejections ; [prod] requête non signée vers /agent/v1/report refusée (401) simulation par tests seulement ; aucun exercice sur un nœud réel ; un agent compromis peut toujours mentir sur les mesures de son propre nœud
S10 Déploiement interrompu Non fait aucun test ne simule l'interruption d'un déploiement. Le type deploy.release est désactivé, donc il n'existe pas de déploiement piloté par le produit à interrompre. Éléments voisins seulement : une action interrompue par le crash de l'orchestrateur ou de l'agent n'est jamais ré-émise (TestCrashRestartNeverIssuesASecondCommand, TestUnresolvedAfterCrash, TestUnknownOutcomeAfterAgentCrash) ; les migrations s'appliquent un fichier par transaction (internal/db/db.go, sans test d'interruption) ; install.sh remplace le binaire de l'agent par renommage atomique (sans test) l'interruption d'une mise à jour du plan de contrôle lui-même (make build + redémarrage PM2 en cours de route) n'est ni testée ni décrite au-delà de OPERATIONS.md §2
S11 Panne de base de données Fait, partiellement vérifié TestDatabaseOutage (ingestion : 503, reprise seule, les agents tamponnent) ; TestSurvivesDatabaseConnectionLoss (orchestrateur) aucun test pour control-api pendant une coupure de base : comportement lu dans le code (/health/ready → 503, SSE fermé, /admin/status → database: down ; sortie du processus si la base est absente au démarrage) ; aucune coupure provoquée en production

# 4. Clients, API, documentation

# Exigence Statut Preuves Écarts restants
C1 Application web : tous les écrans, système de design, fr/en, thèmes, mobile, accessibilité, CSP Fait, partiellement vérifié 172 tests unitaires (rejoué) ; Playwright : 94 tests rapportés (identité, invitations, sécurité, temps réel, écrans, données, opérations, accessibilité, poids et captures) ; apps/web/DESIGN-SYSTEM.md ; 21 captures dans docs/screenshots/web/ ; [prod] pages servies avec CSP à nonce Playwright non rejoué pour ce document ; Chromium seulement ; jamais utilisée en production par une personne connectée ; deux écarts de charge utile SSE affectent le rafraîchissement en direct (F16)
C2 Application macOS Non évalué ici voir APPLE-APPS.md (rédigé séparément, en cours) —
C3 Application iOS Non évalué ici voir APPLE-APPS.md ; aucun répertoire apps/ios dans le dépôt au moment de la rédaction —
C4 API : contrat OpenAPI 3.1, serveur généré, sécurité déclarée par opération Fait, partiellement vérifié packages/api-contracts/openapi.yaml (132 opérations) ; tools/gen-api.py --check propre (rejoué) ; les 132 opérations ont un handler (recoupement fait pour ce document) ; [prod] points publics de santé, version et AASA 14 écarts entre contrat et implémentation recensés dans API.md §8
C5 Documentation Fait ARCHITECTURE.md, SECURITY.md, OPERATIONS.md, API.md, ce document, AGENT-PROTOCOL.md, METRICS-CATALOG.md, DECISIONS/ (10 ADR), README, CHANGELOG APPLE-APPS.md rédigé par ailleurs ; DESIGN-BRIEF.md garde les ports de développement et une écoute LAN de l'ingestion qui ne correspondent plus à la production (voir ARCHITECTURE.md §2)
C6 Contraintes de conception : produit neuf sans reprise, agent sans root, valeurs non mesurables déclarées, pas de shell distant Fait, vérifié ADR 0001, 0007, 0008 ; local-stack.sh (« thermal.temp declared, not invented ») ; TestStaleDataIsNotEvaluable ; Playwright « node detail: … explicit unsupported metrics » —
C7 Exploitation : déploiement en production, supervision, sauvegarde Fait, partiellement vérifié [prod] voir OPERATIONS.md pas de CI hébergée ; pas de supervision externe ; pas de réplication ; procédures de rotation de clés, de déplacement du plan de contrôle et de retour arrière non exercées

# 5. Ce qui reste ouvert, par priorité

  1. Amorcer le compte owner (action du propriétaire, avec sa passkey) : tant que ce n'est pas fait, aucun parcours authentifié n'est vérifié en production.
  2. Corriger TestJobRunsToSuccess pour que make ci passe de nouveau.
  3. Aligner les charges utiles SSE (node.state, action.output, audit.appended, node.updated de l'ingestion, resync) sur le contrat, ou le contrat sur elles ; faire porter le test Playwright sur la forme réellement émise.
  4. Brancher ou retirer les réglages sans effet (retention.*_days, alerts.default_*).
  5. Exercer un authentificateur et des navigateurs réels (Safari, Firefox, passkey de plateforme, apps natives).
  6. Exécuter go test -race sur ingest et agent.
  7. Tester control-api pendant une coupure de base et définir ce que veut dire « déploiement interrompu ».
  8. Clé APNs pour activer les notifications.
  9. Exercer une restauration sur un autre nœud, puis une rotation de clé.
  10. Régénérer METRICS-CATALOG.md avec la colonne Linux maintenant que BHS64 rapporte.

Liste de travail détaillée : INTEGRATION-TODO.md.

Files main
Menu

Theme