Files
meow/ROADMAP.md
T
2026-11-20 23:17:15 +01:00

16 KiB
Raw Blame History

Meow v2 (Rust) — Roadmap

Le travail est découpé en lots indépendants. Chaque lot :

  • tient dans une session de travail (≈ une demi-journée d'agent) ;
  • laisse le workspace dans un état qui compile, avec cargo test vert ;
  • a un critère de fin vérifiable.

Légende : ✅ fait · 🟡 partiel · ⬜ à faire. L'architecture cible est décrite dans ARCHITECTURE.md.

Pour reprendre le travail : lire ce fichier, prendre le premier lot ⬜ dont les dépendances sont ✅, puis mettre à jour ce fichier à la fin du lot. Avant de clore un lot, scripts/check.sh et tests/e2e.sh doivent passer.

Ordre conseillé pour la suite

  1. 3.8 livraison au moins une fois ✅
  2. 4.5 brancher meow-store dans le client et la CLI ✅
  3. 5.5, 5.6 ✅, puis 5.9 flux d'événements (prérequis de l'UI), et 5.10.
  4. 7.1 → 7.3 FFI et intégration dans bastet.
  5. Le reste (phases 8–10) selon les priorités.

Journal

Date Lots Notes
2026-11-20 5.6 Status par message (Queued, Sent, Delivered, Read, sans retour en arrière), mis à jour dans le segment qui contient le message. Accusés DELIVERED (un par contact et par lot) et READ (mark_read) dans le ratchet, désactivables par identité (Settings). Event::Receipt. CLI : read, identity receipts, statuts dans history, longpoll --exit ignore les lots ne contenant que des accusés. Correction d'un test de store instable (motif de 3 octets trouvé par hasard dans l'aléa). 43 tests, e2e avec une section « accusés ».
2026-11-20 5.5 OutboxItem enregistrés dans le store (un objet par élément et par espace), dans la même sauvegarde que le ratchet. Backoff exponentiel avec aléa, expiration après 7 jours (Event::SendFailed), dépôts regroupés par serveur avec repli élément par élément. Les messages de handshake passent aussi par la file. CLI : outbox [--flush], « queued for … ». ARCHITECTURE : §5.1, et §7 (réseau de serveurs et Matriochka, points à trancher). 41 tests, e2e avec une section « file hors ligne ».
2026-11-20 4.5 meow-client passe sur meow-store (un état par espace, sauvegarde des seuls espaces modifiés, acks par espace) ; API unlock, hide_contact, reveal_contact, change_password, history_page, file. CLI : -u, contact hide/reveal, identity password. Store derrière un Mutex pour garder le client Send + Sync (requis pour la FFI). Le fichier .mwid2 provisoire disparaît. 38 tests, e2e avec sections « contact caché » et « changement de mot de passe ».
2026-11-20 4.1–4.3 meow-store repensé après relecture du stockage v1 : objectifs anti-saisie (rien ne relie les blocs sans mot de passe, espaces cachés à un ou plusieurs contacts). Sac de blocs uniformes, espaces, segments. Un premier brouillon avec une colonne contact en clair a été abandonné. 6 tests de store. Pas encore branché dans le client.
2026-11-20 3.8 Pull non destructif + acks signés dans MailboxAuth, PendingAck enregistrés avec l'état, redélivrances dédupliquées, pagination (more), mise en retraite des mailbox disparues. Redis : liste → stream. Profil client au format 2 (les .mwid2 de format 1 sont refusés). 31 tests, e2e mémoire et Redis verts, et plus aucun message résiduel dans Redis à la fin de l'e2e.
2026-11-20 0.x, 1.1–1.4, 2.1–2.4, 3.1–3.4, 4.0, 5.1–5.4, 6.1–6.5 Squelette complet et fonctionnel. 29 tests Rust + tests/e2e.sh (≈ 60 appels CLI, 2 serveurs, mémoire et Redis, bascule quand un serveur tombe). Décision : protocole v2 sans compatibilité v1.

Phase 0 — Fondations

Lot Contenu Fin État
0.1 Workspace Cargo, conventions (fmt, clippy, forbid(unsafe)), .gitignore cargo build OK ✅
0.2 proto/meow.proto v2 + crate meow-proto (prost + protox, sans protoc) Les types sont générés au build ✅
0.3 Script scripts/check.sh (fmt + clippy + test) Le script passe ✅

