192 lines
16 KiB
Markdown
192 lines
16 KiB
Markdown
# 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`](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).
|