12 KiB
12 KiB
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 testvert ; - 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
3.8 livraison au moins une fois✅- 4.1 → 4.5
meow-store(prérequis du mobile). - 5.5, 5.6, 5.9 file d'envoi, accusés, flux d'événements (prérequis de l'UI).
- 7.1 → 7.3 FFI et intégration dans bastet.
- Le reste (phases 8–10) selon les priorités.
Journal
| Date | Lots | Notes |
|---|---|---|
| 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 : fichier d'identité chiffré unique (*.mwid2) dans meow-client, avec écriture atomique et verrou exclusif |
La CLI fonctionne | ✅ |
| 4.1 | Schéma SQLite (identité, serveurs, contacts, sessions DR, messages, fichiers, file d'envoi) + migrations | Tests | ⬜ |
| 4.2 | Chiffrement applicatif des colonnes (AAD table‖id), changement de mot de passe |
Tests | ⬜ |
| 4.3 | Contacts cachés : emplacements de taille fixe, déverrouillage par mot de passe secondaire | Tests d'indiscernabilité de taille | ⬜ |
| 4.4 | Pagination de l'historique, recherche, aperçus de fichiers | Tests | ⬜ |
| 4.5 | Bascule de meow-client du fichier .mwid2 vers meow-store |
e2e vert | ⬜ |
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 |
⬜ |
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 }, délais aléatoires |
⬜ |
| 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 | Liste de serveurs connus, échange de cartes, fédération | ⬜ |
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.jsonversionne la clé privée du serveur etapi_key/api_secretLiveKit. Ces secrets sont à changer.meowsrvenvoie 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:vsmsg:). - Le TTL des invitations est faux (millisecondes au lieu de secondes ;
mwiv:n'expire jamais).