Phase 1 — meow-crypto

Lot Contenu Fin État
1.1 Types de clés (Ed25519, X25519), sérialisation, zeroize, MailboxId Tests aller-retour ✅
1.2 AEAD XChaCha20-Poly1305, HKDF à labels, sealed box avec clé de réponse Tests : chiffrement, altération, mauvaise clé ✅
1.3 Chiffrement au repos par mot de passe (Argon2id) Tests ✅
1.4 Double Ratchet (spécification Signal), messages hors ordre, MAX_SKIP, état sérialisable Tests : ping-pong, désordre, rejeu refusé, état persisté puis rechargé ✅
1.5 Vecteurs de test figés (KAT) pour les labels v2, et fuzzing des décodeurs (cargo-fuzz) CI fuzz 5 min sans crash ⬜
1.6 Montée de version vers ed25519/x25519-dalek 3.x, chacha20poly1305 0.11 et rand_core 0.10 (on est volontairement sur la génération précédente, stable et cohérente) Tests verts ⬜

Phase 2 — meow-core (protocole pur, sans E/S)

Lot Contenu Fin État
2.1 Modèle : ContactKeys, Contact, ServerInfo, ContactCard ↔ proto Tests ✅
2.2 Invitation 4 étapes (Offer, Answer, Confirm, Ack) avec transcript signé Test du flux complet et des falsifications ✅
2.3 Codec des messages : UserMessage → padding → DR → PeerEnvelope Aller-retour, désordre ✅
2.4 Requêtes serveur : construction, scellement, ouverture des réponses, MailboxAuth Tests ✅
2.5 Rotation des clés de mailbox (my_next_identity v1) et révocation de contact Tests ⬜

Phase 3 — meow-server (meowsrv)

Lot Contenu Fin État
3.1 axum : /v2/card, /v2/rpc, /healthz, configuration TOML + variables d'env, server.key en 0600 Le serveur démarre ✅
3.2 MemoryStore : post, pull, long-poll (Notify), invitations (shortcode, mot de passe, 3 essais, TTL) Tests d'intégration en mémoire ✅
3.3 Vérification de MailboxAuth (fenêtre de temps, signature, anti-rejeu) Tests : rejet d'un pull volé ou rejoué ✅
3.4 RedisStore (même trait), sélectionné par storage = "redis://..." Tests avec redis-server local (ignorés si absent) ✅
3.5 Limites : taille de corps, nombre de dépôts par requête, quota par mailbox, rate limiting par IP Tests 🟡 taille de corps et nombre de dépôts faits
3.6 Packaging : Dockerfile multi-stage, unité systemd, deb/rpm (cargo-deb, cargo-generate-rpm) Image < 30 Mo ⬜
3.7 Statistiques agrégées /v2/stats (sans métadonnées par utilisateur) ⬜
3.8 Livraison au moins une fois : aujourd'hui Pull vide la mailbox (comme en v1), donc un message est perdu si le client tombe entre la réponse et la sauvegarde. Il faut un pull qui renvoie des ids, puis un Ack { ids } au pull suivant pour supprimer, avec déduplication côté client par id de message Test : coupure réseau simulée sans perte ✅ (no_message_lost_when_the_client_dies)
3.9 Chiffrer l'offre publiée sur le serveur avec une clé placée dans le fragment de l'URL (…/inv/<code>#<clé>) : le serveur ne verrait plus le nom ni le message de l'initiateur Test ⬜

Phase 4 — meow-store (persistance client)

Lot Contenu Fin État
4.0 Provisoire, remplacé par 4.5 : fichier d'identité chiffré unique dans meow-client La CLI fonctionne ✅ (retiré)
4.1 Sac de blocs : un fichier SQLite meta + blocks(id aléatoire, 4096 octets), objets découpés en blocs, réécriture vers d'autres blocs avec effacement des anciens, recyclage des blocs libres, aléa de remplissage non enregistré, migrations Tests : uniformité des blocs, rien en clair, blocs non permutables ✅
4.2 Espaces : racine à HMAC(Argon2id(mot de passe, sel)), espace principal et espaces cachés (un ou plusieurs contacts), unlock à coût constant, changement de mot de passe Tests : un espace caché est invisible avec le mot de passe principal ✅
4.3 Segments de conversation (≈ 16 Kio), historique page par page, fichiers reçus enregistrés avec le message (donc avant l'ack) Tests ✅
4.4 Recherche dans l'historique, aperçus de fichiers, compactage du fichier (reconstruction avec l'aléa) Tests ⬜
4.5 Bascule de meow-client vers meow-store, avec les espaces dans l'API (unlock, create_space, déplacement d'un contact vers un espace caché) et dans la CLI. Les espaces cachés déverrouillés sont relevés comme les autres e2e vert ✅
4.6 Test de type « analyse d'appareil » avec plusieurs copies du fichier : mesurer ce qu'un attaquant déduit de la différence entre deux copies, et ajuster la réécriture aléatoire des blocs libres et l'ajout d'aléa (voir ARCHITECTURE §6.6) Rapport ⬜

