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

192 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).