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) :TestJobRunsToSuccessa été corrigé (assertion alignée sur le format réel des paramètres) etgo test -count=1 ./...est de nouveau vert sur les 26 paquets. L'événement SSEnode.stateémis par l'ingestion porte désormais les champs du contrat (alias,freshness,maintenance,observed_at) en plus devalues/availability,node.updatedportechange, 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é
- 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.
- Corriger
TestJobRunsToSuccesspour quemake cipasse de nouveau. - Aligner les charges utiles SSE (
node.state,action.output,audit.appended,node.updatedde l'ingestion,resync) sur le contrat, ou le contrat sur elles ; faire porter le test Playwright sur la forme réellement émise. - Brancher ou retirer les réglages sans effet (
retention.*_days,alerts.default_*). - Exercer un authentificateur et des navigateurs réels (Safari, Firefox, passkey de plateforme, apps natives).
- Exécuter
go test -racesuringestetagent. - Tester
control-apipendant une coupure de base et définir ce que veut dire « déploiement interrompu ». - Clé APNs pour activer les notifications.
- Exercer une restauration sur un autre nœud, puis une rotation de clé.
- Régénérer
METRICS-CATALOG.mdavec la colonne Linux maintenant que BHS64 rapporte.
Liste de travail détaillée : INTEGRATION-TODO.md.