Phase 5 — meow-client (façade asynchrone)

Lot Contenu Fin État
5.1 Transport HTTP (reqwest, rustls), ajout de serveur avec épinglage de la carte ✅
5.2 Invitation par fichier et par serveur (shortcode et mot de passe) e2e ✅
5.3 Envoi : dépôt sur tous les serveurs de pull du contact, repli en cas d'échec e2e ✅
5.4 Réception : un pull par serveur regroupant toutes les mailbox, long-poll, traitement, événements e2e ✅
5.5 File d'envoi persistante avec retries et backoff, envoi hors ligne Tests ✅
5.6 Accusés de réception et de lecture chiffrés (dans le ratchet) e2e ✅
5.7 Fichiers : découpage en morceaux, reprise, déduplication, limite de taille. Le contenu reçu doit être écrit sur disque avant l'ack : aujourd'hui, la CLI écrit les fichiers après sync, alors que les acks sont déjà partis e2e (send-file) 🟡 envoi en un seul morceau
5.8 Trafic leurre : mailbox fictives dans les pulls, ordre aléatoire, padding des requêtes Tests ⬜
5.9 Stream d'événements (tokio::broadcast) et tâche de synchronisation en arrière-plan ⬜
5.10 Inviter directement dans un espace caché (le contact ne passe jamais par l'espace principal) Tests ⬜

Phase 6 — meow-cli (meow)

Lot Contenu Fin État
6.1 identity create/show, server add/list/remove, contact list/show ✅
6.2 invitation create/check/answer/accept/finalize (fichiers) e2e ✅
6.3 server-invitation create/get e2e ✅
6.4 send, send-file, sync (commande par défaut), longpoll e2e ✅
6.5 tests/e2e.sh : parité avec meowcli/test.sh Script vert ✅
6.6 Sortie --json pour l'automatisation, et import d'identité v1 (pseudo et serveurs) ⬜

Phase 7 — meow-ffi + intégration Flutter

Lot Contenu Fin État
7.1 Crate meow-ffi (cdylib) avec flutter_rust_bridge v2, API miroir de meow-client Génération Dart OK ⬜
7.2 Build Android (cargo-ndk arm64-v8a, armeabi-v7a, x86_64) et Linux, script deploy.sh libmeow_ffi.so chargé par bastet ⬜
7.3 Adaptateur Dart dans bastet (lib/meow2/), remplacement écran par écran de meowwrapper.dart Chat fonctionnel sur Linux ⬜
7.4 Arrière-plan Android : WorkManager + client.sync() Notifications ⬜
7.5 Suppression de meowjsonlib et de meowwrapper.dart ⬜

Correspondance des 63 exports actuels de meowjsonlib → API v2 : voir l'annexe A.

Phase 8 — Fonctionnalités avancées

Lot Contenu État
8.1 Chiffrement des en-têtes DR (variante « header encryption » de Signal) ⬜
8.2 Matriochka (multi-saut) : Forward { next_server, sealed }, couches de taille constante, délais aléatoires, politique de juridiction (ARCHITECTURE §7.3) ⬜
8.2a ServerCard enrichie (juridiction, opérateur, rôles, validité) + annuaire local du client alimenté par les réponses des serveurs ⬜
8.2b Maillage entre serveurs : lots de taille fixe à cadence régulière (0 à n messages, 1 à x cartes), trafic de couverture ⬜
8.2c Approbation des serveurs (anti-Sybil) : approbation manuelle, attestations signées, ancienneté (ARCHITECTURE §7.4) ⬜
8.3 Multi-appareils (mailbox d'appareil, synchronisation chiffrée) ⬜
8.4 Push WebSocket (/v2/ws) en plus du long-poll ⬜
8.5 Visio : émission de jetons LiveKit côté serveur (VideoRoomRequest) ⬜
8.6 Groupes (fan-out par paire, puis évaluation de MLS / openmls) ⬜
8.7 Portage de peer_secure (SAS) : canal Rust + vérification de l'empreinte transcript ⬜
8.8 Fédération entre organisations (voir 8.2a à 8.2c pour l'échange de cartes) ⬜
8.9 Secret pré-partagé hors ligne mélangé au ratchet (SK = HKDF(DH ‖ PSK)), puis KEM post-quantique (ML-KEM) dans l'invitation ⬜
8.10 Profils professionnels : LDAP, dépôt de clé vers l'organisation visible dans le protocole et signalé dans l'UI (ARCHITECTURE §7.4) ⬜

Phase 9 — Durcissement et livraison

Lot Contenu État
9.1 Fuzzing continu (décodeurs proto, open_sealed, ratchet_decrypt, RPC serveur) ⬜
9.2 Mémoire verrouillée pour la clé maîtresse (memsec), zeroize audité ⬜
9.3 Revue de sécurité externe du protocole v2 (document de spécification formelle) ⬜
9.4 Benchmarks (criterion) : v1 Go vs v2 Rust (chiffrement, débit serveur) ⬜
9.5 Builds reproductibles, SBOM, cargo-audit / cargo-deny en CI ⬜

Phase 10 — Migration

Lot Contenu État
10.1 Déploiement d'un meowsrv v2 en parallèle du v1 (port distinct) ⬜
10.2 Import v1 → v2 : pseudo, serveurs, historique des messages (lecture Badger/SQLite v1 via un petit outil Go d'export JSON) ⬜
10.3 Ré-invitation assistée des contacts v1 (message v1 « je passe en v2 » contenant une Offer v2) ⬜
10.4 Arrêt de la v1 ⬜

Annexe A — Correspondance meowjsonlib → API v2

meowjsonlib (v1) v2 (meow-client / FFI)
InitConfig, LoadConfig, SetConfig, SetMemPass, GetStoragePath MeowClient::open(path, password) / MeowClient::create(...)
IdentityCreate, LoadIdentity, GetIdentity MeowClient::create, client.identity()
*Avatar* client.identity().set_avatar(bytes) (phase 4.4)
MessageServerCard*, MessageServerRemove, MessageServerSetBackup client.servers().add/list/remove/update
ContactsList, ContactGet, ContactUpdate, ContactRemove, ContactNameExists client.contacts().list/get/update/remove/find_by_name
InvitationFile*, InvitationMessage*, InvitationCheck client.invitations().create/answer/accept/finalize/inspect (octets indépendants du transport)
InvitationServer* (8 fonctions) client.invitations().publish(offer, opts) / fetch(url) : 2 appels
PollServer, LongPollAllServerJobs, SaveCheckJobs, ConsumeInboxFile client.sync(wait) + client.subscribe() (plus de fichiers inbox)
CreateUserMessageAndSendJob, ProcessSendQueues, ProcessSentMessages, CreateAndStoreUserMessage, SendMessage client.messages().send(contact, Outgoing{…}) (la file d'envoi est interne)
LoadMessagesHistory, GetMessagePreview, GetFilePreview, MarkMessageProcessed client.messages().history(contact, page), .mark_read(id)
Test*, TestDb, ActivateRemoteLogger supprimés

Annexe B — Points v1 à ne pas oublier

  • Repérés pendant l'analyse, à corriger dans le dépôt Go tant que la v1 tourne :
    • meowsrv/config/meowsrv.json versionne la clé privée du serveur et api_key/api_secret LiveKit. Ces secrets sont à changer.
    • meowsrv envoie ses logs en dur à https://log.redroom.link/loki.
    • Les pulls ne sont pas authentifiés (n'importe qui peut vider une mailbox dont il connaît la clé).
    • Le suivi de livraison serveur est cassé (dvyrq: vs msg:).
    • Le TTL des invitations est faux (millisecondes au lieu de secondes ; mwiv: n'expire jamais).